Files

361 lines
17 KiB
TypeScript

import { useTranslation } from "react-i18next";
import { Form, useNavigate } from "react-router";
import {
FeatherAlertTriangle,
FeatherCheckCircle,
FeatherClock,
FeatherFileText,
FeatherPauseCircle,
FeatherPlayCircle,
FeatherRefreshCw,
FeatherRotateCcw,
} from "@subframe/core";
import type { QueueMonitorVM, QueueMonitorRow } from "@hivegrid/view-models";
import { BadgeFeedback } from "~/ui/components/BadgeFeedback";
import { Dialog } from "~/ui/components/Dialog";
import { BannerAlert } from "~/ui/components/BannerAlert";
import { Button } from "~/ui/components/Button";
import { Card } from "~/ui/components/Card";
import { EmptyState } from "~/ui/components/EmptyState";
import { StatsCard } from "~/ui/components/StatsCard";
import { Table } from "~/ui/components/Table";
import { TextArea } from "~/ui/components/TextArea";
import { TextInput } from "~/ui/components/TextInput";
import { useLocaleFormatters } from "~/locale/format";
type FailedJob = {
/** BullMQ wire id — retry and detail requests must send this value. */
id: string;
/** Human-readable id for operator text; see `fromBullMqJobId`. */
displayId: string;
name: string;
failedReason: string | null;
attemptsMade: number;
timestamp: number | null;
};
type FailedQueue = { queueName: string; jobs: readonly FailedJob[] };
export type JobDetailView = {
queueName: string;
job: {
id: string;
displayId: string;
name: string;
failedReason: string | null;
stacktrace: readonly string[];
attemptsMade: number;
timestamp: number | null;
processedOn: number | null;
finishedOn: number | null;
};
};
const PRODUCT_PROVIDER_OUTBOX_QUEUE = "outbox.billing-product-provider";
export type AdminJobsPageProps = {
vm: QueueMonitorVM;
failedJobs: FailedQueue[];
csrf: string;
submitting: boolean;
canManagePortalDomainKillSwitch: boolean;
feedback?: { success?: string; error?: string };
jobDetail?: JobDetailView | null;
};
/** D-ADMIN S08: app-chrome-free queue monitor interim screen. */
export function AdminJobsPage({ vm, failedJobs, csrf, submitting, canManagePortalDomainKillSwitch, feedback, jobDetail }: AdminJobsPageProps): React.JSX.Element {
const { t } = useTranslation();
const ready = vm.status === "ready" ? vm.data : null;
return (
<div data-ui-id="ui.admin.jobs.page" className="flex w-full flex-col items-start bg-surface-neutral-primary">
<header className="flex w-full items-start gap-4 border-b border-solid border-border-default bg-surface-neutral-secondary px-6 py-5 mobile:px-4">
<div className="flex grow shrink-0 basis-0 flex-col items-start">
<h1 className="text-subtitle font-subtitle text-text-neutral-primary">{t("admin.jobs.title")}</h1>
<p className="text-body-small-regular-150 font-body-small-regular-150 text-text-neutral-tertiary">{t("admin.jobs.description")}</p>
</div>
</header>
{feedback?.success ? <BannerAlert type="success" fillContainer>{feedback.success}</BannerAlert> : null}
{feedback?.error ? <BannerAlert type="error" fillContainer>{feedback.error}</BannerAlert> : null}
<div className="flex w-full flex-col items-start gap-6 px-6 py-6 mobile:px-4">
{vm.status === "error" ? (
<EmptyState
variant="error"
outlined
title={t("admin.jobs.errors.queueUnavailableTitle")}
body={t(vm.error.messageKey)}
/>
) : vm.status === "empty" || !ready ? (
<EmptyState outlined title={t("admin.queues.empty.headline")} body={t("admin.queues.empty.body")} />
) : (
<>
<QueueSummary vm={ready} />
<div className="grid w-full grid-cols-2 gap-4 mobile:grid-cols-1">
{ready.rows.map((row) => (
<QueueCard
key={row.queueName}
row={row}
failedJobs={failedJobs.find((item) => item.queueName === row.queueName)?.jobs ?? []}
csrf={csrf}
submitting={submitting}
/>
))}
</div>
</>
)}
{canManagePortalDomainKillSwitch ? <PortalDomainKillSwitch csrf={csrf} submitting={submitting} /> : null}
</div>
{jobDetail ? <JobDetailDialog detail={jobDetail} /> : null}
</div>
);
}
function JobDetailDialog({ detail }: { detail: JobDetailView }): React.JSX.Element {
const { t } = useTranslation();
const formatters = useLocaleFormatters();
const navigate = useNavigate();
const close = () => navigate(".", { replace: true });
const timelineEntries: Array<{ labelKey: string; value: number | null }> = [
{ labelKey: "admin.jobs.detail.enqueuedAt", value: detail.job.timestamp },
{ labelKey: "admin.jobs.detail.processedAt", value: detail.job.processedOn },
{ labelKey: "admin.jobs.detail.finishedAt", value: detail.job.finishedOn },
];
return (
<Dialog open onOpenChange={(open) => (open ? undefined : close())}>
<Dialog.Content className="w-[720px] max-w-[95vw] p-8">
<div className="flex w-full flex-col gap-6">
<div className="flex w-full items-start justify-between gap-4">
<div className="flex min-w-0 flex-col gap-1">
<span className="text-heading-3 font-heading-3 text-text-neutral-primary">{detail.job.name}</span>
<span className="text-body-small-regular-150 font-body-small-regular-150 text-text-neutral-tertiary">
{t("admin.jobs.detail.meta", { queue: detail.queueName, id: detail.job.displayId, attempts: detail.job.attemptsMade })}
</span>
</div>
<Button type="button" variant="tertiary" onClick={close}>{t("shared.close")}</Button>
</div>
<div className="grid w-full grid-cols-3 gap-4 mobile:grid-cols-1">
{timelineEntries.map((entry) => (
<div key={entry.labelKey} className="flex flex-col items-start gap-1">
<span className="text-body-extra-small-medium-0 font-body-extra-small-medium-0 uppercase text-text-neutral-tertiary">{t(entry.labelKey)}</span>
<span className="text-body-small-regular-150 font-body-small-regular-150 text-text-neutral-primary">
{entry.value ? formatters.dateTime(new Date(entry.value)) : t("shared.notSet")}
</span>
</div>
))}
</div>
<div className="flex w-full flex-col items-start gap-2">
<span className="text-body-default-semibold-0 font-body-default-semibold-0 text-text-neutral-primary">{t("admin.jobs.detail.failedReason")}</span>
<span className="break-all text-body-small-regular-150 font-body-small-regular-150 text-text-feedback-negative">
{detail.job.failedReason || t("shared.notSet")}
</span>
</div>
<div className="flex w-full flex-col items-start gap-2">
<span className="text-body-default-semibold-0 font-body-default-semibold-0 text-text-neutral-primary">{t("admin.jobs.detail.stacktrace")}</span>
{detail.job.stacktrace.length === 0 ? (
<span className="text-body-small-regular-150 font-body-small-regular-150 text-text-neutral-tertiary">{t("admin.jobs.detail.noStacktrace")}</span>
) : (
<div className="max-h-[320px] w-full overflow-auto rounded-md border border-solid border-border-default bg-surface-neutral-secondary p-4">
{detail.job.stacktrace.map((frame, index) => (
<pre key={index} className="whitespace-pre-wrap break-all font-mono text-xs text-text-neutral-primary">{frame}</pre>
))}
</div>
)}
</div>
</div>
</Dialog.Content>
</Dialog>
);
}
function PortalDomainKillSwitch({ csrf, submitting }: { csrf: string; submitting: boolean }): React.JSX.Element {
const { t } = useTranslation();
return (
<Card>
<div className="flex w-full flex-col items-start gap-4">
<div className="flex flex-col items-start gap-1">
<h2 className="text-body-large-0 font-body-large-0 text-text-neutral-primary">
{t("admin.jobs.portalDomainKillSwitch.title")}
</h2>
<p className="text-body-small-regular-150 font-body-small-regular-150 text-text-neutral-tertiary">
{t("admin.jobs.portalDomainKillSwitch.description")}
</p>
</div>
<BannerAlert type="warning" fillContainer>
{t("admin.jobs.portalDomainKillSwitch.warning")}
</BannerAlert>
<Form method="post" className="flex w-full max-w-[640px] flex-col items-start gap-4">
<input type="hidden" name="csrf" value={csrf} />
<TextInput showLabel fillContainer label={t("admin.jobs.portalDomainKillSwitch.tenantIdLabel")}>
<TextInput.Input name="tenantId" required autoComplete="off" />
</TextInput>
<TextArea showLabel label={t("admin.jobs.portalDomainKillSwitch.reasonLabel")}>
<TextArea.Input name="reason" required minLength={5} />
</TextArea>
<div className="flex flex-wrap items-center gap-3">
<Button
type="submit"
name="action"
value="portal-domain-kill-enable"
variant="destructive"
loading={submitting}
>
{t("admin.jobs.portalDomainKillSwitch.enable")}
</Button>
<Button
type="submit"
name="action"
value="portal-domain-kill-disable"
variant="tertiary"
loading={submitting}
>
{t("admin.jobs.portalDomainKillSwitch.disable")}
</Button>
</div>
</Form>
</div>
</Card>
);
}
function QueueSummary({ vm }: { vm: NonNullable<QueueMonitorVM["data"]> }): React.JSX.Element {
const { t } = useTranslation();
const waiting = vm.rows.reduce((sum, row) => sum + row.waiting + row.delayed, 0);
const active = vm.rows.reduce((sum, row) => sum + row.active, 0);
return (
<div className="grid w-full grid-cols-4 gap-4 mobile:grid-cols-1">
<StatsCard trend={vm.overallSignal === "ok" ? "positive" : "negative"} label={t("admin.jobs.summary.health")} value={t(vm.overallLabelKey)} percentage="" comparisonText="" icon={<FeatherCheckCircle />} />
<StatsCard trend={vm.failedTotal > 0 ? "negative" : "positive"} label={t("admin.jobs.summary.failed")} value={vm.failedTotal} percentage="" comparisonText="" icon={<FeatherAlertTriangle />} />
<StatsCard trend="neutral" label={t("admin.jobs.summary.inFlight")} value={active} percentage="" comparisonText="" icon={<FeatherRefreshCw />} />
<StatsCard trend={waiting > 0 ? "negative" : "positive"} label={t("admin.jobs.summary.backlog")} value={waiting} percentage="" comparisonText="" icon={<FeatherClock />} />
</div>
);
}
function QueueCard({ row, failedJobs, csrf, submitting }: { row: QueueMonitorRow; failedJobs: readonly FailedJob[]; csrf: string; submitting: boolean }): React.JSX.Element {
const { t } = useTranslation();
return (
<Card>
<div className="flex w-full items-start justify-between gap-4 mobile:flex-col">
<div className="flex min-w-0 flex-col items-start gap-2">
<div className="flex flex-wrap items-center gap-2">
<BadgeFeedback farbe={queueTone(row.healthSignal)} size="small">{t(row.healthLabelKey)}</BadgeFeedback>
<BadgeFeedback farbe="subtle-neutral" size="small">{t(row.groupLabelKey)}</BadgeFeedback>
</div>
<span className="break-all text-body-large-0 font-body-large-0 text-text-neutral-primary">{row.queueName}</span>
</div>
<Form method="post">
<input type="hidden" name="csrf" value={csrf} />
<input type="hidden" name="queueName" value={row.queueName} />
<input type="hidden" name="action" value={row.paused ? "resume" : "pause"} />
<Button
type="submit"
variant="secondary"
size="small"
loading={submitting}
icon={row.paused ? <FeatherPlayCircle /> : <FeatherPauseCircle />}
>
{row.paused ? t("admin.jobs.actions.resume") : t("admin.jobs.actions.pause")}
</Button>
</Form>
</div>
<Table
header={
<Table.HeaderRow>
<Table.HeaderCell>{t("admin.jobs.metrics.active")}</Table.HeaderCell>
<Table.HeaderCell>{t("admin.jobs.metrics.waiting")}</Table.HeaderCell>
<Table.HeaderCell>{t("admin.jobs.metrics.delayed")}</Table.HeaderCell>
<Table.HeaderCell>{t("admin.jobs.metrics.failed")}</Table.HeaderCell>
<Table.HeaderCell>{t("admin.jobs.metrics.completed")}</Table.HeaderCell>
</Table.HeaderRow>
}
>
<Table.Row>
{[row.active, row.waiting, row.delayed, row.failed, row.completed].map((value, index) => (
<Table.Cell key={index}><span className="text-body-default-semibold-0 font-body-default-semibold-0 text-text-neutral-primary">{value}</span></Table.Cell>
))}
</Table.Row>
</Table>
<FailedJobs queueName={row.queueName} jobs={failedJobs} csrf={csrf} submitting={submitting} />
</Card>
);
}
function FailedJobs({ queueName, jobs, csrf, submitting }: { queueName: string; jobs: readonly FailedJob[]; csrf: string; submitting: boolean }): React.JSX.Element {
const { t } = useTranslation();
const formatters = useLocaleFormatters();
const navigate = useNavigate();
const requiresGenerationAwareReplay = queueName === PRODUCT_PROVIDER_OUTBOX_QUEUE;
return (
<div className="flex w-full flex-col items-start gap-3 border-t border-solid border-border-default pt-4">
<span className="text-body-default-semibold-0 font-body-default-semibold-0 text-text-neutral-primary">{t("admin.jobs.failedJobs.title")}</span>
{requiresGenerationAwareReplay && jobs.length > 0 ? (
<BannerAlert type="warning" fillContainer>
{t("admin.jobs.failedJobs.generationAwareReplay")}
</BannerAlert>
) : null}
{jobs.length === 0 ? (
<span className="text-body-small-regular-150 font-body-small-regular-150 text-text-neutral-tertiary">{t("admin.jobs.failedJobs.empty")}</span>
) : (
jobs.map((job) => (
<div key={job.id} className="flex w-full items-start justify-between gap-4 rounded-md border border-solid border-border-default bg-surface-neutral-primary px-4 py-4 mobile:flex-col">
<div className="flex min-w-0 flex-col items-start gap-1">
<span className="break-all text-body-default-medium-0 font-body-default-medium-0 text-text-neutral-primary">{job.name}</span>
<span className="break-all text-body-small-regular-150 font-body-small-regular-150 text-text-feedback-negative">{job.failedReason || t("shared.notSet")}</span>
<span className="text-body-extra-small-regular-150 font-body-extra-small-regular-150 text-text-neutral-tertiary">
{t("admin.jobs.failedJobs.meta", { id: job.displayId, attempts: job.attemptsMade, timestamp: job.timestamp ? formatters.dateTime(new Date(job.timestamp)) : t("shared.notSet") })}
</span>
</div>
<div className="flex shrink-0 flex-wrap items-center gap-2">
{/*
A `<button>` inside an `<a>` is invalid markup, and it made the
first click land on the button while only the second one reached
the link (admin audit 2026-07-26, P0-10). The control opens a
dialog on the same page, so a button that navigates is both valid
and the more accurate semantics.
The query carries the BullMQ wire id, not `displayId`: the wire
form is what the queue can look up, and percent-encoding it once
is correct even though the result contains `%253A`. Decoding the
display form back would be ambiguous for keys that legitimately
contain a percent sign.
*/}
<Button
type="button"
variant="secondary"
size="small"
icon={<FeatherFileText />}
onClick={() => navigate(`?detailQueue=${encodeURIComponent(queueName)}&detailJob=${encodeURIComponent(job.id)}`, { preventScrollReset: true })}
>
{t("admin.jobs.actions.detail")}
</Button>
{requiresGenerationAwareReplay ? null : (
<Form method="post">
<input type="hidden" name="csrf" value={csrf} />
<input type="hidden" name="queueName" value={queueName} />
<input type="hidden" name="jobId" value={job.id} />
<input type="hidden" name="action" value="retry-job" />
<Button type="submit" size="small" loading={submitting} icon={<FeatherRotateCcw />}>{t("admin.jobs.actions.retry")}</Button>
</Form>
)}
</div>
</div>
))
)}
</div>
);
}
function queueTone(signal: QueueMonitorRow["healthSignal"]): "subtle-positive" | "subtle-warning" | "subtle-negative" {
if (signal === "ok") return "subtle-positive";
if (signal === "paused") return "subtle-warning";
return "subtle-negative";
}