Files
HiveGrid-Wireframes/02 Wireframes/D-FORM Formulare/WF-D-FORM Form Builder/WF-D-FORM Form Builder.md
T
2026-07-09 21:38:28 +02:00

39 KiB

kind, project, ticket, package, typ, status, subframe, canvas
kind project ticket package typ status subframe canvas
wireframe-package HiveGrid Screen Project D-FORM WF-D-FORM Form Builder Flow Review-ready / Subframe Draft gebaut https://app.subframe.com/f023064a5ca0/flow/afb1c257-46f0-4b23-aaed-d75f4773f1a9/edit?tab=ai&conversationId=02d948da-f9aa-4ab5-8352-2745789bb9ad 02 Wireframes/D-FORM Formulare/WF-D-FORM Form Builder/WF-D-FORM Form Builder.canvas

WF-D-FORM Form Builder

Status: Review-ready fuer David / Subframe Draft gebaut
Subframe-Link: https://app.subframe.com/f023064a5ca0/flow/afb1c257-46f0-4b23-aaed-d75f4773f1a9/edit?tab=ai&conversationId=02d948da-f9aa-4ab5-8352-2745789bb9ad
Canvas: WF-D-FORM Form Builder.canvas
David-Review: David Review Checkliste
Subframe-Bauplan: Subframe Bauplan
Subframe-Bau-Log: Subframe Bau Log
Simple Builder: Simple Builder Neuausrichtung
Stand: 2026-07-09 Uebergabe: D-FORM David Uebergabe 2026-07-09
Start fuer Review: 00 Start hier - David


1. Kurzfassung

Dieses Paket bereitet D-FORM fuer David vor: den internen Form-Builder-Canvas und das oeffentliche Formular.

Der Fokus liegt bewusst auf den zwei Bespoke-Erlebnissen:

  • Form-Builder-Canvas fuer interne Nutzer
  • Oeffentliches Formular fuer externe Submitter

Fuer den eigentlichen Subframe-Bau gilt Subframe Bauplan als konkrete Bau-Reihenfolge und Komponenten-Zuordnung. Interne Builder-Screens wie S01/D07/D08/D09 nutzen das vorhandene Default Page Layout; keine eigene Sidebar oder Header-Navigation nachbauen. Public-Screens bleiben ohne App-Shell.

Die vollstaendige Forms-/Submissions-Verwaltung, Booking, Kalender und Signatur werden nicht in diesem Paket gebaut. Als schlanker Einstieg wurde aber S00 Formulare verwalten ergaenzt, damit Nutzer vorhandene Formulare finden und in den Builder springen koennen.

Wichtig: Dieses Paket ist jetzt ein tragfaehiger Detail-Brainstorming-Entwurf fuer David. Davids Review vom 2026-07-06 hat den fachlichen Scope bestaetigt, aber fuer den Builder mehr Interaktionslogik verlangt. Diese "was passiert nach Klick?"-Ebene ist im Advanced-Builder nachgezogen. D-FORM ist in Subframe als Draft gebaut: S00 bis S05, die Public-Screens S04/V01/V02/V03 sowie D07 Logic Regel Detail, D08 Action Detail mit Mapping und D09 Publish Blocker Summary sind gebaut.

Vor einer echten Fertig-Markierung muss David die Subframe-Frames final reviewen. Danach koennen nur noch gezielte Korrekturen oder explizit nachgeforderte Zustands-/Modalframes folgen.

Nachtrag 2026-07-07: Fuer Handwerksbetriebe wirkt der bisherige S01 fachlich stark, aber zu komplex. Deshalb wurden einfachere Alternativen gebaut: zuerst Screens/01 S00 Formulare verwalten als Startseite, danach Screens/04 S01 Formularart auswaehlen und Google-Forms-artige Beispiel-Editoren je Formularart. Gebaute Varianten: Screens/05 S02 Einfacher Fragen Editor, Screens/80 S01B Gefuehrter Fragen Editor, Screens/81 S01C Website Formular Editor, Screens/82 S01D Umfrage Editor und Screens/83 S01E Internes Formular Editor. Ergaenzt wurden ausserdem Screens/06 S03 Formular Design und Screens/11 S05 Antworten Tabelle. Die bisherige Logic bleibt im Hintergrund erhalten, aber der Einstieg soll nicht mehr wie ein Profi-Builder wirken.

Nachtrag 2026-07-08: Die Simple-Builder-Richtung wurde nachgeschaerft: S00 nutzt Mehrfachfilter nach Status und Art, S02 hat mehrere editierbare Optionen und eine erweiterte Google-Forms-nahe Werkzeugleiste, S04 enthaelt eine Datenschutz-Checkbox, S03/S05 haben keinen eigenen Teilen-Tab mehr und S05 dient nur Antworten/Export.

Nachtrag Lead-Zuweisung 2026-07-08: David hat ergaenzt, dass Lead-Formulare einen sichtbaren Bereich Felder zuweisen brauchen. Deshalb bleibt S02 der einfache Haupteditor, bekommt aber den neuen Zustand Screens/05b S02L Lead Felder zuweisen. Wenn eine Zuweisung fehlt oder nicht moeglich ist, greift optional Screens/05c E05 S02 Lead Zuweisung pruefen. Logic und Actions kommen damit in den Screen: Bedingung an der Frage, Nach Absenden / Lead anlegen als Card mit Dropdown-Zuweisung.

Nachtrag 2026-07-09: Fuer Davids Review wurde ein kompletter Obsidian-faehiger Paketordner vorbereitet. Die aktuelle Uebergabe liegt in D-FORM David Uebergabe 2026-07-09. Die S02/S02L-Lead-Hinweise sind optisch an die gruene Lead anlegen-Card angeglichen: Icon links, Titel/Badge/Beschreibung in der Mitte, Aktion rechts.


2. Intent Check

Frage Antwort
Welches Ticket/Modul ist betroffen? D-FORM / P16 / M05 Form Builder
Was soll der Nutzer am Ende schaffen? Interne Nutzer bauen und veroeffentlichen Formulare; externe Nutzer reichen ein Formular sauber ein.
Ist es ein Flow, einzelner Screen, Zustand oder nur Dokumentation? Bespoke-Flow mit zwei Hauptscreens und wenigen Public-Varianten.
Welche Planning-Quellen wurden geprueft? D-FORM.md, P16-kalender-booking-forms-signatur.md, M05-form-builder.md, ENTITY-MODEL.md Domaene 9, SCREEN-MAP.md Paragraph 3, DESIGNER-FIRST-PLAYBOOK.md Rang 2, ROADMAP.md Phase 16.
Was ist sicher im Scope? Drag-and-Drop-Builder, 12 Feldtypen, Conditional Logic, Field-Config, Live-Vorschau, Publish, URL/QR/iFrame-Sharing, Post-Submit-Actions, Public Form mit mCaptcha und 4 Zustaenden.
Was ist sicher nicht im Scope? Booking-Page, Kalender, vollstaendige Submissions-Liste, Signatur-Wizard, personalisierte Links, JS-Snippet, Multi-Step-Forms, Repeater, A/B-Testing. S00 ist nur die schlanke Formular-Zentrale, nicht das komplette Submissions-Modul.
Gibt es Admin/Normalrolle-Unterschiede? Ja: Builder/Publisher/Admin duerfen bauen und publishen; einfache Nutzer sehen ggf. nur Submission-/Basic-Rechte.
Welche Annahmen sind noch unsicher? Ob David einzelne dokumentierte Zustands-/Modalframes aus S01 zusaetzlich in Subframe sehen will.

3. Scope

Punkt Inhalt
Ticket/Modul D-FORM / M05 Form Builder
Nutzerrolle Interner Builder/Publisher/Admin; externer Submitter im Public Form.
Admin-Variante Darf Form konfigurieren, Actions anlegen, publishen, Sharing nutzen.
Normale Rolle Kann je nach Permission eventuell Formular bearbeiten oder nur Submissions sehen; Submissions sind nicht Teil dieses Pakets.
Startpunkt Intern: /forms/:id/edit; Public: /f/{tenant}/{slug}
Ziel Formulare robust bauen, veroeffentlichen und extern einreichbar machen.
Haupt-Archetyp A4 Form/Input-Kit + A7 Zustands-Kit
Bespoke-Anteil Sehr hoch: Canvas, Drag-and-Drop, Conditional Logic, Live Preview, Public Renderer.
Out of scope Booking/Kalender/Signatur, Submission-Detail, personalisierte Links/JS-Snippet, komplexe v2-Logic.

3a. Detailausbau vor Fertig

Diese Punkte fehlen noch, bevor D-FORM wirklich als fertig vorbereitet gelten sollte:

Bereich Was noch auszuarbeiten ist Warum wichtig
Builder-Layout Entscheidung fuer Canvas-Aufbau: Drei-Spalten, Tabs, Drawer, Preview-Mode, Mobile/Small-Viewport-Verhalten. Der Builder ist die schwerste UI im Ticket.
Drag-and-Drop Empty Dropzone, Drag Preview, Reorder, Drop zwischen Feldern, Feld-Auswahl, Undo/Cancel-Gefuehl. Sonst bleibt der Canvas zu abstrakt.
Feldtypen Properties je Feldtyp, Sonderfaelle fuer Datei/Foto, Datum/Datum-Range, Select/Multi-Select, Boolean. David braucht konkrete Inspector-Inhalte.
Validation Required, min/max, Regex, Datei-Typen/Groesse, Custom Error, Publish-Blocker. Das Ticket verlangt Klartext-Validation.
Conditional Logic Regel-Liste, Regel-Editor, kaputte Referenzen, Vorschau/Test, Limits fuer v1. Pflicht laut Ticket, aber UX-riskant.
Form-Stammdaten Name, Beschreibung, Slug, Status, Subtype, Success Message, Redirect, Close/Limit. M05-Datenmodell ist groesser als nur Felder.
Templates SHK-Templates sichtbar machen oder bewusst nur als Forms-Liste/Seed dokumentieren. Ticket nennt geseedete Templates.
Publish / Unpublish Publish-Flow, Blocker, Warnungen bei bereits oeffentlichem Formular, Unpublish-Folge. Kritischer Arbeitsmoment fuer interne Nutzer.
Sharing / Embed URL, QR, iFrame-Code, Copy-Feedback, Allowed Origins, v2-Abgrenzung JS-Snippet/personalisierte Links. Public-Verteilung ist Teil von D-FORM.
Post-Submit-Actions Action-Typen, Reihenfolge, Mapping-Zeilen, Pflichtmapping, Test/Preview, einfache Filter. Sehr grosser Komplex im Builder.
Public Form 4 Public-Zustaende, Mobile, mCaptcha, Datei-Upload, Success/Redirect, nicht verfuegbar. Oeffentliche Screens brauchen hohen Polish.
Permissions Builder, Publisher, Admin, Read-only/No-Permission-Zustand. D-FORM hat eigene Permission-Bundles.
Abgrenzung Was bleibt in D-FORM, was gehoert zu Submissions, Forms-Liste, D-BOOK, D-REST oder v2. Verhindert Scope-Explosion.

Empfehlung fuer die naechste Arbeitseinheit: David validiert die nachgezogene S01-Interaktionslogik. Danach kann Subframe-Bau oder letzte Korrektur erfolgen.


3b. SCREEN-MAP-Abgleich

Die SCREEN-MAP.md enthaelt deutlich mehr Screens, aber sie ist die Gesamt-Bauliste fuer HiveGrid v1. Fuer D-FORM zaehlen daraus nur die Form-Builder-bezogenen Zeilen.

SCREEN-MAP-Screen Gehoert zu D-FORM? Umgang
Form-Builder-Canvas /forms/:id/edit ja In diesem Paket als S01 ausarbeiten.
Oeffentliches Formular /f/{tenant}/{slug} ja In diesem Paket als S04 plus Public-Varianten ausarbeiten.
Submissions /forms/:id/submissions nein, Forms-Compose Nicht D-FORM-Bespoke; spaeter eigenes Compose-/Submissions-Paket.
Forms-Liste /forms teilweise S00 als schlanke Formular-Zentrale im D-FORM-Paket; vollstaendige Forms-/Submissions-Compose bleibt spaeter.
Booking-Page /b/{tenant}/{slug} nein Eigenes Ticket/Paket D-BOOK.
Booking intern / Booking-Page-Editor / Verfuegbarkeit nein Eigenes Booking-Paket.
Kalender /calendar nein Eigenes Kalender-Paket.
Signatur-Wizard nein Eigenes Signatur-/D-REST-Paket.
HR Urlaub/Krankmeldung, Requests, Surveys nein HR nutzt M05/Form-Renderer wieder, ist aber nicht D-FORM.
Kampagnen-Editor, Kampagnen-Liste, Segmente, Sender nein Email-Marketing-Paket, nicht D-FORM.
Pipeline-Kanban, Projekt-Liste, Projekt-Detail, Pipeline-Config nein Projekt/Pipeline-Paket, nicht D-FORM.
Plattform-Admin-Screens nein Plattform-Admin-Paket, nicht D-FORM.

Merksatz: D-FORM hat wenige eigene Routen, aber einen riesigen Detailumfang innerhalb des Builder-Screens und des Public-Renderers.


3c. Detailausbau-Fortschritt

Bereich Stand Naechster Schritt
ADV-S01 Builder-Layout Arbeitsentwurf in ADV-S01 ergaenzt und als Subframe-Frame gebaut. David prueft Drei-Zonen-Builder in Subframe.
ADV-S01 Feld-Palette Arbeitsentwurf in ADV-S01 ergaenzt. Entscheiden, ob Content Blocks wie Section Header in v1 sichtbar werden.
ADV-S01 Canvas / Drag-and-Drop Arbeitsentwurf in ADV-S01 ergaenzt. Drag-Zustaende ggf. in Subframe besonders sichtbar machen.
ADV-S01 Feld-Inspector Arbeitsentwurf in ADV-S01 ergaenzt. Properties je Feldtyp reviewen.
ADV-S01 Interaktionslogik Nach David-Feedback ergaenzt und als Zustandsdateien ausgearbeitet. D07/D08/D09 sind als zusaetzliche Subframe-Zustaende gebaut. David prueft die Subframe-Frames und entscheidet nur noch ueber Feinschliff oder Zusatzframes.
ADV-S01 Validation / Publish Arbeitsentwurf in ADV-S01 ergaenzt und als D09 gebaut. David prueft Blocker-Copy, Warnungen und Sprungziele.
ADV-S01 Conditional Logic Arbeitsentwurf in ADV-S01 ergaenzt. V1-Grenzen final bestaetigen.
ADV-S01 Sharing Arbeitsentwurf in ADV-S01 ergaenzt. iFrame/QR/URL-Darstellung finalisieren.
ADV-S01 Post-Submit-Actions Arbeitsentwurf in ADV-S01 ergaenzt. Action-Typen und Mapping-Tiefe final reviewen.
ADV-S01 Permissions Arbeitsentwurf in ADV-S01 ergaenzt. Read-only/No-Permission-Zustand final entscheiden.
S04 Public Form Arbeitsentwurf in S04 ergaenzt. David validiert Public Layout, Mobile, Submit und Branding.
V01/V02/V03 Public-Varianten Arbeitsentwurf in Varianten ergaenzt. David validiert Copy und Public-Fehlerlogik.
Canvas/Tracker/Handoff Nach P2-Auth-Referenz synchronisiert: Hauptflow plus ADV-S01-Zustaende/Case-Matrix im Canvas sichtbar. Vor Subframe nur noch David-Freigabe bzw. Auswahl moeglicher Zusatzframes.

3d. David-Feedback 2026-07-06

Review-Ergebnis: Der grobe fachliche Scope ist gut. D-FORM bleibt Builder plus oeffentliches Formular. Nicht nach D-FORM gehoeren Forms-Liste, Submissions, Booking, Kalender, Signatur und HR.

Nacharbeit: In S01 fehlte die Interaktionslogik fuer konkrete Aktionen. Die wichtigsten Klicks sind jetzt entschieden:

Bereich Entscheidung
Feld bearbeiten Im rechten Inspector, kein Modal.
Feld duplizieren Feldkarte oder 3-Punkte-Menue; kein Confirm.
Feld loeschen 3-Punkte-Menue/Gefahrenzone; Confirm bei Abhaengigkeiten oder public-wirksamen Folgen.
Logic-Regel anlegen Logic-Panel/Detailbereich im selben S01, kein Modal.
Post-Submit-Action hinzufuegen Typauswahl als Popover/kleines Auswahlpanel, Konfiguration im Action-Panel/Drawer.
Sharing oeffnen Sharing-Panel/Modus im ADV-S01, kein Modal.
Publish Inline-Check mit Summary/Popover; Blocker springen zu Feld, Logic, Action oder Settings.
Unpublish Confirm-Dialog, weil Public-Link danach nicht mehr erreichbar ist.

Bewertung: Die 5 Hauptframes bleiben bestehen. Nach Empfehlung wurden zusaetzlich D07 Logic Regel Detail, D08 Action Detail mit Mapping und D09 Publish Blocker Summary als Subframe-Zustaende gebaut. M01/M02 und die restlichen D-/M-Zustaende bleiben vorerst dokumentiert.

Nachgezogene Vor-Subframe-Dateien: Screens/D01 Sharing Panel URL QR iFrame, Screens/D02 Post-Submit Actions, Screens/D03 Conditional Logic Editor, Screens/D06 Feldkarten Menue, Screens/M01 Feld loeschen Confirm, Screens/91 D07 Logic Regel Detail, Screens/92 D08 Action Detail mit Mapping, Screens/93 D09 Publish Blocker Summary, Screens/D10 Builder Interaktionsfaelle, Screens/M02 Unpublish Confirm, Screens/M03 Archive Confirm, Screens/M04 Unsaved Changes Confirm.

Nach weiterer Rueckmeldung wurde D10 als Case-Matrix ergaenzt: Was passiert, wenn Nutzer etwas auswaehlen, eine Checkbox setzen, einen mittleren Pflichtschritt vergessen, Bild/Datei hinzufuegen, Optionen loeschen, Mapping halb setzen oder eine public-wirksame Aktion ausloesen.


3e. P2-Auth-Dbgleich 2026-07-06

P2 Auth ist als Referenz fuer Reifegrad genutzt worden. Dort sind nicht nur Hauptscreens, sondern auch D-/M-Zustaende, Modal-Inhalte, Subframe-Grid, Canvas-Notizen und Handoff-Checks konsequent dokumentiert.

Nachgezogen fuer D-FORM:

P2-Muster D-FORM-Umsetzung
Screen-Dateien mit Ziel, Daten, Aktionen, Verhalten, Zustaenden und Subframe-Hinweis ADV-S01/S02/S04/V01-V03 sowie D01-D10 und M01-M04 entsprechend ausgearbeitet.
D-/M-Zustaende als eigene Dateien, auch wenn sie nicht gebaut werden ADV-S01-Zustaende liegen als eigene Vor-Subframe-Dateien im Screens-Ordner; D07/D08/D09 sind als zusaetzliche Subframe-Zustaende gebaut.
Canvas zeigt Hauptflow plus dokumentierte Zustaende/Notizen WF-D-FORM Form Builder.canvas wurde erweitert: Hauptflow, D-/M-Zustaende, D10 Case-Matrix, Public Flow und Scope-Notizen.
Tracker fuehrt dokumentierte Zustaende als eigene Zeilen Tracker enthaelt D01-D10 und M01-M04; D07/D08/D09 stehen auf Bauen, M01/M02/M03/M04 bleiben dokumentiert.

Bewertung: D-FORM ist auf dem gleichen Vor-Subframe-Dokumentationsniveau wie die besser ausgearbeiteten P2 Auth Pakete. Subframe ist als Draft gebaut und verlinkt; Review und Feinschliff folgen.


4. Brainstorming

Flow-Frage

Wie bekommt David den Builder so vorbereitet, dass er nicht in zehn Unterseiten zerfaellt, aber trotzdem alle schweren Entscheidungen sichtbar sind?

UX-Varianten

Option Beschreibung Vorteil Nachteil Empfehlung
D Ein grosser Builder-Screen mit Palette, Canvas, Properties, Preview und Tabs/Panels fuer Sharing/Actions/Logic. Ein Arbeitsort, weniger Navigation, passt zum Bespoke-Canvas. Kann sehr dicht werden. Genommen fuer v1-Draft.
B Mehrere Unterseiten: Felder, Design, Logic, Sharing, Actions, Preview. Uebersichtlicher pro Thema. Wirkt eher Settings als Canvas; mehr Route- und Handoff-Last. Raus fuer v1-Draft.
C Minimaler Builder plus separate Modals fuer jedes Feature. Reduziert Hauptscreen. Modal-Kaskade wird schwer wartbar; Field-Mapping leidet. Nur fuer einzelne Confirm-/Blocker-Zustaende.

Entscheidung

Entscheidung Status Notiz
Builder als ein Hauptscreen genommen Die Route /forms/:id/edit ist der Arbeitsort.
Public Form als eigener Screen genommen Extern sichtbar, eigener Polish, eigene Zustaende.
Sharing in Builder integrieren genommen URL, QR, iFrame als Panel/Tab im Builder.
Post-Submit-Actions in Builder integrieren genommen Field-Mapping gehoert zur Form-Konfiguration, kein eigener Screen.
Conditional Logic in v1 eng schneiden genommen Nur Anzeige/Ausblenden: Wenn Feld Y = Z, zeige Feld X.
12 Feldtypen nach A4 verwenden Empfehlung genommen Text, Textarea, Zahl, Waehrung, Datum, Datum-Range, Select, Multi-Select, Boolean, Email, Telefon, Datei.
Code-Stand nicht als Design-Grenze nehmen genommen Der vorhandene Form-Widget-Code ist kleiner als D-FORM; Design folgt Planning/D4.
Personalisierte Links raus fuer v1 Laut Ticket v2.
JS-Snippet raus fuer v1 Laut Ticket v2, iFrame bleibt.

Arbeitsentscheidung: 12 Feldtypen

Fuer Davids D-FORM-Draft nehmen wir die A4-Liste als verbindliche v1-Designbasis:

Feldtyp Design-Hinweis
Text Einzeiliger Text.
Textarea Mehrzeiliger Text, optional Markdown-Anmutung fuer interne/langformatige Antworten.
Zahl Ganze Zahl oder Dezimalwert.
Waehrung Zahl mit Waehrungsformat, z. B. Auftragswert.
Datum Einzelnes Datum.
Datum-Range Start-/Enddatum oder Zeitraum.
Select Eine Auswahl aus Optionen; Radio kann als Darstellungsvariante davon gelten.
Multi-Select Mehrere Optionen, z. B. Chips oder Checkbox-Liste.
Boolean Ja/Nein, Checkbox oder Toggle.
Email Email mit Formatvalidierung.
Telefon Telefonnummer mit Format-/Normalisierungs-Hinweis.
Datei Datei-Upload; Foto ist fuer v1 eine Upload-/Kamera-Variante, kein eigener Feldtyp.

Nicht als normale Feldtypen zaehlen: Honeypot/mCaptcha (Anti-Spam), Section Header/Description (Darstellungsbloecke), Signature (Abnahme/Signatur-Kontext), Hidden Field, Address-Autocomplete. Diese koennen spaeter als v2 oder Spezialbausteine dazukommen.

Arbeitsentscheidung: Post-Submit-Actions

Der Builder zeigt Actions, aber baut keinen zweiten Automation-Editor.

Tiefe Inhalt Entscheidung
Action-Liste Reihenfolge, Typ, aktiv/inaktiv, kurzer Status, Warnungen. In S01 sichtbar.
Action-Konfiguration Ziel, Bedingung optional, Empfaenger/URL/Entity, Field-Mapping-Zeilen. In S01 als Panel/Drawer/Tab sichtbar.
Field-Mapping Form-Feld -> Ziel-Feld, Pflichtfeldwarnungen, fehlende Zuordnung. In S01 sichtbar.
Test/Validation Webhook-URL pruefen, Mapping-Warnungen, Preview was erzeugt wird. In S01 dokumentieren.
ActionLog voll Submission-bezogene Ausfuehrungen, Re-Run, Fehlerverlauf. Nicht eigener D-FORM-Screen; gehoert zu Submissions-Compose.

Arbeitsentscheidung: Builder-Arbeitsbereiche

Der Form-Builder bleibt ein Hauptscreen, aber nicht alles muss gleichzeitig im Vordergrund sein.

Arbeitsbereich Gewichtung Empfehlung fuer David
Header / Status dauerhaft sichtbar Name, Status Draft/Published, Save, Preview, Publish, Share.
Feld-Palette Primaerbereich 12 Feldtypen schnell scanbar, Drag + Klick.
Canvas Primaerbereich Reihenfolge der Felder, Drag-and-Drop, Empty State, Feldfehler.
Feld-Inspector Primaerbereich Ausgewaehltes Feld bearbeiten: Label, Key, Pflicht, Validation, Optionen.
Logic Sekundaerbereich Eigener Tab/Panel/Drawer; einfache Wenn-Dann-Regeln.
Actions Sekundaerbereich Eigener Tab/Panel/Drawer; Action-Liste + Mapping.
Sharing Sekundaerbereich Eigener Tab/Panel/Drawer; URL, QR, iFrame.
Preview Umschaltbereich Public-nahe Vorschau, ideal als eigener View/Tab oder rechte Preview-Fläche.
Settings Sekundaerbereich Slug, Success Message, Redirect, Branding/Theme, Allowed Origins.

Empfehlung: David sollte Palette + Canvas + Inspector als Kernarbeit verstehen. Logic, Actions, Sharing, Preview und Settings sind eigene Arbeitsmodi um denselben Form-Datensatz herum.

Happy Path

  1. Nutzer oeffnet den Form-Builder.
  2. Nutzer waehlt ein Feld aus der Palette und zieht es in den Canvas.
  3. Nutzer konfiguriert Label, Pflichtfeld, Optionen und Validierung.
  4. Nutzer setzt bei Bedarf Conditional Logic.
  5. Nutzer prueft die Live-Vorschau.
  6. Nutzer definiert Post-Submit-Actions mit Field-Mapping.
  7. Nutzer published das Formular.
  8. Nutzer kopiert Public URL, QR oder iFrame.
  9. Externer Submitter oeffnet das Public Form, fuellt es aus und sendet ab.
  10. System zeigt Erfolgstext oder leitet weiter.

Varianten / Branches

  • Feld ohne Label oder ungueltige Konfiguration.
  • Conditional Logic referenziert ein geloeschtes Feld.
  • Pflichtfeld ohne passende Validation.
  • Webhook-URL ungueltig.
  • Publish blockiert wegen fehlendem Namen, Slug oder sichtbaren Feldern.
  • Public Form ist nicht veroeffentlicht, archiviert, geschlossen oder nicht erreichbar.
  • Captcha oder Submit schlaegt fehl.

Roadblocks

  • Zu viele Funktionen im Builder koennen David ueberladen.
  • 12 Feldtypen muessen aus A4 kommen, aber Builder braucht Feld-spezifische Properties.
  • Post-Submit-Actions koennen sehr komplex werden; im Design sollte Field-Mapping sichtbar sein, ohne einen Automations-Editor nachzubauen.
  • Public Form muss wiederverwendbar fuer HR, Booking-Intake, Urlaub/Krank und Requests sein.

Meldungs-/Error-State-Brainstorming

Ereignis UI-Form Blockiert? Bauen? Copy/Notiz
Keine Felder im Formular Empty State im Canvas nein ja, in S01 Klarer CTD: Feld aus Palette hinzufuegen.
Ungueltiges Feld Inline + Summary-Banner ja, fuer Publish dokumentieren Feldname nennen, nicht nur generisch.
Logic-Regel kaputt Inline im Logic-Panel ja, fuer Publish dokumentieren Ursache zeigen: referenziertes Feld fehlt.
Publish nicht moeglich Banner im Builder ja dokumentieren Liste der fehlenden Voraussetzungen.
Kopieren erfolgreich Toast nein dokumentieren URL/iFrame kopiert.
Public Form nicht verfuegbar Public Blocker Screen ja ja, V02 Externe Nutzer brauchen klare Erklaerung.
Captcha fehlgeschlagen Inline/Banner im Public Form ja, temporar ja, V03 Erneut versuchen.
Submit erfolgreich Public Success State nein ja, V01 Erfolgstext oder Redirect.

Offene Fragen

  • Soll date, datetime, time spaeter als Varianten des Datumsfelds oder als eigene v2-Feldtypen behandelt werden?
  • Soll signature im Form-Builder v1 als normales Feld verfuegbar sein oder nur im Abnahme-/Signatur-Kontext?
  • Wie tief soll Field-Mapping fuer create_projekt in v1 sichtbar sein?
  • Soll der Public Form Renderer mehrere Branding-Level haben oder nur Tenant-Logo plus einfache Theme-Werte?

5. Screen-Kandidaten nach Entscheidung

Kandidat Warum eventuell noetig? Erste Einschaetzung
Form-Builder Canvas Hauptarbeitsort, komplexe Sonder-UI. Bauen
Oeffentliches Formular Extern sichtbar, eigener Polish, eigener Renderer. Bauen
Public Erfolg oder Redirect Submit-Ende ist copy- und vertrauenskritisch. Bauen
Public Formular nicht verfuegbar Externer Blocker braucht klare Loesung. Bauen
Public Captcha oder Submit Fehler Hauefiger Public-Fehler, muss sauber wirken. Bauen oder dokumentieren
Sharing-Panel URL/QR/iFrame gehoeren in Builder. In ADV-S01 integrieren
Post-Submit-Actions Field-Mapping muss sichtbar sein. In ADV-S01 integrieren
Conditional-Logic-Editor v1-Pflicht, aber eng schneiden. In ADV-S01 integrieren
Forms-Liste Compose aus D2, nicht D-FORM. Raus
Submissions Compose aus A2/A3, nicht D-FORM. Raus
Booking-Intake Eigenes Ticket D-BOOK. Raus
Signatur-Wizard Eigenes Paket/Compose. Raus

6. Screen Validation Gate

ID Screen/Zustand Ist eigener Arbeitsmoment? Neue Struktur/Entscheidung/Risiko? Entscheidung Begruendung
ADV-S01 [[Screens/90 ADV Form-Builder Canvas ADV-S01 Form-Builder Canvas]] ja ja, schwerste P16-UI Referenz behalten
S04 [[Screens/07 S04 Oeffentliches Formular S04 Oeffentliches Formular]] ja ja, Public Renderer und Branding Bauen
V01 [[Screens/08 V01 Public Erfolg oder Redirect V01 Public Erfolg oder Redirect]] teilweise ja, Submit-Ende und Copy Bauen
V02 [[Screens/09 V02 Public Formular nicht verfuegbar V02 Public Formular nicht verfuegbar]] ja ja, blockierender Public-State Bauen
V03 [[Screens/10 V03 Public Captcha oder Submit Fehler V03 Public Captcha oder Submit Fehler]] teilweise ja, Public Trust Bauen
D01 Screens/D01 Sharing Panel URL QR iFrame nein nein, Bereich in S01 Nur dokumentieren Kein eigener Screen, aber UI-Bereich.
D02 Screens/D02 Post-Submit Actions nein ja, Mapping-Komplexitaet Nur dokumentieren In S01 als Panel/Tab dokumentieren.
D03 Screens/D03 Conditional Logic Editor nein ja, Regel-Editor Nur dokumentieren In S01 als Panel/Tab dokumentieren.
D06 Screens/D06 Feldkarten Menue nein ja, Klick-Logik nach David-Feedback Nur dokumentieren 3-Punkte-Menue fuer Duplizieren, Loeschen, ggf. Deaktivieren.
M01 Screens/M01 Feld loeschen Confirm nein ja, Abhaengigkeiten in Logic/Actions Nur dokumentieren Confirm nur bei Risiko, kein normaler Bearbeitungsdialog.
D07 [[Screens/91 D07 Logic Regel Detail D07 Logic Regel Detail]] teilweise ja, Regelbearbeitung Referenz behalten
D08 [[Screens/92 D08 Action Detail mit Mapping D08 Action Detail mit Mapping]] teilweise ja, Field-Mapping Referenz behalten
D09 [[Screens/93 D09 Publish Blocker Summary D09 Publish Blocker Summary]] ja ja, Publish-Entscheidung Referenz behalten
D10 Screens/D10 Builder Interaktionsfaelle nein ja, Auswahlfolgen und Edge Cases Nur dokumentieren Case-Matrix fuer Dropdowns, Checkboxen, vergessene Zwischenschritte, Datei/Bild und Modal-Inhalte.
M02 Screens/M02 Unpublish Confirm nein ja, public-wirksam Nur dokumentieren Confirm-Dialog wegen Public-Link.
M03 Screens/M03 Archive Confirm nein ja, destruktiv/Statuswechsel Nur dokumentieren Confirm aus More-Menue.
M04 Screens/M04 Unsaved Changes Confirm nein ja, Datenverlust-Risiko Nur dokumentieren Standard-Guard beim Verlassen mit Dirty State.
D04 Forms-Liste nein nein Raus Compose, nicht Teil von D-FORM.
D05 Submissions nein nein Raus Compose, nicht Teil von D-FORM.

Entscheidung: Bauen, Wiederverwenden, Nur dokumentieren, Spaeter, Raus

Validation-Ergebnis fuer David

Der urspruengliche Advanced-Subframe-Fokus lag auf diesen 8 Frames/Zustaenden:

  • ADV-S01 Form-Builder Canvas
  • S04 Oeffentliches Formular
  • V01 Public Erfolg oder Redirect
  • V02 Public Formular nicht verfuegbar
  • V03 Public Captcha oder Submit Fehler
  • D07 Logic Regel Detail
  • D08 Action Detail mit Mapping
  • D09 Publish Blocker Summary

Nach der Simple-Builder-Neuausrichtung sind zusaetzlich gebaut und fuer Review nach vorne gezogen:

  • S00 Formulare verwalten
  • S01 Formularart auswaehlen
  • S02 Einfacher Fragen Editor
  • S01B Gefuehrter Fragen Editor
  • S01C Website Formular Editor
  • S01D Umfrage Editor
  • S01E Internes Formular Editor
  • S03 Formular Design
  • S05 Antworten Tabelle

Nicht als eigene Frames bauen:

  • Kein Sharing/Teilen als eigener Hauptreiter im Simple Builder; Public-Link/QR/Einbettung gehoeren in Veroeffentlichen/Public-Link-Kontext.
  • Actions, Logic, Preview und Settings als Arbeitsbereiche von S01 bzw. einfache Zusatzoptionen im Simple Builder.
  • Feldkarten-Menue, allgemeine Panels, D10 Case-Matrix und Confirm-Dialoge als dokumentierte ADV-S01-Zustaende.
  • Vollstaendige Forms-Liste und Submissions, weil diese Compose aus A2/A3 sind. S00/S05 sind nur schlanke D-FORM-Einstiegs-/Antwortansichten.
  • Booking/Kalender/Signatur, weil diese eigene Tickets haben.

Als zusaetzliche S01-Zustandsframes bauen:

  • D07 Logic Regel Detail
  • D08 Action Detail mit Mapping
  • D09 Publish Blocker Summary

Copy-kritische Zustaende

Zustand Bauen? Warum / Copy-Entscheidung
Publish blockiert dokumentieren Interner Nutzer braucht konkrete fehlende Punkte.
Public Erfolg ja Externer Nutzer muss sicher wissen, dass die Anfrage angekommen ist.
Public nicht verfuegbar ja Externer Nutzer ist blockiert.
Captcha/Submit Fehler ja Vertrauen erhalten, einfache naechste Aktion.

Blockierende Error States

Zustand UI-Form Primaeraktion Sekundare Aktion Inhalt/Copy-Richtung
Public Form nicht veroeffentlicht Screen Zur Website zurueck Anbieter kontaktieren Formular ist aktuell nicht verfuegbar.
Public Form geschlossen Screen Anbieter kontaktieren - Dnnahmezeitraum ist beendet.
Public Submit scheitert dauerhaft Banner/Screen Erneut versuchen Anbieter kontaktieren Keine technischen Details.
Builder Publish blockiert Banner im Builder Fehler beheben Vorschau weiter nutzen Konkrete Liste: Name, Slug, Feldfehler.

7. Validierte Screen-Liste

ID Screen/Zustand Typ Umsetzung Ort Status
S00 [[Screens/01 S00 Formulare verwalten S00 Formulare verwalten]] Formular-Zentrale Bauen /forms
E01 [[Screens/02 E01 S00 Keine Formulare E01 S00 Keine Formulare]] Empty State Bauen /forms
E02 [[Screens/03 E02 S00 Keine Treffer E02 S00 Keine Treffer]] Empty State Bauen /forms
S01 [[Screens/04 S01 Formularart auswaehlen S01 Formularart auswaehlen]] Einstieg / Auswahl Bauen /forms/new
S02 [[Screens/05 S02 Einfacher Fragen Editor S02 Einfacher Fragen Editor]] Simple Builder Bauen /forms/:id/edit
S02L [[Screens/05b S02L Lead Felder zuweisen S02L Lead Felder zuweisen]] Lead-Zustand Bauen /forms/:id/edit
E05 [[Screens/05c E05 S02 Lead Zuweisung pruefen E05 S02 Lead Zuweisung pruefen]] Lead Error State Bauen /forms/:id/edit
S03 [[Screens/06 S03 Formular Design S03 Formular Design]] Builder Tab Bauen /forms/:id/edit
S04 [[Screens/07 S04 Oeffentliches Formular S04 Oeffentliches Formular]] Public Form Bauen /f/{tenant}/{slug}
V01 [[Screens/08 V01 Public Erfolg oder Redirect V01 Public Erfolg oder Redirect]] Public Feedback Bauen nach Submit
V02 [[Screens/09 V02 Public Formular nicht verfuegbar V02 Public Formular nicht verfuegbar]] Public Blocker Bauen Variante von S04
V03 [[Screens/10 V03 Public Captcha oder Submit Fehler V03 Public Captcha oder Submit Fehler]] Public Error Bauen Variante von S04
S05 [[Screens/11 S05 Antworten Tabelle S05 Antworten Tabelle]] Builder Tab Bauen /forms/:id/edit
E03 [[Screens/12 E03 S05 Keine Antworten E03 S05 Keine Antworten]] Empty State Bauen /forms/:id/edit
E04 [[Screens/13 E04 S05 Export Fehler E04 S05 Export Fehler]] Error State Bauen /forms/:id/edit
S01B [[Screens/80 S01B Gefuehrter Fragen Editor S01B Gefuehrter Fragen Editor]] Spaeter / Referenz Bauen /forms/:id/edit
S01C [[Screens/81 S01C Website Formular Editor S01C Website Formular Editor]] Spaeter / Referenz Bauen /forms/:id/edit
S01D [[Screens/82 S01D Umfrage Editor S01D Umfrage Editor]] Spaeter / Referenz Bauen /forms/:id/edit
S01E [[Screens/83 S01E Internes Formular Editor S01E Internes Formular Editor]] Spaeter / Referenz Bauen /forms/:id/edit
ADV-S01 [[Screens/90 ADV Form-Builder Canvas ADV-S01 Form-Builder Canvas]] Advanced Builder / Referenz Bauen /forms/:id/edit
S01 [[Screens/90b ADV Form-Builder Canvas 2 ADV-S01-2 Form-Builder Canvas 2]] Advanced Builder / Referenz Bauen /forms/:id/edit

ADV-S01-Zustaende und Zusatzframes vor Subframe

Diese Eintraege sind ausgearbeitet. D07/D08/D09 wurden nach Empfehlung als zusaetzliche Subframe-Zustaende gebaut; die restlichen bleiben dokumentiert.

ID Zustand Typ Umsetzung
D01 Screens/D01 Sharing Panel URL QR iFrame Panel-Zustand Nur dokumentieren
D02 Screens/D02 Post-Submit Actions Panel-Zustand Nur dokumentieren
D03 Screens/D03 Conditional Logic Editor Panel-Zustand Nur dokumentieren
D06 Screens/D06 Feldkarten Menue Inline-Zustand Nur dokumentieren
M01 Screens/M01 Feld loeschen Confirm Confirm Modal Nur dokumentieren
D07 [[Screens/91 D07 Logic Regel Detail D07 Logic Regel Detail]] Panel-Zustand
D08 [[Screens/92 D08 Action Detail mit Mapping D08 Action Detail mit Mapping]] Panel-Zustand
D09 [[Screens/93 D09 Publish Blocker Summary D09 Publish Blocker Summary]] Inline-Zustand
D10 Screens/D10 Builder Interaktionsfaelle Case-Matrix Nur dokumentieren
M02 Screens/M02 Unpublish Confirm Confirm Modal Nur dokumentieren
M03 Screens/M03 Archive Confirm Confirm Modal Nur dokumentieren
M04 Screens/M04 Unsaved Changes Confirm Confirm Modal / Browser Guard Nur dokumentieren

8. Subframe-Grid

Interner Hauptarbeitsort:

ADV-S01 Form-Builder Canvas
  - Header / Status / Save / Publish
  - Feld-Palette
  - Canvas
  - Feld-Inspector
  - Arbeitsmodi: Logic, Actions, Sharing, Preview, Settings

Dokumentierte ADV-S01-Zustaende:

S01 -> D01 Sharing Panel
S01 -> D02 Post-Submit Actions -> D08 Action Detail mit Mapping
S01 -> D03 Conditional Logic Editor -> D07 Logic Regel Detail
S01 -> D06 Feldkarten Menue -> M01 Feld loeschen Confirm
S01 -> D09 Publish Blocker Summary -> M02 Unpublish Confirm
S01 -> M03 Archive Confirm
S01 -> M04 Unsaved Changes Confirm
S01 -> D10 Builder Interaktionsfaelle

Public Flow:

S04 Oeffentliches Formular
 |
 +--> V01 Public Erfolg oder Redirect
 |
 +--> V02 Public Formular nicht verfuegbar
 |
 +--> V03 Public Captcha oder Submit Fehler

9. Screen-Pakete


10. Handoff-Check

  • Jeder Screen ist mit Umsetzung markiert.
  • Jedes sichtbare Feld hat eine Datenquelle. Als Detail-Brainstorming dokumentiert.
  • Jeder Button hat eine Aktion. Nach David-Feedback um Interaktionslogik ergaenzt.
  • Die wichtigsten ADV-S01-Klickzustaende sind als eigene Vor-Subframe-Dateien dokumentiert.
  • Die wichtigsten Was-passiert-wenn-Faelle sind in D10 als Case-Matrix dokumentiert.
  • Canvas ist nach P2-Auth-Referenz erweitert: Hauptflow, ADV-S01-Zustaende, D10, Public Flow und Scope-Notizen.
  • Banner/Inline-Meldungen sind dokumentiert.
  • Toasts/Action-Feedback sind dokumentiert.
  • Meldungs-/Error-State-Matrix ist ausgefuellt.
  • Blockierende Error States sind mit naechster Aktion definiert.
  • Relevante Zustaende sind beschrieben.
  • Offene Fragen sind sichtbar.
  • Ticket-Handoff-Entwurf ist in Tickets/Fertige Tickets/ angelegt.
  • Detail-Brainstorming fuer ADV-S01/S02/S04/V01/V02/V03 ist abgeschlossen.
  • David-Review-Rueckmeldung ist erfolgt.
  • S01-Interaktionslogik nach David-Feedback ist eingearbeitet.
  • David-Freigabe nach S01-Nacharbeit ist erfolgt.
  • Subframe-Link fuer Flow, Hauptfluss 01-13 und Referenzseiten 80-93 ist eingetragen.