diff --git a/docs/README.md b/docs/README.md new file mode 100644 index 0000000..68ab311 --- /dev/null +++ b/docs/README.md @@ -0,0 +1,83 @@ +# Documentation Life-NOC + +Cette arborescence constitue le **point d’entrée documentaire** du dépôt. + +## Règles de lecture + +- **Un sujet = un document canonique** +- les documents sous `docs/archive/` sont **historiques** et **non normatifs** +- `domains.yaml` demeure la **source de vérité opérationnelle** du système +- la documentation explique, cadre et guide ; elle ne remplace pas la configuration active + +## Structure + +### `docs/vision/` +Cadre conceptuel et formulations de référence. + +- `vision/vision-fondatrice.md` — définition, finalité et nature de Life-NOC +- `vision/devise-et-formulations.md` — devise, formulations de positionnement et langage de référence + +### `docs/architecture/` +Choix structurants et fonctionnement d’ensemble. + +- `architecture/architecture-life-noc.md` — architecture complète et articulation des composants +- `architecture/decisions-techniques.md` — décisions de principe et choix techniques retenus + +### `docs/modeles/` +Modèles canoniques utilisés par le système. + +- `modeles/probe-model-v1.md` — modèle canonique des sondes +- `modeles/inputs-store-model-v1.md` — modèle de stockage des intrants vivants + +### `docs/guides/` +Guides pratiques pour installer, exploiter et utiliser Life-NOC. + +- `guides/deploiement-from-scratch.md` — déploiement depuis Debian 12 vanille +- `guides/exploitation-life-noc.md` — exploitation, vérifications et dépannage +- `guides/guide-usager-life-noc.md` — usage courant côté utilisateur + +### `docs/roadmap/` +Évolution planifiée du système. + +- `roadmap/plan-demockage-life-noc.md` — trajectoire de démockage et de pages item canoniques + +### `docs/validation/` +Constats validés sur le terrain. + +- `validation/preuve-de-reproductibilite.md` — résultats réellement reproduits + +### `docs/archive/` +Documents anciens, fusionnés ou remplacés. + +Ne pas les utiliser comme références actives. + +## Ordre de lecture conseillé + +### Pour comprendre rapidement le projet + +1. `vision/vision-fondatrice.md` +2. `architecture/architecture-life-noc.md` +3. `architecture/decisions-techniques.md` +4. `modeles/probe-model-v1.md` + +### Pour déployer + +1. `guides/deploiement-from-scratch.md` +2. `validation/preuve-de-reproductibilite.md` +3. `guides/exploitation-life-noc.md` + +### Pour faire évoluer le système + +1. `modeles/probe-model-v1.md` +2. `modeles/inputs-store-model-v1.md` +3. `roadmap/plan-demockage-life-noc.md` + +## Politique documentaire + +Lorsqu’un document devient redondant, trop partiel ou remplacé par une version canonique plus complète : + +- il quitte l’arborescence active +- il passe dans `docs/archive/` +- un statut explicite d’archivage lui est ajouté + +L’objectif est de garder une documentation **lisible, non contradictoire et sans doublons actifs**. diff --git a/docs/architecture-life-noc.md b/docs/architecture/architecture-life-noc.md similarity index 100% rename from docs/architecture-life-noc.md rename to docs/architecture/architecture-life-noc.md diff --git a/docs/decisions-techniques.md b/docs/architecture/decisions-techniques.md similarity index 100% rename from docs/decisions-techniques.md rename to docs/architecture/decisions-techniques.md diff --git a/docs/archive/README.md b/docs/archive/README.md new file mode 100644 index 0000000..a7bdd93 --- /dev/null +++ b/docs/archive/README.md @@ -0,0 +1,7 @@ +# Archive documentaire + +Ce répertoire contient des documents conservés pour mémoire historique. + +Ils peuvent être utiles pour retracer l’évolution du projet, mais ils ne doivent plus être utilisés comme références actives. + +Pour les documents canoniques, revenir à `docs/README.md`. diff --git a/docs/architecture.md b/docs/archive/architecture.md similarity index 91% rename from docs/architecture.md rename to docs/archive/architecture.md index 8e36a6c..c3b0c3e 100644 --- a/docs/architecture.md +++ b/docs/archive/architecture.md @@ -1,3 +1,11 @@ +# STATUT : ARCHIVÉ + +Ce document n’est plus une référence active. Version courte remplacée par `docs/architecture/architecture-life-noc.md`. + +Ne pas l’utiliser comme source canonique. + +--- + # Architecture ## Vue d'ensemble diff --git a/docs/concept.md b/docs/archive/concept.md similarity index 85% rename from docs/concept.md rename to docs/archive/concept.md index 5a557f0..49f110f 100644 --- a/docs/concept.md +++ b/docs/archive/concept.md @@ -1,3 +1,11 @@ +# STATUT : ARCHIVÉ + +Ce document n’est plus une référence active. Version courte remplacée par `docs/vision/vision-fondatrice.md` et `docs/architecture/architecture-life-noc.md`. + +Ne pas l’utiliser comme source canonique. + +--- + # Concept Life-NOC Life-NOC transpose la logique d'un NOC à la vie réelle. diff --git a/docs/life-noc-sondes-et-intrants-v1.md b/docs/archive/life-noc-sondes-et-intrants-v1.md similarity index 98% rename from docs/life-noc-sondes-et-intrants-v1.md rename to docs/archive/life-noc-sondes-et-intrants-v1.md index 3e2de95..93d259d 100644 --- a/docs/life-noc-sondes-et-intrants-v1.md +++ b/docs/archive/life-noc-sondes-et-intrants-v1.md @@ -1,3 +1,11 @@ +# STATUT : ARCHIVÉ + +Ce document n’est plus une référence active. Document fusionné puis remplacé par `docs/modeles/probe-model-v1.md` et `docs/modeles/inputs-store-model-v1.md`. + +Ne pas l’utiliser comme source canonique. + +--- + # Life-NOC — Modèle des sondes et des intrants v1 ## 1. Objet diff --git a/docs/life_noc_documentation_pack.md b/docs/archive/life_noc_documentation_pack.md similarity index 98% rename from docs/life_noc_documentation_pack.md rename to docs/archive/life_noc_documentation_pack.md index a54e521..b21b7d9 100644 --- a/docs/life_noc_documentation_pack.md +++ b/docs/archive/life_noc_documentation_pack.md @@ -1,3 +1,11 @@ +# STATUT : ARCHIVÉ + +Ce document n’est plus une référence active. Compilation redondante remplacée par l’index structuré `docs/README.md` et les documents canoniques par thème. + +Ne pas l’utiliser comme source canonique. + +--- + # Life-NOC — Documentation complète ## 1. Présentation générale diff --git a/docs/positionnement.md b/docs/archive/positionnement.md similarity index 91% rename from docs/positionnement.md rename to docs/archive/positionnement.md index 09af021..da426c9 100644 --- a/docs/positionnement.md +++ b/docs/archive/positionnement.md @@ -1,3 +1,11 @@ +# STATUT : ARCHIVÉ + +Ce document n’est plus une référence active. Doublon exact de `docs/vision/vision-fondatrice.md`. + +Ne pas l’utiliser comme source canonique. + +--- + # Vision fondatrice — Life-NOC ## Définition diff --git a/docs/archive/rituel_matinal.md b/docs/archive/rituel_matinal.md new file mode 100644 index 0000000..1a9865f --- /dev/null +++ b/docs/archive/rituel_matinal.md @@ -0,0 +1,8 @@ +# STATUT : ARCHIVÉ + +Ce document n’est plus une référence active. Fichier vide conservé uniquement à titre historique. + +Ne pas l’utiliser comme source canonique. + +--- + diff --git a/docs/deploiement-from-scratch.md b/docs/guides/deploiement-from-scratch.md similarity index 100% rename from docs/deploiement-from-scratch.md rename to docs/guides/deploiement-from-scratch.md diff --git a/docs/exploitation-life-noc.md b/docs/guides/exploitation-life-noc.md similarity index 100% rename from docs/exploitation-life-noc.md rename to docs/guides/exploitation-life-noc.md diff --git a/docs/guide-usager-life-noc.md b/docs/guides/guide-usager-life-noc.md similarity index 100% rename from docs/guide-usager-life-noc.md rename to docs/guides/guide-usager-life-noc.md diff --git a/docs/inputs-store-model-v1.md b/docs/modeles/inputs-store-model-v1.md similarity index 100% rename from docs/inputs-store-model-v1.md rename to docs/modeles/inputs-store-model-v1.md diff --git a/docs/probe-model-v1.md b/docs/modeles/probe-model-v1.md similarity index 100% rename from docs/probe-model-v1.md rename to docs/modeles/probe-model-v1.md diff --git a/docs/rituel_matinal.md b/docs/rituel_matinal.md deleted file mode 100644 index e69de29..0000000 diff --git a/docs/plan-demockage-life-noc.md b/docs/roadmap/plan-demockage-life-noc.md similarity index 100% rename from docs/plan-demockage-life-noc.md rename to docs/roadmap/plan-demockage-life-noc.md diff --git a/docs/preuve-de-reproductibilite.md b/docs/validation/preuve-de-reproductibilite.md similarity index 100% rename from docs/preuve-de-reproductibilite.md rename to docs/validation/preuve-de-reproductibilite.md diff --git a/docs/devise-et-formulations.md b/docs/vision/devise-et-formulations.md similarity index 100% rename from docs/devise-et-formulations.md rename to docs/vision/devise-et-formulations.md diff --git a/docs/vision-fondatrice.md b/docs/vision/vision-fondatrice.md similarity index 100% rename from docs/vision-fondatrice.md rename to docs/vision/vision-fondatrice.md