Aller au contenu principal

Fichiers de lot de conformité

L'architecture produit de référence fournie par le client (partie A : sections 1 à 6, partie B : sections 3 à 19) est vérifiée élément par élément. tools/traceability/conformance.py liste chaque section, son nombre minimal d'éléments et le lot qui en a la charge. Chaque lot possède ici un fichier <lot>.yaml (version anglaise : README.md) :

---
lot: C01
title: {fr: "...", en: "..."}
items:
ARCH-A3.2-01: # ARCH, la section, le rang de l'élément dans la section
item: {fr: "Discovery : ...", en: "Discovery: ..."}
state: existing # existing | partial | absent | broken | blocked
requirements: [MANA-003] # lignes liées de la matrice du kit, facultatif
paths: [navin-manager/server/src/navin_manager/services/planner.py]
tests: [navin-manager/server/tests/test_services_operate.py::test_restart_is_audited]
docs: [navin-manager/docs/en/operations.md]
routes: ["POST /api/v1/services/{id}/operations"]
evidence: [E-PO-OPERATIONS] # jeux de docs/implementation/evidence.yaml ou evidence.d/*.yaml
residual: {fr: "...", en: "..."} # seulement tant qu'il reste du travail
blocked: {fr: "... [B-CLUSTER]", en: "... [B-CLUSTER]"} # seulement pour une ressource manquante ou une décision du client
notes: {fr: "...", en: "..."}
blockers: {} # facultatif : nouveaux blocages transverses, titre, détail, besoin en fr et en

Chaque test cité doit exister et être exécuté par l'un des jeux de preuves que l'élément cite. Validation d'un fichier : services/control-plane/.venv/bin/python tools/traceability/conformance.py --validate docs/implementation/conformance/&lt;lot&gt;.yaml. Un élément ne passe PASSED que lorsque tools/traceability/trace.py run enregistre une exécution verte de chaque jeu de preuves cité, sans travail restant ni blocage. Le résultat est docs/implementation/ARCHITECTURE_CONFORMANCE.md (français) et docs/implementation/en/ARCHITECTURE_CONFORMANCE.md (anglais).