chartbastan/docs/user-provided-context.md
2026-02-01 09:31:38 +01:00

146 lines
3.5 KiB
Markdown

# 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