704f472729
Migration activity_events (uuid id, organization_id FK CASCADE, kind ENUM PG natif relance_sent/invoice_paid/invoice_imported/warning_drafted, at, label HTML léger, meta jsonb). Append-only — pas de mutation. Index (org, at).
Schema rules : kind typé en union + meta typé { invoiceId?, clientId?, planStepOrder? }.
Service activity_recorder.ts : recordActivity({orgId, kind, label, meta, trx?}). Branché dans :
- InvoicesController.markPaid → invoice_paid
- ImportBatchesController.validateDraft → invoice_imported
À venir : SendRelanceJob (relance_sent + warning_drafted) quand BullMQ sera là.
Service dashboard.ts :
- computeKpis(orgId) : 1 requête FILTER pour les counts par status + 1 requête pour les sommes paid this month / prev month / DSO. miseEnDemeurePending=0 et percentile=undefined V1 (placeholders honnêtes plutôt que faux chiffres).
- topLatePayers(orgId, 5) : INNER JOIN clients + agrégation count() par client_id, due_date < today + status actif.
Controller DashboardController :
- GET /dashboard/kpis : computeKpis
- GET /dashboard/activity : 20 derniers events de l'org, plus récent en tête
- GET /dashboard/top-late : top 5
Routes /api/v1/dashboard/* (auth requise).
Bruno : nouveau dossier 07-Dashboard avec 3 requêtes documentées.
Pour générer du contenu activity feed : encaisser une facture (Invoices → Mark paid) ou valider un draft (Imports → Validate). KPIs : créer des factures puis les marquer payées (paidAt rentre dans les sommes).
49 lines
1.0 KiB
Plaintext
49 lines
1.0 KiB
Plaintext
meta {
|
|
name: 02 Activity
|
|
type: http
|
|
seq: 2
|
|
}
|
|
|
|
get {
|
|
url: {{baseUrl}}/api/v1/dashboard/activity
|
|
body: none
|
|
auth: inherit
|
|
}
|
|
|
|
tests {
|
|
test("200 OK", function () {
|
|
expect(res.getStatus()).to.equal(200);
|
|
});
|
|
test("data is array", function () {
|
|
expect(res.getBody().data).to.be.an("array");
|
|
});
|
|
}
|
|
|
|
docs {
|
|
GET /api/v1/dashboard/activity
|
|
|
|
Journal d'activité — append-only, 20 derniers events de l'org, plus
|
|
récent en tête.
|
|
|
|
Kinds émis :
|
|
- `invoice_paid` (Invoices → Mark paid)
|
|
- `invoice_imported` (Imports → Validate draft)
|
|
- `relance_sent` (à venir, SendRelanceJob)
|
|
- `warning_drafted` (à venir, mise en demeure)
|
|
|
|
Chaque event a :
|
|
```json
|
|
{
|
|
"id": "<uuid>",
|
|
"kind": "...",
|
|
"at": "ISO 8601",
|
|
"label": "Texte HTML léger (<b> autorisé pour les noms d'entité)",
|
|
"meta": { "invoiceId": "...", "clientId": "..." }
|
|
}
|
|
```
|
|
|
|
Pour générer des events : encaisse une facture (Invoices → 06 Mark paid)
|
|
ou valide un draft d'import (Imports → 03 Validate draft) puis re-call
|
|
cette route.
|
|
}
|