Parcours principaux

Les 5 parcours utilisateur que Kohinos automatise.

1. Adhérer & cotiser

sequenceDiagram
    autonumber
    participant Visiteur
    participant Kohinos
    participant HelloAsso
    participant Tresorier
    Visiteur->>Kohinos: Formulaire d'adhésion
    Kohinos->>HelloAsso: Redirection paiement cotisation
    HelloAsso-->>Kohinos: Webhook paiement validé
    Kohinos->>Kohinos: Création compte adhérent
    Kohinos-->>Visiteur: Email de bienvenue + identifiants
    Visiteur->>Tresorier: (optionnel) Mandat SEPA pour cotisation annuelle
    Tresorier-->>Kohinos: Valide le mandat
    

2. Recharger son compte eMLc

• En ligne — paiement HelloAsso ou PayZen, crédit instantané du compte adhérent.
• Au comptoir — espèces ou chèque remis à un comptoir physique, qui crédite le compte depuis son interface.
• Par virement (TAV) — virement bancaire avec un token applicatif unique en référence, créditant le compte dès réception et rapprochement bancaire.

3. Payer un commerce partenaire

sequenceDiagram
    autonumber
    participant Adherent
    participant Kohinos
    participant Presta
    Adherent->>Kohinos: Saisit montant + destinataire (prestataire)
    Kohinos->>Kohinos: Vérifie solde, applique lock pessimiste
    Kohinos->>Kohinos: Débite Adhérent / Crédite Prestataire (atomique)
    Kohinos-->>Adherent: Confirmation + reçu
    Kohinos-->>Presta: Notification (mail, app)
    

4. Prélèvement SEPA récurrent

Un adhérent peut autoriser un prestataire à le prélever chaque mois pour un achat récurrent (paniers de produits, abonnement…). Le workflow :

1. L'adhérent signe un mandat SEPA (identifiant unique généré par Kohinos).
2. Le trésorier valide le mandat (en attente → validé → actif).
3. L'adhérent et le prestataire conviennent du montant et du jour de prélèvement (entre 1 et 28).
4. Une fois par mois, le traitement SEPA mensuel génère le fichier de prélèvement et débite.
5. L'adhérent peut révoquer son mandat à tout moment, annulant atomiquement toutes les requêtes liées.

5. Sécurité Sociale de l'Alimentation (SSA)

Un adhérent participant à la SSA cotise mensuellement (par défaut 5 % de ses achats du mois chez les prestataires SSA du fonds). En milieu de mois, le cycle mensuel SSA :

1. Calcule le total des achats SSA de chaque participant pour le mois.
2. Prélève le pourcentage configuré sur leur compte eMLc.
3. Redistribue le fonds collectif selon la stratégie choisie (calculée / proportionnelle / fixe).
4. Envoie un email récapitulatif à chaque participant.