Comprendre le rôle vital de Forgejo dans le métabolisme de l’Alliance

docs/architecture/Forgejo_dans_le_cycle_vivant.md

@@ -0,0 +1,134 @@
+# 🧱 Forgejo dans le cycle vivant boréal  
+**Version :** 1.0 (CRB-4)  
+**Statut :** Document explicatif interne  
+**Auteur :** Coordinateur Systémique (#13)  
+**Licence :** CC-BY-SA-4.0  
+
+---
+
+## 🌲 1. Rôle fondamental
+
+Forgejo est **le cœur métabolique** du système boréal.  
+Il héberge la matière vivante du projet :  
+- code source,  
+- documentation Markdown,  
+- schémas YAML,  
+- scripts d’automatisation,  
+- pipelines CI/CD,  
+- et artefacts déployables.
+
+> 🪶 Il ne sert pas seulement à stocker :  
+> **il transforme et régénère la connaissance** à chaque commit.
+
+---
+
+## ⚙️ 2. Position dans le modèle à 8 couches
+
+| Couche | Rôle | Interaction avec Forgejo |
+|:--:|:--|:--|
+| **C1** | Racines physiques | Fournit l’infrastructure matérielle d’hébergement (serveur Forgejo). |
+| **C2** | Réseau fédéré | Expose Forgejo via DNS sécurisé (`forge.alliance-boreale.ca`). |
+| **C3** | Gouvernance & conformité | Définit les règles de contribution, revue et labellisation. |
+| **C4** | 🔧 **Forge / Métabolisme** | **Forgejo agit ici** : création, versionnement, signature, CI/CD. |
+| **C5** | 🌉 **Pivot / Membrane** | **Forgejo agit aussi ici** : expose les artefacts par API HTTP sécurisée. |
+| **C6** | Services | Le site React consomme ces artefacts pour afficher les documents. |
+| **C7** | Expérience utilisateur | Interface de gouvernance (site de pilotage). |
+| **C8** | Conscience collective | Interprétation, discussion, réalignement par les membres. |
+
+---
+
+## 🧭 3. Dualité fonctionnelle : *Forge* et *Membrane*
+
+### A. **Forge (C4)**  
+> “Là où le savoir se condense.”
+
+- Lieu de production des artefacts : code, docs, configurations.  
+- Versionnement Git = **trace génétique** de chaque évolution.  
+- CI/CD = **processus métabolique** qui transforme le code en artefacts vivants.  
+- Signatures GPG = **anticorps de confiance** garantissant l’intégrité.
+
+### B. **Membrane (C5)**  
+> “Là où la connaissance circule.”
+
+- API REST Forgejo = passerelle sécurisée pour lecture des fichiers `.md` et `.yml`.  
+- Contrôle d’accès : tokens personnels, permissions fines.  
+- Permet à l’artefact React de lire en temps réel les documents du dépôt.  
+- Chaque GET devient un acte de transparence vérifiable (commit SHA affiché).
+
+---
+
+## 🧩 4. Schéma vivant des flux
+
+```
+
+╔══════════════════════════════════════════════════════╗
+║              ÉCOSYSTÈME BORÉAL - FLUX DOCUMENTAIRE   ║
+╚══════════════════════════════════════════════════════╝
+
+```
+    [ C8 ]  Conscience collective (membres, usagers)
+             │
+             ▼
+    [ C7 ]  Site React — interface de gouvernance
+             │   (lecture temps réel des .md)
+             ▼
+    [ C6 ]  Service documentaire (artefact vivant)
+             │
+             ▼
+    [ C5 ]  🌉 Forgejo (API REST — membrane)
+             │   (expose les fichiers .md/.yml en lecture)
+             ▼
+    [ C4 ]  🔧 Forgejo (forge interne)
+             │   (versionne, signe, CI/CD)
+             ▼
+    [ C3 ]  Gouvernance (validation, labellisation)
+             ▼
+    [ C2 ]  Réseau (DNS, SSL, accès sécurisé)
+             ▼
+    [ C1 ]  Infrastructure physique (serveur, VM, stockage)
+```
+
+```
+
+---
+
+## 🔐 5. Sécurité et intégrité
+
+- **Accès lecture :** via token Forgejo `read:repository`.  
+- **Accès écriture :** membres actifs uniquement (via CI ou pull request).  
+- **Intégrité :** chaque document affiché mentionne le `commit SHA` et l’auteur.  
+- **Traçabilité :** historique complet dans Git + ΔLog documentaire.
+
+---
+
+## 🧠 6. Vision cognitive
+
+> Forgejo est au système boréal ce que le **mycélium** est à la forêt :  
+> un réseau invisible, dense, interconnecté,  
+> qui transporte la mémoire et les nutriments d’un arbre à l’autre.
+
+Chaque push est une **croissance**,  
+chaque pull est une **respiration**,  
+chaque merge est une **symbiose**.
+
+---
+
+## 🌿 7. En résumé
+
+| Fonction | Couche | Action |
+|-----------|:--:|-----------|
+| Production et versionnement | C4 | Création d’artefacts, gestion des commits, CI/CD |
+| Diffusion et lecture | C5 | API REST, permissions, synchronisation documentaire |
+| Gouvernance | C3 | Validation éthique et technique des contributions |
+| Représentation visuelle | C6–C7 | Site React (pilotage, transparence) |
+
+---
+
+## 🪶 8. Signature boréale
+
+> *Forgejo forge, la membrane respire,  
+> et le savoir circule — sans jamais quitter la forêt.*
+
+📁 **Fichier source :** `/docs/architecture/Forgejo_dans_le_cycle_vivant.md`  
+👤 **Auteur :** Coordinateur Systémique (#13)  
+🕊️ **Validé par :** Cercle Opérationnel et Cercle Éthique (CRB-4)