archicratie-edition/docs/TROUBLESHOOTING.md

TROUBLESHOOTING — Archicratie Web / NAS / Gitea

Dernière mise à jour : 2026-02-01

Ce document liste les symptômes rencontrés et les remèdes concrets.

---

0) Réflexe unique

Toujours isoler : Local, Gitea, NAS, Navigateur.

• Si ça marche sur 127.0.0.1:8082 mais pas sur le domaine → proxy/cache.
• Si ça marche après login Gitea mais pas via “Proposer” → variables PUBLIC_GITEA_*.
• Si push refusé → branch protection (normal).

---

1) “Proposer” ouvre Gitea mais retourne 404 / non autorisé

Symptôme

Nouvel onglet :

• 404 Not Found / “n’existe pas ou pas autorisé”
• ou redirect /user/login

Cause la plus fréquente

URL pointe vers mauvais owner/repo (casse sensible) :

• archicratia/archicratie-web au lieu de Archicratia/archicratie-edition

Diagnostic

Sur NAS (ou dans le HTML généré), vérifier l’URL ouverte :

• doit contenir : /Archicratia/archicratie-edition/issues/new

Fix

Dans .env de build prod (NAS) :

• PUBLIC_GITEA_OWNER=Archicratia
• PUBLIC_GITEA_REPO=archicratie-edition Puis rebuild + restart du container + smoke.

---

2) Double onglet à la validation du flow “Proposer”

Symptôme

Deux onglets s’ouvrent au moment de valider (après choix 1 / choix 2).

Causes possibles

• handler JS déclenché deux fois (bubbling)
• présence d’un window.open + a.click() simultanément
• bouton “Proposer” est un <a target=_blank> et un autre handler ouvre aussi.

Diagnostic rapide (devtools navigateur)

Chercher window.open dans la page générée :

• la commande doit retourner 0 lignes.

Sur NAS :

curl -fsS http://127.0.0.1:8082/archicratie/archicrat-ia/chapitre-4/ > /tmp/page.html
grep -n "window.open" /tmp/page.html | head