## Fonctionnalités principales
### 1. 📋 Déclaration d'un avoir depuis la page Achats
Depuis la liste des achats, chaque ligne non-avoir affiche un bouton 🏷️ qui ouvre un modal de déclaration directement pré-rempli avec le fournisseur et les montants de l'achat source.
- Fournisseur pré-rempli (lecture seule)
- Description libre de l'avoir (ex. : *Produit non conforme — salade iceberg*)
- Sélection du taux de TVA (20 %, 10 %, 5,5 %, 2,1 %, 0 %) avec recalcul automatique HT ↔ TTC
- Montants HT et TTC modifiables indépendamment avec recalcul croisé
- Champ Notes optionnel (raison du retour, numéro de bon de livraison…)
- L'avoir est créé en statut **En attente** : aucun impact financier immédiat
- Lien direct vers la page Avoirs pour application ultérieure
### 2. 📂 Page dédiée Avoirs — gestion du cycle de vie
La page **/avoirs** liste tous les avoirs avec leur statut et permet de les gérer.
- Affichage séparé : **En attente** (modifiables, applicables) et **Appliqués** (lecture seule, archivés)
- Informations visibles : fournisseur, description, montant HT, montant TTC, taux TVA, date de création, notes, achat source lié
- **Application** : transforme l'avoir en attente en ligne négative dans les achats du mois courant
- **Suppression** : possible uniquement sur les avoirs en attente (avant application)
- Accès complet aux rôles admin, gestionnaire et cuisinier ; consultation seule pour le rôle lecteur
### 3. 💸 Application de l'avoir — ligne négative dans les achats
Lorsqu'un avoir est appliqué depuis la page Avoirs :
- L'avoir passe en statut **Appliqué** avec référence à l'achat
- La ligne avoir est **non convertible en stock**
### 4. 📊 Affichage dans la page Achats — section séparée
Les lignes d'avoir n'apparaissent **pas** dans le tableau principal des achats (pas de checkbox, pas de conversion en stock). Elles sont affichées dans une **section dédiée** sous le tableau principal :
- Carte avec bordure orange, titre *Avoirs appliqués ce mois*
- Tableau lecture seule : date, fournisseur, description, montant HT (rouge), montant TTC (rouge)
- Ligne **Total avoirs** en rouge
- Ligne **Net achats (après avoirs)** en vert = Total achats − Total avoirs
### 5. 📈 Impact sur la synthèse financière mensuelle et annuelle
Les avoirs appliqués sont automatiquement intégrés dans tous les indicateurs financiers :
**Mensuel :**
- `total_achats` = somme des achats hors lignes avoir
- `total_avoirs` = somme des montants absolus des lignes avoir
- `achats_nets = total_achats − total_cessions − total_avoirs`
- `achats_consommés = achats_nets + stock_début − stock_fin`
- La carte synthèse mensuelle affiche les avoirs déduits en orange avec flèche descendante
- Tous les ratios (coût matière/couvert, taux de coût matière) sont calculés sur `achats_consommés`
**Annuel (tableau récapitulatif) :**
- Colonne **Avoirs** dédiée (fond orange) sur chaque mois et sur la ligne Total Année
- `achats_consommés_annuel = (total_achats − total_cessions − total_avoirs) + stock_début − stock_fin`
- Résultat d'exploitation et résultat complet reflètent les avoirs sur l'année entière
## Cas d'usage typiques
- **Retour de marchandise non conforme** : livraison de légumes abîmés, le fournisseur émet un avoir partiel → déclaré et appliqué le jour même
- **Erreur de facturation** : doublon ou quantité facturée supérieure à la livraison → avoir pour le delta
- **Remise commerciale ponctuelle** : négociation en fin de mois, le fournisseur accorde un avoir global → tracé en une ligne
- **Produit manquant** : article absent de la livraison mais facturé → avoir pour la valeur de l'article
- **Avoir sur bon de commande** : le fournisseur rembourse partiellement une commande passée via le module Commandes
## Points forts exclusifs
✅ **Déclaration en un clic** : depuis la ligne d'achat concernée, sans ressaisie du fournisseur ni des montants
✅ **Cycle de vie traçable** : statut En attente → Appliqué avec horodatage et référence double (achat source + achat application)
✅ **Isolation totale** : les lignes avoir ne polluent jamais la liste principale des achats ni la conversion en stock
✅ **Impact financier automatique** : dès l'application, la synthèse reflète les achats nets sans aucune intervention manuelle
✅ **Double déduction** : les avoirs sont déduits à la fois de `total_achats` (trésorerie) et de `achats_consommés` (performance réelle)