SPB Git

Repository Public

Dashboard.tsx 22.4 KB 478 lines tsx

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

Theme