DATEI 1: public/runbook/runbook-tower-notfall.md (statisch, Anker #deadman/#spool/#deadletter/#health)
DATEI 2: /runbook-Route (Server Component, Mini-MD-Renderer, CSP-konform, force-static)
DATEI 3: runbookHints.ts (LAMP_HINTS/buildView/renderHintHtml 1:1 aus runbook_hints.py)
+ RunbookHint.tsx eingebunden an 4 Alarm-Flaechen:
- EscalationHistory (Deadman, Szenario A)
- TaskBrowser Spool-Tab (Szenario B) + Dead-Letter-Tab (B3)
- TaskBrowser/OpsPanels Degraded/Error (Health, Szenario C)
Keine Ampelfarben/Deadman-Logik/Degraded-Banner/Datenpfade angefasst (CHO-NICHT ANFASSEN erfuellt).
Build verifiziert: tsc --noEmit clean, next build gruen (/runbook static).
516 lines
20 KiB
TypeScript
516 lines
20 KiB
TypeScript
"use client"
|
|
|
|
/**
|
|
* TaskBrowser — Task-Detail-Ansicht im Tower (Karte tower-task-detail).
|
|
*
|
|
* Drei Listen aus /api/fleet/tasks:
|
|
* - Spool-Reifegrad (offene submitted/working, Alter)
|
|
* - Dead-Letter (failed der letzten 7 Tage)
|
|
* - Alarm-Feed (Stoerungsereignisse aus dem Journal)
|
|
* Klick auf eine Zeile -> /api/fleet/task-detail?id=... -> Modal mit vollem
|
|
* Envelope (from/to/type/status/priority/created/Alter/topic/thread/karte/body).
|
|
* Body unredigiert (Change-Order Abnahme 3; React escaped beim Rendern).
|
|
* Polt 30 s; degradierte Quelle -> Banner statt Leeranzeige.
|
|
*/
|
|
import { useCallback, useEffect, useRef, useState } from "react"
|
|
import RunbookHint from "./RunbookHint"
|
|
import { hintByKey } from "@/app/lib/fleet/runbookHints"
|
|
|
|
type TaskEnvelope = {
|
|
task_id: string
|
|
from: string
|
|
to: string
|
|
type: string
|
|
status: string
|
|
priority: string
|
|
created: number | null
|
|
created_iso: string
|
|
age_seconds: number | null
|
|
age_human: string
|
|
topic: string
|
|
body: string
|
|
thread_id: string
|
|
karte_id: string
|
|
reply_to: string
|
|
vs: string
|
|
claimed_at: string
|
|
status_label: string
|
|
re_dispatched_to: string
|
|
re_dispatch_of: string
|
|
file: string
|
|
}
|
|
|
|
type AlarmRow = {
|
|
time_epoch: number | null
|
|
time_iso: string
|
|
age_human: string
|
|
event: string
|
|
ref: string
|
|
from: string
|
|
to: string
|
|
task_id: string
|
|
note: string
|
|
}
|
|
|
|
type TaskOverview = {
|
|
generated_at: string
|
|
spool: TaskEnvelope[]
|
|
dead_letter: TaskEnvelope[]
|
|
alarm: AlarmRow[]
|
|
counts: { spool: number; dead_letter: number; alarm: number }
|
|
degraded: boolean
|
|
degraded_reason: string
|
|
}
|
|
|
|
type TaskDetail = {
|
|
generated_at: string
|
|
found: boolean
|
|
query_task_id: string
|
|
entry_kind: string
|
|
task: Record<string, string | number | null>
|
|
missing_fields: string[]
|
|
raw_keys: string[]
|
|
body_note: string
|
|
degraded: boolean
|
|
degraded_reason: string
|
|
error: string
|
|
}
|
|
|
|
type Tab = "spool" | "dead-letter" | "alarm"
|
|
|
|
const REFRESH_MS = 30000
|
|
const AGING_ALERT_S = 5400
|
|
|
|
const DETAIL_FIELDS: Array<[string, string]> = [
|
|
["task_id", "Task-ID"],
|
|
["status_label", "Status"],
|
|
["from", "Von"],
|
|
["to", "An"],
|
|
["type", "Typ"],
|
|
["priority", "Prio"],
|
|
["created_iso", "Erstellt (ISO)"],
|
|
["age_human", "Alter"],
|
|
["topic", "Thema"],
|
|
["thread_id", "Thread-ID"],
|
|
["karte_id", "Karte"],
|
|
["reply_to", "Antwort an"],
|
|
["vs", "Value-Stream"],
|
|
["claimed_at", "Geclaimt"],
|
|
]
|
|
|
|
function ageClass(seconds: number | null): string {
|
|
if (seconds === null) return "text-[var(--foreground-dim)]"
|
|
if (seconds > AGING_ALERT_S) return "text-[var(--status-stopped)] font-semibold"
|
|
if (seconds > 900) return "text-amber-400"
|
|
return "text-[var(--foreground-dim)]"
|
|
}
|
|
|
|
function prioClass(p: string): string {
|
|
switch (p) {
|
|
case "P1": return "text-[var(--status-stopped)] font-semibold"
|
|
case "P2": return "text-amber-400"
|
|
default: return "text-[var(--foreground-dim)]"
|
|
}
|
|
}
|
|
|
|
export default function TaskBrowser() {
|
|
const [data, setData] = useState<TaskOverview | null>(null)
|
|
const [loadError, setLoadError] = useState("")
|
|
const [tab, setTab] = useState<Tab>("spool")
|
|
const [detail, setDetail] = useState<TaskDetail | null>(null)
|
|
const [detailLoading, setDetailLoading] = useState(false)
|
|
const [detailError, setDetailError] = useState("")
|
|
const [redis, setRedis] = useState<Record<string, { state: string; msg: string }>>({})
|
|
const modalRef = useRef<HTMLDivElement | null>(null)
|
|
|
|
const load = useCallback(async () => {
|
|
try {
|
|
const res = await fetch("/api/fleet/tasks", { cache: "no-store" })
|
|
const body = (await res.json()) as TaskOverview & { error?: string }
|
|
if (!res.ok || body.error) {
|
|
setLoadError(body.error || `HTTP ${res.status}`)
|
|
return
|
|
}
|
|
setData(body)
|
|
setLoadError("")
|
|
} catch (e) {
|
|
setLoadError(e instanceof Error ? e.message : String(e))
|
|
}
|
|
}, [])
|
|
|
|
useEffect(() => {
|
|
void load()
|
|
const t = setInterval(() => void load(), REFRESH_MS)
|
|
return () => clearInterval(t)
|
|
}, [load])
|
|
|
|
/** Dead-Letter-Re-Dispatch: neuer Envelope ueber den board-service (Tower schreibt nie selbst). */
|
|
const redispatch = useCallback(
|
|
async (taskId: string) => {
|
|
setRedis((prev) => ({ ...prev, [taskId]: { state: "busy", msg: "stelle zu…" } }))
|
|
try {
|
|
const res = await fetch("/api/fleet/task-redispatch", {
|
|
method: "POST",
|
|
headers: { "Content-Type": "application/json" },
|
|
body: JSON.stringify({ id: taskId }),
|
|
})
|
|
const body = (await res.json()) as {
|
|
result?: string
|
|
new_task_id?: string
|
|
reason?: string
|
|
problems?: string[]
|
|
}
|
|
const result = String(body.result || `HTTP ${res.status}`)
|
|
let state = "err"
|
|
let msg = result
|
|
if (result === "OK_REDISPATCHED") {
|
|
state = "ok"
|
|
msg = `erneut zugestellt -> ${body.new_task_id}`
|
|
} else if (result === "OK_ALREADY") {
|
|
state = "already"
|
|
msg = `bereits re-dispatched -> ${body.new_task_id || "?"}`
|
|
} else if (body.reason || body.problems?.length) {
|
|
msg = `${result}: ${body.reason || body.problems?.join("; ")}`
|
|
}
|
|
setRedis((prev) => ({ ...prev, [taskId]: { state, msg } }))
|
|
await load()
|
|
} catch (e) {
|
|
setRedis((prev) => ({
|
|
...prev,
|
|
[taskId]: { state: "err", msg: e instanceof Error ? e.message : String(e) },
|
|
}))
|
|
}
|
|
},
|
|
[load]
|
|
)
|
|
|
|
const openDetail = useCallback(async (id: string, kind: string) => {
|
|
setDetailLoading(true)
|
|
setDetailError("")
|
|
setDetail(null)
|
|
try {
|
|
const res = await fetch(
|
|
`/api/fleet/task-detail?id=${encodeURIComponent(id)}&kind=${encodeURIComponent(kind)}`,
|
|
{ cache: "no-store" }
|
|
)
|
|
const body = (await res.json()) as TaskDetail & { error?: string }
|
|
if (!res.ok || body.error) {
|
|
setDetailError(body.error || `HTTP ${res.status}`)
|
|
} else {
|
|
setDetail(body)
|
|
}
|
|
} catch (e) {
|
|
setDetailError(e instanceof Error ? e.message : String(e))
|
|
} finally {
|
|
setDetailLoading(false)
|
|
}
|
|
}, [])
|
|
|
|
useEffect(() => {
|
|
const onKey = (e: KeyboardEvent) => {
|
|
if (e.key === "Escape") setDetail(null)
|
|
}
|
|
document.addEventListener("keydown", onKey)
|
|
return () => document.removeEventListener("keydown", onKey)
|
|
}, [])
|
|
|
|
const counts = data?.counts
|
|
const tabBtn = (id: Tab, label: string, n: number | undefined) => (
|
|
<button
|
|
onClick={() => setTab(id)}
|
|
data-testid={`task-tab-${id}`}
|
|
className={`px-3 py-1.5 text-[11px] font-mono uppercase tracking-wider border ${
|
|
tab === id
|
|
? "border-[var(--nvidia-green)] text-[var(--nvidia-green)] bg-[var(--background-tertiary)]"
|
|
: "border-[var(--border)] text-[var(--foreground-dim)] hover:text-[var(--foreground)]"
|
|
}`}
|
|
>
|
|
{label} <span className="ml-1 opacity-70">{n ?? 0}</span>
|
|
</button>
|
|
)
|
|
|
|
return (
|
|
<div className="space-y-4" data-testid="fleet-task-browser">
|
|
<div className="panel p-6">
|
|
<div className="flex flex-wrap items-center justify-between gap-3">
|
|
<div>
|
|
<h1 className="text-lg font-semibold text-[var(--nvidia-green)] uppercase tracking-wider">
|
|
Tasks
|
|
</h1>
|
|
<p className="mt-1 text-xs text-[var(--foreground-dim)]">
|
|
Spool-Reifegrad, Dead-Letter und Alarm-Feed — Klick auf eine Zeile zeigt den vollen
|
|
Task-Envelope (Body unveraendert). Refresh alle 30 s
|
|
{data ? ` · Stand ${new Date(data.generated_at).toLocaleTimeString()}` : ""}
|
|
</p>
|
|
</div>
|
|
<div className="flex gap-2" data-testid="task-tabs">
|
|
{tabBtn("spool", "Spool-Reife", counts?.spool)}
|
|
{tabBtn("dead-letter", "Dead-Letter", counts?.dead_letter)}
|
|
{tabBtn("alarm", "Alarm-Feed", counts?.alarm)}
|
|
</div>
|
|
</div>
|
|
|
|
{loadError && (
|
|
<div className="mt-4 border border-[var(--status-stopped)] bg-[var(--background-tertiary)] p-3 text-xs text-[var(--status-stopped)]">
|
|
Tasks nicht ladbar: {loadError}
|
|
</div>
|
|
)}
|
|
{tab === "spool" && (
|
|
<div className="mt-4 border border-[var(--border)] bg-[var(--background-tertiary)] p-3">
|
|
<RunbookHint hint={hintByKey("spool")} />
|
|
</div>
|
|
)}
|
|
{tab === "dead-letter" && (
|
|
<div className="mt-4 border border-[var(--border)] bg-[var(--background-tertiary)] p-3">
|
|
<RunbookHint hint={hintByKey("deadletter")} />
|
|
</div>
|
|
)}
|
|
{data?.degraded && (
|
|
<div className="mt-4 border border-amber-500 bg-[var(--background-tertiary)] p-3 text-xs text-amber-400">
|
|
DEGRADED: {data.degraded_reason || "Quelle gestoert"} — Anzeige evtl. unvollstaendig.
|
|
</div>
|
|
)}
|
|
{(loadError || data?.degraded) && (
|
|
<div className="mt-4 border border-[var(--border)] bg-[var(--background-tertiary)] p-3">
|
|
<RunbookHint hint={hintByKey("health")} />
|
|
</div>
|
|
)}
|
|
|
|
<div className="mt-4 overflow-x-auto">
|
|
{tab === "alarm" ? (
|
|
<table className="w-full text-left text-xs" data-testid="task-table-alarm">
|
|
<thead className="text-[10px] uppercase tracking-wider text-[var(--foreground-dim)]">
|
|
<tr>
|
|
<th className="py-2 pr-3">Alter</th>
|
|
<th className="py-2 pr-3">Event</th>
|
|
<th className="py-2 pr-3">Ref</th>
|
|
<th className="py-2 pr-3">Von</th>
|
|
<th className="py-2 pr-3">An</th>
|
|
<th className="py-2">Notiz</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody className="font-mono">
|
|
{(data?.alarm || []).map((row, i) => (
|
|
<tr
|
|
key={`${row.event}-${row.ref}-${i}`}
|
|
data-tid={row.ref}
|
|
data-kind="alarm"
|
|
onClick={() => void openDetail(row.ref, "alarm")}
|
|
className="cursor-pointer border-t border-[var(--border)] hover:bg-[var(--background-tertiary)]"
|
|
>
|
|
<td className={`py-1.5 pr-3 whitespace-nowrap ${ageClass(null)}`}>{row.age_human}</td>
|
|
<td className="py-1.5 pr-3">{row.event}</td>
|
|
<td className="py-1.5 pr-3">{row.ref}</td>
|
|
<td className="py-1.5 pr-3">{row.from}</td>
|
|
<td className="py-1.5 pr-3">{row.to}</td>
|
|
<td className="py-1.5 max-w-[28rem] truncate" title={row.note}>
|
|
{row.note || "-"}
|
|
</td>
|
|
</tr>
|
|
))}
|
|
{data && data.alarm.length === 0 && (
|
|
<tr>
|
|
<td colSpan={6} className="py-4 text-[var(--foreground-dim)]">
|
|
Keine Stoerungsereignisse in den letzten 24 h.
|
|
</td>
|
|
</tr>
|
|
)}
|
|
</tbody>
|
|
</table>
|
|
) : (
|
|
<table className="w-full text-left text-xs" data-testid={`task-table-${tab}`}>
|
|
<thead className="text-[10px] uppercase tracking-wider text-[var(--foreground-dim)]">
|
|
<tr>
|
|
<th className="py-2 pr-3">Alter</th>
|
|
<th className="py-2 pr-3">Task-ID</th>
|
|
<th className="py-2 pr-3">Von -> An</th>
|
|
<th className="py-2 pr-3">Typ</th>
|
|
<th className="py-2 pr-3">Prio</th>
|
|
<th className="py-2 pr-3">Status</th>
|
|
<th className="py-2 pr-3">Thema</th>
|
|
{tab === "dead-letter" && <th className="py-2">Aktion</th>}
|
|
</tr>
|
|
</thead>
|
|
<tbody className="font-mono">
|
|
{(tab === "spool" ? data?.spool : data?.dead_letter)?.map((t) => (
|
|
<tr
|
|
key={t.task_id}
|
|
data-tid={t.task_id}
|
|
data-kind={tab}
|
|
onClick={() => void openDetail(t.task_id, tab)}
|
|
className="cursor-pointer border-t border-[var(--border)] hover:bg-[var(--background-tertiary)]"
|
|
>
|
|
<td className={`py-1.5 pr-3 whitespace-nowrap ${ageClass(t.age_seconds)}`}>
|
|
{t.age_human}
|
|
</td>
|
|
<td className="py-1.5 pr-3 whitespace-nowrap">{t.task_id.slice(0, 8)}</td>
|
|
<td className="py-1.5 pr-3 whitespace-nowrap">
|
|
{t.from} -> {t.to}
|
|
</td>
|
|
<td className="py-1.5 pr-3">{t.type}</td>
|
|
<td className={`py-1.5 pr-3 ${prioClass(t.priority)}`}>{t.priority}</td>
|
|
<td className="py-1.5 pr-3">{t.status_label}</td>
|
|
<td className="py-1.5 max-w-[26rem] truncate" title={t.topic}>
|
|
{t.re_dispatch_of !== "-" && t.re_dispatch_of !== "" && (
|
|
<span
|
|
className="mr-1 text-[var(--foreground-dim)]"
|
|
title={`Re-Dispatch von ${t.re_dispatch_of}`}
|
|
data-testid={`redispatch-of-${t.task_id}`}
|
|
>
|
|
↻
|
|
</span>
|
|
)}
|
|
{t.topic}
|
|
</td>
|
|
{tab === "dead-letter" && (
|
|
<td className="py-1.5 whitespace-nowrap" data-testid={`redispatch-${t.task_id}`}>
|
|
{t.re_dispatched_to !== "-" && t.re_dispatched_to !== "" ? (
|
|
<span
|
|
className="text-[var(--foreground-dim)]"
|
|
title={`Bereits erneut zugestellt an ${t.re_dispatched_to}`}
|
|
data-testid={`redispatch-already-${t.task_id}`}
|
|
>
|
|
↻ zugestellt {t.re_dispatched_to.slice(0, 8)}
|
|
</span>
|
|
) : redis[t.task_id] ? (
|
|
<span
|
|
className={
|
|
redis[t.task_id].state === "ok"
|
|
? "text-emerald-400"
|
|
: redis[t.task_id].state === "already"
|
|
? "text-[var(--foreground-dim)]"
|
|
: redis[t.task_id].state === "busy"
|
|
? "text-[var(--foreground-dim)]"
|
|
: "text-red-400"
|
|
}
|
|
title={redis[t.task_id].msg}
|
|
>
|
|
{redis[t.task_id].state === "ok"
|
|
? "✔ "
|
|
: redis[t.task_id].state === "already"
|
|
? "✔ "
|
|
: redis[t.task_id].state === "busy"
|
|
? "… "
|
|
: "✖ "}
|
|
{redis[t.task_id].msg.slice(0, 42)}
|
|
</span>
|
|
) : (
|
|
<button
|
|
type="button"
|
|
className="rounded border border-[var(--border)] px-2 py-0.5 text-[11px] hover:bg-[var(--background-tertiary)]"
|
|
onClick={(e) => {
|
|
e.stopPropagation()
|
|
void redispatch(t.task_id)
|
|
}}
|
|
>
|
|
Erneut zustellen
|
|
</button>
|
|
)}
|
|
</td>
|
|
)}
|
|
</tr>
|
|
))}
|
|
{data && ((tab === "spool" ? data.spool : data.dead_letter).length === 0) && (
|
|
<tr>
|
|
<td
|
|
colSpan={tab === "dead-letter" ? 8 : 7}
|
|
className="py-4 text-[var(--foreground-dim)]"
|
|
>
|
|
{tab === "spool"
|
|
? "Keine offenen Tasks — Spool leer."
|
|
: "Keine fehlgeschlagenen Tasks in den letzten 7 Tagen."}
|
|
</td>
|
|
</tr>
|
|
)}
|
|
</tbody>
|
|
</table>
|
|
)}
|
|
</div>
|
|
</div>
|
|
|
|
{(detail || detailLoading || detailError) && (
|
|
<div
|
|
ref={modalRef}
|
|
className="fixed inset-0 z-50 flex items-start justify-center bg-black/70 p-4 overflow-y-auto"
|
|
onClick={(e) => {
|
|
if (e.target === modalRef.current) setDetail(null)
|
|
}}
|
|
data-testid="task-detail-modal"
|
|
>
|
|
<div className="panel w-full max-w-3xl p-6 my-8">
|
|
<div className="flex items-start justify-between gap-4">
|
|
<div>
|
|
<h2 className="text-sm font-semibold text-[var(--nvidia-green)] uppercase tracking-wider">
|
|
Task-Detail
|
|
</h2>
|
|
<p className="mt-1 text-[11px] text-[var(--foreground-dim)] font-mono">
|
|
{(detail?.task.task_id as string) || "…"}
|
|
{detail?.entry_kind ? ` · Quelle: ${detail.entry_kind}` : ""}
|
|
{detail && !detail.found ? " · kein Envelope gefunden (synthetisches Ereignis)" : ""}
|
|
</p>
|
|
</div>
|
|
<button
|
|
onClick={() => setDetail(null)}
|
|
className="px-3 py-1 text-xs font-mono border border-[var(--border)] text-[var(--foreground-dim)] hover:text-[var(--foreground)]"
|
|
data-testid="task-detail-close"
|
|
>
|
|
Schliessen (Esc)
|
|
</button>
|
|
</div>
|
|
|
|
{detailLoading && <p className="mt-4 text-xs text-[var(--foreground-dim)]">Lade Envelope…</p>}
|
|
{detailError && (
|
|
<p className="mt-4 text-xs text-[var(--status-stopped)]">Detail nicht ladbar: {detailError}</p>
|
|
)}
|
|
{detail?.degraded && (
|
|
<p className="mt-4 text-xs text-amber-400">
|
|
DEGRADED: {detail.degraded_reason || "Quelle gestoert"}
|
|
{detail.error ? ` — ${detail.error}` : ""}
|
|
</p>
|
|
)}
|
|
|
|
{detail && (
|
|
<>
|
|
<dl className="mt-4 grid grid-cols-2 gap-x-4 gap-y-2 text-xs" data-testid="task-detail-grid">
|
|
{DETAIL_FIELDS.map(([key, label]) => (
|
|
<div key={key} className="contents">
|
|
<dt className="text-[10px] uppercase tracking-wider text-[var(--foreground-dim)]">
|
|
{label}
|
|
</dt>
|
|
<dd className="font-mono break-all">{String(detail.task[key] ?? "-")}</dd>
|
|
</div>
|
|
))}
|
|
</dl>
|
|
{detail.missing_fields.length > 0 && (
|
|
<p className="mt-3 text-[10px] text-[var(--foreground-dim)]">
|
|
Fehlende Felder: {detail.missing_fields.join(", ")}
|
|
</p>
|
|
)}
|
|
<div className="mt-4">
|
|
<p className="text-[10px] uppercase tracking-wider text-[var(--foreground-dim)]">
|
|
Body (unveraendert aus dem Spool)
|
|
</p>
|
|
<pre
|
|
className="mt-1 max-h-72 overflow-auto whitespace-pre-wrap break-words border border-[var(--border)] bg-[var(--background-tertiary)] p-3 text-[11px] font-mono"
|
|
data-testid="task-detail-body"
|
|
>
|
|
{String(detail.task.body ?? "-")}
|
|
</pre>
|
|
</div>
|
|
{detail.raw_keys.length > 0 && (
|
|
<p className="mt-3 text-[10px] text-[var(--foreground-dim)]">
|
|
Envelope-Keys: {detail.raw_keys.join(", ")}
|
|
</p>
|
|
)}
|
|
{Object.keys(detail.task).length === 0 && (
|
|
<p className="mt-3 text-xs text-[var(--foreground-dim)]">Keine Daten.</p>
|
|
)}
|
|
</>
|
|
)}
|
|
</div>
|
|
</div>
|
|
)}
|
|
</div>
|
|
)
|
|
}
|