265 lines
11 KiB
TypeScript
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 />;
|
|
}
|