APAJH — Documentation

Apparence

Jours fériés ​

Le calendrier des jours fériés que l'application utilise. Il se remplit tout seul depuis le calendrier publié par l'État, et se corrige à la main quand il le faut.

Pour qui : un compte avec le statut équipe et les permissions du domaine Jours fériés · Où : section Jours fériés du menu

Écrans couverts : Jours fériés

Les colonnes, filtres et droits de l'écran sont dans la référence des écrans.

Comprendre ​

Une ligne = un jour férié, dans une zone, à une date. Le couple zone + date est unique : on ne peut pas saisir deux fois le même jour pour la même zone.

La zone existe parce que les jours fériés ne sont pas les mêmes partout. L'Alsace-Moselle en compte deux de plus, et chaque territoire d'outre-mer a les siens. L'installation lit une seule zone, choisie par l'équipe technique dans la configuration (PUBLIC_HOLIDAYS_ZONE, metropole par défaut) : c'est celle que la synchronisation entretient.

L'origine décide qui a le dernier mot. La colonne Origine vaut :

  • API gouv — la ligne vient du calendrier officiel. Elle est écrasée à chaque synchronisation : toute correction faite dessus sera perdue.
  • Saisie manuelle — la ligne vient de quelqu'un. La synchronisation ne la modifie ni ne la supprime jamais.

La synchronisation tourne chaque nuit, vers 4 h 17 (heure de Paris), et le bouton de l'écran fait la même chose immédiatement. Elle est sans risque : elle converge au lieu d'accumuler, et on peut la relancer autant de fois qu'on veut.

Le référentiel ne garde pas tout l'historique. Le calendrier officiel publie depuis 2006 ; la synchronisation ne retient rien avant le 1er janvier de l'année en cours moins cinq ans, et retire les lignes plus anciennes à chaque passage. Les années à venir, elles, sont conservées telles que l'État les publie — le calendrier de l'année prochaine est donc déjà là quand les équipes la préparent. Une ligne en Saisie manuelle échappe à ce ménage, y compris si elle est plus ancienne que la limite.

Consulter une année ​

  1. Ouvrez Jours fériés.

  2. Dans la colonne de droite, choisissez l'année sous Par année. Le filtre ne propose que les années réellement présentes.

  3. La barre de navigation par date, au-dessus de la liste, permet aussi de descendre par année puis par mois.

    ✅ Vous devriez voir les jours de l'année choisie, du plus ancien au plus récent, avec leur libellé, leur zone et leur origine.

Synchroniser maintenant ​

À faire après une installation, ou quand l'État publie un changement qu'on ne veut pas attendre jusqu'au lendemain.

  1. Ouvrez Jours fériés.

  2. Cliquez sur Synchroniser depuis l'API, en haut à droite, à côté de Ajouter jour férié.

    ✅ Vous devriez voir un bandeau vert récapitulant l'opération : la zone traitée, le nombre de jours ajoutés, mis à jour et supprimés. S'il y avait des lignes en saisie manuelle, le bandeau précise combien ont été conservées.

  3. En cas d'échec — le service de l'État est indisponible, le réseau est coupé — le bandeau est rouge et donne la raison. Le référentiel n'est pas modifié : réessayez plus tard, ou laissez la synchronisation de la nuit s'en charger.

Le bouton attend la fin de l'opération avant de répondre. C'est un seul appel, très court.

📸 Capture à produire — images/administration/jours-feries-synchro.png

  • Écran : back-office, Jours fériés, juste après un clic sur Synchroniser depuis l'API.
  • État : bandeau vert de succès visible, filtre Par année déplié sur l'année en cours.
  • Cadrage : le bandeau, les boutons du haut et les premières lignes de la liste.

Ajouter un jour de fermeture local ​

Un jour que le calendrier officiel ne connaît pas : une fermeture décidée par l'association, un pont.

  1. Ouvrez Jours fériés et cliquez sur Ajouter jour férié.

  2. Renseignez la Date et le Libellé.

  3. Choisissez la Zone de l'installation.

  4. Laissez l'Origine sur Saisie manuelle — c'est la valeur par défaut, et c'est elle qui protège la ligne de la synchronisation.

  5. Enregistrez.

    ✅ Vous devriez voir la ligne dans la liste avec l'origine Saisie manuelle. Elle survit à une synchronisation immédiate : relancez-la pour le vérifier.

Corriger un jour venu du calendrier officiel ​

  1. Ouvrez la ligne concernée.

  2. Corrigez le Libellé ou la Date.

  3. Passez l'Origine à Saisie manuelle avant d'enregistrer.

    ✅ Vous devriez voir la correction survivre à une synchronisation. Sans ce changement d'origine, la synchronisation suivante rétablit la valeur officielle.

Points d'attention ​

  • Une correction laissée en API gouv est perdue à la synchronisation suivante — au plus tard la nuit suivante. Le changement d'origine n'est pas optionnel.
  • Une ligne en saisie manuelle n'est jamais supprimée, même à tort. Si vous avez créé une ligne par erreur sur une date que le calendrier officiel porte aussi, la synchronisation ne la corrigera pas : c'est à vous de la supprimer.
  • Un jour supprimé par la loi disparaît de lui-même, mais seulement s'il provient de l'API et se situe dans la période que la réponse couvre. Les années futures que l'État a publiées puis cessé de couvrir sont conservées : elles ne sont pas périmées, simplement plus confirmées.
  • Deux jours fériés qui tombent le même jour ne tiennent pas sur deux lignes. Le couple zone + date étant unique, une seule des deux appellations peut être enregistrée — c'est aussi la limite du calendrier officiel, qui n'en publie qu'une.
  • Changer de zone ne réécrit pas le passé. La zone lue par l'application est un paramètre technique ; les lignes déjà enregistrées gardent la leur, et la synchronisation n'entretient que la zone configurée.
  • Ce référentiel décide de ce qui est férié, pas de qui travaille. Le fait qu'un établissement accueille du public un jour férié se règle sur sa fiche, avec la case Ouvert les jours fériés — voir Référentiel organisationnel.