# Contexte Utilisateur - ChartBastan

## Objectif Principal

**Créer un README simple pour tester l'application complète.**

Le projet ChartBastan est en phase finale de développement:
- ✅ Tous les 9 epics sont complétés
- ✅ L'architecture est implémentée
- ✅ Frontend et Backend sont prêts
- 🔄 **Phase actuelle: Testing de l'application**

---

## Priorités pour la Documentation

### 1. Démarrage Rapide (Testing)
Créer des instructions claires pour:
- Démarrer le frontend (Next.js)
- Démarrer le backend (FastAPI)
- Configurer l'environnement
- Vérifier que tout fonctionne

### 2. Instructions de Test
Fournir des guides pour tester:
- L'authentification des utilisateurs
- L'affichage des matchs
- Les prédictions basées sur l'énergie collective
- Le dashboard en temps réel
- Les notifications (si implémentées)

### 3. Dépannage
Inclure des sections pour résoudre:
- Problèmes de connexion
- Erreurs de base de données
- Problèmes de scraping (Twitter/Reddit)
- Problèmes de synchronisation frontend/backend

---

## Zones d'Intérêt

### Frontend (chartbastan/)
- Dashboard principal
- Visualisation des matchs
- Interface de paris/prédictions
- Gestion du profil utilisateur
- Notifications push

### Backend (backend/)
- API REST (documentation Swagger)
- Scraping de données (Twitter, Reddit, RSS)
- Analyse de sentiment
- Calcul de l'énergie collective
- Machine Learning pour les prédictions

### Intégration
- Communication Frontend ↔ Backend
- Authentification (better-auth)
- Base de données partagée (SQLite)

---

## Configuration Actuelle

### Environnement
- **OS:** Windows 10
- **Shell:** PowerShell 7
- **IDE:** Cursor (VS Code based)

### Répertoire de Travail
```
d:\dev_new_pc\chartbastan
```

### Structure
- Frontend: `chartbastan/`
- Backend: `backend/`
- Documentation: `docs/` (fichiers générés par ce workflow)
- Artefacts de planification: `_bmad-output/`

---

## Notes de l'Utilisateur

- Le projet est complet et prêt pour le test
- Tous les épics ont été implémentés
- Besoin d'un guide simple pour démarrer l'application
- Priorité: Testing et validation des fonctionnalités

---

## Exigences pour le README de Test

### Contenu Essentiel

1. **Prérequis**
   - Versions de Node.js et Python requises
   - Autres dépendances (RabbitMQ, Redis si nécessaires)

2. **Installation**
   - Commandes pour installer les dépendances
   - Configuration des variables d'environnement
   - Initialisation de la base de données

3. **Démarrage**
   - Commandes pour lancer le backend (FastAPI)
   - Commandes pour lancer le frontend (Next.js)
   - Vérification que tout fonctionne

4. **Testing**
   - URLs pour accéder aux interfaces
   - Scénarios de test basiques
   - Comment vérifier les fonctionnalités clés

5. **Dépannage**
   - Problèmes courants et solutions
   - Où chercher les logs
   - Comment réinitialiser l'environnement

---

## Documents de Référence Existant

Documentation disponible dans `_bmad-output/`:
- `planning-artifacts/prd.md` - Exigences complètes
- `planning-artifacts/architecture.md` - Architecture détaillée
- `planning-artifacts/epics.md` - Liste des epics
- `implementation-artifacts/` - 38 fichiers d'implémentation détaillée
- `chartbastan/README.md` - README existant (complet mais complexe)

---

## Prochaine Étape

Générer un README simple et focalisé sur le testing pour permettre à l'utilisateur de:
1. Démarrer rapidement l'application
2. Tester les fonctionnalités principales
3. Valider que tout fonctionne comme prévu

---

## Date de Création

2026-01-18
