Aller au contenu principal

Fichiers d'audit des lots de vérification du kit

Un fichier par lot, <lot>.yaml, propriété de ce seul lot. Ses entrées remplacent le mapping par défaut de tools/traceability/mapping_source.py pour les exigences qu'il liste. Format (version anglaise : README.md) :

requirements:
  FOUN-006:
    component: api-contracts
    state: existing            # existing | partial | absent | broken | blocked
    paths: [services/control-plane/src/eai/api_openapi.py]
    tests: [services/control-plane/tests/test_api_openapi.py::test_breaking_change_needs_a_major_bump]
    docs: [docs/api/control-plane-v1.md]
    migrations: []             # noms de fichiers sous sql/postgres, ou un chemin sous navin-manager/server/sql
    routes: ["GET /v1/telemetry/slo"]   # doit exister dans la surface d'API du Control Plane ou du Platform Manager
    ui: ["studio/policies"]
    evidence: [E-FL-API]       # jeux de preuves de evidence.yaml ou evidence.d/<lot>.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: "ce qui prouve le critère d'acceptation", en: "..."}
blockers:                      # facultatif, uniquement de nouveaux blocages transverses
  B-EXAMPLE: {title: {fr: ..., en: ...}, detail: {fr: ..., en: ...}, needed: {fr: ..., en: ...}, exit: {fr: ..., en: ...}}

Validation d'un fichier : services/control-plane/.venv/bin/python tools/traceability/mapping_source.py --validate docs/implementation/audit/&lt;lot&gt;.yaml docs/implementation/evidence.d/&lt;lot&gt;.yaml. Une exigence ne passe PASSED que lorsque tools/traceability/trace.py run enregistre une exécution verte de chaque jeu de preuves qu'elle cite, sans travail restant ni blocage.