docs: réaligne la documentation sur l'état livré au gel
Trois environnements et un frontal SNI au lieu de deux, certificats Let's Encrypt par DNS-01, sept DAGs, index des ADR complété jusqu'à 0020. Les exemples de l'ETL passent en bash et n'utilisent plus l'option --limit, retirée. L'adresse de la machine est masquée dans l'arbre, les ADR 0009 et 0014 portent une note datée sur l'approbation de la production.
This commit is contained in:
@@ -17,13 +17,16 @@ contredisent, c'est l'ADR qui fait foi et la vue qui est en retard.
|
||||
| [40-data.md](40-data.md) | Frontières `db/` et `alembic/`, cycle de vie d'une mesure, modèle |
|
||||
| [50-cicd.md](50-cicd.md) | Orchestrateur `ci.yml`, gates bloquantes, e2e et charge, SonarCloud, Dependabot, ce qui manque |
|
||||
| [60-observabilite.md](60-observabilite.md) | Métriques, Prometheus, alertes, tableaux de bord Grafana, ce qui manque |
|
||||
| [70-pilotage.md](70-pilotage.md) | Runbook de pilotage des traitements automatisés : entraîner, lire la dérive, rejouer un DAG, rétention |
|
||||
| [owasp-traceabilite.md](owasp-traceabilite.md) | Traçabilité OWASP Top 10 et API Top 10 : couvert, partiel, ouvert |
|
||||
|
||||
La CI/CD a son document : un orchestrateur et ses workflows de composant, c'est assez de
|
||||
matière pour qu'une section de plus dans une autre vue devienne illisible. L'observabilité a le
|
||||
sien depuis l'issue #26, qui lui a donné de la matière : collecte, alertes et tableaux de bord.
|
||||
|
||||
L'orchestration Airflow, elle, en a depuis les issues #115 et #116 : trois DAGs, leur image et
|
||||
leurs contraintes sont décrits dans [10-infra.md](10-infra.md).
|
||||
L'orchestration Airflow, elle, en a depuis les issues #115 et #116 : les sept DAGs, leur image et
|
||||
leurs contraintes sont décrits dans [10-infra.md](10-infra.md), leur pilotage au quotidien dans
|
||||
[70-pilotage.md](70-pilotage.md).
|
||||
|
||||
La sécurité applicative, elle, a désormais de la matière : la vue consolidée reste dans
|
||||
[00-vue-ensemble.md](00-vue-ensemble.md), le détail dans [20-backend.md](20-backend.md), la
|
||||
@@ -38,6 +41,11 @@ GitHub rend Mermaid nativement dans les fichiers `.md`. Un diagramme est donc du
|
||||
relit en revue, il se diffe, et il ne se périme pas dans un binaire que plus personne ne sait
|
||||
rouvrir six mois plus tard. Aucune image exportée, aucun `.drawio`, aucun `.png`.
|
||||
|
||||
Une exception existe, et elle est connue : le schéma de données de
|
||||
[40-data.md](40-data.md) est une image, `images/EnerVision-schema-donnees.png`, versionnée le 15/09,
|
||||
quelques heures après l'adoption de la règle, sans que la revue le relève. Elle se relit à côté de la description des tables qui la suit,
|
||||
qui fait foi ; la migrer en Mermaid reste à faire.
|
||||
|
||||
### Chaque section porte son statut
|
||||
|
||||
Une large part de la stack n'est pas écrite. Une vue qui mélange l'existant et la cible sans le
|
||||
|
||||
Reference in New Issue
Block a user