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
|
## 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
|
||||||
|
```
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue