Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/D-FORM.md
T

55 lines
4.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# D-FORM · Form-Builder-Canvas + öffentliches Formular (Bespoke)
| | |
|---|---|
| **Typ** | Screen (Design) |
| **Owner** | David |
| **Phase** | P16 — Kalender, Booking, Forms & Signatur (bedient `AK-P16a`–`AK-P16d`) |
| **Cycle/Fenster** | W2 — Plattform & CRM (Demo 1) · 2026-06-24 → fällig 2026-06-26 |
| **Status** | geplant |
> 🟦 **Bespoke-Abgrenzung:** Dieses Ticket deckt **NUR den Form-Builder-Canvas + das öffentliche Formular** (P16). Die **Booking-Page + Kalender-View** (P16) → **`D-BOOK`**. Die übrigen P16-Screens (Forms-Liste, Submissions, Buchungs-/Booking-Compose, Signatur-Wizard) sind Compose aus A2/A3/A6 → P16-Compose-Anteil (Signatur-Wizard → `D-REST`).
> 🟡 **v1-Schnitte:** Form-Sharing = **URL + QR + iFrame** (personalisierte Links / JS-Snippet → v2). Der hier gebaute M05-Form-Renderer wird in HR (P17) wiederverwendet — robust und einbettbar designen.
## Abhängigkeiten & Parallelität
- **Blocked by:** `D-D0b` (Archetypen, 12 Feldtypen aus A4, Drag&Drop-Primitive)
- **Blockt:** — (de-facto Vorlage für HR-Form-Renderer in `D-HR`/P17)
- **Bedient (Dev):** `AK-P16a`–`AK-P16d` (M05 Form-Builder)
- **Subframe:** Pflicht je Route. Form-Builder-Canvas + öffentliches Formular sind **BESPOKE** (Canvas = schwerste UI nach Flow-Editor).
## Was wir bauen
**Nur den Form-Builder-Canvas** (Feld-Palette, Drag&Drop-Canvas, Conditional-Logic-Editor, Post-Submit-Actions) und das **öffentliche Formular** (gerenderte Felder, Conditional Logic live, mCaptcha, Tenant-Logo).
## Benötigte Screens
| Screen [Route] | Kern-Inhalt | Archetyp |
|---|---|---|
| **Form-Builder-Canvas** [`/forms/:id/edit`] | Feld-Palette (12 Typen) · Canvas mit Drag-&-Drop-Feldliste · Feld-Konfiguration (Label, Pflicht, Validierung, Optionen) · Conditional-Logic-Editor („zeige Feld X wenn Y = Z") · Live-Vorschau · Publish-Toggle · Sharing: öffentliche URL + QR + iFrame · Post-Submit-Actions (Lead/Kontakt/Projekt/Task, Email, Webhook, Automation-Trigger) mit Field-Mapping | BESPOKE (schwerste UI nach Flow-Editor) |
| 🌐 Öffentliches Formular [`/f/{tenant}/{slug}`] | Gerenderte Felder, Conditional Logic live, mCaptcha, Submit → Erfolgs-Text oder Redirect · Tenant-Logo · 4 Zustände | BESPOKE-Public |
*(Booking-Page + Kalender → `D-BOOK`. Forms-Liste, Submissions, Signatur-Wizard = P16-Compose. Task-Komponente aus P4 wird eingebettet, nicht neu gebaut.)*
## Features (muss abgedeckt sein)
- [ ] Form-Builder mit Drag-&-Drop, **12 Feld-Typen**, **Conditional Logic**, Validierung pro Feld, SHK-Form-Templates geseedet
- [ ] Sharing: iFrame-Embed + QR + öffentliche URL (personalisierte Links → v2)
- [ ] Post-Submit-Actions mit Field-Mapping + ActionLog (Lead/Kontakt/Projekt/Task anlegen, Email an Submitter/Team, Webhook, Automation-Trigger, Auto-Match)
- [ ] Öffentliches Formular: Conditional Logic live, mCaptcha, Submit → Erfolgs-Text/Redirect, Tenant-Logo, 4 Zustände
- [ ] Form-Renderer robust/einbettbar (Reuse in HR P17, Booking-Intake, Urlaub/Krank/Requests)
## UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
Feld-Palette (12 Typen); Drag-&-Drop-Canvas-Feldliste; Feld-Konfigurations-Panel; Conditional-Logic-Editor (Wenn-Dann-Regeln); Live-Vorschau-Pane; Embed-Code-Generator + QR-Generator + Copy-to-Clipboard; Post-Submit-Action-Liste mit Field-Mapping-Zeilen; gerenderter Form-Player (öffentlich, mCaptcha); Tenant-Logo/Branding; Erfolgs-/Redirect-Zustand; Empty-/Loading-/Fehler-/Permission-Denied-States (Klartext mit Lösungs-Knopf).
## Quellen (granular)
- `designer-briefs/P16-kalender-booking-forms-signatur.md` → §Benötigte Screens „Form-Builder-Canvas" + „Öffentliches Formular" (NUR diese) + zugehörige Features/UI-Elemente
- `ENTITY-MODEL.md` → Domäne 9 (Forms)
## Davids Delta (David füllt aus)
- [ ] Überschriebene/geänderte Spec-Punkte:
- [ ] Neue UI/UX-Entscheidungen:
- [ ] Subframe-Screen-Link(s):
- [ ] Offene Fragen an Dev:
## Dev-Integrations-Notiz (2026-07-10, Akeshan — Querverweis AK-P16c)
Der Subframe-Flow **„(MCP) WF-P16 Form Builder"** (S00/S01/S02/S02L/S03/S04/S05 inkl. E01–E05/V01–V03) wurde am 2026-07-10 als Dev-Nachzug von `AK-P16c` in die App integriert (PR #71). Damit ist der D-FORM-Scope (Builder-Canvas + öffentliches Formular) app-seitig umgesetzt; die „Davids Delta"-Sektion unten ist noch unausgefüllt und kann bei Bedarf gegen den integrierten Stand abgeglichen werden. Nicht umgesetzt (kein Backend, siehe AK-P16c §Noch offen): Versionsverlauf, Theme-Logo/Formularbreite, Lead-Mapping Bereich/Datei/Pipeline, Optionen mischen.