docs(ops): add triple-source sync + troubleshooting + proposer spec

.env

@@ -0,0 +1,3 @@
+PUBLIC_GITEA_BASE=https://gitea.archicratie.trans-hands.synology.me
+PUBLIC_GITEA_OWNER=Archicratia
+PUBLIC_GITEA_REPO=archicratie-edition

.env.development

@@ -0,0 +1,4 @@
+PUBLIC_GITEA_BASE=https://gitea.archicratie.trans-hands.synology.me
+PUBLIC_GITEA_OWNER=Archicratia
+PUBLIC_GITEA_REPO=archicratie-edition
+PUBLIC_SITE=https://archicratie.trans-hands.synology.me

.env.local

@@ -0,0 +1,5 @@
+FORGE_API=http://192.168.1.20:3000
+FORGE_BASE=https://gitea.archicratie.trans-hands.synology.me
+FORGE_TOKEN=aW73wpfJ4MiN2!3UU69qL*vWF9$9V7f@2
+PUBLIC_GITEA_OWNER=Archicratia
+PUBLIC_GITEA_REPO=archicratie-edition

.env.production

@@ -0,0 +1,6 @@
+PUBLIC_SITE=https://archicratie.trans-hands.synology.me
+PUBLIC_RELEASE=0.1.0
+
+PUBLIC_GITEA_BASE=https://gitea.archicratie.trans-hands.synology.me
+PUBLIC_GITEA_OWNER=Archicratia
+PUBLIC_GITEA_REPO=archicratie-edition

docs/DEPLOY_PROD_SYNOLOGY_DS220.md

@@ -1,15 +1,5 @@
 # Déploiement production (Synology DS220+ / DSM 7.3) — Astro → Nginx statique
 
-> ✅ **CANONIQUE** — Procédure de référence “prod DS220+ / DSM 7.3”.
-
-> Toute modif de déploiement doit être faite **ici**, via PR sur Gitea/main (pas d’édition à la main en prod).
-
-> Périmètre : build Docker (Node→Nginx), blue/green 8081/8082, Reverse Proxy DSM, smoke, rollback.
-
-> Dépendances critiques : variables PUBLIC_GITEA_* (sinon “Proposer” part en 404/login loop).
-
-> Voir aussi : OPS-REFERENCE.md (index), OPS_COCKPIT.md (checklist), TROUBLESHOOTING.md (incidents).
-
 Dernière mise à jour : 2026-02-01
 
 Ce document décrit une mise en place stable sur NAS :

docs/OPS-DEPLOYMENT.md

@@ -1,16 +1,6 @@
-# OPS — Déploiement Archicratie Web Edition (Mac Studio → DS220+)
+OPS — Déploiement Archicratie Web Edition (Mac Studio → DS220+)
 Objectif : déployer une nouvelle version du site sur le NAS (DS220+) sans jamais casser la prod, en utilisant un schéma blue/green piloté par DSM Reverse Proxy, avec une procédure robuste même quand docker compose build est instable sur le NAS.
 
-> 🟧 **LEGACY / HISTORIQUE** — Ce document n’est plus la source de vérité.
-
-> Référence actuelle : docs/DEPLOY_PROD_SYNOLOGY_DS220.md (canonique).
-
-> Statut : gelé (on n’édite plus que pour ajouter un lien vers le canonique, si nécessaire).
-
-> Raison : doublon → risque de divergence → risque d’erreur en prod.
-
-> Si tu lis ceci pour déployer : stop → ouvre le canonique.
-
 ## 0) Repères essentiels
 Noms & domaines
     • Site public (prod) : https://archicratie.trans-hands.synology.me

docs/OPS-RUNBOOK-ARCHICRATIE-WEB.md

@@ -1,15 +1,5 @@
 # OPS Runbook — Archicratie Web (NAS Synology DS220 + Gitea)
 
-> 🟦 **ALIAS (résumé)** — Runbook 1-page pour opérer vite sans se tromper.
-
-> La procédure détaillée **canonique** est : docs/DEPLOY_PROD_SYNOLOGY_DS220.md.
-
-> Source Git : Gitea/main ; déploiement = rebuild depuis main ; pas de hotfix non versionné.
-
-> Déploiement : build sur slot inactif → smoke → bascule DSM → rollback si besoin.
-
-> Incidents connus : voir docs/TROUBLESHOOTING.md.
-
 ## 0. Objectif
 Ce document décrit la procédure **exacte** pour :
 - maintenir un état cohérent entre **Local (Mac Studio)**, **Gitea**, **NAS (prod)** ;

docs/OPS-SYNC-TRIPLE-SOURCE.md

@@ -71,7 +71,8 @@ Ce document décrit la synchronisation **sans ambiguïté** entre :
 
 ### Étape B — NAS : aligner `current` sur `origin/main`
 Sur NAS, git n’est pas forcément installé : on utilise un conteneur git.
-en sh :
+
+en sh:
 
 APP="/volume2/docker/archicratie-web/current"
 U_ID="$(id -u)"; G_ID="$(id -g)"

docs/TROUBLESHOOTING.md

@@ -58,7 +58,7 @@ en sh :
 curl -fsS http://127.0.0.1:8082/archicratie/archicrat-ia/chapitre-4/ > /tmp/page.html
 grep -n "window.open" /tmp/page.html | head
 
-Fix
+# Fix
 
 garder un seul mécanisme d’ouverture
 
@@ -101,7 +101,6 @@ git fetch impossible sur le NAS.
 Git non installé sur DSM shell.
 
 # Fix standard (recommandé)
-
 Utiliser un conteneur git :
 
 APP="/volume2/docker/archicratie-web/current"
@@ -177,9 +176,9 @@ BuildKit is enabled but the buildx component is missing
 
 client version ... too new. Maximum supported API version ...
 
-# Fix “robuste” (principe)
+Fix “robuste” (principe)
 
-installer buildx si nécessaire
+# installer buildx si nécessaire
 
 si DSM/docker API ancienne : définir DOCKER_API_VERSION=<compatible> (selon ton environnement)