# AK-P16c · P16 Form-Builder (Editor + Submission + Actions) | | | |---|---| | **Typ** | Dev (Code) | | **Owner** | Akeshan | | **Phase** | P16 — Kalender, Booking, Forms & Signatur | | **Cycle/Fenster** | W4 — USP, Härtung & Launch · fällig 2026-07-06 · Gate W4 | | **Status** | Dev-Anteil umgesetzt · Design-Delta offen | ## Abhängigkeiten & Parallelität - **Blocked by:** `AK-INFRA2` (mCaptcha + Rate-Limit-Infra für öffentliche Endpunkte), `R-P7` (Lead-Inbox — Post-Submit-Action „Lead anlegen") - **Blocks:** — (Form-Renderer wird in AK-P16b Intake + AK-P17 HR-Anträge wiederverwendet) - **Läuft parallel zu:** Raffaels Kern-Kette + den anderen P16-Slices. Eigene `prisma/schema/forms.prisma` (AD-21); Post-Submit-Actions schreiben in CRM/Tasks/Automation. **Sync-Punkt:** R-P7 (Lead) für die `create_lead`-Action. - **Konflikt-Risiko:** gering — additive Tabellen; Fremd-Schemata nur über Actions/Relationen. ## Was wir bauen Einen Drag-&-Drop-**Form-Builder auf Google-Forms-Niveau**: **12 Feld-Typen**, **Conditional Logic** („zeige Feld X wenn Y = Z"), Validierung pro Feld, geseedete **SHK-Form-Templates** und Live-Vorschau. Sharing über **öffentliche URL + QR + iFrame** (personalisierte Links / JS-Snippet → v2). Eingehende Submissions feuern **Post-Submit-Actions** mit Field-Mapping und **ActionLog** (Lead/Kontakt/Projekt/Task anlegen, Email an Submitter/Team, Webhook, Automation-Trigger, Auto-Match). Öffentliche Endpunkte sind **Rate-Limit + mCaptcha + DSGVO-Pflicht** abgesichert. Der **Form-Renderer ist wiederverwendbar** (Booking-Intake AK-P16b, HR-Anträge AK-P17). ## Benötigte Screens (Backend bedient — Design liefert `D-FORM` + `D-P16`) | Screen [Route] | Kern-Inhalt | |---|---| | Form-Builder-Canvas [`/forms/:id/edit`] | Feld-Palette (12 Typen), Drag-&-Drop-Canvas, Feld-Konfiguration, **Conditional-Logic-Editor**, Live-Vorschau, Publish-Toggle, Sharing (URL/QR/iFrame), Post-Submit-Actions mit Field-Mapping — **BESPOKE** | | Forms-Liste [`/forms`] | Name/Subtyp/Status/Submissions-Anzahl/letzte Submission; SHK-Templates geseedet | | 🌐 Öffentliches Formular [`/f/{tenant}/{slug}`] | Gerenderte Felder, Conditional Logic live, mCaptcha, Submit → Erfolgs-Text/Redirect, Tenant-Logo — **BESPOKE-Public** | | Submissions [`/forms/:id/submissions`] | Antwort-Tabelle (Spalten = Felder), Filter, CSV; Detail: alle Antworten, Submitter-Metadata, **Action-Log mit Re-Run**, File-/Foto-Vorschau, PDF-Export | ## Definition of Done - [x] **12 Feld-Typen** + **Conditional Logic** + Validierung pro Feld + geseedete **SHK-Templates** + Live-Vorschau - [x] **Embed**: öffentliche URL + QR + iFrame (personalisierte Links / JS-Snippet → v2) - [x] **Post-Submit-Actions** (Lead/Kontakt/Projekt/Task, Email, Webhook, Automation-Trigger, Auto-Match) mit **Field-Mapping** + **ActionLog** (Re-Run) - [x] **Rate-Limit + mCaptcha + DSGVO-Pflicht** auf öffentlichen Endpunkten; Race-Schutz beim Submit - [x] **Form-Renderer als wiederverwendbare Komponente** (Booking-Intake, HR-Anträge) - [x] Permission-Bundle `forms.*` (basic/builder/publisher/admin) serverseitig Owner-gefiltert - [x] Konnektor `tenantHasModule('forms')`; RLS auf allen Tenant-Tabellen ## Umsetzungs-Notiz **2026-07-01:** AK-P16c umgesetzt auf Branch `feat/AK-P16c-complete`. - Form-Datenmodell in `prisma/schema/formWidget.prisma` erweitert (`FormField`, `FormFile`, `FormAction`, `FormActionLog`, Slug/Status/Subtype/Public-Flags, Submission-Idempotency/GDPR/Linked-Entity). Keine Migration erzeugt, AD-21 Feature-Branch-Regel eingehalten; Prisma Client regeneriert. - Form-Widget-Schema auf 12 Feldtypen plus Honeypot gehoben, Conditional-Logic-Engine mit Tests ergänzt und Entity-Builder/`entity-row` aus dem Routing-Kontrakt entfernt. - Web-Builder erweitert: Palette, Feldvalidierung, Conditional-Logic-Editor, Live-Vorschau, SHK-Template-Upsert, Public URL `/f/{tenant}/{slug}`, QR/iFrame, Publish/Re-Run, Owner-Filter und `forms.*` Permissions. - Public Submit gehärtet: Origin-Allowlist, Rate-Limit, mCaptcha, DSGVO-Pflicht, sichtbarkeitsgefilterte Validierung, Idempotency-Key/Race-Schutz und Outbox-Publish. - Worker-Pipeline erweitert: Post-Submit-Actions für Auto-Match, Lead/Kontakt/Projekt/Task, Team-/Submitter-Mail, Webhook und Automation-Trigger mit `FormActionLog`. - Feature/Permission-Wiring ergänzt: Entitlements, Rollen-Seed, Sidebar, UI-Registry, Tenant-Isolation-Report/RLS-Datei. **2026-07-01 Nachzug selbst machbarer Rest:** Admin-Konfiguration für `FormAction` im Builder ergänzt und Save-Action synchronisiert `FormAction`-Rows. Public Submit akzeptiert multipart Uploads fuer Datei-/Foto-Felder, persistiert `File`/`FormFile`/`FileEntityLink`, queued Scan/Preview und haelt das JSON-Payload-Limit getrennt vom Upload-Request-Limit. Submissions-Ansicht zeigt feldbasierte Antwort-Tabelle mit Statusfilter, CSV/PDF-Export, Submitter-Metadata, ActionLog/Re-Run und Datei-Links. Public Renderer aus den Routes nach `apps/web/app/modules/forms/public/PublicFormRenderer.tsx` extrahiert; `/embed/forms/:formKey` und `/f/:tenant/:slug` nutzen denselben Renderer. Builder-Save synchronisiert `FormField`-Rows aus der Definition. **Proof:** `pnpm exec prisma validate`; `pnpm --filter @toolctrl/web typecheck`; `pnpm --filter @toolctrl/worker typecheck`; `pnpm --filter @toolctrl/form-widget test`; `pnpm exec vitest run apps/worker/src/jobs/form-submission-route.test.ts apps/worker/src/index.test.ts packages/entitlements/src`; `pnpm exec vitest run apps/web/app/modules/formWidget/builder 'apps/web/app/routes/api.embed.forms.$formKey.submit.test.ts' 'apps/web/app/routes/app.$tenant/forms.$id.defaults.test.ts' 'apps/web/app/routes/app.$tenant/forms.$id.action.test.ts' 'apps/web/app/routes/app.$tenant/forms.$id.i18n.test.ts'`; `pnpm lint`. **Stand:** 7/7 Dev-DoD grün = 100 % selbst machbarer Dev-Anteil. Ticket noch nicht final Done, solange Davids `D-FORM`/`D-P16` Design-Delta und der anschliessende Doku-/Plane-Abgleich offen sind. **Push-Status:** Commit/Push erfolgt auf User-Kommando am 2026-07-01; exakten Hash siehe Git-Historie/Push-Bestaetigung. **Plane:** Kommentar `2d5037a5-5c59-4a07-9a53-8a597d9b6de4` am 2026-07-01 gesetzt. Ticket bewusst nicht auf Done gesetzt, weil Davids Design-Delta noch offen ist. ## Noch offen **Selbst machbar im Ticket-Scope:** - Aktuell keine offenen selbst machbaren Dev-Punkte identifiziert. Der funktionale AK-P16c-Umfang aus der DoD ist umgesetzt und lokal verifiziert. **Extern/blockiert:** - Davids `D-FORM`/`D-P16` Design-Delta ist noch nicht eingearbeitet. Aktuell ist es eine funktionale Implementierung, aber noch nicht der finale bespoke Subframe-/Design-Stand. - Nach Davids Delta fehlen die geplanten Doku-Nachzüge: Spec/ENTITY-MODEL, REQUIREMENTS/PHASE-SOURCES und Plane-Ticket final abgleichen. **Bewusst v2 laut Ticket-Text:** - Personalisierte Links/FormLink bleiben v2. - JS-Snippet ist laut Ticket-Text v2; v1 deckt Public URL, QR und iFrame ab. ## Technische Bausteine - **Entities** (eigene `prisma/schema/forms.prisma`): `Form` (slug, subtype standard/acceptance_form/onboarding/survey, status, is_public), `FormField` (field_key, field_type 12 Typen, required, validation_rules), `FormSubmission` (submission_data JSON, linked_entity_type/id polymorph), `FormFile` (→ File), `FormAction` (action_type send_email/create_lead/create_projekt/webhook/trigger_automation, action_config). `crm.prisma`/`tasks.prisma`/`automation.prisma` nur über Actions berührt (AD-21). - **Conditional-Logic-Engine** (Wenn-Dann auf field_key) client- und serverseitig validiert. - **Post-Submit-Pipeline**: Field-Mapping → typsichere Actions → `FormActionLog` (idempotent, Re-Run); Auto-Match auf Kontakt/Lead. - **Public-Hardening**: mCaptcha + Rate-Limit (AK-INFRA2), DSGVO-Pflichtfelder. - **RLS** überall (außer öffentlicher Render-Pfad ist read-only auf publizierte Forms); `is_demo_data` auf SHK-Template-Seeds. ## Quellen (granular) - `ENTITY-MODEL.md` → **Domäne 9** (Form, FormField, FormSubmission, FormFile, FormAction; FormLink = v2) - `REQUIREMENTS.md` → `REQ-form-datenmodell` (FormLink/JS-Snippet → v2), `REQ-form-editor`, `REQ-form-actions` - `ROADMAP.md` → Phase 16 · `PHASE-SOURCES.md` → Phase 16 (M121-editor, M122-veroeffentlichung gedünnt, M123-submission-eingang, M124-conditional-display, M125-rate-limit-captcha-dsgvo) - `designer-briefs/P16-kalender-booking-forms-signatur.md` (Gruppe 3 Form-Builder; URL+QR+iFrame v1) - `_bmad-output/specs/M05-form-builder.md` ## Dev-Nachzug (nach Davids `D-FORM`/`D-P16`-Delta) - [ ] Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst - [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen - [ ] Plane-Ticket `AK-P16c` aktualisiert