Skip to content

Adhérents : export de la liste pour l'APEL départementale - #97

Merged
flocom merged 1 commit into
mainfrom
claude/export-adherents-apel-departementale
Oct 13, 2026
Merged

flocom merged 1 commit into
mainfrom
claude/export-adherents-apel-departementale

Conversation

@flocom

@flocom flocom commented Oct 13, 2026

Copy link
Copy Markdown
Owner

Pourquoi

L'APEL d'établissement doit transmettre chaque année à l'APEL départementale la liste de ses adhérents (fichier du mouvement, envoi de Famille & éducation, appel de la part de cotisation qui remonte). Rien ne permettait de la sortir de l'application.

Ce que ça fait

Bouton Exporter sur la liste des adhérents → fenêtre → téléchargement pour une année scolaire, en Excel (.xlsx) par défaut ou en CSV.

Le tableau suit les modèles publiés par plusieurs APEL départementales (Côtes-d'Armor, Morbihan, Maine-et-Loire — aucun modèle propre à la Vendée n'est en ligne) :

  • en tête : association, établissement, date d'export ;
  • une ligne par famille : nom et prénom du parent, e-mail, adresse, complément, code postal, ville, cotisation ;
  • en pied : N adhésions × 23,00 € et le total.

Règles :

  • seules les adhésions actives partent ; les fiches en attente sur option, les inactives jamais ;
  • une famille qui règle moins que la cotisation pleine (tarif publié pour l'année en cours, sinon le montant le plus fréquent de l'année) adhère par un autre établissement : écartée par défaut, ou incluse et signalée dans une colonne « Adhésion ». Une fiche à 0 € n'est jamais classée ainsi ;
  • ni dons, ni notes, ni téléphone, ni règlement dans le fichier ;
  • la fenêtre annonce le nombre d'adhésions, le total, les familles écartées et les fiches sans adresse ou sans e-mail ;
  • réservé aux administrateurs, chaque export est consigné au journal d'audit (adherent.export).

Fichiers

  • src/lib/adherent-export.ts — tableau (pur, partagé avec la fenêtre), CSV, feuille Excel
  • src/lib/xlsx.ts — écriture d'un .xlsx sans dépendance (ZIP deflate + CRC32, chaînes en ligne jamais interprétées comme formules, en-tête figé et filtrable, format euros)
  • src/lib/services/adherents-export.ts, src/app/api/adherents/export/route.ts — GET /api/adherents/export?annee=2026-2027&format=xlsx&enAttente=1&autresEtablissements=1
  • src/components/adherents-export-dialog.tsx, adherents-manager.tsx, page Adhérents
  • docs/DEPLOIEMENT.md, README.md

Vérifications

  • tsc --noEmit, eslint, next build : OK
  • export généré sur les 27 fiches 2026-2027 et relu avec openpyxl ; unzip -t sans erreur ; en-tête figé, filtre arrêté avant le pied, montants au format euros
  • CSV : valeurs commençant par = + - @ neutralisées, ; et guillemets échappés
  • non testé : l'écran dans un navigateur avec une vraie base (pas de base locale disponible)

🤖 Generated with Claude Code

Chaque année, l'APEL d'établissement doit transmettre à l'APEL
départementale la liste de ses adhérents : elle tient le fichier du
mouvement, adresse Famille & éducation et appelle la part de cotisation
qui lui revient. Le bouton « Exporter » de la liste des adhérents produit
ce fichier pour une année scolaire, en Excel (.xlsx, ce que demandent les
départementales) ou en CSV.

Le tableau suit les modèles des départementales : en tête l'association,
l'établissement et la date ; une ligne par famille (nom et prénom du
parent, e-mail, adresse postale, cotisation) ; en pied le nombre
d'adhésions multiplié par la cotisation, et le total.

N'y partent que les adhésions actives (les fiches en attente sur
demande). Une famille qui règle moins que la cotisation pleine — le tarif
publié pour l'année en cours, sinon le montant le plus fréquent — adhère
par un autre établissement, où sa part au mouvement est déjà remontée :
elle est écartée par défaut, ou incluse et signalée. Une fiche à 0 € n'en
est pas une. Les dons, les notes, le téléphone et le règlement restent
dans l'application. La fenêtre annonce ce qui part et signale les fiches
sans adresse ou sans e-mail ; chaque export est consigné au journal.

Le classeur est écrit sans dépendance (src/lib/xlsx.ts : ZIP deflate,
chaînes en ligne jamais interprétées comme formules, en-tête figé et
filtrable, montants au format euros). Le CSV neutralise les valeurs qui
commencent par = + - @.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@flocom
flocom merged commit ef73861 into main Oct 13, 2026
2 checks passed
@flocom
flocom deleted the claude/export-adherents-apel-departementale branch October 13, 2026 08:46
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.

1 participant