# Don't Look Up - Server

Backend du jeu "Don't Look Up", un jeu narratif post-apocalyptique généré par IA.

## 🛠️ Installation

1. Assurez-vous d'avoir Python 3.10+ et Poetry installés
2. Clonez le repository
3. Installez les dépendances :

```bash
cd server
poetry install
```

4. Créez un fichier `.env` à la racine du dossier `server` avec :

```env
MISTRAL_API_KEY=votre_clé_api_mistral
```

## 🚀 Lancement du serveur

```bash
poetry run dev
```

Le serveur démarrera sur `http://localhost:8000`

## 🎮 Tests du jeu

Le projet inclut un script de test qui permet de jouer au jeu en mode console et de tester la génération d'histoire.

### Modes de lancement

1. Mode interactif (normal) :

```bash
poetry run test-game
```

2. Mode automatique (pour les tests) :

```bash
poetry run test-game --auto
```

3. Mode automatique avec nombre de tours personnalisé :

```bash
poetry run test-game --auto --max-turns 20
```

4. Mode automatique avec affichage du contexte complet :

```bash
poetry run test-game --auto --show-context
```

### Codes de retour

En mode automatique, le script retourne :

- Code 0 : Victoire
- Code 1 : Défaite, erreur ou timeout (> 15 tours par défaut)

### Exemple d'utilisation dans un script

```bash
# Lancer 5 tests automatiques d'affilée
for i in {1..5}; do
    echo "Test run $i"
    poetry run test-game --auto || echo "Test $i failed"
done
```

## 📚 Structure du projet

```
server/
├── api/            # Routes et modèles FastAPI
├── core/           # Logique métier et générateurs
│   ├── generators/ # Générateurs (histoire, univers, etc.)
│   └── prompts/    # Templates de prompts pour l'IA
├── scripts/        # Scripts utilitaires
└── services/       # Services externes (Mistral, etc.)
```

## 🔄 Workflow de génération

1. Génération de l'univers (`UniverseGenerator`)

   - Style graphique
   - Genre
   - Époque
   - MacGuffin
   - Histoire de base

2. Génération des segments d'histoire (`StoryGenerator`)

   - Texte narratif
   - Choix
   - Prompts d'images
   - Métadonnées (temps, lieu)

3. Gestion de l'état du jeu (`GameState`)
   - Progression de l'histoire
   - Historique des choix
   - État du monde