From 044e35bc052fdc058ed65812b51ac8859880a530 Mon Sep 17 00:00:00 2001
From: Alpinux <cedric.abonnel@gmail.com>
Date: Sun, 3 May 2026 20:43:35 +0200
Subject: [PATCH] =?UTF-8?q?docs:=20compl=C3=A9ter=20README=20(flux=20publi?=
 =?UTF-8?q?cation,=20structure=20pr=C3=A9vue,=20d=C3=A9ploiement)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 README.md | 57 ++++++++++++++++++++++++++++++++++++++++++++++++-------
 1 file changed, 50 insertions(+), 7 deletions(-)

diff --git a/README.md b/README.md
index 3cfe96d..fdacc34 100644
--- a/README.md
+++ b/README.md
@@ -4,7 +4,7 @@ Formulaire de retours et suggestions pour l'association Alpinux.
 
 ## Statut
 
-À construire. Ce sous-domaine n'est pas encore développé.
+**À construire.** Ce sous-domaine n'est pas encore développé.
 
 ## Idées
 
@@ -12,23 +12,66 @@ Formulaire de retours et suggestions pour l'association Alpinux.
 - Intégration AlpID optionnelle (retours anonymes possibles)
 - Stockage SQLite ou envoi par e-mail vers une liste de l'association
 
+---
+
+## Flux de publication (quand développé)
+
+```
+Modifier feedback/  →  git add / commit  →  git push  →  SSH sur serveur : git pull + restart
+```
+
+```bash
+git push    # → gitea.alpinux.org:alpinux.cedrica5l/alpinux-feedback
+
+ssh alpinux.org
+cd /home/alpinux/feedback           # chemin à confirmer à l'installation
+git pull
+source venv/bin/activate && pip install -r requirements.txt
+sudo systemctl restart feedback-alpinux
+```
+
+---
+
 ## Structure prévue
 
 ```
 feedback/
-├── app.py                     # Flask app (à créer)
+├── app.py                  # Flask app
 ├── templates/
 ├── static/
 ├── requirements.txt
 ├── .env.example
-└── feedback.alpinux.org.service   # unit systemd pour Gunicorn
+└── README.md
 ```
 
-## Déploiement
+L'unit systemd sera à ajouter dans `../infra/services/`.
 
-Le sous-domaine est créé via **ISPConfig** (`https://owni.alpinux.org:8080`) :
+---
+
+## Déploiement serveur (ISPConfig)
 
 1. *Sites → Ajouter un site web* — domaine `feedback.alpinux.org`
 2. Activer **Let's Encrypt SSL**
-3. Dans *Options → Directives Apache personnalisées*, ajouter le reverse proxy vers Gunicorn
-4. Installer le service systemd (`feedback.alpinux.org.service`) pour Gunicorn
+3. Directives Apache SSL (reverse proxy Gunicorn) :
+
+```apache
+RequestHeader set X-Forwarded-Proto "https"
+ProxyPreserveHost On
+ProxyPass        / http://127.0.0.1:5004/
+ProxyPassReverse / http://127.0.0.1:5004/
+```
+
+4. Créer et activer le service systemd
+
+---
+
+## Développement local
+
+```bash
+cd feedback
+python3 -m venv venv && source venv/bin/activate
+pip install -r requirements.txt
+cp .env.example .env && nano .env
+flask run --port 5004
+# → http://localhost:5004
+```