Repository Public
1// Onglet « Vue d'ensemble » : tableau de bord de santé de l'infrastructure (GET /api/admin/health) — serveur de courrier, file,2// disque, certificats, sauvegardes, DNS, push, travailleurs, webhooks, base — avec les alertes ouvertes et les compteurs de la3// plateforme. Remplace l'ancienne vue d'ensemble : un seul écran d'accueil. Le DNS détaillé reste dans l'onglet « DNS ».4import { useState, type ReactNode } from "react"5import { certificatesOf, countByStatus, openAlertCount, parseAlerts, parseHealth, workersOf, type Alert, type CheckStatus, type Health, type HealthCheck } from "../../../admin/ops"6import { fmtDateTime, fmtNumber, t } from "../../../i18n"7import { apiGet } from "../../../jmap/http"8import { linkProps } from "../../../state/session"9import { Icon, Spinner, type IconName } from "../../kit"10import { Section } from "../../Page"11import { setOpenAlerts } from "../AlertBadge"12import { DASH, asNumber, asString, errorText, fmtBytes, fmtWhen, loadOverview, useLoad, type Overview } from "../shared"13import { Stat, StatusChip, ago, duration, useAutoRefresh } from "./common"1415/** Actualisation automatique : une fois par minute (les contrôles sont mis en cache 15 s à 30 min côté serveur). */16const REFRESH_MS = 60_0001718interface Data {19 health: Health20 alerts: Alert[]21 overview: Overview | null22}23type Fresh = { fresh: boolean }2425const ICON: Record<string, IconName> = { mail_server: "server", queue: "queue", disk: "archive", certificates: "shieldOk", backups: "download", dns: "globe", push: "phone", workers: "bolt", webhooks: "send", database: "list" }26const KNOWN = new Set(Object.keys(ICON))2728type Fact = [label: string, value: ReactNode]29interface View {30 plain: string31 facts: Fact[]32 link?: { href: string; label: string }33}34const n = (v: unknown): string => {35 const x = asNumber(v)36 return x === null ? DASH : fmtNumber(x)37}3839/** Phrase en clair et faits d'un contrôle, à partir de ses données (le détail brut du serveur reste affiché en dessous). */40function describe(c: HealthCheck, overview: Overview | null): View {41 const d = c.data42 const s = c.status43 switch (c.name) {44 case "mail_server":45 return s === "fail"46 ? { plain: t("adm.ops.mail_server.fail"), facts: [[t("adm.ops.fact.failures"), n(d.consecutive_failures)]] }47 : { plain: t(s === "warn" ? "adm.ops.mail_server.warn" : "adm.ops.mail_server.ok", { ms: n(d.latency_ms) }), facts: [[t("adm.ops.fact.latency"), `${n(d.latency_ms)} ms`], [t("adm.ops.fact.domains"), n(d.domains)]] }48 case "queue": {49 const link = { href: "/admin/queue", label: t("adm.ops.link.queue") }50 if (s === "unknown") return { plain: t("adm.ops.queue.unknown"), facts: [], link }51 const size = asNumber(d.size) ?? 052 return {53 plain: s === "fail" ? t("adm.ops.queue.fail") : s === "warn" ? t("adm.ops.queue.warn", { n: size }) : size === 0 ? t("adm.ops.queue.empty") : t("adm.ops.queue.ok", { n: size }),54 facts: [[t("adm.ops.fact.queued"), n(d.size)], [t("adm.ops.fact.oldest"), size ? duration((asNumber(d.oldest_minutes) ?? 0) * 60_000) : DASH], [t("adm.ops.fact.failing"), n(d.failures)]],55 link,56 }57 }58 case "disk":59 return {60 plain: t(s === "fail" ? "adm.ops.disk.fail" : s === "warn" ? "adm.ops.disk.warn" : s === "ok" ? "adm.ops.disk.ok" : "adm.ops.unknown.plain", { pct: n(d.free_pct) }),61 facts: [[t("adm.ops.fact.free"), `${fmtBytes(d.free_bytes)} / ${fmtBytes(d.total_bytes)}`], [t("adm.ops.fact.volume"), <span className="mono">{asString(d.path) ?? DASH}</span>]],62 link: { href: "/admin/storage", label: t("adm.ops.link.storage") },63 }64 case "certificates": {65 const certs = certificatesOf(c)66 const next = certs.find((x) => x.days !== null)67 return {68 plain: s === "fail" ? t("adm.ops.certificates.fail") : s === "warn" ? t("adm.ops.certificates.warn", { n: next?.days ?? 0 }) : s === "ok" ? t("adm.ops.certificates.ok", { n: next?.days ?? 0 }) : t("adm.ops.certificates.unknown"),69 facts: [[t("adm.ops.fact.certs"), fmtNumber(certs.length)], [t("adm.ops.fact.nextExpiry"), next ? `${next.subject} — ${t("adm.ops.days", { n: next.days ?? 0 })}` : DASH]],70 link: { href: "#certificates", label: t("adm.ops.link.certificates") },71 }72 }73 case "backups": {74 const link = { href: "#backups", label: t("adm.ops.link.backups") }75 if (s === "unknown") return { plain: t("adm.ops.backups.unknown"), facts: [], link }76 const age = asNumber(d.age_hours)77 return {78 plain: d.readable === false ? t("adm.ops.backups.unreadable") : d.ok === false ? t("adm.ops.backups.failed") : s === "ok" ? t("adm.ops.backups.ok", { d: age === null ? DASH : duration(age * 3600_000) }) : t("adm.ops.backups.stale", { d: age === null ? DASH : duration(age * 3600_000) }),79 facts: [[t("adm.ops.fact.lastBackup"), fmtWhen(d.at)], [t("adm.ops.fact.result"), d.ok === true ? t("adm.ops.backups.result.ok") : d.ok === false ? t("adm.ops.backups.result.failed") : DASH]],80 link,81 }82 }83 case "dns": {84 const problems = Array.isArray(d.problems) ? d.problems.filter((x): x is string => typeof x === "string") : []85 return {86 plain: s === "ok" ? t("adm.ops.dns.ok", { n: asNumber(d.domains) ?? 0 }) : s === "warn" ? t("adm.ops.dns.warn", { n: problems.length }) : t("adm.ops.unknown.plain"),87 facts: problems.length ? [[t("adm.ops.fact.misaligned"), <span className="mono">{problems.join(", ")}</span>]] : [[t("adm.ops.fact.domains"), n(d.domains)]],88 link: { href: "/admin/dns", label: t("adm.ops.link.dns") },89 }90 }91 case "push":92 if (s === "unknown") return { plain: t("adm.ops.push.absent"), facts: [] }93 return {94 plain: d.configured === false ? t("adm.ops.push.off") : s === "warn" ? t("adm.ops.push.warn") : t("adm.ops.push.ok"),95 facts: [[t("adm.ops.fact.configured"), d.configured === false ? t("adm.ops.no") : t("adm.ops.yes")], [t("adm.ops.fact.sent24"), n(d.sent_24h)], [t("adm.ops.fact.failed24"), n(d.failed_24h)], [t("adm.ops.fact.pending"), n(d.pending)]],96 link: { href: "/admin/devices", label: t("adm.ops.link.devices") },97 }98 case "workers": {99 const w = workersOf(c)100 if (!w.enabled) return { plain: t("adm.ops.workers.off"), facts: [] }101 const stale = w.workers.filter((x) => x.stale)102 return {103 plain: w.stalled.length ? t("adm.ops.workers.stalled", { n: w.stalled.length }) : stale.length ? t("adm.ops.workers.stale", { n: stale.length }) : s === "warn" ? t("adm.ops.workers.lag") : t("adm.ops.workers.ok", { n: w.workers.length }),104 facts: [[t("adm.ops.fact.alive"), `${w.workers.length - stale.length} / ${w.workers.length}`], [t("adm.ops.fact.rulesQueue"), n(w.queues.ruleJobs)], [t("adm.ops.fact.stuckOutbound"), n(w.queues.stuckOutbound)]],105 link: { href: "#workers", label: t("adm.ops.link.workers") },106 }107 }108 case "webhooks":109 return {110 plain: s === "ok" ? t("adm.ops.webhooks.ok") : s === "fail" ? t("adm.ops.webhooks.fail", { n: asNumber(d.failed_24h) ?? 0 }) : s === "warn" ? t("adm.ops.webhooks.warn", { n: asNumber(d.failed_24h) ?? 0 }) : t("adm.ops.unknown.plain"),111 facts: [[t("adm.ops.fact.failed24"), n(d.failed_24h)], [t("adm.ops.fact.backlog"), n(d.backlog)]],112 link: { href: "/admin/webhooks", label: t("adm.ops.link.webhooks") },113 }114 case "database":115 return { plain: s === "ok" ? t("adm.ops.database.ok") : t("adm.ops.unknown.plain"), facts: overview ? [[t("admin.counts.users"), n(overview.counts.users)], [t("admin.counts.mailboxes"), n(overview.counts.mailboxes)]] : [] }116 default:117 return { plain: c.detail || t("adm.ops.unknown.plain"), facts: [] }118 }119}120121function CheckCard({ c, overview }: { c: HealthCheck; overview: Overview | null }) {122 const v = describe(c, overview)123 const title = KNOWN.has(c.name) ? t(`adm.ops.check.${c.name as "queue"}`) : c.name124 return (125 <article className="card adm-ops-check" data-testid={`check-${c.name}`} data-status={c.status} aria-label={title}>126 <div className="adm-ops-check-head">127 <h3>128 <Icon name={ICON[c.name] ?? "server"} small />129 <span className="truncate">{title}</span>130 </h3>131 <span className="spacer" />132 <StatusChip status={c.status} />133 </div>134 <p className="adm-ops-plain" data-testid={`check-${c.name}-plain`}>135 {v.plain}136 </p>137 {v.facts.length ? (138 <dl className="adm-ops-facts">139 {v.facts.map(([label, value]) => (140 <div key={label} style={{ display: "contents" }}>141 <dt>{label}</dt>142 <dd>{value}</dd>143 </div>144 ))}145 </dl>146 ) : null}147 {c.detail ? (148 <p className="adm-ops-raw mono" lang="en" title={t("adm.ops.rawDetail")}>149 {c.detail}150 </p>151 ) : null}152 <div className="adm-ops-foot">153 <span className="muted small">{t("adm.ops.checked", { when: ago(c.checkedAt) })}</span>154 <span className="spacer" />155 {v.link ? v.link.href.startsWith("#") ? <a href={v.link.href}>{v.link.label}</a> : <a {...linkProps(v.link.href)}>{v.link.label}</a> : null}156 </div>157 </article>158 )159}160161function Certificates({ check }: { check: HealthCheck | undefined }) {162 const certs = certificatesOf(check)163 return (164 <section className="card section" id="certificates" aria-labelledby="ops-certs-h">165 <div className="row section-head">166 <h3 id="ops-certs-h">{t("adm.ops.certs.title")}</h3>167 </div>168 <p className="muted small section-desc">{t("adm.ops.certs.desc")}</p>169 {certs.length === 0 ? (170 <p className="muted">{t("adm.ops.certs.empty")}</p>171 ) : (172 <div className="table-wrap">173 <table className="table cards-sm" data-testid="ops-certificates">174 <caption className="sr-only">{t("adm.ops.certs.title")}</caption>175 <thead>176 <tr>177 <th scope="col">{t("adm.ops.certs.col.name")}</th>178 <th scope="col">{t("adm.ops.certs.col.kind")}</th>179 <th scope="col">{t("adm.ops.certs.col.expires")}</th>180 <th scope="col" className="adm-num">181 {t("adm.ops.certs.col.days")}182 </th>183 <th scope="col">{t("adm.ops.certs.col.state")}</th>184 </tr>185 </thead>186 <tbody>187 {certs.map((c) => (188 <tr key={c.name} data-cert={c.name}>189 <th scope="row" className="adm-rowhead mono adm-break">190 {c.subject}191 </th>192 <td data-label={t("adm.ops.certs.col.kind")}>{c.kind === "web" || c.kind === "smtp" || c.kind === "stalwart" ? t(`adm.ops.certs.kind.${c.kind}`) : c.kind}</td>193 <td data-label={t("adm.ops.certs.col.expires")}>{c.expiresAt ? fmtDateTime(c.expiresAt) : DASH}</td>194 <td data-label={t("adm.ops.certs.col.days")} className="adm-num">195 {c.days === null ? DASH : c.days < 0 ? t("adm.ops.certs.expired") : t("adm.ops.days", { n: c.days })}196 </td>197 <td data-label={t("adm.ops.certs.col.state")}>198 <StatusChip status={c.status} />199 {c.days === null && c.detail ? <span className="muted small adm-block">{t("adm.ops.certs.unverifiable", { detail: c.detail })}</span> : null}200 </td>201 </tr>202 ))}203 </tbody>204 </table>205 </div>206 )}207 </section>208 )209}210211function Backups({ check, raw }: { check: HealthCheck | undefined; raw: Overview["backup"] }) {212 const d = check?.data ?? {}213 const status: CheckStatus = check?.status ?? "unknown"214 const age = asNumber(d.age_hours)215 const error = raw ? asString(raw.error) : null216 return (217 <section className="card section" id="backups" aria-labelledby="ops-backups-h" data-testid="ops-backups" data-status={status}>218 <div className="row section-head">219 <h3 id="ops-backups-h">{t("adm.ops.backup.title")}</h3>220 <span className="spacer" />221 <StatusChip status={status} />222 </div>223 <p className="muted small section-desc">{t("adm.ops.backup.desc")}</p>224 {status === "unknown" ? (225 <p className="muted">{t("adm.ops.backups.unknown")}</p>226 ) : (227 <dl className="adm-dl">228 <dt>{t("adm.ops.backup.last")}</dt>229 <dd>230 {fmtWhen(d.at)} {age !== null ? <span className="muted">({ago(asString(d.at))})</span> : null}231 </dd>232 <dt>{t("adm.ops.backup.result")}</dt>233 <dd data-testid="ops-backup-result">234 {d.readable === false ? t("adm.ops.backups.unreadable") : d.ok === true ? t("adm.ops.backups.result.ok") : t("adm.ops.backups.result.failed")}235 {error ? <span className="adm-error adm-block">{error}</span> : null}236 </dd>237 <dt>{t("adm.ops.backup.verification")}</dt>238 <dd>{d.readable === false ? DASH : d.ok === true ? t("adm.ops.backup.verified") : t("adm.ops.backup.notVerified")}</dd>239 <dt>{t("adm.ops.backup.age")}</dt>240 <dd>{age === null ? DASH : t(status === "ok" ? "adm.ops.backup.age.ok" : "adm.ops.backup.age.late", { d: duration(age * 3600_000) })}</dd>241 {raw && asString(raw.file) ? (242 <>243 <dt>{t("adm.ops.backup.file")}</dt>244 <dd className="mono">{asString(raw.file)}</dd>245 </>246 ) : null}247 {raw && asNumber(raw.bytes) !== null ? (248 <>249 <dt>{t("admin.backup.size")}</dt>250 <dd>{fmtBytes(raw.bytes)}</dd>251 </>252 ) : null}253 {raw && asNumber(raw.copies) !== null ? (254 <>255 <dt>{t("adm.ops.backup.copies")}</dt>256 <dd>{fmtNumber(asNumber(raw.copies) ?? 0)}</dd>257 </>258 ) : null}259 </dl>260 )}261 </section>262 )263}264265function Workers({ check }: { check: HealthCheck | undefined }) {266 const w = workersOf(check)267 return (268 <section className="card section" id="workers" aria-labelledby="ops-workers-h" data-testid="ops-workers">269 <div className="row section-head">270 <h3 id="ops-workers-h">{t("adm.ops.workers.title")}</h3>271 <span className="spacer" />272 <StatusChip status={check?.status ?? "unknown"} />273 </div>274 <p className="muted small section-desc">{t("adm.ops.workers.desc")}</p>275 {!w.enabled ? (276 <div className="banner warn" role="status">277 <Icon name="warn" />278 <span>{t("adm.ops.workers.off")}</span>279 </div>280 ) : (281 <div className="stack">282 {w.stalled.length ? (283 <div className="banner danger" role="alert" data-testid="ops-watcher-stalled">284 <Icon name="warn" />285 <span className="adm-grow">286 {t("adm.ops.workers.stalledIntro")}287 {w.stalled.map((x) => (288 <span key={x.address} className="adm-block">289 <span className="mono">{x.address}</span> — {t("adm.ops.workers.stalledItem", { n: x.failures, since: ago(x.since) })}290 {x.error ? <span className="adm-reply adm-block">{x.error}</span> : null}291 </span>292 ))}293 </span>294 </div>295 ) : null}296 {w.workers.length === 0 ? (297 <p className="muted">{t("adm.ops.workers.none")}</p>298 ) : (299 <div className="table-wrap">300 <table className="table cards-sm">301 <caption className="sr-only">{t("adm.ops.workers.title")}</caption>302 <thead>303 <tr>304 <th scope="col">{t("adm.ops.workers.col.name")}</th>305 <th scope="col">{t("adm.ops.workers.col.last")}</th>306 <th scope="col">{t("adm.ops.workers.col.state")}</th>307 </tr>308 </thead>309 <tbody>310 {w.workers.map((x) => (311 <tr key={x.name} data-worker={x.name}>312 <th scope="row" className="adm-rowhead">313 {x.name}314 </th>315 <td data-label={t("adm.ops.workers.col.last")}>{x.ageMs === null ? DASH : t("adm.ops.ago", { d: duration(x.ageMs) })}</td>316 <td data-label={t("adm.ops.workers.col.state")}>317 <StatusChip status={x.stale ? "warn" : "ok"} />318 </td>319 </tr>320 ))}321 </tbody>322 </table>323 </div>324 )}325 <dl className="adm-metas">326 <div className="adm-meta-item">327 <dt>{t("adm.ops.fact.rulesQueue")}</dt>328 <dd>{n(w.queues.ruleJobs)}</dd>329 </div>330 <div className="adm-meta-item">331 <dt>{t("adm.ops.fact.semanticQueue")}</dt>332 <dd>{n(w.queues.semanticQueue)}</dd>333 </div>334 <div className="adm-meta-item">335 <dt>{t("adm.ops.fact.stuckOutbound")}</dt>336 <dd>{n(w.queues.stuckOutbound)}</dd>337 </div>338 <div className="adm-meta-item">339 <dt>{t("adm.ops.fact.watcherIdle")}</dt>340 <dd>{w.queues.watcherIdleSeconds === null ? DASH : duration(w.queues.watcherIdleSeconds * 1000)}</dd>341 </div>342 </dl>343 </div>344 )}345 </section>346 )347}348349export default function DashboardTab() {350 const mode = useState<Fresh>({ fresh: false })[0]351 const load = useLoad<Data>(async (signal) => {352 const fresh = mode.fresh353 mode.fresh = false354 const [health, alerts, overview] = await Promise.all([355 apiGet<unknown>(`/api/admin/health${fresh ? "?fresh=1" : ""}`, signal).then(parseHealth),356 apiGet<unknown>("/api/admin/alerts?state=open", signal).then(parseAlerts, () => [] as Alert[]),357 loadOverview(signal).catch(() => null),358 ])359 setOpenAlerts(openAlertCount(alerts))360 return { health, alerts, overview }361 })362 const [auto, setAuto] = useState(true)363 useAutoRefresh(load.reload, REFRESH_MS, auto)364 const refreshNow = () => {365 mode.fresh = true366 load.reload()367 }368 const data = load.data369 return (370 <div className="adm" data-testid="ops-dashboard">371 <div className="row wrap adm-toolbar">372 <button type="button" className="btn small" aria-pressed={auto} onClick={() => setAuto((v) => !v)} data-testid="ops-auto">373 <Icon name={auto ? "check" : "clock"} small />374 <span>{t(auto ? "adm.ops.auto.on" : "adm.ops.auto.off")}</span>375 </button>376 <span className="muted small" data-testid="ops-generated">377 {data?.health.generatedAt ? t("adm.ops.generated", { when: fmtDateTime(data.health.generatedAt) }) : null}378 </span>379 <span className="spacer" />380 {load.loading && data ? <Spinner /> : null}381 <button type="button" className="btn small" onClick={refreshNow} disabled={load.loading} data-testid="ops-refresh">382 <Icon name="refresh" small />383 <span>{t("adm.ops.refreshNow")}</span>384 </button>385 </div>386 {load.error ? (387 <div className="banner danger" role="alert">388 <Icon name="warn" />389 <span className="adm-grow">{errorText(load.error)}</span>390 <button type="button" className="btn small" onClick={load.reload}>391 {t("common.retry")}392 </button>393 </div>394 ) : !data ? (395 <Spinner label={t("common.loading")} />396 ) : (397 <Body data={data} />398 )}399 </div>400 )401}402403function Body({ data }: { data: Data }) {404 const { health: h, alerts, overview: o } = data405 const counts = countByStatus(h.checks)406 const open = alerts.filter((a) => a.state === "open")407 const by = (name: string) => h.checks.find((c) => c.name === name)408 const tone = h.status === "fail" ? "danger" : h.status === "warn" ? "warn" : "ok"409 return (410 <>411 <div className={`banner ${tone}`} role="status" data-testid="ops-overall" data-status={h.status}>412 <Icon name={h.status === "ok" ? "check" : "warn"} />413 <div className="adm-ops-summary adm-grow">414 <strong>{t(h.status === "fail" ? "adm.ops.overall.fail" : h.status === "warn" ? "adm.ops.overall.warn" : "adm.ops.overall.ok")}</strong>415 <span className="adm-ops-counts">416 {(["fail", "warn", "unknown", "ok"] as const).map((s) =>417 counts[s] ? (418 <span key={s} className="small" data-count={s}>419 {t(`adm.ops.count.${s}`, { n: counts[s] })}420 </span>421 ) : null,422 )}423 </span>424 </div>425 </div>426427 {alerts.length ? (428 <div className={`banner ${open.length ? "warn" : ""}`} role="status" data-testid="ops-alerts-strip">429 <Icon name="warn" />430 <span className="adm-grow">431 {open.length ? t("adm.ops.alerts.open", { n: open.length }) : t("adm.ops.alerts.acked", { n: alerts.length })}432 <span className="muted adm-block small">{alerts.slice(0, 3).map((a) => a.title).join(" · ")}</span>433 </span>434 <a className="btn small" {...linkProps("/admin/alerts")}>435 {t("adm.ops.alerts.see")}436 </a>437 </div>438 ) : null}439440 <div className="adm-ops-grid" data-testid="ops-checks">441 {h.checks.map((c) => (442 <CheckCard key={c.name} c={c} overview={o} />443 ))}444 </div>445446 {o ? (447 <div className="adm-stats" data-testid="ops-counts">448 <Stat label={t("admin.counts.users")} value={n(o.counts.users)} />449 <Stat label={t("admin.counts.mailboxes")} value={n(o.counts.mailboxes)} />450 <Stat label={t("admin.counts.sessions")} value={n(o.counts.sessions)} />451 <Stat label={t("admin.domains.title")} value={fmtNumber(o.domains.length)} />452 </div>453 ) : null}454455 <Certificates check={by("certificates")} />456 <Backups check={by("backups")} raw={o?.backup ?? null} />457 <Workers check={by("workers")} />458459 <Section title={t("adm.ops.more.title")}>460 <ul className="adm-list">461 <li>462 <a {...linkProps("/admin/dns")}>{t("adm.ops.more.dns")}</a> <span className="muted small">— {o && o.domains.length ? o.domains.map((d) => d.name).join(", ") : DASH}</span>463 </li>464 <li>465 <a {...linkProps("/admin/webhooks")}>{t("adm.ops.more.webhooks")}</a>466 </li>467 <li>468 <a {...linkProps("/admin/health")}>{t("adm.ops.more.exposure")}</a>469 </li>470 <li>471 <a {...linkProps("/admin/security")}>{t("adm.ops.more.security")}</a>472 </li>473 </ul>474 </Section>475 </>476 )477}478