chartbastan/docs/user-provided-context.md

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