Hygiène du dépôt
Le contrôle de version de DispatchAtlas contient de la source, des tests, de la configuration, de la documentation, et des métadonnées reproductibles rédigés à la main. Les produits d'exécution locale restent hors de Git à moins qu'une politique ne les promeuve explicitement en source.
🧹 Politique de sortie générée
Les données d'expérience générées, points de contrôle, lots de résultats, rapports de couverture, sortie de compilation des docs, artefacts de paquet, et candidats de publication sont ignorés par défaut. Ils sont régénérés depuis la source et consignés via la provenance lorsque des gates ultérieurs les promeuvent.
Les fichiers générés suivis nécessitent :
- Un propriétaire de source.
- Une commande de régénération.
- Une justification de rétention.
- Un chemin de révision pour la sortie obsolète.
🗃️ Politique de cache
Les caches locaux de Python, Ruff, mypy, pytest, couverture, compilations de documentation, et environnements virtuels sont ignorés. CI peut mettre en cache les dépendances, mais les clés de cache doivent dériver des lockfiles et des entrées de workflow.
🔬 Politique de sortie d'expérience locale
Les exécutions d'expérience locale écrivent dans les couches de sortie ignorées de
l'espace de travail des expériences — résultats d'exécution, journaux, points de
contrôle, et lots de preuves, tels qu'agencés dans le README de l'espace de travail
lui-même — aux côtés d'autres emplacements de scratch ignorés comme outputs/ ou
artifacts/. La preuve de recherche finale est produite via des commandes validées de
campagne et d'analyse avant tout usage public.
📋 Règles de rétention des artefacts
| Classe d'artefact | Emplacement par défaut | Statut Git | Rétention |
|---|---|---|---|
| Compilations de paquet | dist/ | Ignoré | Recompiler à la demande. |
| Compilation des docs | site/out/ | Ignoré | Recompiler à la demande. |
| Couverture | htmlcov/, .coverage* | Ignoré | Recompiler durant les vérifications de qualité. |
| Sorties de test | outputs/ | Ignoré | Conserver localement uniquement lors du débogage. |
| Résultats de campagne | les couches de résultats et de points de contrôle de l'espace de travail des expériences | Ignoré | Promouvoir uniquement via des exports à gate de provenance. |
| Preuve de publication | artifacts/ | Ignoré jusqu'à approbation | Conserver selon la politique de candidat de publication. |