Skip to content
iprospectivePublic

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

269 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AtomBox — le dépôt

Un moteur de stockage d'emails, son API, et le webmail qui les consomme. Démo (session simulée, données inventées) : https://atombox.dev.iprospective.fr/ — se connecter avec poc / poc.

Le webmail AtomBox en session simulée : liste, message ouvert avec ses tags et son fil, et la trace des gestes qui montre la cascade d'API derrière chaque clic

À droite, la trace des gestes : pour chaque clic, la cascade complète — appel d'API, route, contrôleur, service, requêtes, magasin d'octets, JSON renvoyé. C'est elle le livrable du POC, plus que les écrans : elle décrit ce qu'il faudra écrire, et fixe le contrat d'API.

Un seul dépôt pour le produit (D156) :

Dossier Contenu
webmail/ l'interface — un seul index.html (D157) ; src/noyau, src/modules/<nom>/ (vue, contrôleur, service, style SCSS), src/poc ; css/app.css compilé par npm run css — D141, D160
serveur/ le serveur, en Python (D154) : schéma, magasin d'octets, démon d'ingestion, moteur de filtres, API, page d'état — découpé par fonctionnalité de V0
outils/ ce qui sert aux deux : gen-dict.py (le chapitre 16 depuis dict/*.yml), gen-cdc-index.py (l'index du CDC lisible dans le webmail), gen-schema.py (le DDL PostgreSQL depuis le dictionnaire), et le vérificateur de contrat à venir

Le cahier des charges et le dictionnaire des données ne sont pas ici : ils vivent dans le dépôt PM (.mmi-pm/docs, ticket RM2881). Le code les lit, il ne les possède pas.

python3 outils/gen-dict.py            # régénère le chapitre 16 du CDC
python3 outils/gen-cdc-index.py       # régénère webmail/src/poc/cdc-index.js
python3 outils/gen-schema.py          # régénère serveur/atombox/schema/schema.sql (F114) — rapport vide exigé
cd webmail && python3 outils/bundle.py && node test/smoke.js   # le POC (voir webmail/README.md)
bash webmail/outils/deploy.sh         # mise en ligne du webmail

Branches : main (protégée, un jalon à la fois), dev (intégration), une branche courte par fonctionnalité — v0/F114-schema, v0/F001-ingestion… — fusionnée dans dev par MR.

Ce qui empêche de casser

Barrière Où elle tourne Ce qu'elle refuse
.gitlab-ci.yml à chaque MR et sur dev/main une fusion dont la suite serveur (83 tests, PostgreSQL réel) ou les quatre harnais du webmail (494 assertions) sont rouges
outils/verifier-engendre.sh avant le push, sur le poste (hook pre-push) un schéma, des modèles ou un contrat d'API qui ne correspondent plus au dictionnaire — leur source vit dans le dépôt de données, absent de la CI
webmail/outils/deploy.sh à chaque déploiement une interface mise en ligne alors que l'API qui tourne est plus ancienne : elle proposerait des gestes que le serveur refuse

Poser le hook sur un poste neuf : bash outils/verifier-engendre.sh --installer.

Ces trois barrières ont la même règle : elles refusent, elles n'avertissent pas. Un contrôle qu'on peut ignorer n'est pas une barrière, c'est une opinion — et les fichiers engendrés ne portent plus d'horodatage, sans quoi le contrôle de fraîcheur crierait à chaque exécution et cesserait d'être lu.

Le cahier des charges — une source, plusieurs vues

Le CDC, le registre des décisions et le dictionnaire des données ne sont pas dans ce dépôt : ils vivent dans le dépôt de données du projet (.mmi-pm/docs, ticket RM2881), et ce dépôt les lit — outils/gen-cdc-index.py en tire webmail/src/poc/cdc-index.js, que la maquette affiche. Rien n'est recopié à la main : une décision s'écrit une fois, au registre.

Les mêmes pages, dans la maquette (barre du haut, en session poc/poc) :

Page Ce qu'elle montre Source
CDC les chapitres, le registre des décisions, les questions ouvertes docs/cdc-rm2881-*.md
Fonctionnalités les F… par domaine, leur état et leurs dépendances docs/dict/fonctionnalites.yml
Feuille de route les mêmes F…, par jalon, dans l'ordre de codage calculé la même donnée, triée
V0 ce que le premier jalon contient, et ce qu'il ne contient pas docs/dict/jalons.yml
Aide les décisions expliquées en langage d'utilisateur écrite pendant le CDC

La méthode qui produit tout ça est normalisée : norms/src/modules/cdc.md du système PM (gabarits templates/cdc/, outil pm-cdc.py).

Licence

GPL-3.0 — voir LICENSE.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages