// P4 Files (AK-P4a) §11 — File detail route. Loader builds FileDetailVM (proxy // URLs only, AD-23); action handles archive/reactivate/delete/regenerate + // audit. Not-visible / foreign file -> 404. Baseline functional UI. import { type ActionFunctionArgs, type LoaderFunctionArgs, redirect, useLoaderData } from "react-router"; import { useTranslation } from "react-i18next"; import { buildFileDetailVM, type FileDetailVM, type FileLinkedEntity } from "@toolctrl/view-models"; import { getTranslations } from "~/locale/i18next.server"; import { badRequestResponse, loadFilesContext, notFoundResponse, requireFilesPermission } from "~/utils/integrations/fileAccess.server"; import { archiveFile, getVisibleFileWithLinks, hardDeleteFile, linkFile, reactivateFile, regenerateFilePreview, unlinkFile, type FileEntityType, } from "~/utils/integrations/fileService.server"; import { auditFileEvent, logFileActivity } from "~/utils/integrations/fileAudit.server"; import { filesDetailPath, mediaVariantPath } from "~/utils/integrations/fileRoutePaths"; import ServerError from "~/components/ui/errors/ServerError"; type LoaderData = { title: string; vm: FileDetailVM }; const FILE_ENTITY_TYPES: FileEntityType[] = [ "contact", "company", "lead", "deal", "project", "user", "form_submission", "order", "task", "appointment", ]; export const loader = async ({ request, params }: LoaderFunctionArgs) => { const { t } = await getTranslations(request); const ctx = await loadFilesContext({ request, params, requireModule: true }); const fileId = params.id ?? ""; const tenantSlug = params.tenant ?? ""; let file, links; try { ({ file, links } = await getVisibleFileWithLinks(ctx.tenantId, fileId, ctx)); } catch { throw notFoundResponse(); } const linkedEntities: FileLinkedEntity[] = links.map((link) => ({ entityType: link.entityType, entityId: link.entityId, linkRole: link.linkRole, href: null, })); const vm = buildFileDetailVM({ id: file.id, displayName: file.displayName, mimeType: file.mimeType, sizeBytes: file.sizeBytes, createdAtIso: file.createdAt.toISOString(), tags: file.tags, notes: file.notes, source: file.source, previewStatus: file.previewStatus as never, scanStatus: file.scanStatus as never, previewUrl: file.previewStorageKey && file.previewStatus === "ready" ? mediaVariantPath(tenantSlug, file.id, "preview") : null, downloadUrl: mediaVariantPath(tenantSlug, file.id, "original"), assignedToUserId: file.assignedToUserId, linkedEntities, canWrite: ctx.permissions.includes("files.write"), canDelete: ctx.permissions.includes("files.delete"), canAdmin: ctx.permissions.includes("files.admin"), }); return Response.json({ title: `${file.displayName} | ${process.env.APP_NAME}`, vm } satisfies LoaderData); }; export const action = async ({ request, params }: ActionFunctionArgs) => { const ctx = await loadFilesContext({ request, params, requireModule: true }); const fileId = params.id ?? ""; const tenantSlug = params.tenant ?? ""; const formData = await request.formData(); const intent = String(formData.get("intent") ?? ""); try { if (intent === "delete") { requireFilesPermission(ctx, "files.delete"); await hardDeleteFile({ tenantId: ctx.tenantId, fileId }); await auditFileEvent({ ctx, action: "file.deleted", fileId }); return redirect(`/${tenantSlug}/files`); } requireFilesPermission(ctx, "files.write"); if (intent === "link") { const entityType = String(formData.get("entityType") ?? "") as FileEntityType; const entityId = String(formData.get("entityId") ?? "").trim(); const linkRole = String(formData.get("linkRole") ?? "").trim() || null; if (!FILE_ENTITY_TYPES.includes(entityType) || !entityId) { throw badRequestResponse(); } await linkFile({ tenantId: ctx.tenantId, userId: ctx.userId, fileId, entityType, entityId, linkRole }); await auditFileEvent({ ctx, action: "file.linked", fileId, metadata: { entityType, entityId } }); await logFileActivity({ ctx, entityType, entityId, activityType: "file_uploaded", summaryText: "Datei verknüpft", fileId }); return redirect(filesDetailPath(tenantSlug, fileId)); } if (intent === "unlink") { const entityType = String(formData.get("entityType") ?? "") as FileEntityType; const entityId = String(formData.get("entityId") ?? "").trim(); await unlinkFile({ tenantId: ctx.tenantId, fileId, entityType, entityId }); await auditFileEvent({ ctx, action: "file.unlinked", fileId, metadata: { entityType, entityId } }); return redirect(filesDetailPath(tenantSlug, fileId)); } if (intent === "archive") { await archiveFile({ tenantId: ctx.tenantId, fileId }); await auditFileEvent({ ctx, action: "file.archived", fileId }); } else if (intent === "reactivate") { await reactivateFile({ tenantId: ctx.tenantId, fileId }); await auditFileEvent({ ctx, action: "file.reactivated", fileId }); } else if (intent === "regeneratePreview") { await regenerateFilePreview({ tenantId: ctx.tenantId, fileId }); await auditFileEvent({ ctx, action: "file.updated", fileId, metadata: { previewRegenerated: true } }); } return redirect(filesDetailPath(tenantSlug, fileId)); } catch (error) { if (error instanceof Response) throw error; throw notFoundResponse(); } }; export default function FileDetailRoute() { const { t, i18n } = useTranslation(); const { vm } = useLoaderData(); if (vm.status !== "ready" || !vm.data) { return
; } const data = vm.data; const dateFormatter = new Intl.DateTimeFormat(i18n.language, { dateStyle: "medium" }); return (

{data.displayName}

{data.mimeType} · {dateFormatter.format(new Date(data.createdAtIso))}

{data.scanNoticeKey ? (

{t(data.scanNoticeKey)}

) : null}
{data.previewUrl ? ( {data.displayName} ) : data.previewFallbackKey ? (

{t(data.previewFallbackKey)}

) : null}
{t("files.detail.actions.download")} {data.canWrite && data.canRegeneratePreview ? (
) : null} {data.canWrite ? (
) : null} {data.canDelete ? (
) : null}
{data.tags.length > 0 ? (

{t("files.detail.section.tags")}

{data.tags.join(", ")}

) : null} {data.notes ? (

{t("files.detail.section.notes")}

{data.notes}

) : null}

{t("files.detail.section.links")}

{data.linkedEntities.length > 0 ? (
    {data.linkedEntities.map((link) => (
  • {link.entityType} {link.linkRole ? ` · ${link.linkRole}` : ""} {data.canWrite ? (
    ) : null}
  • ))}
) : null} {data.canWrite ? (
) : null}
); } export function ErrorBoundary() { return ; }