Files
archicratie-edition/docs/TROUBLESHOOTING.md
Archicratia 8b7cfdfd48
All checks were successful
CI / build-and-anchors (push) Successful in 1m45s
SMOKE / smoke (push) Successful in 17s
docs(ops): add triple-source sync + troubleshooting + proposer spec
2026-02-01 14:30:18 +01:00

58 lines
1.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 / “nexiste 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 lURL 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 souvrent au moment de valider (après choix 1 / choix 2).
### Causes possibles
- handler JS déclenché deux fois (bubbling)
- présence dun `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 :
```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