Update :)

40_decisions_et_archi.md

@@ -331,16 +331,32 @@ La structure standard suivante est adoptée sur les machines d’infrastructure
 
 ```
 /srv
+├ helpers
+├ infra
 ├ projects
+├ shared
 ├ docker-data
 └ backups
 ```
 
 Principes :
 
+- `/srv/helpers`
+  contient les dépôts, scripts et bases de connaissance transverses utilisés
+  par plusieurs projets ou par les agents (ex : `_Assistant_Lead_Tech`).
+
+- `/srv/infra`
+  contient les éléments d’infrastructure mutualisés ou transverses à la machine
+  (reverse proxy, stacks techniques partagées, supervision, administration).
+
 - `/srv/projects`
   contient les projets applicatifs (code, `docker-compose.yml`, `.env`, scripts).
 
+- `/srv/shared`
+  contient les ressources partagées entre plusieurs projets quand elles ne
+  relèvent ni du code d’un projet donné ni d’une donnée Docker persistante
+  d’un seul service.
+
 - `/srv/docker-data`
   contient les données persistantes des conteneurs (bases de données, uploads,
   état applicatif).
@@ -351,6 +367,8 @@ Principes :
 ### Justification
 
 - séparation claire **code / données / sauvegardes**
+- séparation explicite entre **projets applicatifs**, **outillage transverse**,
+  **infrastructure mutualisée** et **ressources partagées**
 - sauvegardes plus simples et plus fiables
 - nettoyage d’un projet possible sans risque pour les autres
 - lisibilité immédiate de l’infrastructure
@@ -370,10 +388,22 @@ lisibilité et la maintenabilité priment.
 Les données critiques à sauvegarder se trouvent principalement dans :
 
 ```
+/srv/helpers
+/srv/infra
 /srv/projects
+/srv/shared
 /srv/docker-data
 ```
 
+Règle de placement :
+
+- si c’est le code ou la config d’une application donnée : `/srv/projects/<nom>`
+- si c’est de la donnée persistante d’un conteneur : `/srv/docker-data/<nom>/...`
+- si c’est un backup ou un export destiné à la restauration : `/srv/backups/<nom>/...`
+- si c’est un outil, script ou référentiel transverse : `/srv/helpers/...`
+- si c’est une stack ou une configuration infra mutualisée : `/srv/infra/...`
+- si c’est une ressource commune à plusieurs projets, hors données Docker : `/srv/shared/...`
+
 Convention de nommage recommandée pour les dossiers de données :
 
 ```