SPB Git

Repository Public

charts.ts 9.7 KB 246 lines typescript

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
Files main
Menu

Theme