docs: exigences collectives du groupe, version 1.0

lenaic commented

2026-09-01 09:08:38 +00:00

Owner

Ce que ça change

Première version des exigences collectives, issues de la réunion du 31 août,
des arbitrages du Tech Lead et des huit points tranchés le 1er septembre.

Jusqu'ici chacun avait ses exigences dans son dossier EC01 individuel, et elles
divergeaient. Ce document en fait une liste unique pour ce que nous construisons
ensemble : douze EF inchangées, seize ENF révisées.

À relire et à amender. C'est une proposition, pas une décision imposée.

Ce qui a été tranché le 1er septembre

Sujet	Décision
Entraînement du modèle	En local, sur le Tesla T4 du serveur
Front	Vue en monopage + mandataire FastAPI qui détient le jeton
Stockage	Médaillon complet, zone or matérialisée dans PostgreSQL
Keycloak	Schéma dédié dans l'instance PostgreSQL existante
Déploiement	Ansible, avec un compte `deploy` dédié
Port 443	Deux noms d'hôte sur le même Caddy, `forge.` et `app.`
Multi-client	Un seul, point d'extension identifié
Secrets	Magasin de secrets de Forgejo

Le point le plus important

L'abonnement Azure de l'école est limité et ne donne pas accès à Entra ID.
Le besoin cloud est donc servi par un plan de migration chiffré et une analyse
de coût, plutôt que par un déploiement complet. C'est un choix assumé, et il
faut qu'on le défende de la même façon aux six entretiens du J10.

Conséquence directe : l'identité applicative Entra ID prévue dans certains
dossiers individuels disparaît.

Preuve

$ wc -l docs/EXIGENCES-collectives.md
156 docs/EXIGENCES-collectives.md
$ grep -c '^| EF-' docs/EXIGENCES-collectives.md
12
$ grep -c '^| ENF-' docs/EXIGENCES-collectives.md
16

Relecture

Un pair a relu et laissé un commentaire, même court
Ses remarques sont traitées, ou une réponse explique pourquoi non

Ce qui suit le code

.claude/skills/ticket/references/exigences.md régénéré depuis ce document

Où regarder en priorité

La section 5, les sept écarts avec les dossiers individuels. Chacun doit
devenir une révision d'ADR dans le dossier de son auteur. Le plus lourd est le
médaillon : mon ADR-02 v2 chiffrait le gain de sa suppression à 4 jours-homme,
et la décision collective le rétablit. La zone or matérialisée en base est la
compensation, il faut que ce soit écrit quelque part.

La section 6, ce qui reste à trancher, notamment la répartition des
livrables du J10 et la règle de relecture.

## Ce que ça change Première version des exigences **collectives**, issues de la réunion du 31 août, des arbitrages du Tech Lead et des huit points tranchés le 1er septembre. Jusqu'ici chacun avait ses exigences dans son dossier EC01 individuel, et elles divergeaient. Ce document en fait une liste unique pour ce que nous construisons ensemble : douze EF inchangées, seize ENF révisées. **À relire et à amender.** C'est une proposition, pas une décision imposée. ## Ce qui a été tranché le 1er septembre | Sujet | Décision | |---|---| | Entraînement du modèle | **En local**, sur le Tesla T4 du serveur | | Front | Vue en monopage + mandataire FastAPI qui détient le jeton | | Stockage | Médaillon complet, zone or matérialisée dans PostgreSQL | | Keycloak | Schéma dédié dans l'instance PostgreSQL existante | | Déploiement | Ansible, avec un compte `deploy` dédié | | Port 443 | Deux noms d'hôte sur le même Caddy, `forge.` et `app.` | | Multi-client | Un seul, point d'extension identifié | | Secrets | Magasin de secrets de Forgejo | ## Le point le plus important **L'abonnement Azure de l'école est limité et ne donne pas accès à Entra ID.** Le besoin cloud est donc servi par un plan de migration chiffré et une analyse de coût, plutôt que par un déploiement complet. C'est un choix assumé, et il faut qu'on le défende de la même façon aux six entretiens du J10. Conséquence directe : l'identité applicative Entra ID prévue dans certains dossiers individuels disparaît. ## Preuve ``` $ wc -l docs/EXIGENCES-collectives.md 156 docs/EXIGENCES-collectives.md $ grep -c '^| EF-' docs/EXIGENCES-collectives.md 12 $ grep -c '^| ENF-' docs/EXIGENCES-collectives.md 16 ``` ## Relecture - [ ] Un pair a relu et laissé un commentaire, même court - [ ] Ses remarques sont traitées, ou une réponse explique pourquoi non ## Ce qui suit le code - [x] `.claude/skills/ticket/references/exigences.md` régénéré depuis ce document ## Où regarder en priorité **La section 5**, les sept écarts avec les dossiers individuels. Chacun doit devenir une révision d'ADR dans le dossier de son auteur. Le plus lourd est le médaillon : mon ADR-02 v2 chiffrait le gain de sa suppression à 4 jours-homme, et la décision collective le rétablit. La zone or matérialisée en base est la compensation, il faut que ce soit écrit quelque part. **La section 6**, ce qui reste à trancher, notamment la répartition des livrables du J10 et la règle de relecture.

lenaic added 1 commit

2026-09-01 09:08:38 +00:00

docs: exigences collectives du groupe, version 1.0

Intégration / Qualité du code Python (pull_request) Successful in 3s

Details

Intégration / Tests unitaires (pull_request) Successful in 3s

Details

Intégration / Aucun secret commité (pull_request) Successful in 3s

Details

94738ad813

Issues de la reunion d'architecture du 31 aout, des arbitrages du Tech Lead et
des questions tranchees le 1er septembre. Remplacent les exigences des six
dossiers EC01 individuels pour ce que le groupe construit.

Douze EF inchangees : aucune decision d'architecture ne modifie un comportement
produit. Seize ENF revisees, dont quatre nouvelles, autorisation par ressource,
cloisonnement par adresse d'ecoute, attribution nominative et secrets.

Sept ecarts avec les dossiers individuels sont listes pour etre traces comme des
revisions, la qualite des revues de conception etant un critere note.

Points tranches le 1er septembre : entrainement du modele en local sur le T4 du
serveur, Vue plus mandataire FastAPI, medaillon complet avec zone or
materialisee, Keycloak en schema dedie, deploiement par Ansible, deux noms
d'hote sur le meme Caddy, un seul client, secrets dans le magasin Forgejo.

L'abonnement Azure de l'ecole est limite et sans Entra ID : le besoin cloud est
servi par un plan de migration chiffre plutot que par un deploiement complet.

lenaic added 1 commit

2026-09-01 09:37:03 +00:00

docs: exigences collectives v1.1, architecture cible et plan de charge

Intégration / Qualité du code Python (pull_request) Successful in 3s

Details

Intégration / Tests unitaires (pull_request) Successful in 3s

Details

Intégration / Aucun secret commité (pull_request) Successful in 3s

Details

d3c6dfc605

Ajoute quatre sections au document collectif.

Architecture cible : dix composants avec leur port d'ecoute et leur pilote, le
chemin de la donnee de bronze a la zone or materialisee, et le chemin de
l'authentification par le mandataire FastAPI.

Plan d'adressage : treize ports, dont ceux de MinIO qui manquaient. Tant que le
LXC interdit les reseaux Docker, la colonne exposee est la seule frontiere de
securite du serveur.

Repartition et croisements : qui construit quoi, et qui devra en parler a son
entretien individuel, ce qui n'est pas la meme chose. Un croisement se prouve
par un commit, pas par une intention.

Plan de charge recalcule sur l'architecture collective : 46 jours-homme estimes
pour 31 de capacite utile, soit un deficit de 15 contre 4 dans les dossiers
individuels. L'ecart vient des ajouts collectifs, MinIO, medaillon, Keycloak et
Ansible pesant 11 a eux seuls. Trois reductions sont proposees, elles ne
comblent que 5 jours-homme. Le reste est a arbitrer en equipe.

lenaic changed target branch from main to develop

2026-09-01 11:19:37 +00:00

lenaic commented

2026-09-01 11:19:43 +00:00

Author

Owner

Fusionnée sans relecture, faute de relecteur en 24 heures. C'est une exception, annoncée au point du soir. L'approbation devient obligatoire juste après cette fusion.

lenaic merged commit 346a56827f into develop

2026-09-01 11:31:29 +00:00

lenaic referenced this pull request from a commit

2026-09-01 11:31:30 +00:00

Merge pull request 'docs: exigences collectives du groupe, version 1.0' (#22) from lenaic/0-exigences-collectives into develop

lenaic referenced this pull request

2026-09-01 11:32:08 +00:00

docs: fixe le flux de branches et rend la relecture obligatoire #49