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

109
QUICK_START.md Normal file
View File

@@ -0,0 +1,109 @@
# ⚡ Guide de Démarrage Rapide
## 🚀 En 3 étapes
### 1⃣ Double-cliquez sur START.bat
```
📁 C:\Users\philh\OneDrive\Documents\Codes\family-planner\START.bat
```
### 2⃣ Attendez 30 secondes
Deux fenêtres vont s'ouvrir :
-**Backend API** (port 5000)
-**Frontend** (port 5173)
Attendez de voir "Server ready" et "ready in XXX ms"
### 3⃣ Ouvrez votre navigateur
```
http://localhost:5173
```
Appuyez sur **Ctrl + Shift + R** pour vider le cache.
---
## 🎯 Utilisation
### Créer un profil enfant
1. Cliquez sur **"Nouveau profil"**
2. Nom : Ex. "Robin"
3. Choisissez un avatar et une couleur
4. **Sauvegardez**
### Sélectionner Monaco 🇲🇨
1. Cliquez sur le profil créé
2. Descendez jusqu'à **"Congés scolaires"** 🏖️
3. Cliquez sur le menu déroulant **"Zone scolaire"**
4. Sélectionnez **"Monaco"**
5. Cliquez **"Enregistrer la région"**
6. Les congés et jours fériés de Monaco s'affichent !
---
## 🛑 Pour arrêter
Double-cliquez sur :
```
STOP.bat
```
Ou fermez les 2 fenêtres CMD.
---
## ❓ Problèmes courants
### Le backend ne démarre pas (port occupé)
```bash
netstat -ano | findstr :5000
taskkill /F /PID <numéro_PID>
```
Puis relancez `START.bat`
### Monaco n'apparaît pas
1. Fermez TOUT (Ctrl+W sur les terminaux)
2. Relancez `START.bat`
3. Attendez **30 secondes minimum**
4. Ouvrez http://localhost:5173
5. **Ctrl + Shift + R** (rechargement forcé)
6. Créez un nouveau profil ou rafraîchissez
### La page est blanche
Le frontend n'est pas encore compilé. Attendez de voir dans le terminal :
```
ready in 1234 ms
```
Puis rafraîchissez le navigateur.
---
## 📚 Voir aussi
- [README.md](README.md) - Documentation complète
- [PORTS.md](PORTS.md) - Configuration des ports
- `docs/archive/` - Documentation historique
---
## ✅ Checklist de démarrage
- [ ] Node.js installé (version 20+)
- [ ] Deux terminaux s'ouvrent après `START.bat`
- [ ] Backend affiche "Server ready on port 5000"
- [ ] Frontend affiche "ready in XXX ms"
- [ ] http://localhost:5173 s'ouvre dans le navigateur
- [ ] Les profils se chargent
- [ ] Monaco apparaît dans le menu "Zone scolaire"
**Si tout est ✅ → Vous êtes prêt ! 🎉**