documentation
Kohinos v3 Doc générée le commit 8d60b1904

Glossaire

commun Lexique transversal — termes MLC et SSA.

Les termes clés utilisés dans Kohinos, en une phrase ou deux. Si un mot vous échappe dans la documentation ou dans l'interface, cherchez-le ici. Les renvois pointent vers la page de référence sur chaque sujet.

Comment lire ce glossaire

Chaque entrée est rédigée pour un lecteur non technique. Pour les objets manipulés en interne par le logiciel, reportez-vous à la doc développeur.

A

Adhérent
Personne physique inscrite à la MLCC, titulaire d'un compte eMLc. C'est le rôle de base : tout utilisateur démarre adhérent. Voir le rôle adhérent.
Admin siège
Administrateur du siège (l'association porteuse de la MLCC) avec droits étendus sur la configuration et les opérations. Voir le rôle admin siège.
Auto-abondement
Option d'une caisse SSA : la caisse complète automatiquement l'écart entre le fonds collecté et le montant à redistribuer (par exemple via une réserve dédiée). Voir les caisses SSA.
Auto-pay SSA
Option qui permet à un participant de régler un achat chez un prestataire affilié à une caisse en puisant directement dans le solde redistribué par la SSA.

B

Bcmath
Extension PHP de calcul à précision arbitraire : tous les montants monétaires (eMLc, euros) sont manipulés via Bcmath pour éviter les erreurs d'arrondi des nombres à virgule flottante. C'est un garde-fou pour l'intégrité financière.
BOffice
Module SAV (service après-vente) intégré : outil de gestion des tickets et demandes utilisateur. Permet au secrétariat et au siège de suivre les sollicitations sans email.

C

Caisse SSA
Unité d'organisation d'une SSA : nom, responsable, prestataires affiliés, règle de cotisation, règle de redistribution. Plusieurs caisses peuvent coexister. Voir les caisses SSA.
Caissier
Personne qui tient un comptoir et effectue les opérations de change espèces/eMLc et reconversion pour les adhérents et prestataires.
CB
Carte bancaire. Dans Kohinos, les paiements par CB transitent par un opérateur de paie (HelloAsso ou PayZen) : la plateforme ne stocke jamais le numéro de carte.
Comptoir
Point physique (commerce, association, permanence) où un adhérent peut acheter ou reconvertir des eMLc en espèces. Voir le rôle comptoir.
Conservation (1 eMLc = 1 €)
Règle fondatrice : chaque eMLc en circulation est garantie par exactement 1 euro en réserve bancaire. Aucune création monétaire silencieuse, aucune spéculation.
Cotisation MLCC
Cotisation annuelle d'adhésion à l'association porteuse de la MLCC. Conditionne l'ouverture du compte eMLc. Distincte de la cotisation SSA.
Cotisation SSA
Versement mensuel d'un participant à une caisse SSA. La somme des cotisations forme le fonds redistribué le jour d'exécution.

D

Découvert
Solde eMLc négatif autorisé pour certains rôles (typiquement les prestataires) dans une limite configurée par le siège (GlobalParameter).
Don (mode SSA)
Mode d'engagement dans une caisse SSA : le participant cotise mais renonce explicitement à la redistribution. Sa cotisation profite aux autres bénéficiaires.
Doctrine
Bibliothèque d'accès à la base de données utilisée par Kohinos : c'est la couche qui traduit les objets PHP en lignes de table SQL et inversement. Visible uniquement par les développeurs.

E

eMLc
e-Monnaie Locale Complémentaire : la version électronique de la monnaie locale du projet. 1 eMLc = 1 € adossé en réserve. Pas de blockchain, pas de spéculation : simple écriture en base, signée et chaînée. Voir la FAQ.

F

Flux
Mouvement entre deux comptes (achat, recharge, cotisation, redistribution…). Chaque flux a un type (FluxType) et génère une ou plusieurs opérations en base.
FluxType
Catégorie d'un flux : achat, recharge, reconversion, cotisation MLCC, cotisation SSA, redistribution SSA, etc. Sert au filtrage, aux statistiques et aux règles métier.

G

GlobalParameter
Table de paramétrage central du site : limites de découvert, taux par défaut, libellés, configuration des opérateurs de paie… Modifiable par le siège.
Groupe local
Antenne géographique ou thématique d'une MLCC. Un adhérent est généralement rattaché à un groupe local. Voir le rôle gestion de groupe.

H

HelloAsso
Passerelle de paiement CB partenaire (associative, sans commission obligatoire). Utilisée pour recharger un compte eMLc ou payer une cotisation par carte. Voir opérateur de paie.

I

IBAN
Identifiant bancaire international qui identifie un compte. Utilisé pour les mandats SEPA. Stocké chiffré dans Kohinos (jamais en clair).
Idempotence
Propriété d'une opération qui peut être rejouée plusieurs fois sans effet supplémentaire. Exemple : les prélèvements mensuels SEPA sont idempotents — un même mois ne peut pas être prélevé deux fois, même en cas de relance manuelle.

M

Manager SSA
Prestataire désigné comme responsable opérationnel d'une caisse SSA (synonyme courant de responsable SSA).
Mandat SEPA
Autorisation signée par un adhérent permettant à Kohinos de prélever récurremment sur son compte bancaire. Chaque mandat porte une référence unique (UMR) et doit être validé par le trésorier.
MLCC
Monnaie Locale Complémentaire Citoyenne : type de monnaie portée par une association, circulant sur un territoire défini, à parité fixe avec l'euro. Kohinos est la plateforme logicielle qui équipe une MLCC.
Monnaie locale
Synonyme courant de MLCC. Désigne aussi bien les billets papier que la version électronique (eMLc).

O

Operation
Écriture comptable élémentaire en base : débit ou crédit d'un compte, signé et chaîné à l'opération précédente. Un flux produit toujours au moins deux opérations (débit + crédit).
Opérateur de paie
Prestataire externe qui encaisse les paiements CB pour le compte de l'association (PayZen, HelloAsso…). Kohinos communique avec lui par webhook.

P

Paliers (mode SSA)
Mode de redistribution d'une caisse SSA : chaque participant reçoit un montant qui dépend de la composition de son foyer (1 personne, 2 personnes, etc.). Voir les caisses SSA.
PayZen
Passerelle de paiement CB historique du projet. Voir opérateur de paie.
Verrou financier
Verrou posé en base de données pendant une opération financière : tant qu'un adhérent paie ou est prélevé, aucun autre processus ne peut modifier son compte. Garantit qu'aucun double mouvement n'a lieu, même sous charge.
Prestataire
Commerce, association ou producteur qui accepte la monnaie locale. Possède son propre compte eMLc et peut être affilié à des caisses SSA. Voir le rôle prestataire.

R

Recharge
Achat d'eMLc par un adhérent en échange d'euros : en espèces à un comptoir, ou par CB via un opérateur de paie, ou par virement SEPA.
Reconversion (eMLc → €)
Opération inverse de la recharge : un prestataire (ou un adhérent qui quitte la MLCC) échange ses eMLc contre des euros prélevés sur la réserve.
Récurrent (achat)
Achat eMLc programmé pour se reproduire automatiquement chaque mois, typiquement adossé à un mandat SEPA.
Récurrente (cotisation)
Cotisation MLCC ou SSA programmée pour être prélevée automatiquement chaque mois ou chaque année, sans intervention manuelle.
Redistribution
Reversement, le jour d'exécution mensuel, du fonds collecté d'une caisse SSA vers ses participants éligibles, selon le mode choisi (calculé, fixe, paliers).
Responsable SSA
Personne désignée qui anime et administre une caisse SSA : invite des participants, ajuste les paramètres, déclenche les exécutions exceptionnelles. Voir le rôle responsable SSA.

S

SEPA
Single Euro Payments Area. Mécanisme européen de prélèvement automatique sur compte bancaire. Utilisé par Kohinos pour les cotisations et achats récurrents, sur la base d'un mandat SEPA signé par l'adhérent.
Secrétaire
Rôle qui assure le suivi administratif quotidien : relances, adhésions, courriers, réponses BOffice. Voir le rôle secrétaire.
Siège
Association porteuse de la MLCC (par exemple la Doume pour la MLC du Puy-de-Dôme). Détient la réserve euros et porte la responsabilité juridique.
Engagement SSA
Représente ma participation à une caisse SSA : mon engagement de cotisation, mon moyen de paiement, ma composition de foyer le cas échéant. Un adhérent peut avoir plusieurs engagements (un par caisse).
Caisse SSA (paramètres)
Représente la caisse SSA elle-même : ses règles, son responsable, ses prestataires affiliés, son jour d'exécution. Voir les caisses SSA.
SSA
Sécurité Sociale de l'Alimentation. Dispositif mutualisé : chacun cotise selon ses moyens, chacun reçoit selon une règle votée collectivement. Implémenté dans Kohinos via les caisses SSA.
Super admin
Rôle technique le plus élevé : accès à tout, y compris la configuration système. Réservé à un nombre très restreint de personnes (typiquement l'équipe technique du siège).

T

Taux de prélèvement
Pourcentage du montant des achats d'un adhérent chez les prestataires d'une caisse SSA, qui sera prélevé comme cotisation. Valeur par défaut : 5 %. Configurable par caisse.
Trésorier
Rôle qui valide les mandats SEPA, supervise les reconversions et la santé financière de la MLCC. Voir le rôle trésorier.

U

UMR
Unique Mandate Reference : identifiant unique d'un mandat SEPA, généré automatiquement par Kohinos et imprimé sur le mandat papier signé par l'adhérent.

W

Webhook
Notification automatique envoyée par un service externe (typiquement un opérateur de paie) pour signaler un événement (paiement réussi, prélèvement rejeté…). Kohinos écoute ces webhooks pour mettre à jour les comptes en temps réel.
Un terme manque ?

Ce glossaire couvre les termes les plus fréquents côté utilisateur. Pour le vocabulaire technique (entités Doctrine, services, commandes), reportez-vous à la documentation développeur.