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:
parent
cc2a171ec3
commit
044e35bc05
1 changed files with 50 additions and 7 deletions
57
README.md
57
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
|
||||
```
|
||||
|
|
|
|||
Loading…
Reference in a new issue