groupe-meditation/docs/DEPLOIEMENT.md

Guide de déploiement — Groupe Méditation

27 modules · Phases 0 à 9 · Infrastructure Debian + NGINX + PostgreSQL

---

Prérequis

• Debian 12+ ou Ubuntu 24.04+
• PostgreSQL 16+
• Python 3.11+
• Node.js 20+ (pour le build frontend)
• NGINX 1.24+
• Certbot (Let's Encrypt)

---

1. Installer PostgreSQL

sudo apt update
sudo apt install -y postgresql-16 postgresql-client-16

sudo systemctl enable postgresql
sudo systemctl start postgresql

sudo -u postgres psql << 'SQL'
CREATE USER grpmed WITH PASSWORD 'CHANGEZ_CE_MOT_DE_PASSE';
CREATE DATABASE groupe_meditation OWNER grpmed;
GRANT ALL PRIVILEGES ON DATABASE groupe_meditation TO grpmed;
\c groupe_meditation
GRANT ALL ON SCHEMA public TO grpmed;
SQL

2. Installer Python et les dépendances

sudo apt install -y python3 python3-pip python3-venv

# Dépendances système pour WeasyPrint (rapports PDF)
sudo apt install -y libpango-1.0-0 libpangocairo-1.0-0 libgdk-pixbuf2.0-0 libffi-dev libcairo2

sudo mkdir -p /opt/groupe-meditation
sudo chown $USER:$USER /opt/groupe-meditation

cp -r backend/ /opt/groupe-meditation/backend/
cp -r deploy/ /opt/groupe-meditation/deploy/

cd /opt/groupe-meditation/backend
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

3. Configurer le backend

cd /opt/groupe-meditation/backend
cp .env.example .env
nano .env

Modifier .env :

DATABASE_URL=postgresql+asyncpg://grpmed:VOTRE_MOT_DE_PASSE@localhost:5432/groupe_meditation
JWT_SECRET=GENEREZ_AVEC_openssl_rand_base64_48
CORS_ORIGINS=["https://groupe-meditation.chezlepro.ca"]
INVITATION_EXPIRE_HOURS=48

Générer le secret JWT :

openssl rand -base64 48

4. Initialiser la base de données (23 tables)

cd /opt/groupe-meditation
source backend/venv/bin/activate
python deploy/seed.py

Le script crée interactivement :

• Les 23 tables
• Les 10 postes prédéfinis
• La répartition par défaut des contributions (30/30/30/10)
• La littérature de base (5 titres)
• Le premier groupe et le premier membre avec son poste
• Un code d'invitation valide 7 jours

5. Créer le service systemd

sudo cp deploy/groupe-meditation.service /etc/systemd/system/
sudo chown -R www-data:www-data /opt/groupe-meditation
sudo systemctl daemon-reload
sudo systemctl enable groupe-meditation
sudo systemctl start groupe-meditation

# Vérifier
curl http://127.0.0.1:8000/api/health

6. Construire le frontend

cd frontend/
npm install
npm run build

sudo mkdir -p /var/www/groupe-meditation
sudo cp -r dist/* /var/www/groupe-meditation/
sudo chown -R www-data:www-data /var/www/groupe-meditation

7. Configurer NGINX

NGINX fait tout : servir les fichiers statiques du frontend ET proxy vers FastAPI. Pas besoin d'Apache.

sudo cp deploy/nginx-groupe-meditation.conf /etc/nginx/sites-available/groupe-meditation
sudo ln -s /etc/nginx/sites-available/groupe-meditation /etc/nginx/sites-enabled/

sudo nginx -t
sudo systemctl reload nginx

# Certificat TLS
sudo certbot --nginx -d groupe-meditation.chezlepro.ca

NGINX sert :

• /api/* → reverse proxy vers FastAPI (Uvicorn port 8000)
• /* → fichiers statiques du build React (SPA routing via try_files)
• Cache 1 an sur les assets (JS, CSS, images), pas de cache sur index.html

8. Sauvegarde automatique

sudo cp deploy/backup.sh /etc/cron.daily/groupe-meditation-backup
sudo chmod +x /etc/cron.daily/groupe-meditation-backup

• pg_dump quotidien en format custom (-Fc)
• Rétention 30 jours
• Test de restauration mensuel recommandé :

pg_restore -U grpmed -d groupe_meditation_test /var/backups/groupe-meditation/grpmed_DERNIER.dump

9. Vérification finale

# API
curl -s https://groupe-meditation.chezlepro.ca/api/health | python3 -m json.tool

# Documentation OpenAPI
# Ouvrir https://groupe-meditation.chezlepro.ca/api/docs

# Frontend
# Ouvrir https://groupe-meditation.chezlepro.ca
# Se connecter avec le prénom et le PIN créés lors du seed

---

Dépannage

Problème	Commande
API ne démarre pas	sudo journalctl -u groupe-meditation -f
Erreur base de données	sudo -u postgres psql -d groupe_meditation -c "SELECT count(*) FROM groupes;"
NGINX 502	sudo systemctl status groupe-meditation (vérifier que FastAPI tourne)
WeasyPrint échoue	sudo apt install libpango-1.0-0 libpangocairo-1.0-0
Mise à jour frontend	cd frontend && npm run build && sudo cp -r dist/* /var/www/groupe-meditation/
Mise à jour backend	sudo systemctl restart groupe-meditation

Mise à jour de l'application

# Backend
cd /opt/groupe-meditation/backend
source venv/bin/activate
pip install -r requirements.txt
sudo systemctl restart groupe-meditation

# Frontend
cd frontend
npm install
npm run build
sudo cp -r dist/* /var/www/groupe-meditation/

---

Hébergé au Québec · 100% logiciel libre · Zéro traçage · 23 tables · 25 routers · 27 modules