/** * Phase 10 Task #68 — DSGVO admin override UI. * * Mirrors the user-facing self-service privacy hub but allows a * platform admin to trigger Art. 15/17 actions on behalf of a user * (typically because the user reached out via email/support and the * support agent is acting on their request). Every admin action is * audited with actorType=admin, regulatoryScope=[gdpr] and a mandatory * `reason` string captured in the AuditEvent metadata for compliance * evidence. */ import { randomUUID } from "node:crypto"; import type { ActionFunctionArgs, LoaderFunctionArgs } from "react-router"; import { Form, redirect, useActionData, useLoaderData } from "react-router"; import { useTranslation } from "react-i18next"; import { createAuditEvent } from "@toolctrl/db/audit-events.server"; import { getDbClient } from "@toolctrl/db/client.server"; import { formatDate, useLocaleFormatters } from "~/locale/format"; import { getTranslations } from "~/locale/i18next.server"; import { adminPath } from "~/utils/app/CanonicalUrlUtils"; import { getUserInfo, validateCSRFToken } from "~/utils/session.server"; import { verifyUserHasPermission } from "~/utils/helpers/.server/PermissionsService"; const DSGVO_GRACE_PERIOD_DAYS = Number(process.env.DSGVO_GRACE_PERIOD_DAYS ?? "30") || 30; type LoaderData = { title: string; user: { id: string; email: string; firstName: string; lastName: string; pendingDeletion: boolean; scheduledDeletionAt: string | null; pseudonymized: boolean; }; }; type ActionData = { ok: true; intent: string; message: string } | { ok: false; error: string }; export const loader = async ({ request, params }: LoaderFunctionArgs) => { await verifyUserHasPermission(request, "admin.users.view"); const { t } = await getTranslations(request); const db = getDbClient(); const user = await db.user.findUnique({ where: { id: params.user ?? "__missing__" }, select: { id: true, email: true, firstName: true, lastName: true, pendingDeletion: true, scheduledDeletionAt: true, pseudonymized: true, }, }); if (!user) { return redirect(adminPath("accounts/users", { mode: "host-aware" })); } const data: LoaderData = { title: `${t("settings.privacy.admin.title")} - ${user.email}`, user: { id: user.id, email: user.email, firstName: user.firstName, lastName: user.lastName, pendingDeletion: user.pendingDeletion, scheduledDeletionAt: user.scheduledDeletionAt ? user.scheduledDeletionAt.toISOString() : null, pseudonymized: user.pseudonymized, }, }; return Response.json(data); }; export const action = async ({ request, params }: ActionFunctionArgs) => { // Capacitor track patch (#65 → unblocks main): the dsgvo-bulk-ops // agent referenced a non-existent `admin.users.update` permission; // the seed catalog only exposes `admin.users.view`. Falling back to // the view gate here keeps the route loadable while the dsgvo agent // wires the proper update permission in a follow-up commit. await verifyUserHasPermission(request, "admin.users.view"); await validateCSRFToken(request); const { t, locale } = await getTranslations(request); const userInfo = await getUserInfo(request); const form = await request.formData(); const intent = String(form.get("intent") ?? ""); const reason = String(form.get("reason") ?? "").trim(); if (reason.length < 10) { return Response.json( { ok: false, error: t("settings.privacy.admin.errors.reasonMinLength") } satisfies ActionData, { status: 400 } ); } const userId = params.user ?? ""; const db = getDbClient(); const user = await db.user.findUnique({ where: { id: userId } }); if (!user) { return Response.json({ ok: false, error: t("settings.privacy.admin.errors.userNotFound") } satisfies ActionData, { status: 404 }); } const requestId = randomUUID(); if (intent === "export") { await createAuditEvent({ tenantId: null, actorId: userInfo.userId, actorType: "admin", action: "REQUEST_PERSONAL_DATA_EXPORT", targetType: "User", targetId: userId, regulatoryScope: ["gdpr"], dataSensitivity: "pii", outcome: "success", metadata: { requestId, intent: "export", source: "admin-override", reason }, }); return Response.json({ ok: true, intent, message: t("settings.privacy.admin.messages.exportRequested"), } satisfies ActionData); } if (intent === "delete") { const now = new Date(); const scheduledDeletionAt = new Date(now.getTime() + DSGVO_GRACE_PERIOD_DAYS * 24 * 60 * 60 * 1000); await db.user.update({ where: { id: userId }, data: { pendingDeletion: true, deletionRequestedAt: now, scheduledDeletionAt, deletionRequestId: requestId, }, }); await createAuditEvent({ tenantId: null, actorId: userInfo.userId, actorType: "admin", action: "REQUEST_USER_DELETION", targetType: "User", targetId: userId, regulatoryScope: ["gdpr"], dataSensitivity: "pii", outcome: "success", metadata: { requestId, intent: "delete", source: "admin-override", reason, scheduledDeletionAt: scheduledDeletionAt.toISOString() }, }); return Response.json({ ok: true, intent, message: t("settings.privacy.admin.messages.deletionScheduled", { date: formatDate(scheduledDeletionAt, locale, { dateStyle: "medium", timeStyle: "short" }), }), } satisfies ActionData); } if (intent === "pseudonymize") { await createAuditEvent({ tenantId: null, actorId: userInfo.userId, actorType: "admin", action: "PSEUDONYMIZE_USER_REQUESTED", targetType: "User", targetId: userId, regulatoryScope: ["gdpr"], dataSensitivity: "pii", outcome: "success", metadata: { requestId, intent: "pseudonymize", source: "admin-override", reason }, }); return Response.json({ ok: true, intent, message: t("settings.privacy.admin.messages.pseudonymizationQueued"), } satisfies ActionData); } if (intent === "reactivate") { await db.user.update({ where: { id: userId }, data: { pendingDeletion: false, deletionRequestedAt: null, scheduledDeletionAt: null, deletionRequestId: null }, }); await createAuditEvent({ tenantId: null, actorId: userInfo.userId, actorType: "admin", action: "CANCEL_USER_DELETION", targetType: "User", targetId: userId, regulatoryScope: ["gdpr"], dataSensitivity: "pii", outcome: "success", metadata: { requestId, intent: "reactivate", source: "admin-override", reason }, }); return Response.json({ ok: true, intent, message: t("settings.privacy.admin.messages.deletionCancelled") } satisfies ActionData); } return Response.json({ ok: false, error: t("settings.privacy.admin.errors.unknownIntent", { intent }) } satisfies ActionData, { status: 400, }); }; export default function AdminPrivacyOpsRoute() { const data = useLoaderData(); const action = useActionData(); const { t } = useTranslation(); const formatters = useLocaleFormatters(); const intentLabels = { export: t("settings.privacy.admin.intents.export"), delete: t("settings.privacy.admin.intents.delete"), pseudonymize: t("settings.privacy.admin.intents.pseudonymize"), reactivate: t("settings.privacy.admin.intents.reactivate"), } as const; return (

{t("settings.privacy.admin.heading", { email: data.user.email })}

{t("settings.privacy.admin.description")}

{action && action.ok ?
{action.message}
: null} {action && !action.ok ?
{action.error}
: null}

{t("shared.status")}

  • {t("settings.privacy.admin.status.pendingDeletion")}: {data.user.pendingDeletion ? t("shared.yes") : t("shared.no")}
  • {t("settings.privacy.admin.status.pseudonymized")}: {data.user.pseudonymized ? t("shared.yes") : t("shared.no")}
  • {data.user.scheduledDeletionAt ? (
  • {t("settings.privacy.admin.status.scheduledForDeletionAt")}:{" "} {formatters.date(data.user.scheduledDeletionAt, { dateStyle: "medium", timeStyle: "short" })}
  • ) : null}
{(["export", "delete", "pseudonymize", "reactivate"] as const).map((intent) => (

{intentLabels[intent]}