// 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 { buildFileDetailVM, type FileDetailVM, type FileLinkedEntity } from "@hivegrid/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, updateFileMeta, type FileEntityType, } from "~/utils/integrations/fileService.server"; import { auditFileEvent, logFileActivity } from "~/utils/integrations/fileAudit.server"; import { filesDetailPath, mediaVariantPath } from "~/utils/integrations/fileRoutePaths"; import { FileDetailPage } from "~/components/screens/files/FileDetailPage"; import ServerError from "~/components/ui/errors/ServerError"; type LoaderData = { title: string; vm: FileDetailVM; filesHref: string }; 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, filesHref: `/${tenantSlug}/files` } 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 === "updateMeta") { // Tags come in as a comma-separated list; normalize (trim, drop empties, // de-dupe, cap) into the String[] the File row stores. const tags = Array.from( new Set( String(formData.get("tags") ?? "") .split(",") .map((tag) => tag.trim()) .filter(Boolean), ), ).slice(0, 30); await updateFileMeta({ tenantId: ctx.tenantId, fileId, tags }); await auditFileEvent({ ctx, action: "file.updated", fileId, metadata: { tagsUpdated: true } }); 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 { vm, filesHref } = useLoaderData(); if (vm.status !== "ready" || !vm.data) { return
; } return ; } export function ErrorBoundary() { return ; }