Périscolaire — Inscriptions

Plugin WordPress de gestion des services périscolaires municipaux : inscriptions des familles, planning annuel, garderies, cantine, midi sans repas, menus, commande fournisseur, pointage et facturation.

Version documentée : 5.5.0 — schéma de données 4.2.0 — 6 septembre 2026. WordPress 5.8 minimum, PHP 7.4 minimum. L’environnement de développement local utilise Podman.

Les familles utilisent un espace dédié sans compte WordPress. La mairie administre le service depuis le menu Périscolaire. Les intervenants disposent d’un écran de présence protégé par code. Aucun paiement en ligne ni émission de prélèvement bancaire n’est intégré.

Sommaire

• Fonctionnalités récentes
• Côté familles
• Côté mairie
• Listes intervenantes SIDSCM
• Règles métier
• Données et migrations
• Sécurité
• Conservation des données
• Installation
• Configuration
• Développement local
• Structure du projet
• Points ouverts / à valider

Fonctionnalités récentes

• 5.5.0 : facturation libre — génération quand la mairie le veut, pour n'importe quel mois (passé, courant, futur), suppression du mois et régénération sans toucher au statut d'envoi ; export prélèvements SEPA du mois en fichier .ods (une ligne par famille : IBAN déchiffré, mandat, montant).

• 5.4.2 et 5.4.3 : allergies conservées sur tout le parcours d'approbation (écran mairie, approbation manuelle et automatique) et rapprochement contrôlé des demandes déjà approuvées ; présence du midi pointable pour les enfants sans repas (déclaration MSR, flag mairie, forfait flégué) ; sécurité — révocation durable des accès familles (époques de session), chiffrement bancaire sans repli en clair, anti-cache no-store.

• 5.2.0 : prestation « Midi sans repas » (MSR), indicateur mairie « Cantine sans repas » sur la fiche enfant, suppression du réglage de variante Planning.

• 5.1 à 5.1.2 : seul le planning avec rythme et exceptions figure au menu, sous le nom Planning ; le raccourci « Déclarer un jour » y conduit. L’ancien écran jour par jour reste disponible par URL de compatibilité.

• 5.0.5 à 5.0.9 : goûters dans les commandes fournisseur, e-mail ventilé par régime, pied de mail personnalisable, aperçu avant confirmation d’envoi, tests fournisseur et traces CI améliorés. Correction des libellés de jours de l’aperçu le 4 septembre.

• 5.0 à 5.0.4 : passage des trimestres au planning annuel, rythme hebdomadaire et exceptions, allergies alimentaires, migration des déclarations, adaptation des factures/listes/exports, amélioration des performances et des tests du planning.

• Fin de la série 4.x : portail famille remanié, onglet Habilitations pour la fratrie, confirmations en popin auto-masquée, autocomplétion BAN et validation des téléphones, codes postaux et naissances.

Le détail chronologique des versions est conservé dans readme.txt. Ses anciennes sections de présentation et d’installation peuvent encore décrire des versions antérieures ; le présent README décrit le fonctionnement courant.

Côté familles

Première inscription

Le formulaire public comporte quatre étapes, contrôlées dans le navigateur et côté serveur :

1. Coordonnées : identité, e-mail, téléphone et adresse du foyer. Un second parent peut être ajouté avec ses coordonnées facultatives ; les valeurs renseignées sont validées.
2. Enfants : jusqu’à cinq enfants par demande, identité, classe, naissance, régime facultatif (sans porc et/ou sans viande), allergies éventuelles et assurance scolaire obligatoire par enfant (PDF, JPG ou PNG, 1 Mo maximum). Des personnes autorisées à récupérer les enfants peuvent être déclarées.
3. Paiement : chèque/espèces ou prélèvement SEPA. Dans ce dernier cas : titulaire, adresse, IBAN, BIC et acceptation du règlement de prélèvement. L’IBAN est validé par clé mod-97 et le BIC par son format.
4. Règlement intérieur : lecture et acceptation horodatée. Il s’agit d’une acceptation par case à cocher, pas d’une signature électronique qualifiée.

Adresse BAN : la recherche propose des adresses et remplit rue, code postal et ville. Le code postal et la ville restent visibles, en lecture seule après sélection. Une bascule rend la saisie manuelle possible ; elle est également disponible sans JavaScript. La recherche appelle l’API BAN depuis le navigateur.

Les téléphones français et codes postaux sont validés. La naissance doit correspondre à un enfant ayant au moins trois ans au 1er septembre de l’année civile en cours, y compris pour une inscription pendant l’été.

Allergies alimentaires : une case révèle un champ facultatif, limité à 1 000 caractères, strictement alimentaire. La mairie est alertée à l’enregistrement d’une allergie non vide pour organiser si nécessaire un PAI. Aucun menu individualisé n’est proposé : l’enfant apporte son repas et son goûter.

Le rythme habituel n’est plus demandé lors de l’inscription initiale : il se déclare ensuite dans Planning.

Confirmation et ouverture du compte

La famille confirme son adresse par un lien reçu par e-mail (trois jours par défaut, réglable). La demande ne rejoint la file mairie qu’après cette confirmation. La mairie accepte ou refuse, avec motif et notification possibles.

Une option de validation automatique, désactivée par défaut, ouvre directement l’espace famille après confirmation de l’adresse. L’approbation crée le foyer et les enfants dans une transaction. Pour le prélèvement, elle génère une référence de mandat et joint un PDF SEPA à l’e-mail ; le fichier temporaire est supprimé après l’envoi.

Connexion sans mot de passe

Un lien reçu par e-mail ouvre l’espace famille : validité de 30 minutes par défaut, session de 12 heures. Le lien reste réutilisable durant sa validité pour supporter les passerelles de messagerie qui préouvrent les liens. La déconnexion révoque la session concernée ; un événement sensible (retrait ou remplacement du second parent, changement d’adresse du titulaire) révoque durablement TOUTES les sessions du foyer et le lien encore valable.

Le second parent peut se connecter avec sa propre adresse au même foyer et exercer les mêmes actions. Une adresse déjà utilisée par un autre foyer est refusée. Désactiver une famille en mairie coupe son accès, même avec une session ouverte.

Tableau de bord

Vue d’ensemble des déclarations, montants, factures, menu et enfants, avec accès rapide au Planning et à l’ajout d’un enfant. Une visite guidée en cinq étapes s’affiche à la première connexion ; son état est partagé par le foyer.

La popin Annulation prestations permet de retirer plusieurs prestations encore modifiables, sur plusieurs jours. Une annulation portant sur une composante affichée d’un forfait annule le forfait entier ; la mairie reçoit un récapitulatif par jour concerné.

Planning

Le planning porte sur l’année scolaire, sans trimestre. Il associe :

• Une frise mensuelle : jours déclarés pour la fratrie et estimation annuelle.
• Des onglets enfants : prénom, classe et compteurs du mois.
• Le rythme habituel : prestations récurrentes du lundi, mardi, jeudi et vendredi. Avec au moins deux enfants, « Appliquer ce rythme à toute la fratrie » copie ce rythme.
• Les exceptions du mois : ajouts ou retraits ponctuels. La grille distingue ce qui vient du rythme, les ajouts, les retraits et les jours verrouillés. Des commandes de colonne permettent les modifications en lot ; « Revenir au rythme » supprime les exceptions modifiables du mois.
• Les récapitulatifs mensuels et annuels, par enfant et pour la fratrie.

Chaque clic est enregistré en AJAX. Revenir à l’état du rythme supprime l’exception devenue inutile. Les jours fermés sont exclus du calcul. Un changement de rythme préserve les jours déjà verrouillés au lieu de modifier rétroactivement leurs déclarations.

Le préavis vaut 48 heures par défaut, configurable pour l’année scolaire et contrôlé côté serveur. L’absence d’assurance à jour bloque les ajouts, tout en permettant les retraits dans la période modifiable.

« Valider et recevoir mon planning » envoie un récapitulatif annuel : rythme par enfant, écarts à venir et estimation. Les choix sont déjà enregistrés avant ce clic ; il déclenche l’e-mail, pas la sauvegarde.

Le menu affiche seulement Planning. L’ancien écran jour par jour reste accessible par URL et utilise les mêmes données. Le réglage de choix de variante a disparu en v5.2.

Mes enfants et assurance

Tableau des enfants avec identité, classe, naissance, régime, allergies et statut actif/sorti. « Modifier » ouvre une popin de correction de l’identité, de la naissance et des allergies. L’affichage s’adapte aux petits écrans.

Le panneau Assurance scolaire indique l’état du document annuel, sa date et les actions de consultation, ajout ou remplacement. Ajouter un enfant demande aussi son assurance, dans la limite configurable du foyer (10 enfants par défaut). Un enfant sorti garde son historique mais n’est plus proposé au planning courant.

Habilitations

Onglet dédié aux personnes autorisées à récupérer les enfants à la garderie du soir, pour toute la fratrie. Les parents proviennent de la fiche foyer ; les tiers sont gérés avec leurs coordonnées et leur lien avec la famille. L’ajout s’applique à tous les enfants actifs du foyer. La liste est présentée par enfant ; les modifications et retraits portent sur la ligne sélectionnée pour cet enfant.

Les confirmations s’affichent dans une popin qui se masque automatiquement. Les modifications restent historisées pour la mairie ; retirer une personne de la liste courante n’efface pas son historique.

Autres onglets

• Menu de la semaine : navigation hebdomadaire en AJAX, avec URL synchronisée et retour à la semaine courante. Le menu est aussi consultable publiquement, sans connexion, avec indication des jours sans école.
• Mes factures : factures mensuelles, statut et téléchargement du PDF.
• Mon profil : identité, contacts, adresse et second parent. Un changement d’e-mail nécessite une confirmation à la nouvelle adresse ; l’ancienne reste active jusque-là.
• Documents : règlement intérieur et règlement de prélèvement en PDF, ou message si le document manque.
• Réinscription : onglet visible pendant la campagne mairie. Confirmation des enfants, classe proposée, nouvelle assurance et acceptation du règlement. Décocher un enfant ne le marque pas automatiquement sorti.

Côté mairie

Tableau de bord

Indicateurs de familles/enfants actifs et d’année scolaire du planning ; liste « À faire » pour les demandes en attente, menus et commandes fournisseur, avec accès aux écrans concernés.

Années scolaires

Deux ensembles complémentaires coexistent :

• Dossiers annuels : année en préparation, active ou archivée ; classe, statut, assurance et acceptation du règlement par enfant. Une seule année de dossiers est active.
• Configuration du planning : clé d’année, dates, plages de vacances, jours fériés et préavis de 0 à 720 heures. Le planning utilise la configuration couvrant la date courante, sinon la plus récente.

Les plages de vacances personnalisées sont prioritaires ; sans elles, le calendrier importé sert de référence. Les fériés sont préremplis et peuvent être complétés ou retirés. Les jours d’école sont calculés ; il n’y a plus de gestion opérationnelle des trimestres.

Passage d’année : la mairie prépare la classe suivante selon la table de correspondance des Réglages, ajuste chaque proposition dans un récapitulatif puis confirme. Les enfants en fin de cycle peuvent être proposés en sortie. Cette bascule est manuelle.

Réinscription : campagne avec dates d’ouverture/fermeture, contrôle des dossiers et relances manuelles. Le dossier annuel et le rythme du planning sont des données distinctes.

Calendrier scolaire

Import iCal officiel de la zone C, avec traitement de la fin exclusive des vacances. Les corrections manuelles sont préservées lors des réimports. La vue visuelle mois/semaine permet de consulter le calendrier et les fermetures, y compris par prestation.

Une fermeture avec des déclarations existantes présente son impact avant confirmation et notifie les familles concernées. Les jours et prestations fermés sont exclus du planning effectif et de la facturation.

Demandes, familles et enfants

La mairie examine les coordonnées, dossiers enfants, allergies et informations de paiement, puis approuve ou refuse les demandes. Les IBAN sont masqués dans les listes et accessibles dans le formulaire de modification du foyer.

Les fiches familles permettent édition, envoi du lien de connexion, activation/désactivation et suppression avec confirmation. Les enfants sont rattachés au foyer, avec classe et assurance pour l’année sélectionnée, et peuvent être marqués actifs ou sortis. Les habilitations et leur historique sont consultables.

Cantine sans repas (v5.2) : l’indicateur mairie sur la fiche enfant est activable et retirable. Il convertit ses déclarations CANT en MSR lors de leur résolution, sans réécrire les choix de la famille : tarif MSR pour le midi seul, aucun repas fournisseur, présence maintenue dans la liste intervenants. Les garderies restent inchangées ; un forfait sélectionné est facturé au tarif « Forfait sans repas cantine » (9 € par défaut, configurable). Cet indicateur est distinct des allergies alimentaires.