# La base de données

Droits, migrations, décisions humaines : les règles de la base.


Les règles vivent dans la base, pas dans l'écran. Une règle d'accès oubliée dans un écran laisse sortir des données ; oubliée dans la base, elle n'en laisse sortir aucune.

:::caution[Cloisonnement en évolution]
Ironlane évolue vers une base par société dans un même serveur PostgreSQL. La règle BASE-04 (chaque ligne porte sa société) décrit l'état actuel ; elle sera réécrite avec la construction.
:::

:::note[En bref]
- **BASE-01** · [Activez la règle d'accès sur chaque table](#base-01--activez-la-règle-daccès-sur-chaque-table)
- **BASE-02** · [Écrivez les droits dans la migration qui crée la table](#base-02--écrivez-les-droits-dans-la-migration-qui-crée-la-table)
- **BASE-03** · [Gardez toute fonction qu'un écran appelle](#base-03--gardez-toute-fonction-quun-écran-appelle)
- **BASE-04** · [N'écrivez pas de société dans une table](#base-04--nécrivez-pas-de-société-dans-une-table)
- **BASE-05** · [Passez par l'outil de migration, avant le code](#base-05--passez-par-loutil-de-migration-avant-le-code)
- **BASE-06** · [Dites comment la migration se défait](#base-06--dites-comment-la-migration-se-défait)
- **BASE-07** · [Recréez une fonction dont la signature change](#base-07--recréez-une-fonction-dont-la-signature-change)
- **BASE-08** · [Ne touchez jamais la production à la main](#base-08--ne-touchez-jamais-la-production-à-la-main)
- **BASE-09** · [Archivez, ne supprimez pas](#base-09--archivez-ne-supprimez-pas)
- **BASE-10** · [Gardez une décision humaine dans une table](#base-10--gardez-une-décision-humaine-dans-une-table)
- **BASE-11** · [Écrivez les dates à l'heure de Paris](#base-11--écrivez-les-dates-à-lheure-de-paris)
- **BASE-12** · [Sauvegardez avant, restaurez pour de vrai](#base-12--sauvegardez-avant-restaurez-pour-de-vrai)
:::

## Les droits

### BASE-01 · Activez la règle d'accès sur chaque table

:::tip[Règle]
Chaque table active la RLS, en lecture et en écriture, et ne laisse rien lire sans session. Sans session, rien ne répond.
:::

**Pourquoi.** Un filtre oublié dans un écran laisse sortir des données ; une règle oubliée dans la base n'en laisse sortir aucune.

<div class="avant-apres">

```sql title="À éviter"
create table rappel (id uuid primary key, quoi text);
```

```sql title="À faire"
create table rappel (id uuid primary key, quoi text);
alter table rappel enable row level security;
create policy rappel_lecture on rappel for select to authenticated
  using (true);  -- version simplifiée : la vraie règle dit qui voit quoi
```

</div>

<span class="puce outil">Outil</span> Le contrôle de la base refuse une table sans règle d'accès.

### BASE-02 · Écrivez les droits dans la migration qui crée la table

:::tip[Règle]
Une table neuve reçoit ses droits dans sa migration : les comptes connectés ce qu'un écran touche en direct, le rôle de service tout, le rôle anonyme rien.
:::

<div class="avant-apres">

```sql title="À éviter"
grant all on rappel to anon;  -- ou aucun droit écrit
```

```sql title="À faire"
revoke all on rappel from anon;
grant select, insert, update on rappel to authenticated;
grant all on rappel to service_role;
```

</div>

<span class="puce outil">Outil</span> Un relevé croise chaque lecture directe des écrans avec les droits de la base.

### BASE-03 · Gardez toute fonction qu'un écran appelle

:::tip[Règle]
Toute fonction qu'un écran appelle commence par vérifier le droit, puis le périmètre. Une fonction interne, appelée seulement par une autre, reste fermée.
:::

**Pourquoi.** Tout compte connecté a la clé de l'API : il peut appeler toute fonction ouverte aux comptes connectés, avec ou sans l'écran.

<div class="avant-apres">

```sql title="À éviter"
create function les_rappels() returns setof rappel
language sql security definer as $$ select * from rappel $$;
```

```sql title="À faire"
create function les_rappels() returns setof rappel
language sql security definer as $$
  select garde('rappels.voir');          -- le droit
  select * from rappel;                  -- la règle d'accès filtre le périmètre
$$;
revoke all on function les_rappels() from public, anon;
grant execute on function les_rappels() to authenticated;
```

</div>

<span class="puce outil">Outil</span> Un contrôle refuse une fonction à droits élevés ouverte sans garde ; un relevé liste les fonctions ouvertes sans besoin.

### BASE-04 · N'écrivez pas de société dans une table

:::tip[Règle]
Une base ne porte qu'une société. Une table neuve n'a ni colonne de société, ni paramètre de société dans ses fonctions : la société de la base se lit par `ma_societe()`, et aucune requête ne la choisit.
:::

<div class="avant-apres">

```sql title="À éviter"
create table piece (id uuid primary key, societe_id uuid not null, affaire_id uuid);
create function les_pieces(p_societe uuid) returns setof piece ...
```

```sql title="À faire"
create table piece (id uuid primary key, affaire_id uuid references affaire(id));
create function les_pieces() returns setof piece ...
```

</div>

<span class="puce outil">Outil</span> `pnpm societe` refuse, au commit, toute mention nouvelle de la société hors d'une liste connue.

**Voir aussi.** [L'architecture](/ingenierie/architecture/)

## Les migrations

### BASE-05 · Passez par l'outil de migration, avant le code

:::tip[Règle]
Un changement de la base est un fichier de migration, joué par l'outil, avant le code qui l'appelle. L'ancien code doit tenir sur la base nouvelle le temps du déploiement.
:::

<div class="avant-apres">

```bash title="À éviter"
psql "$BASE_PRODUCTION" -c "alter table rappel add column urgence boolean"
```

```bash title="À faire"
# migrations/20261108120000_un_rappel_peut_etre_urgent.sql
alter table rappel add column urgence boolean not null default false;
```

</div>

<span class="puce outil">Outil</span> Les scripts de mise en ligne jouent les migrations avant de pousser le code.

### BASE-06 · Dites comment la migration se défait

:::tip[Règle]
Chaque migration porte, en commentaire de tête, comment on la défait, ou pourquoi on ne peut pas.
:::

<div class="avant-apres">

```sql title="À éviter"
alter table rappel drop column urgence;
```

```sql title="À faire"
-- Défaire : alter table rappel add column urgence boolean not null default false;
-- Les valeurs de la colonne retirée ne se retrouvent pas.
alter table rappel drop column urgence;
```

</div>

<span class="puce relecture">Relecture</span> Le commentaire de tête est relu à la seconde lecture de la base.

### BASE-07 · Recréez une fonction dont la signature change

:::tip[Règle]
Changer la signature ou le retour d'une fonction, c'est la supprimer puis la recréer avec ses droits. Une fonction partagée se modifie par remplacement sur sa définition vivante, jamais en la recopiant entière.
:::

<div class="avant-apres">

```sql title="À éviter"
create or replace function les_rappels(p_pour uuid, p_tous boolean) ...
-- l'ancienne signature reste : deux fonctions de même nom
```

```sql title="À faire"
drop function les_rappels(uuid);
create function les_rappels(p_pour uuid, p_tous boolean) ...;
revoke all on function les_rappels(uuid, boolean) from public, anon;
grant execute on function les_rappels(uuid, boolean) to authenticated;
```

</div>

<span class="puce outil">Outil</span> Le contrôle des migrations refuse une fonction recopiée entière et un changement de table sans délai de verrou.

### BASE-08 · Ne touchez jamais la production à la main

:::tip[Règle]
Aucun essai ni migration à la main sur la production. Un essai se fait sur une copie, ou dans une transaction annulée.
:::

<div class="avant-apres">

```sql title="À éviter"
-- sur la production, « juste pour voir »
update affaire set montant_ht = 1200 where numero = 'A720';
```

```sql title="À faire"
-- sur une copie, ou dans une transaction qu'on annule
begin;
update affaire set montant_ht = 1200 where numero = 'A720';
select * from affaire where numero = 'A720';
rollback;
```

</div>

<span class="puce outil">Outil</span> Les scripts d'essai et de rejeu tournent en transaction annulée ou sur la copie ; les tests de bout en bout refusent la production.

## Les données

### BASE-09 · Archivez, ne supprimez pas

:::tip[Règle]
On archive une ligne, on ne la supprime pas. Un numéro donné ne se réutilise jamais.
:::

<div class="avant-apres">

```sql title="À éviter"
delete from affaire where id = $1;
```

```sql title="À faire"
update affaire set archive_le = now(), archive_par = auth.uid() where id = $1;
```

</div>

<span class="puce outil">Outil</span> Les comptes connectés n'ont pas le droit de suppression sur les tables principales.

**Exception.** Les données personnelles arrivées à leur durée de conservation s'effacent toutes seules.

### BASE-10 · Gardez une décision humaine dans une table

:::tip[Règle]
Quand une personne tranche (« ces deux fiches sont la même »), la décision va dans une table, sur une clé stable, avec son motif. Aucune correction à la main sur une table de métier.
:::

**Pourquoi.** Un import ou un recalcul consulte la décision ; sinon il l'écrase au passage suivant.

<div class="avant-apres">

```sql title="À éviter"
update client set nom = 'Dupont SA' where nom = 'DUPONT S.A.';  -- écrasé au prochain import
```

```sql title="À faire"
insert into alias_client (nom_importe, client_id, motif)
values ('DUPONT S.A.', $1, 'Même client, raison sociale écrite autrement');
```

</div>

<span class="puce relecture">Relecture</span> Les tables de décisions sont la mise en œuvre ; la règle se relit.

### BASE-11 · Écrivez les dates à l'heure de Paris

:::tip[Règle]
Le métier est à l'heure de Paris, la base tourne en UTC. Utilisez la fonction `aujourdhui()` côté base et son équivalent côté application.
:::

<div class="avant-apres">

```ts title="À éviter"
const jour = new Date().toISOString().slice(0, 10);  // le soir, déjà demain en UTC
```

```ts title="À faire"
const jour = aujourdhui();  // la date de Paris
```

</div>

<span class="puce relecture">Relecture</span> Ni `current_date` ni `toISOString().slice(0, 10)`.

### BASE-12 · Sauvegardez avant, restaurez pour de vrai

:::tip[Règle]
Une sauvegarde juste avant chaque migration, et une chaque nuit, chiffrée, rangée ailleurs que chez l'hébergeur. Une sauvegarde jamais restaurée n'en est pas une.
:::

<div class="avant-apres">

```text title="À éviter"
« La sauvegarde tourne chaque nuit. » (jamais essayée)
```

```text title="À faire"
Restauration essayée sur une base jetable, régulièrement, et le résultat noté.
```

</div>

<span class="puce outil">Outil</span> Un contrôle de restauration tourne chaque nuit sur la copie de secours.

## Référence rapide

| Règle | À retenir | Tenue par |
| --- | --- | --- |
| **BASE-01** | Activez la règle d'accès sur chaque table | Outil |
| **BASE-02** | Écrivez les droits dans la migration qui crée la table | Outil |
| **BASE-03** | Gardez toute fonction qu'un écran appelle | Outil |
| **BASE-04** | N'écrivez pas de société dans une table | Outil |
| **BASE-05** | Passez par l'outil de migration, avant le code | Outil |
| **BASE-06** | Dites comment la migration se défait | Relecture |
| **BASE-07** | Recréez une fonction dont la signature change | Outil |
| **BASE-08** | Ne touchez jamais la production à la main | Outil |
| **BASE-09** | Archivez, ne supprimez pas | Outil |
| **BASE-10** | Gardez une décision humaine dans une table | Relecture |
| **BASE-11** | Écrivez les dates à l'heure de Paris | Relecture |
| **BASE-12** | Sauvegardez avant, restaurez pour de vrai | Outil |

## Voir aussi

- [Nommer dans la base](/regles/nommage-base/)
- [L'architecture](/ingenierie/architecture/)
