Skip to content

Adhérents : fiches à compléter, relances par e-mail et tableau UDAPEL - #100

Merged
flocom merged 5 commits into
mainfrom
claude/mobile-header-buttons-single-line-1ucs8x
Oct 13, 2026
Merged

flocom merged 5 commits into
mainfrom
claude/mobile-header-buttons-single-line-1ucs8x

Conversation

@flocom

@flocom flocom commented Oct 13, 2026

Copy link
Copy Markdown
Owner

Contexte

L'Apel départementale (UDAPEL) demande chaque année le tableau des familles adhérentes. Le modèle 2026-2027 a deux onglets : « 17,50 € via votre Apel » et « 17,50 € via une autre Apel ». Il faut, pour chaque famille, la civilité, le nom, le prénom, l'adresse découpée, le téléphone et l'e-mail. L'adresse postale est obligatoire. Il fallait donc relancer les familles dont la fiche est incomplète.

Ce qui change

Fiche adhérent (migration 0040_fiches_adherents_udapel)

  • Nouveaux champs :

    • civility (M / Mme / Mrme) ;
    • streetNumber (N° voie) ;
    • locality (lieu-dit ou commune déléguée) ;
    • nationalFeeElsewhere + otherSchoolName (part nationale réglée via un autre établissement).

    addressLine1 devient la voie, addressLine2 le complément (résidence, bâtiment).

  • Complétude (src/lib/member-info/completeness.ts), partagée par la liste, la fiche, l'e-mail, le formulaire public et l'export :

    • obligatoire : civilité, voie ou lieu-dit, code postal (5 chiffres en France), ville, pays, établissement si la part nationale est réglée ailleurs ;
    • recommandé : téléphone, e-mail, numéro de voie.
  • Écrans :

    • sur la fiche : les nouveaux champs, l'encadré « Il manque… », le bouton « Envoyer le lien pour compléter » et l'historique des liens ;
    • dans la liste : les pastilles « Adresse manquante » / « Fiche incomplète » et le filtre « Fiches incomplètes » (?fiche=incomplete) ;
    • le bandeau de comptage avec « Relancer les fiches incomplètes ».
  • MCP : les outils adhérents gèrent les nouveaux champs ; list_adherents donne ce qui manque.

Relances par e-mail (src/lib/services/member-update-requests.ts)

  • Fenêtre « Relancer » :
    • options : année, portée (obligatoire seulement ou tout), inclure ou non les relances récentes (moins de 7 jours), mot facultatif du bureau ;
    • aperçu avant envoi : destinataires, familles sans e-mail, familles relancées récemment ;
    • confirmation, puis bilan.
  • Lien personnel :
    • jeton de 32 octets, dont seule l'empreinte SHA-256 est gardée ;
    • valable 30 jours, il remplace le précédent seulement si l'envoi réussit ;
    • lien et e-mail sont traités dans une transaction, avec la fiche verrouillée.
  • Garde-fous :
    • 5 envois groupés par heure, 300 destinataires au plus par envoi, 1 lien par fiche toutes les 10 minutes ;
    • 400 explicite si les e-mails sortants ou APP_URL ne sont pas configurés.
  • Page publique /adhesion/[token] :
    • la famille voit ce qui manque, complète et enregistre, avec les consignes UDAPEL ;
    • elle peut revenir corriger jusqu'à l'expiration ;
    • la page est noindex.
  • API publique (POST /api/adhesion/[token]) :
    • validation stricte : seuls 12 champs sont modifiables ;
    • plafonds par connexion et par lien ;
    • même réponse pour un lien expiré, révoqué ou inconnu ;
    • audit sans valeurs personnelles.
  • Outil MCP send_member_update_requests : aperçu par défaut, confirm requis pour envoyer.

Tableau UDAPEL (GET /api/adherents/export/udapel?schoolYear=…)

  • Écriture du fichier : écrivain XLSX maison, sans dépendance (src/lib/xlsx/writer.ts : zip stocké, CRC32, styles).
  • Contenu :
    • mise en page fidèle au modèle : noms d'onglets, titres, en-têtes ligne 5, largeurs ;
    • familles actives de l'année ;
    • NOM et VILLE en majuscules ; numéro de voie extrait de la voie pour les anciennes fiches ;
    • cases obligatoires vides surlignées en jaune.
  • Accès : bouton « Tableau UDAPEL » en tête de la liste des adhérents. Route réservée aux administrateurs, avec audit.

Confidentialité

Le script de mesure d'audience Cloudflare n'est plus chargé sur les pages dont l'adresse porte un jeton personnel : /adhesion/, /reset/, /annulation/ et /inscription/.

Vérifications

  • tsc et eslint propres ; migration appliquée.
  • Service des relances, sur base de test : aperçus, envoi via un faux SMTP (un échec ne laisse aucun lien), échappement HTML, lecture et enregistrement du formulaire, correction, révocation, réponses identiques pour les liens morts, route publique (200 / 400 / 404 / 429).
  • Navigateur à 390 px :
    • lien personnel ouvert, code postal invalide refusé, fiche enregistrée et audit écrit ;
    • lien inconnu : page d'explication ;
    • pas de défilement horizontal.
  • Export : tableau téléchargé depuis l'application et relu avec openpyxl, sans avertissement et avec des CRC corrects. 20 000 lignes donnent un fichier valide en 1,3 s.
  • Relecture critique (sécurité, logique, cohérence des règles de complétude) : aucun problème grave, cinq défauts mineurs corrigés.

🤖 Generated with Claude Code

https://claude.ai/code/session_013qdzYT4Efr8jYC3U3sCnCJ


Generated by Claude Code

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013qdzYT4Efr8jYC3U3sCnCJ
Pas de mesure d'audience sur les pages à jeton personnel (adhésion,
réinitialisation, annulation, inscription) : le script envoyait l'adresse,
jeton compris. Messages du formulaire public en français, e-mail correct
quand rien ne manque, bouton d'envoi désactivé pour un adhérent archivé,
ligne 4 du tableau UDAPEL laissée vide comme sur le modèle.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013qdzYT4Efr8jYC3U3sCnCJ
…'export

La migration des fiches passe en 0041, après la boîte à justificatifs.
La fenêtre « Exporter » de la liste des adhérents propose désormais le
tableau de l'Apel départementale à son modèle (par défaut), à côté de la
liste simple en Excel ou CSV ; le bouton séparé disparaît.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013qdzYT4Efr8jYC3U3sCnCJ
@flocom
flocom merged commit e5e2e01 into main Oct 13, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants