add pending path

Signed-off-by: GnomeZworc <nicolas.boufidjeline@g3e.fr>
This commit is contained in:
GnomeZworc 2026-06-14 22:29:35 +02:00
commit 8a11a1d5ea
Signed by: nicolas.boufideline
GPG key ID: 4406BBBF8845D632

View file

@ -477,6 +477,29 @@ Liste les positions détaillées (par instrument) du compte jour par jour.
---
### `GET /snapshots/pending`
Liste tous les comptes de l'owner ayant une invalidation en attente (i.e. snapshots non à jour suite à une mutation de transaction).
Utile pour savoir quels comptes doivent être recalculés avant de consulter leurs snapshots, ou pour déclencher un `recompute` ciblé.
**Réponse `200`** — liste vide si tout est à jour
```json
[
{ "account_id": 1, "recompute_from": "2026-06-10" },
{ "account_id": 3, "recompute_from": "2026-05-01" }
]
```
| Champ | Description |
|---|---|
| `account_id` | Identifiant du compte à recalculer |
| `recompute_from` | Date la plus ancienne depuis laquelle les snapshots sont invalides |
> Les invalidations sont insérées automatiquement à chaque create / update / delete / validate de transaction. Le job `daily-snapshot` les consomme toutes les 24h ; cet endpoint permet de les inspecter sans attendre.
---
### `POST /accounts/{id}/snapshots/recompute`
Recalcule immédiatement les snapshots d'un compte depuis sa **date d'invalidation** jusqu'à `today + horizon`.