AMAP et marchés de producteurs — contrats, distributions et permanences (gratuit)

Guide utilisateur — AMAP et marchés de producteurs, édition gratuite (DYONYSOS)

Ce guide s'adresse au coordinateur d'une AMAP et à ses bénévoles.

1. Avant de commencer — paramétrer la structure

Menu Réglages → AMAP :

• Durée par défaut d'une distribution (en heures) : utilisée pour calculer l'heure de fin d'une distribution et détecter les chevauchements de créneau.
• Effectif minimal de permanence et alerte permanence à pourvoir (en jours avant la distribution) : des paramètres de gestion propres à votre structure.
• Traitement par défaut d'un panier non retiré (don associatif, compost, redistribué, autre) et note — charte de l'AMAP : ajustez-les à votre propre charte, ce module ne reflète aucune règle nationale imposée.

Puis menu AMAP → Producteurs → Nouveau : créez chaque producteur partenaire et, dans l'onglet Produits proposés, son catalogue (nom, unité, prix, quantité hebdomadaire disponible).

2. Créer un contrat saisonnier

Menu AMAP → Contrats saisonniers → Nouveau. Choisissez l'adhérent, le producteur, la période (début/fin de saison) — le nombre de livraisons prévues est calculé automatiquement, et reste ajustable. Dans l'onglet Produits engagés, ajoutez une ligne par produit avec sa quantité hebdomadaire ; le prix unitaire est repris du produit et le montant de la saison se calcule tout seul.

Cliquez sur Confirmer. Si le volume total engagé sur un produit, ce contrat compris, dépasse la quantité hebdomadaire déclarée disponible par le producteur, la confirmation est refusée avec un message qui indique le produit et le volume en cause : réduisez la quantité engagée ou augmentez la disponibilité déclarée du produit avant de confirmer. Un contrat en brouillon peut dépasser cette capacité sans blocage — la négociation reste possible.

La facturation du contrat est apportée par l'édition complète dyo_amap.

3. Planifier une distribution

Menu AMAP → Distributions → Nouveau (vue calendrier par défaut). Renseignez le lieu et l'heure de début — l'heure de fin se calcule depuis la durée par défaut paramétrée. Si une autre distribution est déjà planifiée au même lieu sur un créneau qui chevauche celui-ci, l'enregistrement est refusé.

• Générer les retraits crée un retrait « à pointer » pour chaque contrat actif — rejouable sans créer de doublon.

La composition automatique du panier type de la semaine est apportée par l'édition complète dyo_amap.

4. Pointer les retraits le jour de la distribution

Dans l'onglet Retraits de la distribution (ou menu AMAP → Retraits), cliquez sur Retiré ou Non retiré pour chaque adhérent. Un panier marqué non retiré reçoit le traitement par défaut paramétré (don, compost...), modifiable au cas par cas dans l'onglet dédié.

5. Organiser le tour de permanence

Menu AMAP → Permanences → Nouveau (ou depuis l'onglet Permanence de la distribution). Affectez un bénévole et, si besoin, un rôle. Un même bénévole ne peut pas être affecté à deux distributions dont les créneaux se chevauchent — même sur deux lieux différents de l'AMAP, il ne peut pas être à deux endroits en même temps.

6. Relances automatiques

Deux tâches planifiées tournent une fois par jour et créent une activité Odoo pour le coordinateur, sans jamais en créer une seconde tant que la précédente reste ouverte :

• un panier marqué non retiré sans traitement choisi ;
• une distribution à venir, dans la fenêtre d'alerte paramétrée, dont l'effectif de permanence n'atteint pas le minimum requis.

La relance des paiements de contrat en retard est apportée par l'édition complète dyo_amap.

7. Ce que l'édition complète ajoute

L'édition complète dyo_amap s'installe par-dessus celle-ci, sans rien redemander : facturation des contrats et relance des impayés, panier type composé automatiquement, tableau de bord (adhérents actifs, volume engagé, chiffre d'affaires, taux de retrait) et deux éditions PDF (feuille de distribution, fiche prévisionnelle de production).

Hypothèses métier prises pour cette version

• Le tarif solidaire selon les revenus n'est pas implémenté. La spécification identifiait cet usage comme incertain (« à confirmer avant de le prévoir ») : le prix engagé par ligne de contrat reste ajustable manuellement au cas par cas, mais aucun barème par tranche de revenu n'existe dans ce module. Si votre AMAP applique un tarif solidaire, ajustez le prix unitaire de chaque ligne de contrat individuellement.
• Un contrat porte un seul producteur. Un adhérent qui s'approvisionne auprès de plusieurs producteurs crée un contrat par producteur.
• La quantité engagée d'un produit ne compte que les contrats à l'état confirmé. Un contrat en brouillon ou terminé n'occupe aucune capacité de production courante.

Ce que le module ne fait pas

Voir la section dédiée de README.md et de la fiche Apps Store.