fdd72c1135
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>
110 lines
2.2 KiB
Markdown
110 lines
2.2 KiB
Markdown
# ⚡ 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 ! 🎉**
|