docs: compléter README (flux publication, structure prévue, déploiement)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Alpinux 2026-05-03 20:43:35 +02:00
parent cc2a171ec3
commit 044e35bc05

View file

@ -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
```