Cartographie technique
Cartographie principale et matrice : structure, modules, flux, tests, limites
Le projet StrateFluxDistr est cartographié en deux documents complémentaires : une cartographie principale qui décrit l'état du livrable, et une matrice qui présente les relations entre les composants sous forme tabulaire.
Ces deux documents sont mis à jour à chaque palier d'évolution et servent de référence d'audit.
Cartographie principale
La cartographie principale couvre seize sections :
- Vue d'ensemble du projet et état des composants.
- Structure physique du livrable.
- Contrat externe gRPC.
- Couche core : modules canoniques, identifiants, payloads D13-D16, validation, store, sécurité.
- Couche proto : types générés et conversions.
- Couche transport gRPC : modules et façades.
- Payloads structurels et résolution typée.
- Stores : InMemoryStore et PersistentStore.
- Pipeline serveur en 18 étapes.
- Handlers métier des sept opérations.
- Trace protocolaire et inscription du Lease/Flow serveur.
- Contract lookup et validation contractuelle.
- Documents de trace numérotés 01, 02, 03.
- Couverture de tests : suite étendue, tests unitaires et tests d'intégration end-to-end.
- Limites V0 résiduelles.
- Synthèse de l'état du livrable.
Matrice technique
La matrice présente seize sections tabulaires :
- Index opérationnel.
- Graphe des dépendances entre composants.
- Matrice globale des composants.
- Matrice core : valeurs, modèles, D13-D16, store.
- Matrice proto.
- Matrice transport : modules, pipeline.
- Matrice handlers RPC.
- Matrice stores et formats.
- Matrice sécurité et gouvernance.
- Matrice tests.
- Matrice scénarios end-to-end.
- Matrice documents.
- Commandes de contrôle.
- Journal de synchronisation cartographie.
Usage de la cartographie
La cartographie sert trois usages distincts :
Audit interne. Vérifier que le code source est conforme à ce qui est documenté, et que les invariants de gouvernance sont préservés à chaque palier.
Découverte externe. Permettre à un nouveau lecteur de naviguer rapidement dans la structure du projet sans avoir à explorer le code à l'aveugle.
Trace de gouvernance. Servir de point de référence pour les documents de modélisation, feuille de route et contrôle. Toute évolution du livrable qui n'est pas reflétée dans la cartographie fait l'objet d'un signal d'alarme.