# Documentation des fichiers Docker pour lancer la webapp et l'API Streamlit

Ce dossier contient les fichiers nécessaires pour construire et lancer deux services via Docker :
- **Frontend Angular** (service `frontend`)
- **Backend Streamlit** (service `streamlit`)

Les Dockerfiles attendent une arborescence suivante relativement à ce dossier `devops/` :
- `./frontend/` contient l’application Angular et ses `package.json`
- `./streamlit/` contient l’application Streamlit, `requirements.txt` et `app.py`

## 1) docker-compose.yml

Orchestre le lancement des services :
- Service `frontend` (port hôte 4200 → conteneur 4200)
- Service `streamlit` (port hôte 8501 → conteneur 8501)

Commandes de base :

```bash
# Construire les images et démarrer en arrière-plan
docker compose up -d --build

# Voir les logs des deux services
docker compose logs -f

# Arrêter les services
docker compose down
```

## 2) frontend-dockerfile.yml (Angular)

Image basée sur `node:24` qui :
- installe les dépendances `npm` à partir de `package*.json`
- construit l’application (`npm run build -- --configuration=production`)
- sert le build avec `serve` sur le port 4200

Attendus côté projet :
- dossier `frontend/` avec `package.json`, code Angular, et un build générant `dist/`

Accès :
- Application disponible sur `http://localhost:4200`

Notes :
- Ce Dockerfile sert la version buildée (statique). Pour du hot-reload en dev, prévoir un autre service (ex. `ng serve`) ou un mapping de volumes.

## 3) streamlit-dockerfile.yml (Streamlit)

Image basée sur `python:3.11` qui :
- installe les dépendances via `requirements.txt`
- lance l’appli avec `streamlit run app.py --server.port=8501 --server.address=0.0.0.0`

Attendus côté projet :
- dossier `streamlit/` avec `requirements.txt` et `app.py`

Accès :
- Application disponible sur `http://localhost:8501`

## 4) Variables d’environnement et volumes (optionnel)

Si vous avez besoin de configurer des variables ou des volumes, ajoutez-les dans `docker-compose.yml`, par exemple :

```yaml
services:
  frontend:
    environment:
      - NODE_ENV=production
    volumes:
      - ./frontend/dist:/app/dist:ro
  streamlit:
    environment:
      - STREAMLIT_ENV=production
    volumes:
      - ./streamlit:/app:ro
```

Adaptez selon vos besoins (mode lecture/écriture, fichiers de config, secrets via `.env`).

## 5) Dépannage

- Vérifiez que les dossiers `./frontend` et `./streamlit` existent bien au même niveau que `docker-compose.yml`.
- Assurez-vous que `frontend/package.json` contient les scripts et dépendances nécessaires au build.
- Assurez-vous que `streamlit/requirements.txt` liste toutes les dépendances Python requises et que `app.py` existe.
- Si un port est déjà utilisé, changez les ports exposés dans `docker-compose.yml`.
- Pour reconstruire proprement après des changements majeurs : `docker compose build --no-cache`.

## 6) Résumé des ports et conteneurs

- `frontend` → conteneur `frontend-app` → `http://localhost:4200`
- `streamlit` → conteneur `streamlit-app` → `http://localhost:8501`