Files
FamilyPlanner/QUICK_START.md
philippe fdd72c1135 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>
2025-10-14 10:43:33 +02:00

2.2 KiB
Raw Permalink Blame History

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é)

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 - Documentation complète
  • 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 ! 🎉