Pointage enregistré et statistiques de présence

Étape 58 : le présent / absent du référent est enregistré sur
l'affectation (Assignment.attendance + heure, migration 0030,
PUT .../assignments/{id}/attendance) au lieu de disparaître au
rechargement.

Étape 59 : section « Présence » de l'écran Statistiques — créneaux en
cours et créneaux terminés, par poste, rafraîchie toutes les 30 s.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

CLAUDE.md

@@ -170,6 +170,17 @@ les tables sauf les tables d'association.
   jamais donner à un compte VOLUNTEER l'accès en lecture à `positions`/
   `shifts` de toute l'édition — c'est l'écran bénévole (`/mobile-benevole`)
   qui en a besoin.
+  **Pointage** : `attendance` (`AttendanceStatus` `PRESENT` / `ABSENT`,
+  `NULL` = pas pointé) et `attendance_marked_at` (heure du dernier
+  pointage), posés par `PUT .../assignments/{id}/attendance`
+  (`{attendance}`, `null` annule — même contrôle d'écriture que
+  l'affectation : COORDINATION ou référent du poste). Écran référent : un
+  second appui sur le même bouton annule, mise à jour immédiate à l'écran
+  puis enregistrée (`hooks.ts:useSetAttendance`, retour arrière et message
+  si l'enregistrement échoue). Ce n'est pas le statut d'une affectation
+  (toujours valide dès sa création), juste la présence constatée sur
+  place. Avant l'étape 58, ce pointage n'était gardé que dans le
+  navigateur et se perdait au rechargement.
 - **`Account`** : `email` (unique par édition), `role` (`Role`), `edition_id`,
   `volunteer_id` (nullable, unique).
 - **`MagicLinkToken`** : `account_id`, `token_hash` (unique), `expires_at`,
@@ -286,7 +297,13 @@ les tables sauf les tables d'association.
   aucune bibliothèque), palette validée (daltonisme/contraste) sur le fond
   `paper`, chaque graphique doublé d'une vue tableau. Le mock calcule les
   mêmes chiffres (`buildStats`) et étale les dates d'inscription du jeu
-  de démo (`registeredAt`).
+  de démo (`registeredAt`). **Présence** (`attendance`,
+  `_attendance` / mock `buildAttendance`) : présents, absents et non
+  pointés (`Assignment.attendance`) par poste, sur les créneaux terminés
+  et sur ceux en cours à `as_of` (créneaux à venir ignorés), avec le taux
+  de présence parmi les bénévoles pointés ; la section passe en tête de
+  l'écran tant qu'un créneau est en cours, et l'écran se rafraîchit
+  toutes les 30 s (`useStats`, `refetchInterval`).
 - **Export bénévoles** (Excel, `app/exporting/xlsx.py` + `GET
   /editions/{id}/volunteers/export`, COORDINATION) : une ligne par
   bénévole, mêmes champs que la fiche (coordonnées, vœux, cotisation,
@@ -802,10 +819,11 @@ adapté à son tableau bénévole × créneau.
 
 ### Hors périmètre (le modèle doit juste pouvoir les accueillir sans refonte)
 
-SMS · pointage sur site · fonctions d'IA. *(L'envoi d'emails par SMTP est en
+SMS · fonctions d'IA. *(L'envoi d'emails par SMTP est en
 place — voir § 2. Le formulaire public d'inscription est en place — voir § 2
 et § 9 ; ce n'était pas prévu à l'origine, retiré de cette liste à
-l'étape 21.)*
+l'étape 21. Le pointage présent / absent par le référent est en place depuis
+l'étape 58 — `Assignment.attendance`, § 2.)*
 
 ---
 
@@ -1015,7 +1033,9 @@ Aucune dépendance locale requise hors Docker.
 | 55    | Écrans bénévole et référent redessinés d'après la maquette (`design/Planning bénévole mobile.dc.html`, pensée pour le téléphone — tablette et desktop gardent la même colonne, centrée) : bénévole — créneau en cours ou prochain mis en avant (compte à rebours, lieu, chevauchement, bouton « Appeler » le référent), planning par journée de festival avec frise horaire et statut de chaque créneau (terminé / en cours), message de fin de festival ; référent — onglets de postes, choix du créneau (en cours ou prochain par défaut), compteurs présents / attendus / absents, alerte d'absence, pointage (toujours local à l'écran) avec appel direct. Pas encore repris de la maquette, faute de donnée : téléphone de la coordination, bouton « Demander un renfort » (consigne du poste et message de l'organisation : étape 56) | à valider |
 | 56    | Messages aux bénévoles : message de l'organisation, le même pour tous (`Edition.volunteer_message`, onglet « Message aux bénévoles » de la configuration), et message de chaque poste (`Position.message`, saisi par le référent sur son écran ou par la coordination), migration `0029` — affichés sur l'écran bénévole (bloc « Message de l'organisation » daté, consignes du poste sur le créneau mis en avant et dans la liste) | à valider |
 | 57    | Référent aussi bénévole : onglets « Mon équipe » / « Mon planning » sur l'écran référent (compte rattaché à une fiche bénévole), ouverture sur celui qui correspond à ce qu'il fait en ce moment, pastille sur l'onglet dont un créneau est en cours, mention « TOI » dans l'équipe pointée | à valider |
+| 58    | Pointage enregistré : présent / absent du référent sauvegardé sur l'affectation (`Assignment.attendance` + heure, migration `0030`, `PUT .../assignments/{id}/attendance`, COORDINATION ou référent du poste) — il survivait seulement jusqu'au rechargement de la page ; heure du pointage affichée, message si l'enregistrement échoue | à valider |
+| 59    | Statistiques de présence : section « Présence » de l'écran Statistiques — en ce moment (créneaux en cours : attendus, présents, absents, non pointés par poste) et créneaux terminés (même détail + taux de présence parmi les pointés), rafraîchie toutes les 30 s, en tête de l'écran pendant un créneau | à valider |
 
 **Reste hors périmètre** (modèle prêt à les accueillir) : SMS, constructeur
-de formulaire, pointage sur site, IA. Frontend : squelette + 6 écrans +
+de formulaire, IA. Frontend : squelette + 6 écrans +
 connexion en place (voir `frontend/`).