Voir où part l'argent par catégorie

# Dépenses par catégorie de dépense

## Pourquoi ce skill existe

`spendesk_analyze_spend` n'a **pas de dimension « catégorie »** dans `groupBy`. Les catégories de dépenses sortent sous `analyticalCode`, mélangées aux valeurs des champs analytiques personnalisés (région, projet…). Sans tri, le tableau est faux. Ce skill isole les catégories.

## Étape 1 — Récupérer les catégories

```json
{ "tool": "get_expense_categories", "params": {} }
```

Renvoie `id`, `name`, `isArchived`. Garder la liste des `id` : elle sert à filtrer l'étape 2.

- Les catégories archivées sont incluses : les garder pour l'historique, en les signalant.
- Ce sont des libellés destinés aux collaborateurs, **pas des comptes comptables** : ne pas les présenter comme des codes GL (pour cela, `get_chart_of_accounts`).
- `costCenters: []` signifie que la catégorie s'applique à tous les centres de coûts, pas à aucun.

## Étape 2 — Analyser et ne garder que les lignes de catégories

```json
{
  "tool": "spendesk_analyze_spend",
  "params": {
    "fromDate": "YYYY-MM-DD",
    "toDate": "YYYY-MM-DD",
    "groupBy": ["analyticalCode", "month"],
    "limit": 50
  }
}
```

Dans la réponse, **ne garder que les lignes dont `id` figure parmi les identifiants de catégories** de l'étape 1. Les autres lignes sont des valeurs d'autres champs analytiques : les ignorer.

- `analyticalCode` en premier dans `groupBy`, `limit` à 50 pour éviter qu'une catégorie tombe dans « Others ».
- Annoncer les dates exactes utilisées. Période maximale : 366 jours.
- Ne pas reprendre `share` : il est calculé sur toutes les lignes, autres champs compris. Recalculer chaque part sur `summary.totalAmount`.

## Étape 3 — Contrôle de cohérence

Additionner les lignes de catégories et comparer à `summary.totalAmount` :

- **Égal** : toutes les dépenses ont une catégorie. Vérifié en direct sur 12 mois : IT & Technical fees EUR 87 235,36 + Announcements & Ads EUR 25 984,90 + Travel & Expense EUR 500,00 = EUR 113 720,26, soit exactement le total.
- **Inférieur** : l'écart est la dépense **sans catégorie**. La présenter sur une ligne « Non catégorisé ».
- **Supérieur** : cela ne devrait pas arriver, puisque chaque ligne ne porte que les montants de sa catégorie. Vérifier qu'aucune ligne étrangère aux catégories n'a été gardée ; si l'écart persiste, le signaler plutôt que de forcer le total.

## Étape 4 — Lire l'évolution

Le niveau `month` sous chaque catégorie donne la série mensuelle. Pour repérer ce qui accélère :

- comparer le dernier mois à la moyenne des mois précédents de la même catégorie ;
- signaler une catégorie concentrée sur un seul mois (sur le compte démo, 94 % de « IT & Technical fees » tombait en juillet) : c'est un effet ponctuel, pas une tendance.

`compareWithPreviousPeriod` compare à la fenêtre de même durée juste avant, pas au mois ou au trimestre calendaire précédent : lire `summary.previousPeriod.period` et l'afficher tel quel.

## Format de sortie recommandé

```
Dépenses par catégorie — du <date> au <date>
Total : X EUR — catégorisé : Y EUR — non catégorisé : Z EUR

| Catégorie | Montant | Part du total | Nb de dépenses | Mois le plus élevé | Tendance |
```

Montants en devise fonctionnelle, TTC, à la date du document. Les avoirs sont inclus et viennent en déduction. Le MCP ne lit pas les budgets : pour un écart au budget par catégorie, l'utilisateur fournit les chiffres.

## Exemples de prompts utilisateur

- "Où part l'argent par catégorie de dépense sur les 12 derniers mois ?"
- "Quelles catégories de dépenses ont le plus augmenté ce trimestre ?"
- "Quelle part de nos dépenses n'a pas de catégorie ?"