Le projet6 min de lecture
Compétences et preuves
Les compétences que je revendique en full-stack, architecture, sécurité, UX et qualité. Chacune a sa preuve, lue dans le dépôt au build : du code, un test, un schéma ou une décision.
Dire qu’un logiciel est « sécurisé », « testé » ou « bien architecturé », ça ne coûte rien. Du coup, pour chaque compétence, je montre de quoi la vérifier : le code qui l’applique, le test qui la prouve, le schéma calculé depuis les sources, la décision qui l’explique, et des chiffres comptés dans le dépôt.
- suites de tests jouées sur une vraie base Postgres
- 111
- apps/*/test/db/*.db.test.ts
- tests de régression, dont la plupart lisent le code source et refusent tout écart à une règle
- 92
- apps/*/test/*.regression.test.ts
- contraintes CHECK écrites à la main, relues sur la base à chaque migration appliquée
- 169
- apps/erp/scripts/constants/db-invariants.ts#EXPECTED_CHECKS
- tables, sur les 54 du schéma, où le site public peut écrire
- 6
- apps/site/scripts/lib/database-grants.ts#SITE_TABLE_GRANTS
- fichiers de code encore copiés d’une application à l’autre, liste qui ne peut que diminuer
- 28
- scripts/twins.manifest.json
- décisions d’architecture consignées au format ADR
- 14
- apps/docs/content/docs/(public)/architecture/decisions
Dans Mesures, il y a ce que le projet mesure (performance, Core Web Vitals, tests, fiabilité, maintenabilité), ce qu’il ne mesure pas encore, et le protocole pour le mesurer.
L’IA comme levier, l’ingénierie comme exigence. Dans Ma contribution et l’IA, je détaille comment je construis avec Claude Code et ce que je garde en main (conception, arbitrages, développement, validation), traces à l’appui.
Ce que j’affirme, et ce qui le prouve
Comment lire ces pages
Personne ne recopie un extrait à la main. Chacun est lu dans le dépôt au build de la doc. Sa légende donne le fichier, l’élément cité et ses lignes dans le fichier. Pour une définition SQL, on montre la dernière qu’une migration a posée.
Si une fonction, un test ou une définition SQL disparaît ou change de nom, le build de la doc casse, et le message d’erreur dit ce qui manque. Une preuve ne peut donc pas rester en ligne sans le code qu’elle cite. Le build se relance dès qu’un fichier cité change (apps/docs/scripts/ignore-build.sh).
Les chiffres non plus ne sont pas écrits à la main. Chaque mesure dit ce qu’elle compte et où.
Le dépôt est privé, donc la preuve publique, ce sont les extraits. Si vous avez accès au dépôt, vous pouvez tout rejouer :
| Ce qui se rejoue | Commande |
|---|---|
| Les deux applications sans copie | pnpm check:twins, depuis la racine |
| Les tests qui lisent le code de l’ERP | pnpm exec vitest run test/ regression, depuis apps/erp |
| La suite Postgres de l’ERP | DB_BEHAVIOUR_TESTS=1 pnpm test:db, depuis apps/erp, sur une base locale migrée |
| Les garanties d’une base migrée | pnpm db:invariants, depuis la racine, DATABASE_URL posée |
Ce que ces pages ne prouvent pas
Le build de la doc vérifie que le code et les tests cités existent, mais il ne les lance pas. Ce qui tourne dans le hook pre-push, ce sont les tests qui lisent le code, ceux des fichiers touchés et, quand le changement le demande, la suite Postgres. Les tests e2e, eux, se lancent à la main (Qualité). Qualité et livraison dit ce que cette porte ne couvre pas, et les Décisions d’architecture expliquent les compromis assumés.
- Full-stackDes features qui vont de la base à l’écran, dans deux applications : une règle écrite une fois, un paiement qui correspond à la page, un stock qui ne se vend pas deux fois, un cache qui suit l’ERP.
- ArchitectureCe sont des outils qui font respecter les frontières du code, sans compter sur la discipline : des dépendances à sens unique, deux applications qui ne divergent plus, un contrat partagé, des décisions écrites.
- SécuritéDes garanties qui ne dépendent pas du code qu’elles protègent : une base qui limite ce que le site peut faire, des actions serveur qui s’ouvrent toutes sur leur garde, des messages signés, un assistant qui ne peut pas inventer un chiffre.
- UXLes règles d’UX sont écrites dans le code : des pages qui n’attendent pas leur lecture la plus lente, pas de toast pour un succès qu’on voit déjà, des gestes qu’on peut annuler, rien de perdu, un site qu’on peut parcourir au clavier.
- QualitéChaque garantie se prouve là où elle s’applique : sur une vraie base Postgres, avec des tests qui lisent le code, avec une chaîne d’empreintes que la veille recalcule, et avec une porte qui vérifie chaque commit avant la prod.
- MesuresCe que le projet mesure en performance, Core Web Vitals, tests, fiabilité, qualité et maintenabilité : les chiffres comptés au build, les seuils qui font échouer un script, les relevés datés, et un protocole reproductible pour ce qui n’est pas encore mesuré.