184 lines
7.7 KiB
TypeScript
184 lines
7.7 KiB
TypeScript
/**
|
|
* Phase 10 Task #67 — Admin (system-wide) Compliance-Audit-Export.
|
|
*
|
|
* Streams a filtered CSV of AuditEvent rows across ALL tenants. Filters:
|
|
* date range, regulatoryScope, actorType, outcome. The first CSV line is
|
|
* a `# verifyAuditChain` integrity header so the download itself doubles
|
|
* as evidence that the chain is intact.
|
|
*
|
|
* Tenant-scoped variant lives at routes/app.$tenant/settings/audit-export.tsx.
|
|
*/
|
|
import type { LoaderFunctionArgs } from "react-router";
|
|
import { useLoaderData } from "react-router";
|
|
import { useTranslation } from "react-i18next";
|
|
import { getDbClient } from "@toolctrl/db/client.server";
|
|
import { verifyUserHasPermission } from "~/utils/helpers/.server/PermissionsService";
|
|
import { getTranslations } from "~/locale/i18next.server";
|
|
import { useLocaleFormatters } from "~/locale/format";
|
|
import IndexPageLayout from "~/components/ui/layouts/IndexPageLayout";
|
|
import {
|
|
AUDIT_EXPORT_MAX_ROWS,
|
|
buildAuditExportWhere,
|
|
computeAuditIntegritySummary,
|
|
parseAuditExportFilters,
|
|
renderAuditExportCsv,
|
|
type AuditExportRow,
|
|
} from "./audit-export.helpers.server";
|
|
import { buildAuditPdfLabels, renderAuditExportPdfResponse } from "~/utils/audit/pdfRender";
|
|
|
|
type LoaderData = {
|
|
title: string;
|
|
defaultFrom: string;
|
|
defaultTo: string;
|
|
maxRows: number;
|
|
};
|
|
|
|
export const loader = async ({ request }: LoaderFunctionArgs) => {
|
|
await verifyUserHasPermission(request, "admin.auditTrails.view");
|
|
const { t } = await getTranslations(request);
|
|
const url = new URL(request.url);
|
|
|
|
if (url.searchParams.get("export") === "csv") {
|
|
return streamAdminAuditExport(url);
|
|
}
|
|
if (url.searchParams.get("export") === "pdf" || url.searchParams.get("format") === "pdf") {
|
|
return streamAdminAuditPdfExport(url, t);
|
|
}
|
|
|
|
const today = new Date();
|
|
const fromDate = new Date(today);
|
|
fromDate.setDate(fromDate.getDate() - 30);
|
|
const data: LoaderData = {
|
|
title: `${t("models.log.plural")} | ${process.env.APP_NAME}`,
|
|
defaultFrom: fromDate.toISOString().slice(0, 10),
|
|
defaultTo: today.toISOString().slice(0, 10),
|
|
maxRows: AUDIT_EXPORT_MAX_ROWS,
|
|
};
|
|
return Response.json(data);
|
|
};
|
|
|
|
async function streamAdminAuditExport(url: URL): Promise<Response> {
|
|
const filters = parseAuditExportFilters(url);
|
|
const db = getDbClient();
|
|
const rows = (await db.auditEvent.findMany({
|
|
where: buildAuditExportWhere(filters),
|
|
orderBy: { createdAt: "asc" },
|
|
take: AUDIT_EXPORT_MAX_ROWS,
|
|
})) as unknown as AuditExportRow[];
|
|
|
|
const integrity = computeAuditIntegritySummary(rows);
|
|
const csv = renderAuditExportCsv(rows, integrity);
|
|
return new Response(csv, {
|
|
headers: {
|
|
"Content-Type": "text/csv; charset=utf-8",
|
|
"Content-Disposition": `attachment; filename="audit-export-admin-${url.searchParams.get("from") ?? "all"}_${url.searchParams.get("to") ?? "all"}.csv"`,
|
|
"X-Audit-Chain-Status": integrity.ok ? "ok" : "broken",
|
|
},
|
|
});
|
|
}
|
|
|
|
async function streamAdminAuditPdfExport(url: URL, t: Awaited<ReturnType<typeof getTranslations>>["t"]): Promise<Response> {
|
|
const filters = parseAuditExportFilters(url);
|
|
const db = getDbClient();
|
|
const rows = (await db.auditEvent.findMany({
|
|
where: buildAuditExportWhere(filters),
|
|
orderBy: { createdAt: "asc" },
|
|
take: AUDIT_EXPORT_MAX_ROWS,
|
|
})) as unknown as AuditExportRow[];
|
|
const integrity = computeAuditIntegritySummary(rows);
|
|
return renderAuditExportPdfResponse(
|
|
{
|
|
tenantId: filters.tenantId,
|
|
filters,
|
|
integrity,
|
|
rows,
|
|
labels: buildAuditPdfLabels(t),
|
|
},
|
|
{ filenamePrefix: "audit-export-admin" }
|
|
);
|
|
}
|
|
|
|
export default function AdminAuditExportRoute() {
|
|
const data = useLoaderData<LoaderData>();
|
|
const { t } = useTranslation(["settings", "translations"]);
|
|
const formatters = useLocaleFormatters();
|
|
return (
|
|
<IndexPageLayout title={t("translations:models.log.plural")}>
|
|
<div className="space-y-6 p-6">
|
|
<header>
|
|
<h1 className="text-xl font-semibold">{t("translations:models.log.plural")}</h1>
|
|
<p className="text-sm text-gray-500">
|
|
{t(
|
|
"auditExport.descriptionAdmin",
|
|
{ maxRows: formatters.number(data.maxRows) }
|
|
)}
|
|
</p>
|
|
</header>
|
|
<form method="get" className="grid gap-4 sm:grid-cols-2 lg:grid-cols-3" action="">
|
|
<input type="hidden" name="export" value="csv" />
|
|
<label className="text-sm">
|
|
<span className="block">{t("auditExport.filters.fromUtc")}</span>
|
|
<input type="date" name="from" defaultValue={data.defaultFrom} className="mt-1 w-full rounded border px-2 py-1" />
|
|
</label>
|
|
<label className="text-sm">
|
|
<span className="block">{t("auditExport.filters.toUtc")}</span>
|
|
<input type="date" name="to" defaultValue={data.defaultTo} className="mt-1 w-full rounded border px-2 py-1" />
|
|
</label>
|
|
<label className="text-sm">
|
|
<span className="block">{t("auditExport.filters.tenantIdOptional")}</span>
|
|
<input
|
|
type="text"
|
|
name="tenantId"
|
|
className="mt-1 w-full rounded border px-2 py-1"
|
|
placeholder={t("auditExport.filters.tenantIdPlaceholder")}
|
|
/>
|
|
</label>
|
|
<label className="text-sm">
|
|
<span className="block">{t("auditExport.filters.regulatoryScope")}</span>
|
|
<select name="regulatoryScope" className="mt-1 w-full rounded border px-2 py-1" defaultValue="">
|
|
<option value="">{t("auditExport.filters.any")}</option>
|
|
<option value="soc2">{t("auditExport.scopes.soc2")}</option>
|
|
<option value="gdpr">{t("auditExport.scopes.gdpr")}</option>
|
|
<option value="hipaa">{t("auditExport.scopes.hipaa")}</option>
|
|
<option value="pci">{t("auditExport.scopes.pci")}</option>
|
|
</select>
|
|
</label>
|
|
<label className="text-sm">
|
|
<span className="block">{t("auditExport.filters.actorType")}</span>
|
|
<select name="actorType" className="mt-1 w-full rounded border px-2 py-1" defaultValue="">
|
|
<option value="">{t("auditExport.filters.any")}</option>
|
|
<option value="user">{t("auditExport.actorTypes.user")}</option>
|
|
<option value="admin">{t("auditExport.actorTypes.admin")}</option>
|
|
<option value="api_key">{t("auditExport.actorTypes.apiKey")}</option>
|
|
<option value="system">{t("auditExport.actorTypes.system")}</option>
|
|
<option value="plugin">{t("auditExport.actorTypes.plugin")}</option>
|
|
</select>
|
|
</label>
|
|
<label className="text-sm">
|
|
<span className="block">{t("auditExport.filters.outcome")}</span>
|
|
<select name="outcome" className="mt-1 w-full rounded border px-2 py-1" defaultValue="">
|
|
<option value="">{t("auditExport.filters.any")}</option>
|
|
<option value="success">{t("auditExport.outcomes.success")}</option>
|
|
<option value="failure">{t("auditExport.outcomes.failure")}</option>
|
|
<option value="blocked">{t("auditExport.outcomes.blocked")}</option>
|
|
</select>
|
|
</label>
|
|
<div className="flex flex-wrap gap-3 sm:col-span-2 lg:col-span-3">
|
|
<button type="submit" className="rounded bg-blue-600 px-4 py-2 text-sm font-medium text-white hover:bg-blue-500">
|
|
{t("auditExport.downloadCsv")}
|
|
</button>
|
|
<button
|
|
type="submit"
|
|
name="export"
|
|
value="pdf"
|
|
className="rounded border border-blue-600 bg-white px-4 py-2 text-sm font-medium text-blue-600 hover:bg-blue-50"
|
|
>
|
|
{t("auditExport.downloadPdf")}
|
|
</button>
|
|
</div>
|
|
</form>
|
|
</div>
|
|
</IndexPageLayout>
|
|
);
|
|
}
|