# Déploiement Docker - Social Flow

## 📋 Configuration

L'application utilise Docker Compose pour orchestrer :
- **PostgreSQL 16** : Base de données sur réseau interne
- **Social Flow App** : Application Node.js exposée sur le port **4523**

## 🚀 Démarrage rapide

### 1. Copier le fichier d'environnement

```bash
cp .env.example .env
```

### 2. Éditer les variables d'environnement

Modifiez `.env` avec vos valeurs :

```bash
# Base de données
PGDATABASE=socialflow
PGUSER=socialflow
PGPASSWORD=votre_mot_de_passe_securise

# Application
PORT=4523
SESSION_SECRET=votre_cle_secrete_aleatoire

# API OpenRouter (pour la génération IA)
OPENROUTER_API_KEY=votre_cle_openrouter
```

### 3. Lancer les conteneurs

```bash
# Démarrer en arrière-plan
docker-compose up -d

# Voir les logs
docker-compose logs -f

# Arrêter
docker-compose down
```

## 🌐 Accès à l'application

- **Accès direct** : http://localhost:4523
- **Avec Nginx** (reverse proxy) : Voir section ci-dessous

## 🔧 Architecture réseau

### Réseau interne (`internal`)
- PostgreSQL et l'application communiquent sur ce réseau privé
- La base de données n'est **pas exposée** sur l'hôte pour plus de sécurité

### Réseau nginx (`nginx_default`) - OPTIONNEL
- Réseau externe pour le reverse proxy Nginx
- **Par défaut : désactivé** (commenté dans docker-compose.yml)
- Décommentez-le uniquement si vous utilisez Nginx

## 📝 Configuration Nginx (optionnelle)

### Activation du réseau Nginx

Si vous utilisez Nginx comme reverse proxy :

1. **Créer le réseau Docker nginx** (une seule fois) :
```bash
docker network create nginx_default
```

2. **Décommenter dans docker-compose.yml** :
```yaml
# Dans la section app > networks :
networks:
  - internal
  - nginx_default  # ← Décommentez cette ligne

# Dans la section networks en bas du fichier :
networks:
  # ...
  nginx_default:
    external: true  # ← Décommentez ces 2 lignes
```

3. **Mettre à jour votre configuration Nginx** pour cibler le port **4523** :

```nginx
upstream socialflow {
    server socialflow-app:4523;  # ← Utiliser le port 4523
}

server {
    listen 80;
    server_name votre-domaine.com;

    location / {
        proxy_pass http://socialflow;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
        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;
    }
}
```

**Important** : Si vous n'utilisez pas Nginx, vous pouvez retirer le réseau `nginx_default` du `docker-compose.yml`.

## 🛠️ Commandes utiles

### Reconstruire les images

```bash
docker-compose build --no-cache
docker-compose up -d
```

### Voir les logs d'un service spécifique

```bash
docker-compose logs -f app      # Application
docker-compose logs -f postgres # Base de données
```

### Accéder au conteneur

```bash
docker-compose exec app sh       # Shell de l'application
docker-compose exec postgres psql -U socialflow  # PostgreSQL CLI
```

### Nettoyer complètement

```bash
# Arrêter et supprimer les conteneurs, réseaux
docker-compose down

# Supprimer aussi les volumes (⚠️ PERTE DE DONNÉES)
docker-compose down -v
```

## 🔒 Sécurité en production

1. **Variables d'environnement** : Ne commitez JAMAIS le fichier `.env`
2. **Mots de passe** : Utilisez des mots de passe forts et aléatoires
3. **SESSION_SECRET** : Générez une clé aléatoire de 32+ caractères
4. **Firewall** : Limitez l'accès au port 4523 ou utilisez Nginx
5. **HTTPS** : Configurez un certificat SSL (Let's Encrypt + Nginx)

## 📊 Healthchecks

- **PostgreSQL** : Vérifie que la base est prête avant de démarrer l'app
- **Migrations** : Exécutées automatiquement au démarrage (`drizzle-kit push --force`)

## 🐛 Dépannage

### L'application ne démarre pas

```bash
# Vérifier les logs
docker-compose logs app

# Vérifier que PostgreSQL est prêt
docker-compose exec postgres pg_isready -U socialflow
```

### Port 4523 déjà utilisé

```bash
# Trouver le processus
sudo lsof -i :4523

# Ou changer le port dans .env et docker-compose.yml
```

### Erreur de connexion à la base de données

Vérifiez que `DATABASE_URL` dans `.env` correspond aux variables `PGUSER`, `PGPASSWORD`, etc.

## 📦 Volumes Docker

- `postgres_data` : Données persistantes de PostgreSQL
- Mappages locaux :
  - `./attached_assets` → `/app/attached_assets` (médias uploadés)
  - `./migrations` → `/app/migrations` (migrations DB)

## 🔄 Mise à jour de l'application

```bash
# 1. Pull les dernières modifications
git pull

# 2. Reconstruire l'image
docker-compose build

# 3. Redémarrer
docker-compose up -d

# 4. Vérifier les logs
docker-compose logs -f app
```