Comparer la dépense par personne entre équipes

# Dépenses par collaborateur

## But

Comparer les équipes sur leur dépense par personne, et repérer celles qui s'écartent nettement de la moyenne.

## La limite qui structure ce skill

**Le MCP ne connaît pas les effectifs par équipe.** `get_users` renvoie le nom et l'email de chaque utilisateur, mais ni son centre de coûts, ni son équipe, ni son rôle. Il est donc impossible de compter les personnes d'un centre de coûts.

Deux façons de faire, à annoncer à l'utilisateur :

- **A. Avec vos effectifs** — l'utilisateur fournit le nombre de personnes par centre de coûts. C'est la seule façon d'obtenir une vraie dépense par tête.
- **B. Par personne ayant dépensé** — sans effectifs, on rapporte la dépense au nombre de collaborateurs qui ont eu au moins une dépense. Ce n'est pas un effectif : une équipe de 30 où 4 personnes dépensent sera divisée par 4.

Demander les effectifs avant de choisir B.

## Étape 1 — Dépenses par centre de coûts et par collaborateur

Annoncer la période exacte.

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

- Chaque ligne de centre de coûts donne son montant ; son `breakdown` liste les collaborateurs qui y ont dépensé.
- `limit: 50` : par défaut, seules 10 lignes sont renvoyées par niveau, le reste part dans « Others ». Si une ligne « Others » subsiste au niveau des collaborateurs, le nombre de personnes ayant dépensé est sous-estimé : le dire.
- La dimension `employee` rattache une dépense à la personne qui l'a engagée. Les factures fournisseurs n'ont pas toujours de collaborateur : elles peuvent apparaître sans nom.
- Avoirs inclus, en déduction.

## Étape 2 — Calculer

- Méthode A : dépense du centre ÷ effectif fourni.
- Méthode B : dépense du centre ÷ nombre de lignes du `breakdown` (hors « Others »).

Puis la moyenne générale et, pour chaque centre, son rapport à cette moyenne :

- 🔴 plus de 2 fois la moyenne
- 🟡 1,5 à 2 fois
- 🟢 0,5 à 1,5 fois
- ⚪ moins de 0,5 fois

## Étape 3 — Expliquer un écart

Pour un centre qui ressort, détailler par fournisseur :

```json
{
  "tool": "spendesk_analyze_spend",
  "params": {
    "fromDate": "YYYY-MM-DD", "toDate": "YYYY-MM-DD",
    "groupBy": ["costCenter", "supplier"], "limit": 50,
    "filters": { "costCenterIds": ["<id du centre>"] }
  }
}
```

Avec ce filtre, garder `costCenter` en premier et lire le `breakdown` de la ligne du centre : `summary.totalAmount` compte les dépenses concernées en entier, y compris leurs lignes sur d'autres centres.

## Rapport

```
Dépenses par collaborateur — du <date> au <date>
Méthode : effectifs fournis / personnes ayant dépensé

| Centre de coûts | Dépenses | Personnes | Par personne | vs moyenne |

Écarts à regarder : centre, principal fournisseur, montant
```

## Limites à dire

- Avec la méthode B, le dénominateur n'est pas un effectif : ne pas présenter le résultat comme une « dépense par salarié ».
- Certaines équipes dépensent plus par nature (commerce terrain, événementiel).
- Montants en devise fonctionnelle, TTC, à la date du document.

## Résultat observé (compte démo, 5 octobre 2026)

`get_users` a renvoyé pour chaque utilisateur son identifiant, son nom et son email, sans centre de coûts ni équipe : le comptage d'effectifs par équipe que faisait l'ancienne version de ce skill n'est pas possible.

## Exemples de prompts
- "Voici nos effectifs par équipe : quelle est la dépense par personne ce trimestre ?"
- "Quelles équipes dépensent le plus par personne ayant dépensé ?"
- "Qu'est-ce qui explique le niveau de dépense de l'équipe Marketing ?"