Merge pull request 'docs(ops): clarify canonical deploy doc + mark runbook/legacy' (#69 ) from docs/ops-sync-20260201 into main

Reviewed-on: #69
docs(ops): clarify canonical deploy doc + mark runbook/legacy
2026-02-01 17:33:33 +01:00 · 2026-02-01 17:32:50 +01:00 · 2026-02-01 17:06:40 +01:00 · 2026-02-01 17:05:31 +01:00 · 2026-02-01 14:47:48 +01:00
7 changed files with 31 additions and 19 deletions
--- a/.env
+++ b/.env
@@ -1,3 +0,0 @@
-PUBLIC_GITEA_BASE=https://gitea.archicratie.trans-hands.synology.me
-PUBLIC_GITEA_OWNER=Archicratia
-PUBLIC_GITEA_REPO=archicratie-edition
--- a/.env.development
+++ b/.env.development
@@ -1,4 +0,0 @@
-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
--- a/.env.local
+++ b/.env.local
@@ -1,5 +0,0 @@
-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
--- a/.env.production
+++ b/.env.production
@@ -1,6 +0,0 @@
-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
--- a/docs/DEPLOY_PROD_SYNOLOGY_DS220.md
+++ b/docs/DEPLOY_PROD_SYNOLOGY_DS220.md
@@ -1,5 +1,15 @@
 # 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 :
--- a/docs/OPS-DEPLOYMENT.md
+++ b/docs/OPS-DEPLOYMENT.md
@@ -1,6 +1,16 @@
-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
--- a/docs/OPS-RUNBOOK-ARCHICRATIE-WEB.md
+++ b/docs/OPS-RUNBOOK-ARCHICRATIE-WEB.md
@@ -1,5 +1,15 @@
 # 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)** ;
Author	SHA1	Message	Date
Archicratia	80c047369f	Merge pull request 'docs(ops): clarify canonical deploy doc + mark runbook/legacy' (#69 ) from docs/ops-sync-20260201 into main Some checks failed SMOKE / smoke (push) Successful in 33s Details CI / build-and-anchors (push) Failing after 13m44s Details Reviewed-on: #69	2026-02-01 17:33:33 +01:00
Archicratia	d7c158a0fc	docs(ops): clarify canonical deploy doc + mark runbook/legacy All checks were successful CI / build-and-anchors (push) Successful in 1m39s Details SMOKE / smoke (push) Successful in 12s Details	2026-02-01 17:32:50 +01:00
Archicratia	30f0ef4164	Merge pull request 'chore(security): stop tracking .env files (keep .env.example)' (#68 ) from docs/ops-sync-20260201-165524 into main All checks were successful CI / build-and-anchors (push) Successful in 1m24s Details SMOKE / smoke (push) Successful in 16s Details Reviewed-on: #68	2026-02-01 17:06:40 +01:00
Archicratia	d2963673c9	chore(security): stop tracking .env files (keep .env.example) All checks were successful CI / build-and-anchors (push) Successful in 1m41s Details SMOKE / smoke (push) Successful in 21s Details	2026-02-01 17:05:31 +01:00
Archicratia	d59e10dfc6	Merge pull request 'docs(ops): add triple-source sync + troubleshooting + proposer spec' (#67 ) from docs/ops-missing2-20260201 into main All checks were successful CI / build-and-anchors (push) Successful in 1m28s Details SMOKE / smoke (push) Successful in 21s Details Reviewed-on: #67	2026-02-01 14:47:48 +01:00