Files
HiveGrid-Wireframes/hivegrid-cloud/apps/web/app/routes/app.$tenant/files.$id.tsx
T

265 lines
11 KiB
TypeScript

// 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<LoaderData>();
if (vm.status !== "ready" || !vm.data) {
return <main className="mx-auto max-w-3xl px-4 py-10" data-ui-id="ui.files.detail" />;
}
const data = vm.data;
const dateFormatter = new Intl.DateTimeFormat(i18n.language, { dateStyle: "medium" });
return (
<main className="mx-auto max-w-3xl px-4 py-10" data-ui-id="ui.files.detail">
<h1 className="text-foreground text-xl font-semibold">{data.displayName}</h1>
<p className="text-muted-foreground mt-1 text-sm">
{data.mimeType} · {dateFormatter.format(new Date(data.createdAtIso))}
</p>
{data.scanNoticeKey ? (
<p className="text-theme-600 mt-4 text-sm" data-ui-id="ui.files.detail.scanNotice">
{t(data.scanNoticeKey)}
</p>
) : null}
<div className="mt-6" data-ui-id="ui.files.detail.preview">
{data.previewUrl ? (
<img src={data.previewUrl} alt={data.displayName} className="max-h-96 rounded border" />
) : data.previewFallbackKey ? (
<p className="text-muted-foreground text-sm">{t(data.previewFallbackKey)}</p>
) : null}
</div>
<div className="mt-6 flex flex-wrap gap-3">
<a href={data.downloadUrl} className="text-theme-600 font-medium" data-ui-id="ui.files.detail.download">
{t("files.detail.actions.download")}
</a>
{data.canWrite && data.canRegeneratePreview ? (
<form method="post">
<input type="hidden" name="intent" value="regeneratePreview" />
<button type="submit" className="text-theme-600 font-medium">
{t("files.detail.actions.regeneratePreview")}
</button>
</form>
) : null}
{data.canWrite ? (
<form method="post">
<input type="hidden" name="intent" value="archive" />
<button type="submit" className="text-theme-600 font-medium" data-ui-id="ui.files.detail.archive">
{t("files.detail.actions.archive")}
</button>
</form>
) : null}
{data.canDelete ? (
<form method="post">
<input type="hidden" name="intent" value="delete" />
<button type="submit" className="text-destructive font-medium" data-ui-id="ui.files.detail.delete">
{t("files.detail.actions.delete")}
</button>
</form>
) : null}
</div>
{data.tags.length > 0 ? (
<section className="mt-6">
<h2 className="text-muted-foreground text-xs font-semibold uppercase">{t("files.detail.section.tags")}</h2>
<p className="mt-1 text-sm">{data.tags.join(", ")}</p>
</section>
) : null}
{data.notes ? (
<section className="mt-6">
<h2 className="text-muted-foreground text-xs font-semibold uppercase">{t("files.detail.section.notes")}</h2>
<p className="mt-1 text-sm">{data.notes}</p>
</section>
) : null}
<section className="mt-6" data-ui-id="ui.files.detail.links">
<h2 className="text-muted-foreground text-xs font-semibold uppercase">{t("files.detail.section.links")}</h2>
{data.linkedEntities.length > 0 ? (
<ul className="mt-1 text-sm">
{data.linkedEntities.map((link) => (
<li key={`${link.entityType}-${link.entityId}`} className="flex items-center gap-2" data-link-id={`${link.entityType}-${link.entityId}`}>
<span>
{link.entityType}
{link.linkRole ? ` · ${link.linkRole}` : ""}
</span>
{data.canWrite ? (
<form method="post">
<input type="hidden" name="intent" value="unlink" />
<input type="hidden" name="entityType" value={link.entityType} />
<input type="hidden" name="entityId" value={link.entityId} />
<button type="submit" className="text-muted-foreground text-xs underline">
{t("files.detail.actions.unlink")}
</button>
</form>
) : null}
</li>
))}
</ul>
) : null}
{data.canWrite ? (
<form method="post" className="mt-3 flex flex-wrap items-end gap-2" data-ui-id="ui.files.detail.linkForm">
<input type="hidden" name="intent" value="link" />
<label className="text-sm">
<span className="text-muted-foreground block text-xs">{t("files.detail.link.entityType")}</span>
<select name="entityType" className="border-muted-foreground/40 rounded border px-2 py-1">
{FILE_ENTITY_TYPES.map((type) => (
<option key={type} value={type}>
{type}
</option>
))}
</select>
</label>
<label className="text-sm">
<span className="text-muted-foreground block text-xs">{t("files.detail.link.entityId")}</span>
<input name="entityId" required className="border-muted-foreground/40 rounded border px-2 py-1" />
</label>
<label className="text-sm">
<span className="text-muted-foreground block text-xs">{t("files.detail.link.role")}</span>
<input name="linkRole" className="border-muted-foreground/40 rounded border px-2 py-1" />
</label>
<button type="submit" className="text-theme-600 font-medium">
{t("files.detail.actions.link")}
</button>
</form>
) : null}
</section>
</main>
);
}
export function ErrorBoundary() {
return <ServerError />;
}