Aller au contenu

La base de données

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

Voir en Markdown

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.

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

Section intitulée « BASE-01 · Activez la règle d’accès sur chaque table »

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.

À éviter
create table rappel (id uuid primary key, quoi text);
À 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

Outil 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

Section intitulée « BASE-02 · Écrivez les droits dans la migration qui crée la table »
À éviter
grant all on rappel to anon; -- ou aucun droit écrit
À faire
revoke all on rappel from anon;
grant select, insert, update on rappel to authenticated;
grant all on rappel to service_role;

Outil Un relevé croise chaque lecture directe des écrans avec les droits de la base.

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

Section intitulée « BASE-03 · Gardez toute fonction qu’un écran appelle »

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.

À éviter
create function les_rappels() returns setof rappel
language sql security definer as $$ select * from rappel $$;
À 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;

Outil 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

Section intitulée « BASE-04 · N’écrivez pas de société dans une table »
À é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 ...
À faire
create table piece (id uuid primary key, affaire_id uuid references affaire(id));
create function les_pieces() returns setof piece ...

Outil pnpm societe refuse, au commit, toute mention nouvelle de la société hors d’une liste connue.

Voir aussi. L’architecture

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

Section intitulée « BASE-05 · Passez par l’outil de migration, avant le code »
À éviter
psql "$BASE_PRODUCTION" -c "alter table rappel add column urgence boolean"
À faire
# migrations/20261108120000_un_rappel_peut_etre_urgent.sql
alter table rappel add column urgence boolean not null default false;

Outil Les scripts de mise en ligne jouent les migrations avant de pousser le code.

À éviter
alter table rappel drop column urgence;
À 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;

Relecture Le commentaire de tête est relu à la seconde lecture de la base.

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

Section intitulée « BASE-07 · Recréez une fonction dont la signature change »
À éviter
create or replace function les_rappels(p_pour uuid, p_tous boolean) ...
-- l'ancienne signature reste : deux fonctions de même nom
À 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;

Outil 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

Section intitulée « BASE-08 · Ne touchez jamais la production à la main »
À éviter
-- sur la production, « juste pour voir »
update affaire set montant_ht = 1200 where numero = 'A720';
À 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;

Outil 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.

À éviter
delete from affaire where id = $1;
À faire
update affaire set archive_le = now(), archive_par = auth.uid() where id = $1;

Outil 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

Section intitulée « BASE-10 · Gardez une décision humaine dans une table »

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

À éviter
update client set nom = 'Dupont SA' where nom = 'DUPONT S.A.'; -- écrasé au prochain import
À faire
insert into alias_client (nom_importe, client_id, motif)
values ('DUPONT S.A.', $1, 'Même client, raison sociale écrite autrement');

Relecture Les tables de décisions sont la mise en œuvre ; la règle se relit.

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

Section intitulée « BASE-11 · Écrivez les dates à l’heure de Paris »
À éviter
const jour = new Date().toISOString().slice(0, 10); // le soir, déjà demain en UTC
À faire
const jour = aujourdhui(); // la date de Paris

Relecture Ni current_date ni toISOString().slice(0, 10).

BASE-12 · Sauvegardez avant, restaurez pour de vrai

Section intitulée « BASE-12 · Sauvegardez avant, restaurez pour de vrai »
À éviter
« La sauvegarde tourne chaque nuit. » (jamais essayée)
À faire
Restauration essayée sur une base jetable, régulièrement, et le résultat noté.

Outil Un contrôle de restauration tourne chaque nuit sur la copie de secours.

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