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).
61 lines
2.0 KiB
TypeScript
61 lines
2.0 KiB
TypeScript
import { type SchemaRules } from '@adonisjs/lucid/types/schema_generator'
|
|
|
|
/**
|
|
* Override de types pour les colonnes que Lucid n'arrive pas à inférer
|
|
* depuis l'introspection PG (ex. ENUMs natifs et jsonb → tapés `any`).
|
|
*/
|
|
export default {
|
|
tables: {
|
|
plan_steps: {
|
|
columns: {
|
|
tone: {
|
|
tsType: "'amical' | 'courtois' | 'ferme' | 'mise_en_demeure'",
|
|
},
|
|
},
|
|
},
|
|
invoices: {
|
|
columns: {
|
|
status: {
|
|
tsType:
|
|
"'pending' | 'awaiting_user_confirmation' | 'in_relance' | 'paid' | 'litigation' | 'cancelled'",
|
|
},
|
|
},
|
|
},
|
|
activity_events: {
|
|
columns: {
|
|
kind: {
|
|
tsType:
|
|
"'relance_sent' | 'invoice_paid' | 'invoice_imported' | 'warning_drafted'",
|
|
},
|
|
meta: {
|
|
tsType:
|
|
"{ invoiceId?: string; clientId?: string; planStepOrder?: number; [k: string]: unknown }",
|
|
},
|
|
},
|
|
},
|
|
import_drafts: {
|
|
columns: {
|
|
status: {
|
|
tsType: "'pending' | 'validated' | 'skipped'",
|
|
},
|
|
// jsonb des champs extraits par l'OCR. La forme est garantie par
|
|
// le validator Vine côté entrée et par le service côté seed.
|
|
extracted: {
|
|
tsType:
|
|
"{ clientId: string | null; clientName: string; clientEmail: string | null; numero: string; amountTtcCents: number; issueDate: string; dueDate: string; planId: string | null }",
|
|
},
|
|
edited: {
|
|
tsType:
|
|
"{ clientId: string | null; clientName: string; clientEmail: string | null; numero: string; amountTtcCents: number; issueDate: string; dueDate: string; planId: string | null }",
|
|
},
|
|
// Confiance par champ — 0..1. Partial parce que l'OCR n'a pas
|
|
// toujours toutes les confiances.
|
|
confidence: {
|
|
tsType:
|
|
"Partial<{ clientId: number; clientName: number; clientEmail: number; numero: number; amountTtcCents: number; issueDate: number; dueDate: number; planId: number }>",
|
|
},
|
|
},
|
|
},
|
|
},
|
|
} satisfies SchemaRules
|