Solde wallet et allocations cartes

# Instructions — Solde wallet et allocations cartes

## Format des montants : list_cards.availableBalance

Tous les tools MCP utilisent la convention `{ amount: int, precision }` où la valeur = `amount / 10^precision`.

**`list_cards` suit la même convention** — `availableBalance.amount` est un coefficient entier, avec `formatted` prêt à afficher :
```json
// list_cards — coefficient entier standard :
"availableBalance": { "amount": 9138, "currency": "EUR", "precision": 2, "formatted": "EUR 91.38" }
→ balance = 9 138 / 100 = 91,38 EUR

// get_wallet_summary — coefficient entier standard :
"totalAmount": { "amount": 33224769, "currency": "EUR", "precision": 2 }
→ balance = 33 224 769 / 100 = 332 247,69 EUR
```

→ Pour les balances de cartes, afficher `availableBalance.formatted` (ou calculer `amount / 10^precision`).

## ⚠️ Wallet disponible peut être négatif

`totalAvailableAmount` peut être **négatif** sur les comptes démo ou en cas de dépassement de virements programmés. C'est un état valide — interpréter comme "les allocations dépassent le solde actuel".

## ⚠️ allocatedOnCards ≠ somme des availableBalance des cartes actives

Ces deux métriques mesurent des choses différentes :
- `allocatedOnCards.totalAllocatedAmount` = montant réservé dans le wallet pour les cartes (limites de dépense réservées)
- `sum(card.availableBalance)` = montant résiduel que les titulaires peuvent encore dépenser

La différence = montant déjà consommé sur les cartes. Ce n'est **pas** une incohérence — c'est attendu.

## Étape 1 — Wallet snapshot (get_wallet_summary)

```json
{ "companyId": "..." }
```

Champs clés (tous en devise fonctionnelle) :
- `totalAmount` → solde brut du wallet (coefficient entier)
- `totalAvailableAmount` → disponible après toutes allocations (peut être négatif)
- `totalAllocatedAmount` = `allocatedOnCards.totalAllocatedAmount` + `scheduledTransfersAmount.totalScheduledTransferAmount`
- `allocatedOnCards.subscriptionAmount` → réservé sur cartes subscription
- `allocatedOnCards.physicalAmount` → réservé sur cartes physiques
- `allocatedOnCards.singlePurchaseAmount` → réservé sur cartes single-purchase
- `scheduledTransfersAmount.scheduledInvoicesAmount` → virements fournisseurs programmés

## Étape 2 — Cartes actives (list_cards)

```json
{ "companyId": "...", "status": "ACT", "pageSize": 100 }
```

Pour chaque carte active :
- `availableBalance` → solde disponible au format monétaire standard (afficher `formatted`, ou `amount / 10^precision`)
- `spendingLimit` → limite de dépense (peut être null pour les subscriptions sans limite fixe)
- `type` : libellé lisible ("Subscription card", "Physical card", "Single purchase card", "Multi-use card") ; les slugs `subscription | physical | single_purchase | multi_use` ne servent qu'au filtre d'entrée `type`
- `currency` → devise de la carte, toujours celle de l'entreprise ; seuls `request.amount` et `subscriptionBudget` peuvent être dans une autre devise (celle déclarée à la demande)

⚠️ Ne pas sommer des cartes en devises différentes.

## Étape 3 — Interpréter les résultats

Présenter comme suit :

```
Wallet SPENDESK (EUR) au 2026-07-06 :
  Solde total      : 332 247,69 EUR
  Disponible       : -511 590,51 EUR  ⚠️ (allocations > solde)
  Alloué cartes    : 491 808,95 EUR
    dont subscription : 402 288,42 EUR
    dont physiques    :  28 872,30 EUR
    dont single-use   :   4 601,63 EUR
  Virements programmés : 352 029,25 EUR

Cartes actives (ACT) : 2 cartes
  Subscription #7071 : 91,38 EUR disponible
  Subscription #5947 :  9,49 EUR disponible
```

## Exemple live (données réelles)

| Métrique | Valeur |
|----------|--------|
| Solde total | 332 247,69 EUR |
| Disponible | **-511 590,51 EUR** (négatif — test) |
| Alloué cartes | 491 808,95 EUR |
| Virements programmés | 352 029,25 EUR |
| Cartes ACT | 2 (subscriptions uniquement, ~101 EUR disponible) |

## Exemple de prompt

- "Quel est l'état du wallet ?" → get_wallet_summary uniquement
- "Combien reste-t-il sur les cartes actives ?" → list_cards status=ACT + sum availableBalance
- "Y a-t-il des virements programmés en attente ?" → wallet_summary.scheduledTransfersAmount