Repository Public
1// Métriques de remise → géométrie SVG (pur, sans DOM) : lecture défensive de /api/admin/metrics, série de jours continue,2// échelles, graduations rondes, rectangles empilés, barres horizontales par adresse, tracé de ligne, totaux et pourcentages.34/** Séries affichées, dans l'ordre d'empilement (de la base vers le haut). `other` regroupe les états non terminaux ou annulés. */5export const SERIES = ["delivered", "sent", "deferred", "bounced", "failed", "other"] as const6export type Series = (typeof SERIES)[number]7export type Counts = Record<Series, number>89const NAMED = new Set<string>(["delivered", "sent", "deferred", "bounced", "failed"])10export const zeroCounts = (): Counts => ({ delivered: 0, sent: 0, deferred: 0, bounced: 0, failed: 0, other: 0 })11export const sumCounts = (c: Counts): number => SERIES.reduce((n, s) => n + c[s], 0)12export function addCounts(a: Counts, b: Counts): Counts {13 const out = zeroCounts()14 for (const s of SERIES) out[s] = a[s] + b[s]15 return out16}1718export interface DayRow {19 /** AAAA-MM-JJ (UTC) */20 day: string21 counts: Counts22 total: number23}24export interface AddressRow {25 address: string26 counts: Counts27 total: number28}29export interface Backlog {30 status: string31 count: number32 oldest: string | null33}34export interface Metrics {35 days: number36 byDay: DayRow[]37 byAddress: AddressRow[]38 queueDepth: Backlog[]39 webhookBacklog: Backlog[]40 pendingApprovals: number41}4243const isRecord = (v: unknown): v is Record<string, unknown> => typeof v === "object" && v !== null && !Array.isArray(v)44const count = (v: unknown): number => (typeof v === "number" && Number.isFinite(v) && v > 0 ? Math.floor(v) : 0)4546/** Compte par série d'une ligne `{clé, <état>: n, …}` : tout état hors des cinq nommés va dans `other`. */47function countsOf(row: Record<string, unknown>, keyField: string): Counts {48 const c = zeroCounts()49 for (const [k, v] of Object.entries(row)) {50 if (k === keyField) continue51 if (NAMED.has(k)) c[k as Series] += count(v)52 else c.other += count(v)53 }54 return c55}56function backlog(v: unknown): Backlog[] {57 if (!isRecord(v)) return []58 return Object.entries(v)59 .map(([status, x]) => ({ status, count: isRecord(x) ? count(x.count) : count(x), oldest: isRecord(x) && typeof x.oldest === "string" ? x.oldest : null }))60 .filter((b) => b.count > 0)61 .sort((a, b) => a.status.localeCompare(b.status))62}6364/** Réponse de `GET /api/admin/metrics` sous une forme sûre (rien n'est supposé présent). */65export function parseMetrics(raw: unknown): Metrics {66 const o = isRecord(raw) ? raw : {}67 const rows = (v: unknown) => (Array.isArray(v) ? v.filter(isRecord) : [])68 const byDay = rows(o.by_day).flatMap((r): DayRow[] => {69 if (typeof r.day !== "string" || !/^\d{4}-\d{2}-\d{2}$/.test(r.day)) return []70 const counts = countsOf(r, "day")71 return [{ day: r.day, counts, total: sumCounts(counts) }]72 })73 const byAddress = rows(o.by_address).flatMap((r): AddressRow[] => {74 if (typeof r.address !== "string" || !r.address) return []75 const counts = countsOf(r, "address")76 return [{ address: r.address, counts, total: sumCounts(counts) }]77 })78 return {79 days: count(o.days) || 14,80 byDay: byDay.sort((a, b) => a.day.localeCompare(b.day)),81 byAddress: byAddress.sort((a, b) => b.total - a.total || a.address.localeCompare(b.address)),82 queueDepth: backlog(o.queue_depth),83 webhookBacklog: backlog(o.webhook_backlog),84 pendingApprovals: count(o.pending_approvals),85 }86}8788const DAY_MS = 86_400_00089export const utcDay = (d: Date): string => d.toISOString().slice(0, 10)9091/**92 * Série continue des `days` derniers jours (UTC, du plus ancien au plus récent, aujourd'hui compris) : un jour sans envoi93 * vaut zéro. Un jour reçu hors de la fenêtre (décalage d'horloge) est conservé plutôt que perdu.94 */95export function fillDays(rows: readonly DayRow[], days: number, today: Date): DayRow[] {96 const known = new Map(rows.map((r) => [r.day, r]))97 const end = Date.UTC(today.getUTCFullYear(), today.getUTCMonth(), today.getUTCDate())98 const out: DayRow[] = []99 for (let i = Math.max(1, days) - 1; i >= 0; i--) {100 const day = utcDay(new Date(end - i * DAY_MS))101 out.push(known.get(day) ?? { day, counts: zeroCounts(), total: 0 })102 known.delete(day)103 }104 return [...known.values(), ...out].sort((a, b) => a.day.localeCompare(b.day))105}106107export function totals(rows: readonly { counts: Counts }[]): Counts {108 return rows.reduce((acc, r) => addCounts(acc, r.counts), zeroCounts())109}110/** Pourcentage arrondi à une décimale ; 0 quand le total est nul (jamais NaN). */111export function percent(part: number, total: number): number {112 if (!(total > 0) || !Number.isFinite(part)) return 0113 return Math.round((part / total) * 1000) / 10114}115116/** Graduations entières « rondes » de 0 à un maximum ≥ `max` (pas de 1, 2, 5 × 10ⁿ), au plus `target` + 1 intervalles. */117export function niceTicks(max: number, target = 4): number[] {118 const top = Math.max(1, Math.ceil(Number.isFinite(max) ? max : 0))119 const rough = top / Math.max(1, target)120 const pow = 10 ** Math.floor(Math.log10(rough))121 const frac = rough / pow122 const step = Math.max(1, (frac <= 1 ? 1 : frac <= 2 ? 2 : frac <= 5 ? 5 : 10) * pow)123 const ticks: number[] = []124 for (let v = 0; v < top + step; v += step) ticks.push(v)125 return ticks126}127128/** Échelle linéaire 0…max → 0…size (max nul : tout vaut 0). */129export const linearScale = (max: number, size: number) => (v: number): number => (max > 0 ? (v / max) * size : 0)130const r2 = (n: number): number => Math.round(n * 100) / 100131132export interface Box {133 width: number134 height: number135 top: number136 right: number137 bottom: number138 left: number139}140export interface Rect {141 series: Series142 value: number143 x: number144 y: number145 width: number146 height: number147}148export interface StackedLayout {149 /** valeur maximale de l'axe (dernière graduation) */150 max: number151 ticks: { value: number; y: number }[]152 /** largeur d'une barre */153 band: number154 bars: { day: string; total: number; x: number; rects: Rect[] }[]155}156157/** Barres verticales empilées : une par jour, segments dans l'ordre de `SERIES` depuis la ligne de base. */158export function stackedBars(rows: readonly DayRow[], box: Box): StackedLayout {159 const w = Math.max(0, box.width - box.left - box.right)160 const h = Math.max(0, box.height - box.top - box.bottom)161 const tk = niceTicks(Math.max(0, ...rows.map((r) => r.total)))162 const max = tk[tk.length - 1]163 const y = linearScale(max, h)164 const slot = rows.length ? w / rows.length : 0165 const band = r2(Math.max(1, Math.min(36, slot * 0.72)))166 const base = box.top + h167 return {168 max,169 ticks: tk.map((value) => ({ value, y: r2(base - y(value)) })),170 band,171 bars: rows.map((r, i) => {172 const x = r2(box.left + slot * i + (slot - band) / 2)173 let acc = 0174 const rects: Rect[] = []175 for (const s of SERIES) {176 const value = r.counts[s]177 if (value <= 0) continue178 const height = y(value)179 acc += height180 rects.push({ series: s, value, x, y: r2(base - acc), width: band, height: r2(height) })181 }182 return { day: r.day, total: r.total, x, rects }183 }),184 }185}186187export interface HBarLayout {188 max: number189 ticks: { value: number; x: number }[]190 rowHeight: number191 height: number192 rows: { address: string; total: number; y: number; rects: Rect[] }[]193}194195/** Barres horizontales empilées : une par adresse ; la hauteur totale dépend du nombre de lignes. */196export function horizontalBars(rows: readonly AddressRow[], opts: { width: number; left: number; right: number; top: number; rowHeight: number; barHeight: number }): HBarLayout {197 const w = Math.max(0, opts.width - opts.left - opts.right)198 const tk = niceTicks(Math.max(0, ...rows.map((r) => r.total)))199 const max = tk[tk.length - 1]200 const x = linearScale(max, w)201 return {202 max,203 ticks: tk.map((value) => ({ value, x: r2(opts.left + x(value)) })),204 rowHeight: opts.rowHeight,205 height: opts.top + rows.length * opts.rowHeight,206 rows: rows.map((r, i) => {207 const y = r2(opts.top + i * opts.rowHeight + (opts.rowHeight - opts.barHeight) / 2)208 let acc = 0209 const rects: Rect[] = []210 for (const s of SERIES) {211 const value = r.counts[s]212 if (value <= 0) continue213 const width = x(value)214 rects.push({ series: s, value, x: r2(opts.left + acc), y, width: r2(width), height: opts.barHeight })215 acc += width216 }217 return { address: r.address, total: r.total, y, rects }218 }),219 }220}221222/** Attribut `d` d'une ligne brisée passant par les valeurs, de gauche à droite, dans une boîte width × height. */223export function linePath(values: readonly number[], width: number, height: number, pad = 1): string {224 if (!values.length) return ""225 const max = Math.max(0, ...values)226 const y = linearScale(max, Math.max(0, height - 2 * pad))227 const step = values.length > 1 ? (width - 2 * pad) / (values.length - 1) : 0228 const pts = values.map((v, i) => `${r2(pad + step * i)},${r2(height - pad - y(Math.max(0, v)))}`)229 if (pts.length === 1) return `M${pts[0]}h${r2(Math.max(0, width - 2 * pad))}`230 return `M${pts.join("L")}`231}232233/** Indices des jours dont l'étiquette est affichée sous l'axe : au plus `max`, toujours le premier et le dernier. */234export function labelIndexes(n: number, max = 7): number[] {235 if (n <= 0) return []236 if (n <= max) return Array.from({ length: n }, (_, i) => i)237 const out = new Set<number>()238 for (let i = 0; i < max; i++) out.add(Math.round((i * (n - 1)) / (max - 1)))239 return [...out].sort((a, b) => a - b)240}241242/** Raccourcit une adresse trop longue pour l'étiquette d'une barre (le tableau porte toujours l'adresse entière). */243export function clip(text: string, max: number): string {244 return text.length <= max ? text : `${text.slice(0, Math.max(1, max - 1))}…`245}246