# Nouveautés Kohinos — Guide Utilisateur

> Ce document présente les nouvelles fonctionnalités par version, avec des descriptions accessibles pour les **administrateurs**, **adhérents** et **prestataires**.
> Pour le détail technique, voir [`CHANGELOG.md`](./CHANGELOG.md).

---

# 🔧 v2.8.8 — Mars 2026

## 🐛 Prestataires — Correction erreur lors de l'ajout d'un lieu incomplet

### Pour les administrateurs

Lors de l'édition d'un prestataire dans l'interface d'administration, ajouter une géolocalisation ou un contact sans renseigner le nom obligatoire provoquait une erreur 500 en base de données au lieu d'afficher un message d'erreur explicite.

Ce bug est corrigé : le formulaire affiche désormais le message de validation approprié et refuse l'enregistrement sans produire d'erreur système.

---

# 🔧 v2.8.7 — Mars 2026

## ✨ SSA — Paliers de redistribution avec taille de foyer décimale

### Pour les administrateurs SSA

Les paliers de redistribution SSA (mode **TIERS**) acceptent désormais des **valeurs décimales** pour les tailles de foyer minimum et maximum.

Exemple : un palier `[1.5, 3.0]` permet de gérer les situations de **garde alternée** (enfant présent 50 % du temps = 0.5 adulte-équivalent). La valeur minimale peut également être **0** pour un palier sans borne inférieure.

> Les paliers existants avec des entiers continuent de fonctionner sans modification.

---

# 🔧 v2.8.6 — Mars 2026

## 📥 Import — Descriptions des types d'import

### Pour les administrateurs

La page **Admin → Import** affiche maintenant une **description courte** sous chaque type d'import pour expliquer son usage. Par exemple :

- *Import Adhérent avec Caisse SSA* : rappel que ce type crée l'adhérent ET l'associe à une caisse SSA avec cotisation minimum
- *Import Flux* : précision que les flux importés sont uniquement historiques et sans impact sur les soldes de compte
- *Import SSA* : rappel que ce type met à jour les cotisations minimums pour des adhérents existants

## 🐛 Import CSV adhérents SSA — Correction colonne cotisation

### Pour les administrateurs

Un bug empêchait la mise à jour de la cotisation minimum SSA lors de l'import **\"Adhérents avec Caisse SSA\"** : la colonne était nommée `cotisation_amount` dans le fichier CSV téléchargeable, alors que l'import attendait `cotisation_min`. Le template CSV a été corrigé — **téléchargez un nouveau fichier modèle** si vous utilisiez l'ancien.

---

# 🔧 v2.8.5 — Mars 2026

## 🐛 SAV — Aperçu rapide des tickets bug enrichi

### Pour les administrateurs

- **L'aperçu rapide d'un ticket** (depuis le Kanban ou la Timeline) affiche désormais les
  sections "Étapes à reproduire", "Comportement courant" et "Comportement attendu" dans des
  blocs colorés distincts, au même titre que la vue détail du ticket.

- **La description n'est plus obligatoire** lors de la création ou la modification d'un ticket
  bug : il est désormais possible de renseigner uniquement les champs bug détaillés sans
  avoir à rédiger une description libre.

## 🔒 RGPD — Accès à la politique de confidentialité corrigé

### Pour tous les utilisateurs

- **La page "Politique de confidentialité"** est désormais accessible même lorsque
  le modal de consentement RGPD est en attente de validation. Auparavant, tenter
  d'y accéder depuis le modal pouvait provoquer une boucle de redirection.

---

# 🔧 v2.8.4 — Mars 2026

## 🐛 SAV — Formulaire de ticket amélioré (GLOBAL_ADMIN)

### Pour les administrateurs globaux

Plusieurs améliorations ont été apportées au formulaire SAV :

- **La description ne disparaît plus** lors de la réouverture de la modale d'édition d'un ticket.
  Ce bug affectait uniquement la 2ème ouverture et les suivantes après une première modification.

- **Champs bug détaillés** : les champs "Étapes à reproduire", "Comportement courant" et
  "Comportement attendu" sont désormais stockés et restitués séparément dans l'API.
  Lors de la consultation d'un ticket bug, ces trois sections s'affichent dans des blocs
  colorés distincts (gris / rouge / vert) pour une lecture plus claire.

- Lors de la réouverture de la modale d'édition, ces trois champs sont correctement
  pré-remplis depuis les données enregistrées.

---

# 🆕 v2.8.3 — Mars 2026

## ✏️ SAV — Modification de ticket simplifiée (GLOBAL_ADMIN)

### Pour les administrateurs globaux

Lorsque vous consultez un ticket dans le SAV, un bouton **"Modifier"** apparaît
désormais directement dans l'en-tête du ticket. En cliquant dessus, la même
modale que pour la création de ticket s'ouvre, pré-remplie avec les données
actuelles du ticket.

**Champs éditables :**
- Titre, description (éditeur riche), type, zone, priorité
- Champs spécifiques aux bugs (étapes de reproduction, comportements)
- Champs spécifiques aux évolutions (financement, échéance)
- Champs admin : colonne Kanban, monnaie associée, catégorie, date de début

> Le bloc "Modifier" qui se trouvait dans la colonne latérale de la page ticket
> a été supprimé au profit de cette modale unifiée.

---

# 🆕 v2.8.2 — Mars 2026

## 🏠 SSA — Composition du foyer en valeur décimale

### Pour les adhérents

Le champ **\"Nombre de personnes dans le foyer\"** accepte maintenant des valeurs décimales (ex : `1.3`, `2.5`). Cela permet de renseigner des compositions de foyer pondérées (par exemple, un enfant en garde alternée peut être compté pour 0.5).

> Le formulaire affiche un champ numérique avec un pas de 0.01 — vous pouvez saisir n'importe quelle valeur à partir de 1.

### Pour les administrateurs SSA

- Les **paliers de redistribution** (mode Paliers / TIERS) fonctionnent maintenant avec des tailles de foyer décimales. Un foyer de `2.5` tombera dans le palier `[2 – 3]`.
- L'**import CSV** (`foyer`) accepte désormais les valeurs décimales (`1.3`, `2.5`) en plus des entiers.
- La migration `Version20260306000000` convertit la colonne `household_size` de `INT` à `DECIMAL(5,2)` — **à appliquer en production**.

---

## ✏️ SSA — Cotisation minimum éditable directement dans la liste

### Pour les administrateurs SSA

La colonne **\"Cotisation min.\"** dans la liste des participations SSA est maintenant **éditable en un clic**, directement depuis le tableau, sans avoir à ouvrir le formulaire d'édition complet de chaque participant.

> Cette modification déclenche immédiatement la mise à jour — vérifiez la valeur saisie avant de valider.

---

# 🆕 v2.8.1 — Mars 2026

## 🔔 SSA — Emails de rappel aux anciens cotisants (correction)

Les emails de rappel automatiques envoyés aux anciens cotisants SSA fonctionnent maintenant correctement. Un bug technique empêchait leur envoi en production — il est résolu.

---

## 📥 Import CSV — Adhérents avec caisse SSA

### Pour les administrateurs

Un nouveau type d'import est disponible dans **Admin → Import** : **"Adhérent(s) avec Caisse SSA"**.

Ce format enrichi permet d'importer des adhérents en les associant directement à une caisse SSA, avec leur cotisation et leur taille de foyer.

**Format du fichier CSV :**
```
idmlc;groupe;firstname;lastname;email;phone;mobile;adresse;cpostal;ville;ecompte;cotisations;cotisation_amount;foyer;caisse_ssa
```

---

## 🗂️ Admin — Améliorations des listes de flux

### Pour les administrateurs (ROLE_ADMIN)

- La liste des flux affiche maintenant la **colonne "Moyen"** (CB, SEPA, HelloAsso…) directement dans le tableau.
- De nouveaux **filtres de type** sont disponibles : Cotisations SSA, Don, Reconversion, Vente eMLc.
- Les **cotisations SSA payées en euros** (CB, HelloAsso, SEPA) apparaissent désormais dans la vue "Flux euros".
- L'export des participations SSA inclut désormais conditionnellement la **taille du foyer** et la **cotisation recommandée** selon la configuration de la caisse.

---

## 🔒 SSA — Restriction de participation configurable

### Pour les administrateurs SSA

Il est maintenant possible de **bloquer la participation** des adhérents dont la cotisation individuelle n'a pas encore été configurée, avec un message personnalisé.

> ⚙️ Configuration : **Admin → SSA → Paramètres → onglet Cotisation → "Restreindre la participation"**

---

## 📊 SSA — Toutes les opérations SSA en un seul endroit

### Pour les adhérents

Le lien "Voir toutes les opérations SSA" du tableau de bord affiche maintenant une **page dédiée** combinant :
- Les opérations eMLc SSA (prélèvements sur achats, redistributions)
- **Les cotisations payées en euros** (CB, HelloAsso, SEPA, virement…) — qui n'apparaissaient pas auparavant

Filtres disponibles : moyen de paiement, date min/max.

---

## 💳 SSA — Cotisations visibles dans le bloc "Dernières opérations"

### Pour les adhérents

Le bloc "Dernières opérations SSA" du tableau de bord affiche maintenant aussi vos **cotisations payées en euros** (CB, HelloAsso, SEPA, virement, espèces, chèque), en plus des opérations eMLc. Toutes les entrées sont triées par date, de la plus récente à la plus ancienne.

---

# 🆕 v2.8.0 — Mars 2026

## 🌱 SSA — Montant recommandé personnalisé par participant

### Pour les adhérents

Quand votre caisse SSA est en mode **cotisation recommandée**, votre montant est maintenant **calculé individuellement** selon votre situation (décidé par les gestionnaires SSA). Vous voyez :

- Le **montant conseillé pour vous** affiché en vert
- Le **minimum accepté** (avec tolérance éventuelle) en badge orange
- Un **stepper (+/−)** pour ajuster votre participation par paliers d'1€
- Un **retour visuel en temps réel** :
  - ✅ Vert : montant au niveau du conseillé ou au-dessus — merci !
  - ⚠️ Orange : en-dessous du conseillé mais dans la tolérance
  - ❌ Rouge : en-dessous du minimum autorisé (soumission bloquée)

> 💡 Le stepper est désormais disponible pour **tous les modes de cotisation**, pas uniquement le mode recommandé.

---

### Pour les administrateurs SSA

- **Montant minimum personnalisé** : chaque participant peut avoir un montant individuel dans la liste des participations (colonne "Cotisation min."). Ce montant est prioritaire sur le minimum global de la caisse.
- **Filtre adhérent amélioré** : dans la liste des participations SSA, vous pouvez maintenant rechercher par **nom, prénom ou email** de l'adhérent.
- **Nettoyage automatique des doublons** : lors de la mise à jour, les participations SSA en doublon (même adhérent, même caisse) sont archivées automatiquement — seule la participation la plus récente et active est conservée.

---

## 🗂️ Boffice — Gestion avancée des tickets (administrateurs globaux)

### Pour les administrateurs globaux

De nouvelles actions sont disponibles dans la gestion des tickets :

- **Archiver / Désarchiver** un ticket directement depuis la liste ou la page de détail
- **Supprimer définitivement** un ticket (irréversible)
- **Supprimer une pièce jointe** attachée à un ticket
- **Formulaire d'édition complet** : modifier tous les champs d'un ticket (colonne, priorité, installation, zone géographique, catégorie, financement)
- **Filtre par installation** : dans la liste des tickets, un bouton permet d'afficher/masquer les tickets par installation

---

## ✉️ Emails — Éditeur de templates par type de transaction

### Pour les administrateurs

Un nouvel **éditeur de templates d'email par flux de transaction** est disponible dans l'interface d'administration. Il permet de personnaliser les emails envoyés lors des transactions (achats, reconversions, cotisations SSA…) avec des variables dynamiques (montant, adhérent, prestataire, date…).

---

## 🔧 Corrections et améliorations générales

- **Paiements PayZen** : les paiements sont maintenant correctement enregistrés avec leur date de création et de mise à jour pour une meilleure traçabilité.
- **Dons sans montant** : correction d'un problème qui pouvait bloquer certains dons sans montant défini lors du paiement en ligne.
- **Formulaires** : affichage d'un indicateur de chargement (spinner) lors de la soumission de formulaire pour éviter les doubles soumissions.

---

# 🆕 v2.7.0 — Février 2026

## 🔒 RGPD — Gestion des consentements

### Pour les adhérents et prestataires

Kohinos intègre désormais un **système complet de gestion des consentements RGPD**. À la première connexion après cette mise à jour, une modale s'affiche pour recueillir votre accord sur :

- La **politique de confidentialité** générale
- Le **traitement de vos données SSA** (si vous participez à une caisse)

> 💡 Vous pouvez à tout moment consulter et révoquer vos consentements depuis votre espace personnel → **Mes données / RGPD**.

#### Page politique de confidentialité
Une page publique `/gdpr/politique` est accessible sans connexion et présente la politique de confidentialité avec les coordonnées du DPO (Délégué à la Protection des Données).

---

### Pour les administrateurs (ROLE_ADMIN)

#### Tableau de bord des consentements *(SUPER_ADMIN uniquement)*
Un nouveau menu **RGPD → Consentements** affiche :
- Un **camembert** : utilisateurs actifs avec / sans consentement
- Un **tableau par type** : nombre d'utilisateurs ayant accordé chaque type de consentement (%)
- Un **tableau par utilisateur** : statut complet/manquant pour chaque personne

#### Gestion des demandes RGPD
Le menu **RGPD → Demandes** permet de gérer les demandes d'accès, rectification, effacement et portabilité des données :
- Boutons d'action rapide : **En cours** / **Terminer** / **Rejeter**
- Notes administrateur éditables en ligne
- Traçabilité complète avec journal d'audit

#### Audit des exports et impersonations
- Chaque export CSV/XLS depuis l'admin est maintenant **loggé** dans le journal d'audit
- Les changements d'utilisateur (impersonation) sont également tracés

---

## 🏦 SSA — Types de cotisation configurables

### Pour les administrateurs (ROLE_SOLIDOUME / ROLE_ADMIN)

Chaque caisse SSA peut désormais être configurée avec **4 modes de cotisation** différents :

| Mode | Description |
|------|-------------|
| **Libre** | L'adhérent saisit le montant qu'il souhaite (entre le min et le max définis) |
| **Recommandée** | Un montant conseillé est affiché. Une tolérance en % est configurable (ex : 100€ conseillé, −20% toléré → minimum 80€). L'adhérent voit le montant recommandé pré-rempli. |
| **Minimum fixe** | Un montant minimum obligatoire est imposé à tous |
| **Choix restreints** | L'adhérent choisit parmi une liste de montants prédéfinis (ex : 50€, 75€, 100€, 125€) |

> ⚙️ Configuration dans l'admin : **SSA → Paramètres → Éditer → Type de cotisation**

#### Cotisation recommandée personnalisée par participant
En mode **Recommandée**, chaque participant peut avoir un montant recommandé individuel (`minimumCotisation`).
Si ce montant n'est pas encore défini pour un adhérent, il ne peut pas cotiser et un message l'en informe.
> ⚙️ À configurer dans l'admin SSA → liste des participants → colonne "Cotisation min."

---

### Pour les adhérents (mode cotisation recommandée)

Quand votre caisse SSA est en mode **cotisation recommandée**, vous voyez :

- Une **bannière verte** avec le montant conseillé et le minimum accepté
- Un **stepper (+/−)** pour ajuster votre montant par paliers d'1€
- Un **retour visuel en temps réel** :
  - ✅ Vert : vous participez au montant recommandé ou au-delà — merci !
  - ⚠️ Orange : montant en-dessous du conseillé mais acceptable
  - ❌ Rouge : montant inférieur au minimum autorisé (soumission bloquée)

---

## 📊 SSA — Statistiques et suivi

### Pour les administrateurs SSA

Un bouton **"Statistiques"** est disponible dans la liste des caisses SSA. Il affiche :

- **Paiements journaliers** du mois courant (graphique)
- **Top prestataires** bénéficiaires des redistributions
- **Tailles de foyers** des cotisants
- **Évolution mensuelle** de l'écart entre montant payé et montant recommandé (12 mois glissants)

---

## 📥 Import CSV — Cotisations SSA

### Pour les administrateurs (ROLE_ADMIN)

Un nouveau type d'import est disponible dans **Admin → Import** : **"Cotisations SSA par email"**.

**Format du fichier CSV :**
```
email;cotisation_amount;caisse_ssa
jean.dupont@example.com;85;Caisse Grenoble
marie.martin@example.com;120;
```
- La colonne `caisse_ssa` est optionnelle (met à jour toutes les participations actives si absent)
- Un mode **test** est disponible pour vérifier sans modifier les données
- Un rapport détaillé indique les succès, erreurs et avertissements

---

## 🗺️ Cartes — Regroupement des marqueurs

### Pour tous les utilisateurs

Les cartes affichent maintenant les prestataires **regroupés par zone géographique** (clustering). Au zoom, les groupes s'éclatent pour afficher chaque marqueur individuellement.

Si le paramètre **Géolocalisation** est activé par votre administrateur, un bouton 📍 permet de centrer la carte sur votre position actuelle.

---

# v2.6.9 — Janvier 2026

## 🌐 SEO — Référencement amélioré

Votre plateforme Kohinos est maintenant mieux référencée :
- `robots.txt` et `sitemap.xml` générés automatiquement
- Données Schema.org pour les moteurs de recherche
- Meta tags Open Graph et Twitter Cards pour les partages sur réseaux sociaux
- Interface admin pour configurer logo, favicon et image de partage

---

# v2.6.8 — Janvier 2026

## ✉️ Templates email personnalisables

### Pour les administrateurs

L'éditeur de contenu des **templates d'emails** intègre désormais **CKEditor** pour une mise en forme riche (gras, listes, liens, etc.).

Les variables disponibles pour personnaliser les emails sont documentées directement dans l'interface.

---

# v2.6.7 — Janvier 2026

## 💱 SSA & Reconversions

### Pour les prestataires et administrateurs

- **Transferts SSA** : correction du remboursement eMLc prestataire → adhérent
- **Reconversions** : l'IBAN du prestataire est maintenant affiché dans la liste (trésorier/super admin)
- **Dashboard** : badge avec le nombre de reconversions en attente sur le menu
- **Graphiques** : les mois sont maintenant affichés dans l'ordre chronologique (janvier → décembre)

---

# v2.6.6 — Janvier 2026

## 📅 SSA — Redistribution sur mois glissant

La redistribution SSA prend maintenant en compte les **30 derniers jours** (exemple : du 8 décembre au 8 janvier) plutôt que le mois calendaire strict. Cela évite les exclusions injustes pour les adhérents qui cotisent en milieu de mois.

---

# v2.6.4 — Décembre 2025

## 📧 Historique et gestion des emails

### Pour les administrateurs (ROLE_ADMIN)

Un nouveau module **Emails** est disponible dans l'admin :

#### Historique des emails
- Consultez tous les emails envoyés : filtres par type, destinataire, date, statut
- Vue détaillée avec le contenu complet et le contexte
- Export CSV/XLS
- Graphiques de statistiques (emails/jour, par type, taux de succès)

#### Éditeur de templates
- Personnalisez les templates d'emails avec un éditeur visuel
- Aperçu en temps réel
- Possibilité de réinitialiser vers le template par défaut
- Documentation des variables disponibles (prénom, montant, date, etc.)

#### Archivage automatique
Une commande planifiable (`app:email:archive-old-logs`) supprime automatiquement les logs de plus de 6 mois pour garder la base de données légère.

---

# v2.6.3 — Décembre 2025

## ✅ Validations anti-doublons SEPA

Il n'est plus possible de créer accidentellement deux cotisations MLC actives ou deux achats récurrents actifs pour le même adhérent ou prestataire. Un message d'erreur clair s'affiche en cas de tentative.

## 💬 Informations claires sur les paiements SSA uniques

Pour les adhérents qui ont payé leur cotisation SSA en **paiement unique** (non récurrent) :
- Un badge bleu **"Paiement unique effectué"** confirme clairement le statut
- La date et l'heure exactes du paiement sont affichées
- Si aucun paiement ce mois-ci, une alerte orange rappelle d'effectuer le paiement

---

# v2.6.1 — Décembre 2025

## 📅 SEPA — Jours de prélèvement fixes

### Pour les administrateurs

Il est maintenant possible de **fixer le jour de prélèvement** pour :
- Tous les achats récurrents MLC (paramètre global)
- Par caisse SSA spécifiquement

Quand un jour fixe est configuré, les adhérents voient un message informatif (ils ne peuvent plus modifier le jour eux-mêmes).

### Priorité des valeurs
> Configuration système → Choix utilisateur → Valeur par défaut

---

# v2.6.0 — Décembre 2025

## 💳 Cotisation obligatoire

### Pour les administrateurs

Deux nouveaux paramètres permettent de **bloquer les transactions** pour les adhérents ou prestataires dont la cotisation n'est plus valide :
- "Cotisation obligatoire adhérents"
- "Cotisation obligatoire prestataires"

## 📬 Notifications email SEPA

Les adhérents reçoivent maintenant un **email de confirmation** quand le trésorier :
- Valide leur demande d'achat récurrent de monnaie
- Approuve une modification de leur achat récurrent

---

# v2.5.9 — Décembre 2025

## 🔔 SSA — Alertes pour anciens cotisants

Les adhérents qui ont **arrêté de cotiser** à une caisse SSA mais qui ont reçu une redistribution le mois dernier reçoivent maintenant un **email de rappel** automatique avant la prochaine redistribution.

### Pour les administrateurs SSA

- Configurez le **délai d'envoi** (ex : 5 jours avant la redistribution)
- Rédigez le **contenu de l'email** avec un éditeur riche (CKEditor)
- Interface dans l'admin SSA → onglet "Emails"

---

# v2.5.8 — Novembre 2025

## 🏦 SEPA — Prestataires & révocations

### Pour les prestataires

Les prestataires peuvent maintenant créer des **achats mensuels récurrents** en eMLc via SEPA.

### Pour les administrateurs

- Nouveau statut **"Révoqué"** sur les demandes SEPA (distinct de "Annulé") — badge 🚫 dans l'interface
- La révocation d'un mandat SEPA révoque automatiquement toutes les demandes associées
- **Formulaires simplifiés** : suppression du champ "raison" dans les modifications (seulement montant + jour)
- Notifications email automatiques pour les révocations et approbations de modification

---

# v2.5.7 — Novembre 2025

## 💳 Améliorations paiements

- **Formulaires SEPA** : pré-remplissage automatique de l'IBAN, BIC et nom depuis le dernier mandat
- **HelloAsso admin** : bouton de suppression sécurisée (uniquement si aucun flux généré)
- **Bloc SEPA prestataire** : affichage synthèse de l'achat mensuel récurrent avec statut et dernier prélèvement

---

# v2.5.6 — Novembre 2025

## 🏦 Interface SEPA complète côté adhérent

Les adhérents disposent maintenant d'une interface complète dans leur espace personnel pour gérer :
- Leurs **mandats SEPA actifs**
- Leur **cotisation MLC récurrente**
- Leurs **cotisations SSA SEPA**

Un badge indique le nombre de mandats en attente de validation.

---

# v2.5.3 — Octobre 2025

## 🏦 SEPA — Prélèvement automatique

### Pour les adhérents

Un bouton **"Mettre en place un prélèvement automatique"** est disponible sur la page de cotisation. Il permet de créer un mandat SEPA pour automatiser vos cotisations MLC annuelles et/ou vos achats mensuels de monnaie locale.

Vous pouvez **télécharger votre mandat SEPA** en PDF ou l'imprimer depuis votre espace.

---

# v2.4.19 — Septembre 2025

## 🍃 SSA — Refactoring et nouveaux modes de redistribution

### Pour les administrateurs SSA

3 modes de redistribution sont maintenant disponibles :
- **Calculé** (`CALCULATED`) : montant calculé proportionnellement
- **Fixe** (`FIXED`) : même montant pour tous
- **Paliers** (`TIERS`) : montants par tranche de taille de foyer

### Taille du foyer

Les adhérents sont invités à renseigner leur **taille de foyer** — cette information est utilisée par le mode de redistribution en paliers.

---

# v2.4.18 — Septembre 2025

## 📧 SSA — Email post-redistribution

Un email de bilan est automatiquement envoyé aux adhérents après chaque redistribution SSA.

---

# v2.4.16 — Juin 2025

## 📊 Tableau de bord admin — Statistiques

Le tableau de bord administrateur affiche maintenant des **graphiques interactifs** :
- Nombre d'adhérents, prestataires, comptoirs, groupes
- Statistiques détaillées par type d'entité

## 🗺️ Horaires et informations comptoir

Les horaires d'ouverture des comptoirs sont maintenant affichés sur la carte et dans les listes.
