8.5 KiB
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 diecreate_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
- 12 Feld-Typen + Conditional Logic + Validierung pro Feld + geseedete SHK-Templates + Live-Vorschau
- Embed: öffentliche URL + QR + iFrame (personalisierte Links / JS-Snippet → v2)
- Post-Submit-Actions (Lead/Kontakt/Projekt/Task, Email, Webhook, Automation-Trigger, Auto-Match) mit Field-Mapping + ActionLog (Re-Run)
- Rate-Limit + mCaptcha + DSGVO-Pflicht auf öffentlichen Endpunkten; Race-Schutz beim Submit
- Form-Renderer als wiederverwendbare Komponente (Booking-Intake, HR-Anträge)
- Permission-Bundle
forms.*(basic/builder/publisher/admin) serverseitig Owner-gefiltert - 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.prismaerweitert (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-rowaus 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 undforms.*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-P16Design-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.prismanur ü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_dataauf 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-actionsROADMAP.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-P16caktualisiert