groupe-meditation/docs/70_API.md

API applicative

Statut: référence technique
Public: mainteneurs, intégrateurs
Dernière révision: 2026-06-01

Toutes les routes applicatives sont préfixées par /api. Les routes protégées exigent un JWT valide. Sauf mention contraire, les routes doivent agir uniquement dans le groupe du membre courant.

Authentification et accueil

Route	Usage
GET /api/auth/health	Vérifier l'accès DB côté auth.
GET /api/auth/groupes	Lister les groupes disponibles et initialiser le groupe de démonstration au besoin.
POST /api/auth/connexion	Ouvrir une session.
POST /api/auth/impersoner/{membre_id}	Sysadmin agit au nom d'un membre.
POST /api/auth/inscription	Inscrire un membre avec invitation.
GET /api/accueil/	Retourner membre, groupe, postes et modules visibles.
GET /api/health	Santé globale de l'API.

Administration sysadmin

Route	Usage
POST /api/admin/sysadmin-login	Connexion sysadmin depuis la page publique.
POST /api/admin/demo	Créer le groupe de démonstration si absent.
POST /api/admin/demo/reset	Réinitialiser les données fictives de démonstration.
GET /api/admin/groupes	Lister les groupes avec compteurs.
POST /api/admin/groupes	Créer un groupe.
PATCH /api/admin/groupes/{groupe_id}	Modifier un groupe.
POST /api/admin/groupes/{groupe_id}/reset	Réinitialiser un groupe.
DELETE /api/admin/groupes/{groupe_id}	Supprimer un groupe non protégé.

Membres et invitations

Route	Usage
GET /api/membres/moi	Profil complet du membre courant.
PATCH /api/membres/moi	Modifier son profil.
POST /api/membres/moi/pin	Changer son PIN.
GET /api/membres/actifs	Liste des membres actifs.
GET /api/membres/	Liste de gestion des membres.
POST /api/membres/	Créer un membre.
PATCH /api/membres/{membre_id}/desactiver	Désactiver la connexion.
PATCH /api/membres/{membre_id}/reactiver	Réactiver la connexion.
DELETE /api/membres/{membre_id}/oubli	Anonymiser par droit à l'oubli.
POST /api/invitations/	Générer une invitation.

Rencontres

Route	Usage
POST /api/reunions/	Planifier une rencontre ou assemblée.
GET /api/reunions/	Lister les réunions.
GET /api/reunions/rencontres/details	Données enrichies des tuiles de rencontres.
PATCH /api/reunions/{reunion_id}	Modifier une rencontre.
GET /api/reunions/{reunion_id}	Lire une rencontre.
GET /api/reunions/{reunion_id}/rapport.pdf	Produire le rapport PDF de rencontre.

Assemblées et présences

Route	Usage
POST /api/presences/reunion	Créer une réunion d'affaires.
GET /api/presences/reunions	Lister les assemblées.
POST /api/presences/reunions/{reunion_id}/invitation	Générer le lien invité.
GET /api/presences/invite/{code}	Lecture invitée d'une assemblée.
GET /api/presences/reunions/{reunion_id}/rapport.pdf	Rapport PDF d'assemblée.
POST /api/presences/	Enregistrer les présences.
GET /api/pv/	Lister les PV.
GET /api/pv/{pv_id}	Lire un PV.
POST /api/pv/	Créer un PV.
PATCH /api/pv/{pv_id}	Corriger un PV.
PATCH /api/pv/{pv_id}/adopter	Adopter un PV.

Gouvernance

Route	Usage
POST /api/propositions/	Soumettre une proposition.
POST /api/propositions/{proposition_id}/seconder	Seconder ou seconder pour un autre membre.
PATCH /api/propositions/{proposition_id}/voter	Transformer ou rejeter selon le payload.
GET /api/propositions/	Lister propositions et réflexions.
GET /api/propositions/resolutions	Lister les décisions.

Trésorerie

Route	Usage
POST /api/collectes/	Créer une collecte.
PATCH /api/collectes/{collecte_id}	Modifier une collecte.
POST /api/collectes/{collecte_id}/confirmer	Confirmer une collecte.
POST /api/collectes/{collecte_id}/reception	Accuser réception.
GET /api/collectes/	Lister les collectes.
GET /api/collectes/soldes	Soldes et éléments à recevoir.
GET /api/collectes/registre	Registre financier agrégé.
POST /api/depenses/	Soumettre une dépense.
POST /api/depenses/{depense_id}/preuve	Ajouter une preuve.
POST /api/depenses/{depense_id}/confirmer	Confirmer une dépense selon l'ancien flux.
POST /api/depenses/{depense_id}/confirmer-debit	Confirmer le débit bancaire.
DELETE /api/depenses/{depense_id}	Rejeter ou supprimer une demande.
GET /api/depenses/	Lister les dépenses.
GET /api/depenses/a-confirmer	Lister les dépenses à traiter.
PATCH /api/depenses/{depense_id}	Modifier une dépense.
POST /api/banque/	Dépôt, retrait ou opération bancaire.
GET /api/banque/reserves	Lister les réserves.
POST /api/banque/reserves	Créer une réserve.
PATCH /api/banque/reserves/{reserve_id}	Renommer une réserve.
DELETE /api/banque/reserves/{reserve_id}	Supprimer une réserve à zéro.
POST /api/banque/reserves/transfert	Virer entre disponible et réserves.
GET /api/banque/reserves/mouvements	Historique des réserves.
GET /api/banque/registre-comptable	Registre comptable.
GET /api/banque/	Lister opérations bancaires.

Contributions

Route	Usage
GET /api/contributions/destinataires	Lister les destinataires.
POST /api/contributions/destinataires	Créer un destinataire.
PATCH /api/contributions/destinataires/{destinataire_id}	Modifier un destinataire.
DELETE /api/contributions/destinataires/{destinataire_id}	Supprimer un destinataire non protégé.
POST /api/contributions/calculer	Calculer une répartition.
POST /api/contributions/	Créer un envoi de contribution.
POST /api/contributions/{envoi_id}/confirmer-debit	Confirmer le débit.
GET /api/contributions/	Lister les contributions.
GET /api/config-repartition/	Lire la configuration.
PUT /api/config-repartition/	Modifier la répartition.

Postes, mandats et permissions

Route	Usage
GET /api/postes/	Lister les postes.
POST /api/postes/	Créer un poste.
PATCH /api/postes/{poste_id}	Modifier un poste.
DELETE /api/postes/{poste_id}	Abolir un poste.
POST /api/postes/{poste_id}/reactiver	Réactiver un poste.
DELETE /api/postes/{poste_id}/permanent	Supprimer définitivement.
GET /api/postes/disponibles	Postes à pourvoir.
POST /api/postes/candidatures	Postuler.
POST /api/postes/candidatures/proposer	Proposer un autre membre.
POST /api/postes/candidatures/nominer	Nomination directe.
POST /api/postes/candidatures/{id}/retirer	Retirer une candidature.
POST /api/postes/candidatures/{id}/accepter-nomination	Accepter une nomination.
GET /api/postes/candidatures	Lister les candidatures.
GET /api/postes/candidatures/mes	Mes candidatures.
PATCH /api/postes/candidatures/{id}	Traiter une candidature.
GET /api/postes/affectations	Affectations actives du membre.
GET /api/postes/affectations/groupe	Affectations du groupe.
POST /api/postes/affectations	Affecter un poste.
POST /api/postes/affectations/{id}/terminer	Terminer un mandat.
GET /api/postes/modules	Modules configurables.
PUT /api/postes/{poste_id}/modules	Modifier les permissions d'un poste.
GET /api/rotations/	Rotations planifiées.
GET /api/rotations/historique	Historique des rotations.
POST /api/rotations/	Créer une rotation.
POST /api/rotations/batch	Créer plusieurs rotations.
DELETE /api/rotations/{rotation_id}	Supprimer une rotation.

Inventaires, événements et rapports

Route	Usage
GET /api/litterature/	Lister la littérature.
POST /api/litterature/	Ajouter un titre.
PATCH /api/litterature/{item_id}	Modifier un titre.
PATCH /api/litterature/{item_id}/stock	Ajuster le stock.
POST /api/ventes-litterature/	Enregistrer une vente.
GET /api/ventes-litterature/	Lister les ventes.
GET /api/ventes-litterature/a-recevoir	Ventes à recevoir.
POST /api/ventes-litterature/{vente_id}/recevoir	Confirmer réception.
GET /api/jetons/types	Types de jetons.
POST /api/jetons/	Enregistrer une remise statistique.
POST /api/jetons/ventes	Enregistrer une vente de jetons.
GET /api/jetons/ventes/a-recevoir	Ventes de jetons à recevoir.
POST /api/jetons/ventes/{vente_id}/recevoir	Confirmer réception.
GET /api/jetons/	Historique des remises.
GET /api/commandes-jetons/stock	Stock de jetons.
GET /api/evenements/	Lister les événements.
POST /api/evenements/	Créer un événement.
DELETE /api/evenements/{evenement_id}	Supprimer un événement.
GET /api/calendrier/	Calendrier du groupe courant.
GET /api/calendrier/groupe/{groupe_id}	Calendrier public d'un groupe.
GET /api/anniversaires/	Anniversaires de sobriété.

Rapports, journal et notifications

Route	Usage
GET /api/rapports/disponibles	Rapports disponibles.
GET /api/rapports/resolutions/annees	Années de décisions disponibles.
GET /api/rapports/resolutions/{annee}	Registre PDF des décisions.
GET /api/rapports/etat-resultats/{annee}/{mois}	PDF état des résultats.
POST /api/rapports/etat-resultats/{annee}/{mois}/adopter	Adopter un rapport du trésorier.
GET /api/rapports/adoptes	Rapports adoptés.
GET /api/rapports/adoptes/{rapport_id}.pdf	PDF cristallisé.
GET /api/journal/actions	Journal d'actions.
GET /api/journal/historique	Historique détaillé.
GET /api/notifications/configuration	Configuration push.
GET /api/notifications/preferences	Préférences du membre.
PATCH /api/notifications/preferences	Modifier les préférences.
POST /api/notifications/abonnement	Enregistrer un abonnement push.
DELETE /api/notifications/abonnement	Supprimer un abonnement push.
POST /api/notifications/test	Tester une notification.