Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/apps/web/app/routes/app.$tenant/contacts.admin.custom-fields.tsx
T

130 lines
5.5 KiB
TypeScript

// R-P6 (P6 CRM core, Variante A) — custom-field admin (`/contacts/admin/custom-fields`).
// Lists + creates + archives the tenant's CONTACT custom-field definitions (DoD 3).
// Gated on crm.admin (missing -> 404); module off -> locked empty.
import { type ActionFunctionArgs, type LoaderFunctionArgs, useActionData, useLoaderData, useNavigation, useSubmit } from "react-router";
import { buildCustomFieldAdminVM, type CustomFieldAdminVM } from "@hivegrid/view-models";
import { getTranslations } from "~/locale/i18next.server";
import {
badRequestResponse,
crmActionErrorResponse,
loadCrmContext,
notFoundResponse,
requireCrmPermission,
} from "~/utils/integrations/crm/crmAccess.server";
import {
archiveCustomFieldDefinition,
createCustomFieldDefinition,
listCustomFieldDefinitions,
type CustomFieldDatentyp,
} from "~/utils/integrations/crm/customFieldService.server";
import { auditCrmEvent } from "~/utils/integrations/crm/crmAudit.server";
import { contactsPath, CRM_MODULE_KEY } from "~/utils/integrations/crm/crmRoutePaths";
import { CustomFieldAdminPage } from "~/components/screens/crm/CustomFieldAdminPage";
import ServerError from "~/components/ui/errors/ServerError";
import { useSaveToast } from "~/hooks/use-save-toast";
const ENTITY_TYPE = "kontakt";
type BreadcrumbAncestor = { label: string; href: string };
type LoaderData = { title: string; moduleActive: boolean; vm: CustomFieldAdminVM; breadcrumbAncestors: BreadcrumbAncestor[] };
export const loader = async ({ request, params }: LoaderFunctionArgs) => {
const { t } = await getTranslations(request);
const ctx = await loadCrmContext({ request, params });
const title = `${t("crm.admin.customFields.title")} | ${process.env.APP_NAME}`;
// Flat routes give this admin page no shared "Kontakte" layout to hang a crumb
// on, so name the list page it is reached through explicitly.
const breadcrumbAncestors = [{ label: t("crm.contacts.title"), href: contactsPath(params.tenant ?? "") }];
if (!ctx.hasModule) {
return Response.json({ title, moduleActive: false, vm: buildCustomFieldAdminVM({ rows: [], entityType: ENTITY_TYPE, canWrite: false }), breadcrumbAncestors } satisfies LoaderData);
}
try {
requireCrmPermission(ctx, "crm.admin");
} catch {
throw notFoundResponse();
}
const definitions = await listCustomFieldDefinitions({ tenantId: ctx.tenantId, entityType: ENTITY_TYPE, includeArchived: true });
const vm = buildCustomFieldAdminVM({ rows: definitions, entityType: ENTITY_TYPE, canWrite: true });
return Response.json({ title, moduleActive: true, vm, breadcrumbAncestors } satisfies LoaderData);
};
export const action = async ({ request, params }: ActionFunctionArgs) => {
const ctx = await loadCrmContext({ request, params, requireModule: true });
const form = await request.formData();
const intent = form.get("intent")?.toString();
try {
requireCrmPermission(ctx, "crm.admin");
if (intent === "create") {
const datentyp = (form.get("datentyp")?.toString() ?? "text") as CustomFieldDatentyp;
const optionenRaw = form.get("optionen")?.toString().trim();
const optionen = optionenRaw ? optionenRaw.split(",").map((option) => option.trim()).filter(Boolean) : null;
const created = await createCustomFieldDefinition({
tenantId: ctx.tenantId,
entityType: ENTITY_TYPE,
key: form.get("key")?.toString() ?? "",
label: form.get("label")?.toString() ?? "",
datentyp,
optionen,
});
await auditCrmEvent({ ctx, action: "custom_field.created", targetType: "custom_field", targetId: created.id, metadata: { key: created.key } });
return Response.json({ ok: true, intent, messageKey: "crm.toast.customFieldCreated" });
}
if (intent === "archive") {
const definitionId = form.get("definitionId")?.toString().trim();
if (!definitionId) {
throw badRequestResponse();
}
await archiveCustomFieldDefinition({ tenantId: ctx.tenantId, definitionId });
await auditCrmEvent({ ctx, action: "custom_field.archived", targetType: "custom_field", targetId: definitionId });
return Response.json({ ok: true, intent, messageKey: "crm.toast.customFieldArchived" });
}
throw badRequestResponse();
} catch (error) {
if (error instanceof Response) {
throw error;
}
return crmActionErrorResponse(error);
}
};
export default function CustomFieldsAdminRoute() {
const { moduleActive, vm } = useLoaderData<LoaderData>();
const actionData = useActionData<{ intent?: string; ok?: boolean; error?: string; messageKey?: string }>();
useSaveToast(actionData);
const submit = useSubmit();
const navigation = useNavigation();
return (
<CustomFieldAdminPage
vm={vm}
moduleActive={moduleActive}
submitting={navigation.state !== "idle"}
errorKey={actionData?.error ?? null}
actions={{
onCreate: ({ key, label, datentyp, optionen }) => {
const form = new FormData();
form.set("intent", "create");
form.set("key", key);
form.set("label", label);
form.set("datentyp", datentyp);
form.set("optionen", optionen);
submit(form, { method: "post" });
},
onArchive: (definitionId) => {
const form = new FormData();
form.set("intent", "archive");
form.set("definitionId", definitionId);
submit(form, { method: "post" });
},
}}
/>
);
}
export function ErrorBoundary() {
return <ServerError />;
}
export const handle = { moduleKey: CRM_MODULE_KEY };