> ## Documentation Index
> Fetch the complete documentation index at: https://api-documentation.kare-app.fr/llms.txt
> Use this file to discover all available pages before exploring further.

# Coût - budget

**Besoin** : ajouter un suivi des couts.\
Il faut ajouter par dessus la gestion de budget.

[https://claude.ai/code/artifact/daf5a61f-42e7-404c-b0fa-5bd833dde28f](https://claude.ai/code/artifact/daf5a61f-42e7-404c-b0fa-5bd833dde28f)

[https://claude.ai/code/artifact/daf5a61f-42e7-404c-b0fa-5bd833dde28f](https://claude.ai/code/artifact/daf5a61f-42e7-404c-b0fa-5bd833dde28f)

un budget = un début et une fin, un montant\
les budgets ne se mélangent pas, ils sont indépendants\
un budget est relié à un site (ou à l'organisation)

une costline, doit forcément définir le budget qui est relié\
elle peut être soit en engagé (devis), ou facturé\
une costline est un montant

**Estimé vs réel**. C'est la distinction structurante : le devis donne un coût estimé, la facture (ou la saisie à la clôture) donne le réel.

Équipements : on n'y attache pas de coûts, on les dérive (somme des interventions liées via EquipmentIntervention). En revanche on y ajoute deux valeurs de référence saisies : prix d'achat et/ou valeur de remplacement. C'est le couple "coût de maintenance cumulé vs valeur à neuf" qui débloque la décision réparer/remplacer.

Travaux (BuildingWork) : oui, clairement, un chantier a un montant, souvent le plus gros du site.

Contrats → a un cout.

**Réalisé ne suffit pas** — il faut l'engagé. Si le budget ne descend qu'à la facture, le gestionnaire est aveugle : en novembre il croit avoir de la marge alors que trois devis acceptés vont tomber. Le trio classique : budgété / engagé / réalisé. Et la bonne nouvelle, c'est que notre modèle donne l'engagé gratuitement : devis accepté ou intervention planifiée avec coût estimé = engagé ; intervention validée avec coût réel = réalisé. La jauge à afficher : **réalisé + engagé (devis) vs budget**.

**Les budgets se succèdent, ils ne continuent pas.** « Exercice 2026 » et « Exercice 2027 » sont deux enveloppes distinctes. Ce qui n'est pas dépensé fin 2026 ne bascule pas tout seul en 2027 — le report est une décision de gestion du client, pas un automatisme.

Un budget n'est pas une étiquette « 2026 ». C'est une enveloppe **valable entre deux dates** : `startAt → endAt`. Pour la plupart des clients ce sera l'année civile (1<sup>er</sup> janvier → 31 décembre), mais pas pour tous : une école budgète de septembre à août, certaines collectivités ont un exercice décalé. En stockant deux dates plutôt qu'une année, les deux cas coûtent le même code.

\+ purchasePrice?       prix d'achat HT        (saisi)

\+ replacementValue?    valeur à neuf HT       (saisi)

RÉALISÉ  = Σ CostLine(actual)                              │

│  ENGAGÉ   = Σ CostLine(estimated) des interventions/travaux │

│             non clos  +  contrats au prorata de l'exercice

**Technique**: faire une table cout, et relier les éléments concernés.

### Questions

Est ce que le suivi des couts doit être seulement pour les interventions ? ou pour d'autres actions ?

1. « Combien me coûte la maintenance de mon établissement ? » — le gestionnaire n'a aujourd'hui aucune trace d'argent dans l'outil

2. « Où en est mon enveloppe ? » — éviter le dépassement découvert en fin d'année. Besoin : voir en permanence ce qui est déjà dépensé et ce qui est engagé (devis acceptés, interventions planifiées) face au budget.

3. « J'ai plus d'anomalies que de budget : lesquelles je corrige ? » — l'arbitrage économique des corrections. Besoin : rapprocher le tableau d'anomalies du budget restant via les devis de correction.

4. « Je répare encore ou je remplace ? » — décision récurrente sur les équipements vieillissants. Besoin : l'historique de coûts curatifs d'un équipement face à sa valeur à neuf.

5. « Mon contrat vaut-il son prix ? » — évaluer un prestataire au renouvellement. Besoin : montant du contrat face aux interventions réellement effectuées, et écarts devis/facture par prestataire.

6. « Je dois justifier mes dépenses à ma direction » — pour nos clients multi-établissements (grande distribution, collectivités), consolider le réel vs budget par site et remonter un reporting.

7. « Où est passé ce devis ? » — la traçabilité devis → facture rattachée à l'intervention concernée

### Fonctionnalités

**Sur l'intervention et les travaux**

* Saisie de coûts (estimé / réel, typés prestation-pièces-déplacement) sur une intervention ou un chantier, avec le document justificatif rattaché.
* Devis rattaché à l'intervention avec cycle de vie proposé / accepté / refusé (v1.1) — et plus tard, dépôt du devis par le prestataire lui-même via le portail existant.
* Mention « couverte par contrat » sur les interventions préventives concernées.

**Sur le contrat**

* Montant contractuel sur chaque période de contrat, et vue « ce que le contrat couvre vs ce qu'il coûte ».

**Nouveau module Budgets**

* Création d'enveloppes par établissement et par exercice (dates libres), éventuellement par catégorie (préventif / correctif / travaux / formations).
* Jauge de consommation « réalisé + engagé » en temps réel, jamais décrémentée à la main.
* Alertes de seuil (80 %, 100 %) dans le système de notifications existant.

**Sur les anomalies**

* Colonne « coût de correction » (dérivée du devis de l'intervention liée) dans le tableau d'anomalies → tri et arbitrage par coût.
* Indicateur « coût de mise en conformité » d'un site : la somme chiffrée de ce qui reste à corriger. C'est la fonctionnalité la plus « nous » du lot.

**Sur l'équipement**

* Valeurs de référence (prix d'achat, valeur à neuf) sur la fiche.
* Historique des coûts de l'équipement et indicateur réparer/remplacer.

c'est dans la table costline, qu'on choisi le budget dans lequel on pioche.

le budget, on le défini au niveau de l'arborescence conformité ou patrimoniale ?

***

### Besoins (à valider)

* Estimer le coût du **préventif récurrent** (interventions générées par les règles × périodicité).
* Estimer le coût du **correctif** (levée des non-conformités / prescriptions, travaux prescrits).
* Une vue **budget prévisionnel** par site / établissement (consolidation organisation ?).
* Relier **conformité ↔ budget** : « atteindre la conformité = X € de travaux à engager ».
* Suivre le **réalisé vs prévu**.
