The codeQualité et livraison(in French)4 min read
Sauvegardes et reprise
Ce qui protège vraiment les données aujourd’hui, la copie chiffrée et sa restauration vérifiée, la planification prête mais pas activée, et ce qui reste exposé.
Not translated yet
Où on en est aujourd’hui, le README le dit en un paragraphe. Je le reprends ici tel quel :
Sauvegardes
Aucune sauvegarde ne tourne d'elle-même : le retour arrière de la production passe par la restauration à un instant de Neon. pnpm db:backup --source <url> --to-file <chemin> fait à la main une copie chiffrée de la base (clé BACKUP_ENCRYPTION_KEY), pnpm db:backup-documents --dest <dossier> copie les documents comptables, et pnpm db:restore --target <url> --from-file <copie> restaure une copie sur une base vide.
Ce choix est noté dans apps/erp/scripts/pre-deploy-migrate.mts. « Migrer la prod » se fait sans copie de la base (--sans-sauvegarde). Et pour revenir en arrière, on passe par la restauration à un instant donné de Neon. J’ai retiré le workflow de sauvegarde nocturne le même jour que les GitHub Actions (commit ceae67825b : « la copie de nuit n’est plus voulue »). Les outils de copie et de restauration sont restés, avec leurs tests. Ils servent aux copies faites à la main.
La copie chiffrée
pnpm db:backup (apps/erp/scripts/backup-database.mts) refuse tout ce qui pourrait donner une copie fausse ou exposée :
- La source se donne explicitement (
--source). Le script ne la lit pas dans l’environnement. Et il n’accepte pas un pooler, parce quepg_dumpa besoin d’une session directe. - Les versions doivent correspondre. Avant le dump, le script compare la version majeure de
pg_dumpà celle du serveur (pgDumpVersionRefusal,scripts/lib/backup-environment.ts). - La copie n’existe jamais en clair. Le dump (
pg_dump --format=custom) est chiffré au fil de l’eau en AES-256-GCM (scripts/lib/backup-cipher.ts) avant d’être écrit, en0600, avec son empreinte SHA-256. La clé (BACKUP_ENCRYPTION_KEY) n’est ni dans le dépôt ni sur Vercel. - Un dump de zéro octet est refusé.
La copie va sur le disque (--to-file) ou dans un magasin Blob privé. Dans ce deuxième cas, le script refuse un magasin partagé avec les photos ou les factures. Après l’envoi, il vérifie que le magasin contient autant d’octets que ce qui est parti, et il supprime un dépôt incomplet. Il applique la rétention de BACKUP_RETENTION (apps/erp/scripts/constants/backup.ts). Il note chaque suppression avant de la faire, et il ne touche pas à ce qu’il ne reconnaît pas. À la fin, il prévient un témoin externe, mais seulement si le dépôt a réussi.
Les documents comptables se copient à part. pnpm db:backup-documents (apps/erp/scripts/backup-documents.mts) les copie dans un dossier qu’on choisit, et ce dossier ne peut pas être dans le dépôt. Il sait aussi vérifier ou restaurer cette copie.
La restauration vérifiée
pnpm db:restore (apps/erp/scripts/restore-database.mts) ne restaure que sur une base vide. Et quand pg_restore a fini, il lui reste du travail :
- La cible se donne explicitement (
--target). Les URL de l’environnement (DATABASE_URLet ses variantes) ne servent qu’à interdire. Le script ne peut pas écraser la base qu’elles désignent (judgeRestoreTarget,scripts/lib/restore-target.ts). Et il refuse une cible qui n’est pas vide. - Le script déchiffre l’archive puis la lit (
pg_restore --list). Si elle ne contient aucune entrée, il la refuse. - La restauration se fait en une seule transaction (
--single-transaction --exit-on-error). Si elle échoue, la cible reste vide. On ne se retrouve pas avec une base à moitié remplie. - Avec
--replay-erasures, les effacements sont rejoués. Sans ça, une personne effacée après la copie redeviendrait visible. Le registre des effacements les refait, et si un effacement est refusé, la restauration échoue (Données personnelles). - Les séries de factures sont contrôlées. S’il manque un numéro, la restauration échoue (
invoiceSeriesGaps,scripts/lib/restore-verification.ts). - La copie est vérifiée comme une base migrée :
db:invariants, puis la suite Postgres. La restauration ne lance cette suite que sur une cible locale, parce qu’elle écrit en base et consomme des numéros de facture.
La planification, prête mais pas activée
pnpm backup:schedule (apps/erp/scripts/schedule-backup.sh) installe un agent launchd qui lancerait scripts/launchd/backup.sh tous les jours. Il refuse de s’installer tant que la clé, le jeton du magasin et l’URL de la base ne sont pas renseignés dans son fichier d’environnement. Et le lanceur signale un échec par une notification du système. Comme le dit le README, aucune sauvegarde ne tourne toute seule. L’outil existe, mais il n’est pas en service.
Les outils sont testés
apps/erp/test/backup-scripts.regression.test.ts vérifie tout ce que je viens de décrire : un dépôt privé et vérifié, une source et une cible explicites, la comparaison des versions avant le dump, le témoin appelé seulement en cas de succès, la suite Postgres lancée seulement sur une cible locale, la continuité des factures contrôlée avant les autres vérifications, et l’agent qui refuse de s’installer sans ses variables. Les briques ont leurs tests unitaires dans apps/erp/scripts/lib/__tests__ (chiffrement, rétention, environnement, destination, cible et vérification de la restauration).
Ce qui reste exposé
- Il n’y a qu’une copie automatique, celle de Neon. Elle est chez le même fournisseur que la base, et elle se limite à la fenêtre de restauration de son offre.
- Une copie à la main dépend de ma mémoire, surtout avant une migration lancée avec
--sans-sauvegarde. - Une restauration ne laisse pas de trace dans le dépôt. Ses journaux (
restore.*) s’affichent seulement dans le terminal. - La restauration à un instant de Neon ramène les compteurs de numérotation à cet instant. Sauf que les PDF des factures émises après restent archivés. Du coup, la facture suivante reprend un numéro déjà envoyé à un client. L’archivage la refuse et alerte. Par contre, rien ne rapproche encore les compteurs des archives avant que la facturation reprenne.