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:
109
QUICK_START.md
Normal file
109
QUICK_START.md
Normal 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 ! 🎉**
|
||||
Reference in New Issue
Block a user