# Almanach moderne

> Calendrier français annuel et API d'optimisation des congés pour une personne, un couple ou une famille, compatible avec les rythmes hebdomadaires ou tournants, les demi-journées et les calendriers territoriaux.

## Capacités

- Jours fériés français fixes et mobiles
- Ponts et vacances scolaires par zone A, B ou C
- Optimisation de congés selon les jours habituellement travaillés
- Plusieurs compteurs avec période de validité, expiration et affectation de chaque date : CP, RTT, récupération
- Périodes déjà posées et contrôle d'un bloc principal entre mai et octobre
- Réserve facultative, périodes souhaitées, à éviter ou interdites
- Préférences Noël et Nouvel An indépendantes, actives par défaut dans l'interface et expliquées dans le résultat
- Nombre de coupures, durées minimale et maximale, plus longue coupure ciblée
- Explication structurée des contraintes satisfaites, violations et compromis
- Préférence rechercher/neutre/éviter pour les vacances scolaires A, B ou C
- Sélection simultanée de A, B et C : recherche de l'intersection pour les vacances communes, évitement de l'union
- Évitement scolaire compatible avec les semaines de Noël et du Nouvel An explicitement sélectionnées, avec exception expliquée dans le résultat
- Préférence Bison Futé filtrée par départs/retours, zone routière et niveau
- Provenance officielle ou statistique incluse dans chaque effet de score
- Vue annuelle condensée, sauvegarde locale et import/export JSON versionné
- Export ICS des seules dates recommandées à poser et impression/PDF annuelle
- Mode couple à deux profils indépendants : trois objectifs communs, conformité séparée, équité et compromis
- Mode famille : plusieurs enfants et zones, garde alternée, fermetures, garde tierce, couverture explicable et trois objectifs familiaux
- Roulements de 1 à 12 semaines, dimanches ou samedis travaillés et demi-journées calculées en unités entières
- Jours de repos personnels du lundi au vendredi distingués visuellement des week-ends
- Calendriers explicites : métropole, Alsace-Moselle, Guadeloupe, Martinique, Guyane, La Réunion, Mayotte, Saint-Barthélemy et Saint-Martin
- Télétravail conservé comme travail, règles employeur séparées et avertissement de validation RH
- Signaux facultatifs et sourcés de basse saison ou de haute fréquentation

## API

- Documentation OpenAPI : https://almanach-moderne.pages.dev/openapi.json
- Calcul : POST https://almanach-moderne.pages.dev/api/optimize
- Calcul couple : POST https://almanach-moderne.pages.dev/api/couple
- Calcul famille : POST https://almanach-moderne.pages.dev/api/family
- Santé : GET https://almanach-moderne.pages.dev/api/health

Les résultats sont des simulations indicatives et ne remplacent pas la validation de l'employeur.