Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/apps/web/app/routes/app.$tenant/forms.tsx
T
2026-07-08 16:15:37 +02:00

233 lines
10 KiB
TypeScript

/**
* Tenant admin: form-widget list + create (Phase 05 Task #58, layer 3).
*
* Permissions: `app.settings.account.update` (admin-only) — forms expose
* a public submission endpoint so we keep authoring tightly scoped.
*
* The page renders existing forms with their public key + submission
* count + embed-code snippet, plus a minimal create form that seeds a
* single text+email definition. Field editing happens on the detail
* route (forms.$id.tsx).
*/
import { type ActionFunctionArgs, type LoaderFunctionArgs, useLoaderData, Form, Link, useActionData } from "react-router";
import { useTranslation } from "react-i18next";
import slugify from "@sindresorhus/slugify";
import { db } from "~/utils/db.server";
import { getTranslations } from "~/locale/i18next.server";
import { useLocaleFormatters } from "~/locale/format";
import { validateCSRFToken } from "~/utils/session.server";
import { FormDefinitionSchema, HONEYPOT_FIELD_KEY } from "@hivegrid/form-widget";
import { seedShkFormTemplates } from "~/modules/forms/services/shkFormTemplates.server";
import { formsOwnerWhere, loadFormsContext, requireFormsPermission } from "~/modules/forms/routes/formsAccess.server";
import { useRootData } from "~/utils/data/useRootData";
type Row = {
id: string;
key: string;
slug: string | null;
name: string;
subtype: string;
status: string;
isEnabled: boolean;
submissions: number;
createdAt: string;
};
type LoaderData = {
forms: Row[];
embedScriptBase: string;
};
type ActionData = { error?: string; createdId?: string };
export async function loader({ request, params }: LoaderFunctionArgs): Promise<LoaderData> {
const ctx = await loadFormsContext({ request, params, requireModule: true });
requireFormsPermission(ctx, "forms.basic");
const forms = await db.form.findMany({
where: { tenantId: ctx.tenantId, ...formsOwnerWhere(ctx) },
orderBy: { createdAt: "desc" },
select: {
id: true,
key: true,
slug: true,
name: true,
subtype: true,
status: true,
isEnabled: true,
createdAt: true,
_count: { select: { submissions: true } },
},
});
return {
forms: forms.map((f) => ({
id: f.id,
key: f.key,
slug: f.slug,
name: f.name,
subtype: f.subtype,
status: f.status,
isEnabled: f.isEnabled,
submissions: f._count.submissions,
createdAt: f.createdAt.toISOString(),
})),
embedScriptBase: process.env.FORM_WIDGET_CDN_URL?.trim() || process.env.APP_URL?.trim() || "",
};
}
export async function action({ request, params }: ActionFunctionArgs): Promise<Response | ActionData> {
const ctx = await loadFormsContext({ request, params, requireModule: true });
requireFormsPermission(ctx, "forms.builder");
await validateCSRFToken(request);
const { t } = await getTranslations(request);
const body = await request.formData();
const op = body.get("op")?.toString() ?? "";
if (op === "create") {
const name = body.get("name")?.toString()?.trim();
const origin = body.get("allowedOrigin")?.toString()?.trim() ?? "";
if (!name) return { error: t("settings.forms.admin.errors.nameRequired") };
const baseSlug = slugify(name).slice(0, 80) || "form";
let slug = baseSlug;
for (let i = 2; i < 100; i += 1) {
const exists = await db.form.findFirst({ where: { tenantId: ctx.tenantId, slug }, select: { id: true } });
if (!exists) break;
slug = `${baseSlug}-${i}`;
}
const definition = FormDefinitionSchema.parse({
title: name,
submitLabel: t("settings.forms.admin.defaults.submitLabel"),
successMessage: t("settings.forms.admin.defaults.successMessage"),
gdprConsentLabel: t("settings.forms.admin.defaults.gdprConsentLabel"),
fields: [
{ key: "full_name", type: "text", label: t("settings.forms.admin.defaults.fields.fullName"), required: true },
{ key: "email", type: "email", label: t("settings.forms.admin.defaults.fields.email"), required: true },
{ key: "message", type: "textarea", label: t("settings.forms.admin.defaults.fields.message"), required: false },
{ key: HONEYPOT_FIELD_KEY, type: "honeypot", label: t("settings.forms.admin.defaults.fields.honeypot") },
],
});
const created = await db.form.create({
data: {
tenantId: ctx.tenantId,
createdByUserId: ctx.userId,
name,
slug,
subtype: "standard",
status: "draft",
definition: definition as object,
allowedOrigins: origin ? [origin] : [],
config: { honeypotEnabled: true } as object,
},
select: { id: true },
});
return { createdId: created.id };
}
if (op === "seed-shk-templates") {
await seedShkFormTemplates({ tenantId: ctx.tenantId, userId: ctx.userId, t });
return { error: undefined };
}
if (op === "toggle") {
const id = body.get("id")?.toString();
if (!id) return { error: t("settings.forms.admin.errors.missingFormId") };
const target = await db.form.findFirst({ where: { id, tenantId: ctx.tenantId, ...formsOwnerWhere(ctx) }, select: { isEnabled: true } });
if (!target) return { error: t("settings.forms.admin.errors.formNotFound") };
await db.form.update({ where: { id }, data: { isEnabled: !target.isEnabled } });
return { error: undefined };
}
if (op === "delete") {
const id = body.get("id")?.toString();
if (!id) return { error: t("settings.forms.admin.errors.missingFormId") };
await db.form.deleteMany({ where: { id, tenantId: ctx.tenantId, ...formsOwnerWhere(ctx) } });
return { error: undefined };
}
return { error: t("settings.forms.admin.errors.unknownOperation") };
}
export default function FormsAdmin(): React.JSX.Element {
const data = useLoaderData() as LoaderData;
const actionData = useActionData() as ActionData | undefined;
const { t } = useTranslation();
const formatters = useLocaleFormatters();
const rootData = useRootData();
return (
<div className="p-6 space-y-6">
<header>
<h1 className="text-2xl font-semibold">{t("settings.forms.admin.title")}</h1>
<p className="text-sm text-gray-600">
{t("settings.forms.admin.description")}
</p>
</header>
<section>
<h2 className="text-lg font-medium mb-2">{t("settings.forms.admin.create.title")}</h2>
{actionData?.error ? <p className="text-red-600 text-sm mb-2">{actionData.error}</p> : null}
<Form method="post" className="mb-3">
<input type="hidden" name="csrf" value={rootData.csrf ?? ""} readOnly />
<input type="hidden" name="op" value="seed-shk-templates" />
<button type="submit" className="text-sm border rounded px-3 py-1">
{t("settings.forms.admin.create.seedShkTemplates")}
</button>
</Form>
<Form method="post" className="flex gap-2 items-end">
<input type="hidden" name="csrf" value={rootData.csrf ?? ""} readOnly />
<input type="hidden" name="op" value="create" />
<label className="flex flex-col gap-1 flex-1">
<span className="text-sm">{t("settings.forms.admin.create.name")}</span>
<input name="name" required className="border rounded px-2 py-1" />
</label>
<label className="flex flex-col gap-1 flex-1">
<span className="text-sm">{t("settings.forms.admin.create.allowedOrigin")}</span>
<input name="allowedOrigin" placeholder={t("settings.forms.admin.create.allowedOriginPlaceholder")} className="border rounded px-2 py-1" />
</label>
<button type="submit" className="bg-blue-600 text-white px-4 py-1.5 rounded">{t("settings.forms.admin.create.submit")}</button>
</Form>
</section>
<section>
<h2 className="text-lg font-medium mb-2">{t("settings.forms.admin.existing.title")}</h2>
{data.forms.length === 0 ? (
<p className="text-sm text-gray-500">{t("settings.forms.admin.existing.empty")}</p>
) : (
<ul className="divide-y border rounded">
{data.forms.map((f) => (
<li key={f.id} className="p-3 flex items-center justify-between">
<div>
<Link to={f.id} className="font-medium text-blue-700 hover:underline">{f.name}</Link>
<div className="text-xs text-gray-500">
{t("settings.forms.admin.existing.key")}: <code>{f.key}</code> ·{" "}
{t("settings.forms.admin.existing.slug")}: <code>{f.slug ?? "n/a"}</code> ·{" "}
{t("settings.forms.admin.existing.status")}: {f.status} ·{" "}
{t("settings.forms.admin.existing.submissionsCount", {
count: f.submissions,
formattedCount: formatters.number(f.submissions),
})}{" "}
· {f.isEnabled ? t("shared.enabled") : t("shared.disabled")} ·{" "}
{t("settings.forms.admin.existing.createdAtWithDate", {
date: formatters.date(f.createdAt, { dateStyle: "medium", timeStyle: "short" }),
})}
</div>
<pre className="text-xs bg-gray-50 mt-1 p-1 rounded inline-block">
{`<script src="${data.embedScriptBase}/embed/widget.js" data-form-key="${f.key}" async></script>`}
</pre>
</div>
<div className="flex gap-2">
<Form method="post">
<input type="hidden" name="csrf" value={rootData.csrf ?? ""} readOnly />
<input type="hidden" name="op" value="toggle" />
<input type="hidden" name="id" value={f.id} />
<button className="text-sm border rounded px-2 py-1">{f.isEnabled ? t("shared.disable") : t("shared.enable")}</button>
</Form>
<Form method="post" onSubmit={(e) => { if (!confirm(t("settings.forms.admin.delete.confirm"))) e.preventDefault(); }}>
<input type="hidden" name="csrf" value={rootData.csrf ?? ""} readOnly />
<input type="hidden" name="op" value="delete" />
<input type="hidden" name="id" value={f.id} />
<button className="text-sm border rounded px-2 py-1 text-red-600">{t("shared.delete")}</button>
</Form>
</div>
</li>
))}
</ul>
)}
</section>
</div>
);
}