KPIs Dashboard — Comment ils sont calculés

🏗️ Architecture des endpoints

Le dashboard lettrage appelle deux endpoints distincts selon la situation. Chaque endpoint a ses propres règles de filtrage — ce n'est pas le même code que la page traitement.

🔧 Filtres construits par endpoint

Page traitement — getLignes()

// Filtre par défaut TOUJOURS appliqué côté page traitement :
where.statutLettrage = { notIn: ['exclue'] }

// Filtres optionnels (si passés) :
if (entite) → résolution via LettrageBank → banque: { in: [...] }
if (sens)   → sens: params.sens
if (anneeFiltre) → dateOperation: { gte: 2024-01-01, lt: 2025-01-01 }
if (dateDebut/dateFin) → dateOperation: { gte, lte }
// + filtre 'traite', 'nonLettrable', etc.

getDashboardStats() — Dashboard avec filtres

// Pas de filtre statutLettrage par défaut !
// baseWhere est construit ainsi :
const baseWhere: any = {};
if (banqueFilter) baseWhere.banque = banqueFilter;  // si entite != LES_DEUX
if (params.sens)  baseWhere.sens = params.sens;
if (params.annee) baseWhere.dateOperation = { gte, lt };

// baseWhere inclut donc : exclue, archivee, non_lettre, PARTIAL, traite

const nonLettrWhere = { ...baseWhere, statutLettrage: 'non_lettre', traite: false };
const partielWhere  = { ...baseWhere, statutLettrage: 'PARTIAL',    traite: false };
const traiteWhere   = { ...baseWhere, statutLettrage: 'traite' };

getKpis() — Dashboard chargement initial (global)

// Aucun filtre d'entité / sens / année
// Toute la base, sans restriction de statutLettrage sur les requêtes globales

count({ where: { statutLettrage: 'non_lettre' } })  // PAS de traite:false
count({ where: { statutLettrage: 'PARTIAL' } })
count({ where: { nonLettrable: true, statutLettrage: { in: ['non_lettre', 'PARTIAL'] } } })
count({ where: { reouvert: true } })
count({ where: { premiereVueAt: { gte: dernierImport.finishedAt } } })  // nouvelles
count({ where: { derniereVueAt: { gte: dernierFinishedAt }, premiereVueAt: { lt: dernierFinishedAt } } }) // MAJ

⚡ getKpis() — Les KPIs de la barre du haut

📊 getDashboardStats() — Le dashboard filtré

Construction du baseWhere

KPIs calculés

Par banque (agrégation JS)

// Chargement de TOUTES les lignes du baseWhere en mémoire :
parBanque = findMany({ where: baseWhere, select: { banque, statutLettrage, traite, montant, restant } })

// Agrégation en JS (pas en SQL) :
for (const l of parBanque) {
  entry.total++
  if (l.traite)                          entry.lettrees++    // booléen traite
  else if (l.statutLettrage === 'non_lettre') entry.nonLettrées++
  else if (l.statutLettrage === 'PARTIAL')   entry.partielles++
  // exclue / archivee : comptés dans total mais pas dans les 3 catégories
}

📈 getDashboard() — Dashboard complet (non utilisé actuellement)

🚨 Divergence 1 — Lignes exclues comptées dans le dashboard

La page traitement exclut systématiquement les lignes avec statutLettrage = 'exclue'. Le dashboard (getDashboardStats) n'a aucun filtre par défaut sur le statut — il compte tout, y compris les exclues.

Impact concret

⚠️ Divergence 2 — Non lettrées : traite:false manquant dans getKpis

getDashboardStats et la page traitement sont cohérents sur les non lettrées (tous deux utilisent traite: false implicitement via le statut). Mais getKpis() (barre du haut, affichée au chargement) ne filtre PAS sur traite: false.

🚨 Divergence 3 — Total lignes différent entre dashboard et traitement

Le "total" vu dans le dashboard et le total de lignes dans la page traitement ne comptent pas la même chose, même avec les mêmes filtres entité/sens/année.

⚠️ Divergence 4 — Le frontend recalcule son propre total

Dans le composant frontend du dashboard, le totalCount affiché n'est pas le champ total de l'API — c'est une addition en JavaScript.

// Frontend — calcul JS du total affiché dans le dashboard :
const totalCount = (stats?.nonLettrées ?? 0) + (stats?.partielles ?? 0)

// Ce totalCount ne comprend PAS :
// - les lignes traitées (lettrees)
// - les lignes exclues
// - les lignes archivées

⚠️ Divergence 5 — Scope des filtres entité/sens/année

La page traitement propose des filtres supplémentaires (dateDebut/dateFin, traite, nonLettrable, contrat, facture…) qui n'ont aucun équivalent dans le dashboard. Donc même avec entité+sens+année identiques, la page traitement peut afficher moins de lignes si d'autres filtres sont actifs.

📋 Tableau comparatif complet

Pour chaque KPI affiché, d'où vient la valeur et pourquoi elle peut différer de la page traitement.

💡 Recommandations

Fixes prioritaires

Ce qui est normal (par design)