Regisflow/DEPLOYMENT_GUIDE.md

Guide de Déploiement RegisFlow Production 2025

Prérequis

• Docker 20.10+
• Docker Compose 2.0+
• 2GB RAM minimum
• 5GB espace disque minimum

Installation Rapide

1. Cloner et Configurer

git clone <repository-url> regisflow
cd regisflow

# Copier et modifier la configuration
cp .env.production.example .env.production
nano .env.production

2. Modifier la Configuration

Dans .env.production, changez obligatoirement :

# Mot de passe PostgreSQL sécurisé
POSTGRES_PASSWORD=VotreMotDePasseSecure2025!

# Clé de session unique (32+ caractères)
SESSION_SECRET=VotreCleDeSessionUnique2025_32CharacteresMinimum

3. Déployer

# Construction et démarrage
docker-compose up -d

# Vérifier les logs
docker-compose logs -f regisflow

# Vérifier l'état
docker-compose ps

URLs d'Accès

• Application : http://localhost:5000
• Health Check : http://localhost:5000/health
• Base de données : localhost:5433

Comptes par Défaut

• Utilisateur : admin
• Mot de passe : admin123

⚠️ Important : Changez le mot de passe admin dès la première connexion !

Configuration Avancée

Avec Reverse Proxy (Nginx)

1. Décommentez dans docker-compose.yml :

networks:
  default:
    external: true
    name: nginx_default

2. Configuration Nginx :

server {
    listen 80;
    server_name votre-domaine.com;
    
    location / {
        proxy_pass http://regisflow:5000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

Sauvegarde Automatique

Les sauvegardes automatiques sont activées :

• Fréquence : Toutes les 12 heures (00:00 et 12:00)
• Rétention : 20 sauvegardes maximum
• Emplacement : Volume Docker backup_data

Purge Automatique

Suppression automatique des données > 19 mois :

• Fréquence : 1er de chaque mois à 02:00
• Conformité : Réglementation française

Surveillance et Maintenance

Logs d'Application

# Logs en temps réel
docker-compose logs -f regisflow

# Logs PostgreSQL
docker-compose logs -f regisflow-db

# Dernières 100 lignes
docker-compose logs --tail=100 regisflow

Health Checks

# Vérifier la santé des containers
docker-compose ps

# Test manuel du health check
curl http://localhost:5000/health

Sauvegarde Manuelle

# Accéder au container
docker exec -it regisflow-app sh

# Interface admin pour sauvegardes manuelles
# Via l'application : Menu → Administration → Sauvegardes

Mise à Jour

# Arrêter les services
docker-compose down

# Récupérer les dernières modifications
git pull

# Reconstruire et redémarrer
docker-compose up -d --build

# Vérifier les logs
docker-compose logs -f regisflow

Résolution de Problèmes

Base de données inaccessible

# Vérifier PostgreSQL
docker-compose logs regisflow-db

# Redémarrer si nécessaire
docker-compose restart regisflow-db

Application ne démarre pas

# Vérifier les logs de démarrage
docker-compose logs regisflow

# Vérifier les variables d'environnement
docker exec regisflow-app env | grep -E "(DATABASE_URL|SESSION_SECRET)"

Problème de permissions

# Vérifier les volumes
docker volume inspect regisflow_backup_data

# Réinitialiser les permissions
docker-compose down
docker volume rm regisflow_backup_data regisflow_logs_data
docker-compose up -d

Sécurité en Production

1. Variables d'Environnement

• ✅ POSTGRES_PASSWORD : Mot de passe complexe unique
• ✅ SESSION_SECRET : Clé de 32+ caractères aléatoires
• ✅ SECURE_COOKIES=true : Cookies sécurisés (HTTPS)

2. Réseau

• ✅ Isolation des containers
• ✅ Ports exposés uniquement nécessaires
• ✅ Reverse proxy recommandé pour HTTPS

3. Données

• ✅ Volumes Docker persistants
• ✅ Sauvegardes automatiques chiffrées
• ✅ Purge automatique conforme RGPD

Support

Pour toute question technique :

1. Vérifiez les logs : docker-compose logs -f
2. Consultez le health check : curl http://localhost:5000/health
3. Vérifiez la configuration réseau et les ports

---

RegisFlow 2025 - Gestion professionnelle des ventes de feux d'artifice