01

Vue d’ensemble

Adminly aide les particuliers et les indépendants dans leurs démarches en Suisse : impôts, déménagement, création d’entreprise, arrivée en Suisse, TVA, assurance-maladie. Son cœur est le parcours « Situations de vie » : un questionnaire produit un plan de démarches daté et adapté au canton, avec un aperçu gratuit, une offre payante, un export PDF et des rappels par e-mail. C’est un projet personnel en production ; il n’a pas encore fait ses preuves commercialement.

Cette étude de cas suit trois chantiers de novembre 2026 : des sauvegardes réellement restaurables, une chaîne de livraison, et un audit de sécurité suivi de ses corrections.

02

Contexte

Adminly a d’abord été un SaaS à cinq modules, avec un portail pour les fiduciaires. En mai 2026, je l’ai recentré sur les « Situations de vie » ; l’ancien périmètre n’est plus développé depuis. Au fil de ce pivot, le produit avait accumulé plusieurs parcours d’achat.

C’est une application Next.js 16 d’environ 108 000 lignes, conteneurisée, derrière Caddy, avec une base managée sur une offre gratuite sans sauvegarde native. Elle gère des comptes, des paiements et des données sensibles : des réponses pouvant toucher à la santé, des données fiscales. Jusqu’au 9 novembre 2026, le déploiement était un script lancé en root qui tirait la branche et construisait la copie de travail.

03

Défi

Un assistant administratif n’a de valeur que s’il est juste, à jour et sûr : il manipule des données personnelles, des paiements et des règles qui changent d’un canton à l’autre.

Sauvegardes. L’audit du 4 novembre 2026 a montré que le dump nocturne n’était pas restaurable : il ne contenait ni les comptes, ni les permissions, ni les fichiers, et son option de nettoyage détruisait le schéma cible. La clé de stockage présente sur le serveur pouvait effacer tout l’historique, et cinq autres services du serveur n’avaient aucune sauvegarde hors du disque.

Livraison. L’audit du 11 novembre 2026 a classé le déploiement « fragile » : pas de verrou, une construction depuis un répertoire modifiable par les agents, un seul niveau de retour, un contrôle de santé laxiste, un nettoyage d’images qui pouvait toucher d’autres projets. Il n’y avait pas de CI, ni de protection de la branche principale (indisponible sur l’offre utilisée).

Sécurité. L’audit en lecture seule du 9 novembre 2026 a relevé 18 constats, dont 3 critiques : prise de contrôle d’un compte lors d’un achat sans connexion, appropriation d’un client par un compte professionnel, attribution d’un accès payant par mise à jour directe d’une table. S’y ajoutaient une surveillance aveugle depuis 83 jours et un framework en version vulnérable.

04

Objectifs

  • Un plan daté et adapté au canton
  • Un paiement sûr
  • Des données personnelles protégées
  • Des sauvegardes prouvées par de vraies restaurations
  • Des déploiements qui ne cassent pas la production

05

Choix techniques

Application Next.js conteneurisée, servie derrière Caddy sur mon serveur ; base Supabase managée à Francfort (PostgreSQL 17, authentification, stockage privé, Vault) ; paiement Stripe par redirection, avec un webhook signé et idempotent ; e-mails via Resend ; notifications d’administration sur Telegram. La sécurité au niveau des lignes (RLS) est activée sur les 43 tables publiques en production (15.11.2026), et ses politiques sont testées rôle par rôle dans une préproduction locale fidèle.

Sauvegardes. Trois chaînes quotidiennes indépendantes (Adminly, un second produit, l’infrastructure du serveur) : archive restaurable → chiffrement symétrique → envoi vers un stockage objet avec verrou objet de 30 jours → vérification d’empreinte → contrôle quotidien avec alerte → surveillance de fraîcheur toutes les 15 minutes. Les clés d’envoi n’ont pas le droit de supprimer. La procédure de restauration est écrite et embarquée dans l’archive ; les phrases de passe sont hors du serveur.

Livraison. Une CI GitHub Actions sans aucun secret : types → lint à cliquet (jamais pire que la ligne de base) → tests → build → garde des routes → smoke test sur serveur réel → audit des dépendances, et un job séparé, non bloquant, pour les « alarmes de date ». Le déploiement est un script root non modifiable : il prend un commit, vérifie qu’il est le sommet de la branche principale, construit depuis une archive Git, essaie l’image sur un port secondaire, bascule, exige que la route de santé renvoie ce commit, revient seul en arrière sinon, et garde 5 images. Un crochet local refuse tout push direct sur la branche principale ; une image de CI locale permet de rejouer la séquence avant de pousser.

Sécurité. L’accès après achat passe par un lien envoyé à l’adresse du compte, lié à la session de paiement. Les politiques de mise à jour côté client ont été supprimées : l’état d’accès n’est plus écrit que par le serveur, avec un trigger de garde en base. Le webhook de paiement est signé, idempotent et refuse les événements de test. Le secret de notification a été déplacé dans le coffre de la base ; la surveillance a reçu un rôle en lecture seule ; les droits inutiles ont été retirés aux rôles publics. Des tests RLS par rôle s’exécutent dans une préproduction fidèle.

06

Architecture

Navigateur → Caddy → application Next.js (conteneur, serveur de production) → Supabase (Francfort) ; services externes : Stripe, Resend, Telegram.

Commit → CI (GitHub Actions) → script de déploiement → image essayée sur un port secondaire → bascule → contrôle de santé lié au commit → retour arrière automatique en cas d’échec. Base, comptes et fichiers → archive chiffrée → stockage objet hors site, verrouillé 30 jours.

07

Technologies

  • TypeScript 5
  • Next.js 16.4.6
  • React 19.2.4
  • Tailwind CSS 4
  • Node 24.22.3
  • Supabase (PostgreSQL 17, Auth, Storage, Vault)
  • PostgreSQL RLS, triggers, pg_dump
  • Stripe (webhooks)
  • Resend
  • Docker (multi-étapes)
  • Caddy
  • GitHub Actions
  • Vitest
  • ESLint
  • GnuPG
  • Bash, cron

Versions au 15 novembre 2026. Taille : environ 108 000 lignes de TypeScript, 694 fichiers, 56 pages, 75 routes d’API.

08

Mise en œuvre

Sauvegardes. Les difficultés : reconstituer les permissions exactes d’une base managée, restaurer les comptes avec leurs déclencheurs, identifier les versions exactes de la production pour monter une pile fidèle ; le fournisseur a migré un composant pendant le test, et son coffre de secrets n’est pas exportable. Les réponses : une restauration en quatre temps (schéma avec permissions, permissions exactes, déclencheurs d’authentification, données en mode réplication), des versions déduites des empreintes de migrations de la production, une comparaison ligne à ligne par somme de contrôle, et la documentation de ce qui n’est pas sauvegardé et de la façon de le recréer.

Livraison. Les difficultés : 114 erreurs de lint héritées, des tests dépendant de la date ou du fuseau, le besoin de Docker pour la CI locale alors que les agents n’y ont plus accès, un disque serré (chaque build ajoute 1 à 2,5 Go). Les réponses : un cliquet (ne jamais faire pire que la ligne de base) plutôt qu’un blocage total, les tests de date isolés dans un job non bloquant, une commande root fixe pour la CI locale, un ménage nocturne journalisé du cache de build, un banc d’essai du script de déploiement avec un faux Docker.

Sécurité. Les difficultés : corriger sans régression un parcours de paiement non couvert par des tests de bout en bout ; prouver qu’une politique est réellement fermée ; pendant l’intervention, un secret affiché par mégarde par une requête de lecture. Les réponses : des tests RLS rouges sans la migration et verts avec (6 échecs, puis 21 sur 21), des mesures d’urgence réversibles avant le correctif de fond, la rotation du secret exposé dans l’heure, consignée comme incident, et une garde automatique contre les politiques ouvertes.

09

Résultats

  • Sauvegardes, 4 novembre 2026 : 14 contrôles sur 14 et 6 fichiers sur 6, environ 452 600 lignes identiques, en 14 secondes.
  • Sauvegardes, 10 novembre 2026 : restauration de bout en bout depuis le stockage hors site, 7 sur 7 et 9 sur 9, archive identique à l’octet. 11 novembre : chaîne de l’infrastructure, 19 sur 19. 13 novembre : second produit, 18 tables sur 18.
  • Les sauvegardes ne peuvent plus être effacées depuis le serveur pendant 30 jours.
  • Livraison : 22 PR livrées par ce flux en 6 jours (10–15 novembre 2026) ; un job de CI d’environ 3 minutes ; environ 2 600 tests exécutés, selon les journaux du 10 au 13 novembre 2026 ; retour arrière en une commande. Incident consigné : CI rouge environ 24 heures, parce qu’une nouvelle route manquait dans une liste de référence.
  • Sécurité : les 3 constats critiques ont été fermés le 9 novembre 2026 au soir. Le lendemain : dépendances de production ramenées de 13 vulnérabilités à 0, secret en coffre, jetons révoqués, surveillance rétablie avec une alerte « surveillance en panne ». Aucune vente réelle n’avait eu lieu, donc aucune victime.

10

Limites

  • Sauvegardes : restauration des données seulement ; ni délai de reprise mesuré, ni reconstruction complète du service testée.
  • Livraison : pas de test de bout en bout ; migrations de base sans retour arrière ; déploiement déclenché à la main.
  • Sécurité : certains points restent ouverts après l’audit ; ils sont consignés par écrit et en cours de traitement.
  • Restent aussi à faire au 15 novembre 2026 : une journalisation structurée et une mesure de disponibilité complète.

11

Mon rôle

J’ai défini le produit et son recentrage sur les « Situations de vie », choisi les priorités et les règles éditoriales. Le code est en grande partie produit avec Claude Code : 287 des 337 commits (85 %) portent une co-signature Claude au 15 novembre 2026.

Sauvegardes : j’ai exigé des preuves réelles et aucun objet factice, validé chaque étape, créé depuis mon poste les buckets, le verrou et les clés limitées, et installé les scripts. La méthode de restauration et les scripts ont été écrits par Claude Code.

Livraison : je pousse, je fusionne chaque PR après une CI verte, je lance chaque déploiement et j’en vérifie le résultat ; j’ai décidé le flux et l’épinglage des versions. Le code de la CI, le script de déploiement et son banc d’essai ont été écrits par Claude Code.

Sécurité : j’ai commandé l’audit, tranché les urgences, autorisé chaque mesure, et je l’ai appliquée ou fait appliquer sur accord nommé ; j’ai renouvelé les secrets et révoqué les jetons. L’analyse, les correctifs et les tests ont été écrits par Claude Code.

12

Enseignements

Une sauvegarde n’est fiable qu’après une restauration réussie ; un déploiement doit aussi pouvoir être vérifié et annulé.

Contact

Construisons quelque chose de fiable.

Disponible immédiatement pour un poste d’administrateur systèmes, et toujours partant pour fiabiliser un système ou parler d’un produit.

Me contacter