Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/ticket-docs/AK-P16c.md
T

4.8 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 geplant

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

  • 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

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