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 ## Statut
À construire. Ce sous-domaine n'est pas encore développé. **À construire.** Ce sous-domaine n'est pas encore développé.
## Idées ## Idées
@ -12,23 +12,66 @@ Formulaire de retours et suggestions pour l'association Alpinux.
- Intégration AlpID optionnelle (retours anonymes possibles) - Intégration AlpID optionnelle (retours anonymes possibles)
- Stockage SQLite ou envoi par e-mail vers une liste de l'association - 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 ## Structure prévue
``` ```
feedback/ feedback/
├── app.py # Flask app (à créer) ├── app.py # Flask app
├── templates/ ├── templates/
├── static/ ├── static/
├── requirements.txt ├── requirements.txt
├── .env.example ├── .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` 1. *Sites → Ajouter un site web* — domaine `feedback.alpinux.org`
2. Activer **Let's Encrypt SSL** 2. Activer **Let's Encrypt SSL**
3. Dans *Options → Directives Apache personnalisées*, ajouter le reverse proxy vers Gunicorn 3. Directives Apache SSL (reverse proxy Gunicorn) :
4. Installer le service systemd (`feedback.alpinux.org.service`) pour 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
```