feat(api, i18n): add admin report job functionalities and enhance locale support

- Introduced new API functions for managing admin report jobs, including download and post operations.
- Updated English, Nepali, and Chinese locale files to include new messages related to report job actions and rollback confirmations.
- Enhanced user experience by providing clearer instructions and feedback in the admin interface.
- Refactored related components to integrate new functionalities and improve overall usability.
This commit is contained in:
2026-05-26 11:48:51 +08:00
parent 7fb5ec6dff
commit a76b681828
21 changed files with 1139 additions and 118 deletions

View File

@@ -0,0 +1,156 @@
"use client";
import { useCallback, useEffect, useState } from "react";
import { useTranslation } from "react-i18next";
import { toast } from "sonner";
import { Download, RefreshCw } from "lucide-react";
import { downloadAdminReportJob, getAdminReportJobs } from "@/api/admin-report-jobs";
import { AdminStatusBadge } from "@/components/admin/admin-status-badge";
import { Button } from "@/components/ui/button";
import { Card, CardContent, CardHeader, CardTitle } from "@/components/ui/card";
import {
Table,
TableBody,
TableCell,
TableHead,
TableHeader,
TableRow,
} from "@/components/ui/table";
import { useAdminDateTimeFormatter } from "@/hooks/use-admin-datetime-formatter";
import { LotteryApiBizError } from "@/types/api/errors";
import type { AdminReportJobRow } from "@/types/api/admin-report-jobs";
function downloadBlob(blob: Blob, filename: string): void {
const url = URL.createObjectURL(blob);
const anchor = document.createElement("a");
anchor.href = url;
anchor.download = filename;
document.body.appendChild(anchor);
anchor.click();
anchor.remove();
URL.revokeObjectURL(url);
}
type ReportJobsPanelProps = {
canExport: boolean;
refreshToken?: number;
};
export function ReportJobsPanel({ canExport, refreshToken = 0 }: ReportJobsPanelProps) {
const { t } = useTranslation(["reports", "common"]);
const formatTs = useAdminDateTimeFormatter();
const [jobs, setJobs] = useState<AdminReportJobRow[]>([]);
const [loading, setLoading] = useState(true);
const [downloadingId, setDownloadingId] = useState<number | null>(null);
const loadJobs = useCallback(async () => {
setLoading(true);
try {
const data = await getAdminReportJobs({ page: 1, per_page: 10 });
setJobs(data.items);
} catch (e) {
toast.error(e instanceof LotteryApiBizError ? e.message : t("tasks.loadFailed"));
setJobs([]);
} finally {
setLoading(false);
}
}, [t]);
useEffect(() => {
void loadJobs();
}, [loadJobs, refreshToken]);
async function handleDownload(job: AdminReportJobRow): Promise<void> {
if (!canExport || job.status !== "completed") {
return;
}
setDownloadingId(job.id);
try {
const { blob, filename } = await downloadAdminReportJob(job.id);
const fallback = `${job.job_no}.${job.export_format}`;
downloadBlob(blob, filename ?? fallback);
toast.success(t("tasks.downloadSuccess", { jobNo: job.job_no }));
} catch (e) {
toast.error(e instanceof LotteryApiBizError ? e.message : t("tasks.downloadFailed"));
} finally {
setDownloadingId(null);
}
}
function reportTypeLabel(reportType: string): string {
const key = `jobTypes.${reportType}`;
const label = t(key);
return label === key ? reportType : label;
}
return (
<Card className="admin-list-card">
<CardHeader className="admin-list-header flex flex-row items-center justify-between gap-3 pb-4">
<CardTitle className="admin-list-title">{t("recentTasks")}</CardTitle>
<Button type="button" variant="outline" size="sm" disabled={loading} onClick={() => void loadJobs()}>
<RefreshCw data-icon="inline-start" className={loading ? "animate-spin" : undefined} />
{t("tasks.refresh")}
</Button>
</CardHeader>
<CardContent className="pt-2">
<p className="mb-3 text-xs text-muted-foreground">{t("exportHint")}</p>
<Table>
<TableHeader>
<TableRow>
<TableHead>{t("tasks.columns.jobNo")}</TableHead>
<TableHead>{t("tasks.columns.report")}</TableHead>
<TableHead>{t("tasks.columns.format")}</TableHead>
<TableHead>{t("tasks.columns.status")}</TableHead>
<TableHead>{t("tasks.columns.createdAt")}</TableHead>
<TableHead>{t("tasks.columns.actions")}</TableHead>
</TableRow>
</TableHeader>
<TableBody>
{loading ? (
<TableRow>
<TableCell colSpan={6} className="text-muted-foreground">
{t("states.loading", { ns: "common" })}
</TableCell>
</TableRow>
) : jobs.length === 0 ? (
<TableRow>
<TableCell colSpan={6} className="text-muted-foreground">
{t("taskEmpty")}
</TableCell>
</TableRow>
) : (
jobs.map((job) => (
<TableRow key={job.id}>
<TableCell className="font-mono text-xs">{job.job_no}</TableCell>
<TableCell className="text-sm">{reportTypeLabel(job.report_type)}</TableCell>
<TableCell className="uppercase">{job.export_format}</TableCell>
<TableCell>
<AdminStatusBadge status={job.status}>
{t(`tasks.status.${job.status}`, { defaultValue: job.status })}
</AdminStatusBadge>
</TableCell>
<TableCell className="text-xs text-muted-foreground">
{formatTs(job.created_at ?? job.finished_at)}
</TableCell>
<TableCell>
<Button
type="button"
variant="outline"
size="sm"
disabled={!canExport || job.status !== "completed" || downloadingId === job.id}
onClick={() => void handleDownload(job)}
>
<Download data-icon="inline-start" />
{t("tasks.download")}
</Button>
</TableCell>
</TableRow>
))
)}
</TableBody>
</Table>
</CardContent>
</Card>
);
}