Reorganize repo structure and standards references
This commit is contained in:
1 parent
3cb93a81be
commit
be2054274d
5885 files changed
+2588
-195
No files matched your search
+264
@@ -0,0 +1,264 @@
|
||||
// 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 />;
|
||||
}
|
||||
Reference in new issue
Block a user