FamilyPlanner/docs/archive/MONACO_READY.md

✅ Monaco est prêt à l'emploi !

🎉 Résumé

Monaco est déjà intégré dans votre application Family Planner ! Les vacances scolaires et jours fériés de la Principauté de Monaco sont disponibles.

---

📍 Comment utiliser Monaco

Dans l'interface

1. Ouvrir un profil enfant

   • Allez sur http://localhost:5173/profiles
   • Cliquez sur un profil d'enfant (ex: Robin Heyraud)

2. Sélectionner Monaco

   • Descendez jusqu'à la section "Congés scolaires" 🏖️
   • Dans le menu déroulant "Zone scolaire", sélectionnez "Monaco"
   • Cliquez sur "Enregistrer la région"

3. Voir les congés

   • Les vacances scolaires de Monaco s'affichent automatiquement
   • Les jours fériés spécifiques à Monaco sont inclus

---

📅 Données de Monaco (2024-2025)

Vacances Scolaires

Source : Arrêté ministériel n° 2023-221 du 18 avril 2023

Vacances	Début	Fin
Toussaint	23 octobre 2024	4 novembre 2024
Noël	20 décembre 2024	6 janvier 2025
Hiver	7 février 2025	24 février 2025
Printemps	5 avril 2025	22 avril 2025
Été	1er juillet 2025	8 septembre 2025

Jours Fériés 2025

12 jours fériés spécifiques à Monaco :

Jour férié	Date
Jour de l'an	1er janvier 2025
Sainte Dévote 🇲🇨	27 janvier 2025
Lundi de Pâques	21 avril 2025
Fête du Travail	1er mai 2025
Ascension	29 mai 2025
Lundi de Pentecôte	9 juin 2025
Fête-Dieu 🇲🇨	19 juin 2025
Assomption	15 août 2025
Toussaint	1er novembre 2025
Fête du Prince 🇲🇨	19 novembre 2025
Immaculée Conception	8 décembre 2025
Noël	25 décembre 2025

🇲🇨 = Jour férié spécifique à Monaco

---

🔧 Architecture Technique

Backend

Fichier : backend/src/services/holiday-service.ts

// Lignes 55-80 : Vacances scolaires Monaco
// Lignes 169-212 : Jours fériés Monaco par année

Les données sont :

• ✅ Séparées par année scolaire
• ✅ Filtrées automatiquement selon la région
• ✅ Triées par date
• ✅ Combinées avec les jours fériés

Frontend

Fichier : frontend/src/screens/ChildDetailScreen.tsx

// Ligne 522 : Monaco dans REGION_LABELS
monaco: "Monaco",

Le sélecteur affiche toutes les régions disponibles :

• Zone A, B, C (France)
• Corse
• Monaco 🇲🇨
• Guadeloupe
• Guyane
• Martinique
• Réunion
• Mayotte

---

🚀 Pour démarrer

1. Backend (déjà compilé)

cd family-planner/backend
npm run dev

Le backend tourne sur http://localhost:3000

2. Frontend

cd family-planner/frontend
npm run dev

Le frontend tourne sur http://localhost:5173

3. Tester Monaco

1. Ouvrir http://localhost:5173
2. Aller dans "Profils" → Sélectionner un enfant
3. Descendre à "Congés scolaires"
4. Sélectionner "Monaco"
5. Cliquer "Enregistrer"

---

🔍 API Backend

Récupérer les congés de Monaco

GET http://localhost:3000/api/holidays?region=monaco&year=2025

Réponse

{
  "success": true,
  "holidays": [
    {
      "id": "holiday_...",
      "title": "Sainte Dévote",
      "startDate": "2025-01-27",
      "endDate": "2025-01-27",
      "type": "public",
      "description": "Jour férié à Monaco",
      "zones": ["monaco"]
    },
    {
      "id": "holiday_...",
      "title": "Vacances d'hiver Monaco",
      "startDate": "2025-02-07",
      "endDate": "2025-02-24",
      "type": "school",
      "zones": ["monaco"],
      "description": "Vacances scolaires"
    }
    // ... autres congés et jours fériés
  ]
}

---

🎯 Différences France vs Monaco

Vacances scolaires

• France : Zones A, B, C avec dates décalées
• Monaco : Calendrier unique, dates légèrement différentes

Jours fériés

Uniquement en France :

• Victoire 1945 (8 mai)
• Fête Nationale (14 juillet)
• Armistice 1918 (11 novembre)

Uniquement à Monaco :

• 🇲🇨 Sainte Dévote (27 janvier)
• 🇲🇨 Fête du Prince (19 novembre)
• 🇲🇨 Fête-Dieu (juin)

---

📝 Mise à jour des données

Modifier les vacances de Monaco

Fichier : backend/src/services/holiday-service.ts

1. Éditer les dates lignes 55-80
2. Recompiler :

cd backend
npm run build

3. Redémarrer le serveur

Sources officielles

• Législation : https://legimonaco.mc
• Service Public : https://monservicepublic.gouv.mc
• Calendrier : https://journaldemonaco.gouv.mc

---

✅ Checklist de vérification

• Monaco ajouté au backend (holiday-service.ts)
• Vacances scolaires 2024-2025 officielles
• Jours fériés 2025 officiels
• Monaco dans le sélecteur frontend
• API fonctionnelle
• Backend compilé
• Dates vérifiées

---

🐛 Dépannage

Monaco ne s'affiche pas dans le sélecteur

Solution : Vérifier que le frontend est bien à jour

cd frontend
npm run dev

Les congés ne s'affichent pas

Causes possibles :

1. Backend pas démarré → cd backend && npm run dev
2. Région non enregistrée → Cliquer "Enregistrer la région"
3. Cache navigateur → Rafraîchir (Ctrl+Shift+R)

Erreur API

Vérifier :

• Backend tourne sur port 3000
• Frontend tourne sur port 5173
• Console navigateur (F12) pour les erreurs

---

📞 Support

Logs Backend

cd backend
npm run dev

Les logs s'affichent dans le terminal

Console Frontend

Appuyer sur F12 dans le navigateur → Onglet "Console"

---

🎉 Statut

Monaco : ✅ OPÉRATIONNEL

• Données officielles vérifiées
• Backend compilé et fonctionnel
• Frontend mis à jour
• API testée
• Prêt à l'emploi

---

Dernière mise à jour : 13 octobre 2025 Version : 1.0 Statut : Production Ready ✅