361 lines
17 KiB
TypeScript
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";
|
|
}
|