Initial commit: Family Planner application

Complete family planning application with:
- React frontend with TypeScript
- Node.js/Express backend with TypeScript
- Python ingestion service for document processing
- Planning ingestion service with LLM integration
- Shared UI components and type definitions
- OAuth integration for calendar synchronization
- Comprehensive documentation

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
philippe
2025-10-14 10:43:33 +02:00
commit fdd72c1135
239 changed files with 44160 additions and 0 deletions

172
LISEZ-MOI.txt Normal file
View File

@@ -0,0 +1,172 @@
================================================================================
FAMILY PLANNER - INTEGRATION PRONOTE
Application Redesignee
================================================================================
DEMARRAGE RAPIDE
================================================================================
1. Double-cliquez sur : LANCER_APPLICATION.bat
2. Attendez que les 3 serveurs se lancent (environ 10 secondes)
3. L'application s'ouvre automatiquement dans votre navigateur
URL : http://localhost:5173/profiles
4. Cliquez sur un profil d'enfant (ex: Robin Heyraud)
5. Vous verrez la nouvelle page redesignee avec :
- Tous les boutons d'action integres (Planning, Importer, Modifier, Supprimer)
- Bouton "Connexion Pronote" pour se connecter
- Badge de statut Pronote
================================================================================
CONNEXION A PRONOTE - PREMIERE UTILISATION
================================================================================
1. Sur la page de profil, cliquez sur "Connexion Pronote"
2. Entrez vos identifiants :
- URL Pronote : https://[votre-etablissement].index-education.net/pronote
- Nom d'utilisateur : votre identifiant Pronote
- Mot de passe : votre mot de passe Pronote
3. Cliquez sur "Se connecter"
4. Les donnees Pronote s'affichent automatiquement :
- Moyennes generales et classement
- Dernieres notes avec code couleur
- Prochains devoirs a rendre
- Emploi du temps du jour
- Absences et retards
- Conges scolaires selon votre zone
================================================================================
FONCTIONNALITES
================================================================================
BOUTONS D'ACTION :
- [Planning] : Voir le planning complet
- [Importer] : Synchroniser les donnees depuis Pronote
- [Modifier] : Modifier le profil
- [Connexion] : Se connecter/reconnecter a Pronote
- [Supprimer] : Supprimer le profil
DONNEES PRONOTE :
- Moyennes generales (personnelle, classe, classement)
- Dernieres notes (4 plus recentes)
- Absences et retards (compteurs + historique)
- Prochains devoirs (3 plus urgents)
- Emploi du temps du jour
- Conges scolaires (selon zone A/B/C)
AUTRES :
- Notes personnelles editables
- Selection de la zone scolaire
- Sauvegarde automatique
================================================================================
DONNEES DE DEMONSTRATION
================================================================================
Si vous n'avez pas de compte Pronote reel, l'application utilise des donnees
de demonstration pour tester l'interface :
- Moyenne generale : 15.2
- Moyenne de classe : 13.8
- 5 notes recentes en differentes matieres
- Emploi du temps du lundi et mardi
- 5 devoirs a venir
- 2 absences et 3 retards
Ces donnees permettent de voir comment l'interface fonctionne sans connexion
reelle a Pronote.
================================================================================
SERVEURS LANCES
================================================================================
Le script de demarrage lance automatiquement 3 serveurs :
1. API Pronote (Port 3000) :
- Backend pour la connexion Pronote
- Gestion des donnees et authentification
- URL : http://localhost:3000
2. Backend Family Planner (Port 3001) :
- API backend de l'application
- Gestion des profils et calendriers
- URL : http://localhost:3001
3. Frontend (Port 5173) :
- Interface utilisateur React
- URL : http://localhost:5173
================================================================================
ARRETER L'APPLICATION
================================================================================
Pour arreter tous les serveurs :
- Fermez la fenetre du terminal/PowerShell
- Ou appuyez sur Ctrl+C dans le terminal
================================================================================
DEPANNAGE RAPIDE
================================================================================
PROBLEME : Les boutons ne s'affichent pas
SOLUTION : Verifiez que vous etes sur la page d'un profil enfant
URL correcte : http://localhost:5173/child/[ID]
PROBLEME : "Erreur de connexion a Pronote"
SOLUTION : - Verifiez l'URL Pronote (doit commencer par https://)
- Verifiez vos identifiants
- Redemarrez l'application
PROBLEME : Les donnees ne se chargent pas
SOLUTION : - Cliquez sur "Importer"
- Rafraichissez la page (F5)
- Reconnectez-vous a Pronote
PROBLEME : L'application ne demarre pas
SOLUTION : - Verifiez que Node.js est installe : node --version
- Fermez tous les processus Node.js
- Relancez LANCER_APPLICATION.bat
================================================================================
DOCUMENTATION COMPLETE
================================================================================
Pour plus de details, consultez :
- INSTRUCTIONS_PRONOTE.md : Documentation complete en francais
- README.md : Documentation technique
================================================================================
SECURITE
================================================================================
- Les mots de passe Pronote ne sont PAS stockes en clair
- Utilisation de JWT pour l'authentification
- Sessions expirees automatiquement apres 1 heure
- Tokens cryptes dans localStorage
RECOMMANDATIONS :
1. Ne partagez jamais vos identifiants Pronote
2. Fermez l'application apres utilisation
3. Videz le cache si ordinateur partage
================================================================================
SUPPORT
================================================================================
En cas de probleme :
1. Consultez INSTRUCTIONS_PRONOTE.md
2. Verifiez les logs des serveurs
3. Redemarrez l'application
4. Consultez la documentation technique
================================================================================
VERSION : 1.0.0
DATE : 13 Octobre 2025
DEVELOPPE AVEC : Claude Code
================================================================================