Track HiveGrid Cloud planning reference

This commit is contained in:
david committed 2026-06-26 20:48:01 +02:00
1 parent b3d5ea6764
commit e341c5938a
5784 files changed
+1104929 -3

No files matched your search

@@ -0,0 +1,183 @@
/**
* 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>
);
}