Modification du cahier des charges

Modifications.md

@@ -1 +1,49 @@
 # Modifications du cahier des charges
+
+A la suite d'une réunion avec les futurs utilisateurs il apparait un mode de fonctionnement "caché". L'ancien logiciel peu souple ne permetait pas d'effectuer certains ajustements. Des combines sont apparus pour pouvoir coller à la réalité.
+
+## Modification du calendrier de livraison
+
+Des formes de souplesse dans le calendrier de livraison sont parfois proposées aux clients afin de s'adapter à leurs absences.
+Ainsi, pour chaque type d'abonnement, la structure doit pouvoir paramétrer les autorisations de modifications du calendrier de livraison qu'elle donne au client. Il existe les 2 cas suivants :
+
+### 1er cas : report de livraison du produit
+
+La structure offre la possibilité au client de modifier la semaine de livraison d'un produit prévu, aussi bien en anticipé avant la date prévue qu'en report après la date prévue. S'il y a déjà un produit de prévu en livraison sur cette semaine, le client en recevra donc 2.
+
+Dans le cas d'un abonnement lié à une période déterminée, le report de livraison du produit ne peut se faire que dans la période de l'abonnement (on ne peut pas le reporter après la fin de période).
+
+Dans le cas d'un abonnement lié à un nombre de produits à recevoir, il n'y a pas à priori pas de contrainte de période, cela peut être reporté dans le temps après la fin du calendrier initialement prévu. En revanche la structure peut choisir ou non de déterminer un nombre maximum de produits qui peuvent être reportés.
+
+Il faudra pouvoir paramétrer un délai minimal dans le back-office pour éviter une annulation 2H avant la confection des paniers.
+
+### 2ème cas : annulation de la livraison de produits
+
+Ce cas ne concerne que les abonnements liés à une période déterminée.
+La structure offre la possibilité au client de supprimer une ou plusieurs livraisons de produits de son abonnement. La livraison et le produit sont tous simplement déprogrammés, ils ne seront donc pas facturés au client (impact sur le solde / les règlements initialement prévus).
+
+Dans le paramétrage de cette option, la structure doit pouvoir définir si elle le souhaite un nombre maximum d'annulations autorisées par abonnement.
+
+Chaque structure peut choisir, pour chacun de ses abonnements, de proposer l'une, l'autre, les 2, ou aucune de ces formes de souplesse.
+
+Les modifications du calendrier de livraison (reports ou annulation de la livraison d'un produit) peuvent être faits soit par le client en front office depuis son espace client, soit par les salariés de la structure en back office depuis le calendrier de livraison prévu pour ce client. Lors de cette opération de déclaration d'absence, l'outil doit vérifier sur l'ensemble du compte client s'il y a d'autres livraisons de produits de prévues sur cette même semaine d'absence (ex : abonnement panier + œuf + fromage) et offrir la possibilité d'effectuer les reports / annulations pour tous les produits ou individuellement pour chacun des cas.
+
+Il est possible également qu'un client demande à changer de jour de livraison dans la semaine (ex : changer la livraison prévue le Mardi au Vendredi, ce qui peut impliquer un changement de point de dépôt).
+
+## Paniers annulés, reportés
+
+Fixer un nombre maxi de paniers annulés/reportés sur une période (ex : 3 paniers annulés/reportés maxi sur juillet et août). Mais l'adhérent peut faire une demande de « dérogation » si besoin de plus de 3 annulations : c'est alors l'admin, si d'accord, qui fait l'action d'annuler/reporter un 4ème, 5ème panier, en backoffice.
+
+Le « doublage » des paniers doit pouvoir être contrôlé. ex : en été, nécessaire de répartir et étaler les paniers doublés, car impossible de doubler 50 paniers sur la dernière semaine d'août par exemple. Si liberté donnée aux adhérents de choisir les semaines où ils souhaitent doubler leurs paniers, risque d'avoir des semaines avec énormément de paniers doublés => ingérable niveau maraîchage. Donc mettre un compteur qui bloc lorsque le nombre max de paniers doublés et atteint.
+
+- Mais pour garder une marge de manœuvre et flexibilité, admin doit pouvoir agir et ajouter des doublés en backoffice, pour modifier le quota maxi.
+- Lorsque l'adhérent annule un panier, il doit donner une date de doublage obligatoirement pour compenser. Ou bien afficher un décompte (vous avez annulé 2 paniers cette année, et doublé 1 seul => vous avez un panier à doubler avant la fin de l'année)
+- Fixer une date limite pour annuler/reporter/doubler un panier : max 48h avant !
+
+## Changement de point de dépôt
+
+L'ensemble des éléments de l'abonnement sont automatiquement programmés sur le même point de dépôt.
+
+Néanmoins il est possible de changer de point de dépôt ponctuellement pour une date ou période précise, ou définitivement pour toute la fin de l'abonnement. Cela peut se faire en back office par les salariés de la structure ou en front office sur l'espace client par le client. Garder à l'esprit que certains PDD sont réservés à un public spécifique (la mention doit toujours apparaître + validation par mot de passe si ce type de PDD est choisi pour un changement).
+
+Lors de cette opération de changement de PDD, l'outil doit vérifier sur l'ensemble du compte client s'il y a d'autres livraisons de produits de prévues sur ce PDD pour cette même date ou période (ex • abonnement panier + œuf + fromage) et offrir la possibilité d'effectuer les changements de point de dépôt pour tous les produits ou individuellement pour chacun des cas.

README.md

@@ -75,7 +75,7 @@ Contraintes : Répertorier des acteurs locaux non français, anglophones de pr
 - **Coefficients :** 	7 / 50 (3.5 / 50 pour l'écrit - 3.5 / 50 pour l'oral)
 - **Date de rendu:** [16/09/2025](https://arche.univ-lorraine.fr/mod/assign/view.php?id=1622610)
 
-### Rendu 2 : Présentation produit
+### Rendu 2 : Communication commerciale
 
 > [!WARNING]
 > Énoncé non définitif, soumis à modification
@@ -434,13 +434,14 @@ Par exemple rendre un texte rédigé à la place d’un diaporama, un script sql
 ### Insertion Professionnelle (6 groupes)
 
 <table>
-<tr><td>
+<tr>
-PHILIPPON-CHAMPROUX Florentin<br>
+  <td>PHILIPPON-CHAMPROUX Florentin<br>RATTI Martin</td>
-RATTI Martin</td><td>https://github.com/flo0s/Cocagne
+  <td>https://github.com/flo0s/Cocagne
   <br>docker : ✅
   <br>Base de données : PostgreSQL (latest)
   <br>.Net 9.0 - Blazor
-<br>Liste des dépôts : ✅ Itinéraire : ✅ crud Tournée : ☹</td></tr>
+  <br>Liste des dépôts : ✅ Itinéraire : ✅ crud Tournée : ☹</td>
+</tr>
 <tr>
   <td>MATEJKA Milan<br>MAURICE Simon</td>
   <td>https://github.com/VoidOma/SAE5_Developpement_avance

Specifications.md

@@ -1,6 +1,8 @@
 # Cahier des charges
 
-Un Jardin de Cocagne est une association composée de salariés permanents constituant l'équipe d'encadrement, de salariés en réinsertion professionnelle (chômeurs de longue durée, personnes en très grande difficulté sociale, réfugiés, détenu en liberté conditionnelle, etc.) et d'adhérents consommateurs.
+### TL;DR
+
+Un Jardin de Cocagne est une association composée de salariés permanents constituant l'équipe d'encadrement, de salariés en réinsertion professionnelle (chômeurs de longue durée, personnes en très grande difficulté sociale, réfugiés, etc.) et d'adhérents consommateurs.
 
 Seuls les adhérents peuvent utiliser les services de l’association.
 
@@ -57,15 +59,15 @@ Un module de paramétrage initial doit permettre de saisir les données de la st
 
 ## 2. Saisons
 
-L’application doit permettre de définir et gérer la notion de **saison**, correspondant à l’année associative propre à chaque structure.
+L’application doit permettre de définir et gérer la notion de saison, correspondant à l’année associative propre à chaque structure.
 
 La saison représente la période de référence pour la vie de l’association : elle encadre la gestion des adhésions, des cotisations et des activités collectives (ex. : répartition des parcelles, organisation des livraisons, planification des fermetures).
 
 Chaque saison est caractérisée par :
 
-- une **date de début** et une **date de fin** (qui peuvent différer de l’année civile),
+- une date de début** et une date de fin (qui peuvent différer de l’année civile),
-- la possibilité d’indiquer des **semaines de fermeture** ou des **jours fériés** sans activité,
+- la possibilité d’indiquer des semaines de fermeture ou des jours fériés sans activité,
-- un **libellé** permettant d’identifier facilement la saison (ex. : « Saison 2025 », « Printemps–Hiver 2026 », etc.).
+- un libellé permettant d’identifier facilement la saison (ex. : « Saison 2025 », « Printemps–Hiver 2026 », etc.).
 
 La gestion multi-saisons doit être possible afin de conserver l’historique et de préparer la saison suivante tout en clôturant la précédente.
 
@@ -73,11 +75,11 @@ La structure doit définir de manière générale son calendrier livrable c'est-
 
 ### 2.1 Semaines non livrables
 
-La structure doit pouvoir définir, de manière globale les **semaines non livrables**, à cocher sur un calendrier.
+La structure doit pouvoir définir, de manière globale les semaines non livrables, à cocher sur un calendrier.
 
 ### 2.2 Jours fériés
 
-La prise en compte des **jours fériés** auront pour incidence de **décaler** la livraison sur un jour inhabituel de la même semaine (ex : mardi 8 mai férié, livraison décalée au mercredi 9 mai). Cette déclaration des décalages de livraison doit s'aborder jour férié par jour férié, et idéalement par tournée de livraison (exemple pour 2 tournées prévues les mardis, l'une pourrait être décalée au lundi et l'autre au mercredi pour des raisons d'organisation).
+La prise en compte des jours fériés auront pour incidence de décaler la livraison sur un jour inhabituel de la même semaine (ex : mardi 8 mai férié, livraison décalée au mercredi 9 mai). Cette déclaration des décalages de livraison doit s'aborder jour férié par jour férié, et idéalement par tournée de livraison (exemple pour 2 tournées prévues les mardis, l'une pourrait être décalée au lundi et l'autre au mercredi pour des raisons d'organisation).
 
 ## 3. Dépôts
 
@@ -130,7 +132,7 @@ Sur la carte publique, ne doivent figurer que les PDD ouverts à tous et ceux r
 
 Il serait pertinent que les indicateurs des points de dépôts puissent avoir une couleur différente : 1 couleur pour l'indicateur du PDD sur le site du Jardin de Cocagne, 1 couleur pour les PDD ouverts à tous, 1 couleur pour les PDD réservés à un public spécifique.
 
-##### Module de visualisation
+### Module de visualisation
 
 Il faudrait prévoir un module de visualisation des tournées facilitant leur (ré)organisation. Ex : liste globale des PDD organisée par identifiant de tournée puis ordre de livraison, et prévoir une facilité pour les **reclasser** (changer l'ordre de livraison d'une tournée, changer un PDD de tournée.)
 
@@ -142,7 +144,6 @@ Ce [module](https://sources.neotech.fr/Universite/sae5#rendu-15--d%C3%A9veloppem
 
 Les jours de préparation sont des jours pendant lesquels tous les paniers appartenant à une ou plusieurs tournées sont préparés.
 
-
 ## 5. Tournées de livraison
 
 Les points de dépôts sont livrés dans des **tournées de livraison**.
@@ -158,7 +159,7 @@ Une tournée de livraison est définie par :
 
 ![Livraison](photos/photos-29.jpg)
 
-## 6. Adhérents
+## 6. Clients
 
 Un client peut être une personne physique ou morale.
 
@@ -172,6 +173,7 @@ La fiche client comporte :
 - Nom, Prénom, Adresse, Code Postal, Ville, n° téléphone, mail. Rendre ces éléments obligatoires pour l'enregistrement de la fiche.
 - 2ème et 3ème case de téléphone, Profession, date de naissance. Éléments facultatifs pour l'enregistrement de la fiche
 - Mot de passe d'accès à son espace client « Mon compte » (créé automatiquement mais modifiable)
+- Une ou plusieurs critères et zones de commentaires : son souhait de recevoir des SMS, son souhait de recevoir des e-mails...
 
 ### 6.2 Les éléments relatifs à son adhésion
 
@@ -190,6 +192,22 @@ Pour le reste [cf. le paragraphe 7](#7-adhésions)
 
 Pour le reste cf le paragraphe 8
 
+### 6.4 Les éléments relatifs à ses règlements
+
+En particulier un pavé lié aux prélèvements, l'historique des règlements, les états des règlements, le solde en cours.
+
+____
+
+Il faut donner la possibilité aux structures de créer différents types de clients via des catégories (par ex : particuliers, AMAP, restauration collective, magasins, grossistes, salariés).
+
+Cela permettra ensuite de personnaliser des offres (disponibilités produits, tarifs, lieu de livraison) par types de clients.
+
+Dans ce cahier des charges le langage est simplifié pour clarifier les processus et élargir les possibilités de fonctionnement de l'outil.
+
+Habituellement les adhérents-consommateurs du Jardins de Cocagne (abonnés aux paniers ou achat détail au marché) sont appelés les adhérents ; les autres types de ventes réalisées auprès clients de professionnels sont distingués. Or, dans ce cahier des charges on utilisera le terme « client » au sens large, pour toute personne physique ou morale qui va faire un acte d'achat auprès du Jardin de Cocagne (aussi bien un abonné aux paniers, qu'un particulier achetant au marché, qu'un professionnel passant une commande).
+
+Le terme « adhérent » ne sera utilisé que dans le cadre de l'adhésion à l'association, qui est distincte et dissociée de l'acte d' achat (même si dans certains cas l'adhésion à l' association est obligatoire pour pouvoir effectuer certains actes d'achat).
+
 ## 7. Adhésions
 
 > [!NOTE]
@@ -274,6 +292,11 @@ L'abonnement est programmé d'après les conditions de paramétrages définies p
 
 Si une résiliation a été programmée pour cet abonnement (pour avant ou pour le jour de la fin de l'abonnement), alors l'abonnement n'est pas renouvelé.
 
+### 9.4 Paniers solidaires ou offerts
+
+Certains clients, comme les salariés en insertion, ont des paniers payés quelques % du prix public de vente.
+
+Les adhérents peuvent acheter des paniers pour en faire dons
 
 ## 10 Calendrier
 
@@ -364,8 +387,32 @@ Sur la feuille de route, un bouton « valider que la livraison a été effectué
 
 > À noter le besoin d'une très bonne ergonomie des documents de préparation des livraisons car ils seront utilisés par des non professionnels de la logistique. Un outil de paramétrage ou d'export vers des fichiers bureautiques ou la création peu complexe de modèles par des utilisateurs avertis (ex  modèles.odt Dolibarr) sera indispensable.
 
-## Production
+## 13. Composition des paniers
 
 Le module de production permet de définir la constitution des paniers. A partir du stock de légumes disponible il faut pouvoir faire un répartition équitable et homogène des légumes.
 
 Le prix cible du panier doit être respecté.
+
+## 14. Recettes
+
+Idéalement, il faudrait que chaque saisie d'une recette sur un back office d'un des Jardins de Cocagne alimente une base de données commune. Les modules de recherche des front office de l'ensemble des Jardins iraient piocher dans cette base de données nationale.
+
+## 15. Légalité
+
+Le logiciel devra être en conformité avec l'ensemble des lesgislations, et en particulier avec :
+
+- La loi informatique et libertés concernant la collecte, le traitement, la conservation et le droit de rectification de données personnelles, et la déclaration à la CNIL.
+- La loi de finances concernant l'inaltérabilité, la sécurisation, la conservation et l'archivage des opérations.
+- Les normes relatives au prélèvement SEPA et éventuellement autres normes concernant les autres modes de règlement.
+
+Le prestataire devra nous accompagner sur les procédures éventuelles à mettre en œuvre dans ce cadre.
+
+### 16. Charte
+
+En s’abonnant à un Panier Cocagne, vous êtes assuré.e de contribuer à un projet :
+
+- ayant pour priorité l’accueil et l’attention apportés aux personnes les plus vulnérables, sans discrimination ;
+- qui respecte le sol et le vivant, dans une démarche de progrès écologique certifiée « Agriculture Biologique » ;
+- qui défend l’accès digne de toutes et tous à une alimentation saine et durable produite et commercialisée dans le cadre de relations de confiance ;
+- qui croit en la force du collectif et s’évertue à partager ses expériences, ses outils et à développer des dispositifs de coopération entre pairs ;
+- qui participe à l’émergence d’une nouvelle économie au service des territoires et de la transition écologique et sociale.