--- kind: wireframe-package project: HiveGrid Screen Project ticket: D-FORM package: WF-D-FORM Form Builder typ: Flow status: Review-ready / Subframe Draft gebaut subframe: "https://app.subframe.com/f023064a5ca0/flow/afb1c257-46f0-4b23-aaed-d75f4773f1a9/edit?tab=ai&conversationId=02d948da-f9aa-4ab5-8352-2745789bb9ad" canvas: "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 einfachen internen Formular-Editor und das oeffentliche Formular. Der Fokus liegt bewusst auf den zwei Bespoke-Erlebnissen: - S02 Fragen-Editor 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 S00/S01/S02/S03/S05 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 auf den einfachen S02-Hauptfluss ausgerichtet. D-FORM ist in Subframe als Draft gebaut: S00 bis S05, S02L/E05 fuer Lead-Zuweisung und die Public-Screens S04/V01/V02/V03. 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 Builder fachlich stark, aber zu komplex. Deshalb wurden einfachere Alternativen gebaut: zuerst [[Screens/01 S00 Formulare verwalten|S00 Formulare verwalten]] als Startseite, danach [[Screens/04 S01 Formularart auswaehlen|S01 Formularart auswaehlen]] und Google-Forms-artige Beispiel-Editoren. Hauptvariante ist [[Screens/05 S02 Einfacher Fragen Editor|S02 Einfacher Fragen Editor]]. [[Screens/81 S01C Website Formular Editor|S01C Website Formular Editor]], [[Screens/82 S01D Umfrage Editor|S01D Umfrage Editor]] und [[Screens/83 S01E Internes Formular Editor|S01E Internes Formular Editor]] bleiben spaetere Beispiele. Ergaenzt wurden ausserdem [[Screens/06 S03 Formular Design|S03 Formular Design]] und [[Screens/11 S05 Antworten Tabelle|S05 Antworten Tabelle]]. **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|S02L Lead Felder zuweisen]]. Wenn eine Zuweisung fehlt oder nicht moeglich ist, greift optional [[Screens/05c E05 S02 Lead Zuweisung pruefen|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. **Cleanup 2026-07-10:** S01B, die alten Advanced-Screens 90/90b/91/92/93 und die doppelten Dateien unter `Varianten/` wurden aus Obsidian entfernt. Der Handoff zeigt nur noch den aktuellen Hauptfluss plus S01C/S01D/S01E als optionale Beispiele. --- ## 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 | |---|---|---| | S02 Haupteditor | Simple Builder mit Fragekarten, Fragetypen, Bedingung und Lead-Hinweis gebaut. | David prueft die einfache Richtung. | | S02L/E05 Lead-Zuweisung | Lead-Felder werden per Dropdown zugewiesen; Fehlerzustand ist gebaut. | David prueft, ob die Zuordnung reicht. | | S04 Public Form | Arbeitsentwurf in S04 ergaenzt. | David validiert Public Layout, Mobile, Submit und Branding. | | V01/V02/V03 Public-States | Public Success, Nicht-verfuegbar und Captcha/Submit-Fehler gebaut. | David validiert Copy und Public-Fehlerlogik. | | Canvas/Tracker/Handoff | Auf aktuellen Hauptfluss bereinigt; alte Advanced-Frames aus Obsidian entfernt. | Vor Subframe nur noch David-Freigabe bzw. gezielte Korrekturen. | --- ## 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 | Public-Link-/Teilen-Kontext im einfachen Builder, kein eigener Review-Screen. | | 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: Der aktuelle Review konzentriert sich auf den S02-Hauptfluss. M01/M02 und die restlichen D-/M-Zustaende bleiben vorerst dokumentiert. Dokumentierte Detaildateien: [[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/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 | S02/S02L/E05/S04/V01-V03 sowie D-/M-Notizen entsprechend ausgearbeitet. | | D-/M-Zustaende als eigene Dateien, auch wenn sie nicht gebaut werden | Detailnotizen liegen im `Screens`-Ordner, sind aber nicht Teil der aktuellen Subframe-Review-Reihenfolge. | | 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 die D-/M-Notizen als Dokumentation ohne Canvas-Link. | 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 den Public-Link-Kontext. | Dokumentieren | | Post-Submit-Actions | Lead-Feldzuweisung muss sichtbar sein. | In S02L/E05 abgebildet | | Conditional-Logic-Editor | v1 eng schneiden. | Als einfache Bedingung an der Frage | | 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 | |---|---|---|---|---|---| | S04 | [[Screens/07 S04 Oeffentliches Formular|S04 Oeffentliches Formular]] | ja | ja, Public Renderer und Branding | Bauen | Extern sichtbar, hoher Polish. | | V01 | [[Screens/08 V01 Public Erfolg oder Redirect|V01 Public Erfolg oder Redirect]] | teilweise | ja, Submit-Ende und Copy | Bauen | Public Dbschluss soll nicht Dev-Default sein. | | V02 | [[Screens/09 V02 Public Formular nicht verfuegbar|V02 Public Formular nicht verfuegbar]] | ja | ja, blockierender Public-State | Bauen | Nutzer kann nicht fortfahren. | | V03 | [[Screens/10 V03 Public Captcha oder Submit Fehler|V03 Public Captcha oder Submit Fehler]] | teilweise | ja, Public Trust | Bauen | Fehler darf nicht technisch wirken. | | 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. | | 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**: - S04 Oeffentliches Formular - V01 Public Erfolg oder Redirect - V02 Public Formular nicht verfuegbar - V03 Public Captcha oder Submit Fehler Nach der Simple-Builder-Neuausrichtung sind zusaetzlich gebaut und fuer Review nach vorne gezogen: - S00 Formulare verwalten - S01 Formularart auswaehlen - S02 Einfacher 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 Detailnotizen. - 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. Keine zusaetzlichen Advanced-Zustandsframes im aktuellen Handoff bauen. ### 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` | Subframe Draft / Review offen | | E01 | [[Screens/02 E01 S00 Keine Formulare|E01 S00 Keine Formulare]] | Empty State | Bauen | `/forms` | Subframe Draft / Review offen | | E02 | [[Screens/03 E02 S00 Keine Treffer|E02 S00 Keine Treffer]] | Empty State | Bauen | `/forms` | Subframe Draft / Review offen | | S01 | [[Screens/04 S01 Formularart auswaehlen|S01 Formularart auswaehlen]] | Einstieg / Auswahl | Bauen | `/forms/new` | Subframe Draft / Review offen | | S02 | [[Screens/05 S02 Einfacher Fragen Editor|S02 Einfacher Fragen Editor]] | Simple Builder | Bauen | `/forms/:id/edit` | Subframe Draft / Review offen | | S02L | [[Screens/05b S02L Lead Felder zuweisen|S02L Lead Felder zuweisen]] | Lead-Zustand | Bauen | `/forms/:id/edit` | Subframe Draft / Review offen | | E05 | [[Screens/05c E05 S02 Lead Zuweisung pruefen|E05 S02 Lead Zuweisung pruefen]] | Lead Error State | Bauen | `/forms/:id/edit` | Subframe Draft / Review offen | | S03 | [[Screens/06 S03 Formular Design|S03 Formular Design]] | Builder Tab | Bauen | `/forms/:id/edit` | Subframe Draft / Review offen | | S04 | [[Screens/07 S04 Oeffentliches Formular|S04 Oeffentliches Formular]] | Public Form | Bauen | `/f/{tenant}/{slug}` | Subframe Draft / Review offen | | V01 | [[Screens/08 V01 Public Erfolg oder Redirect|V01 Public Erfolg oder Redirect]] | Public Feedback | Bauen | nach Submit | Subframe Draft / Review offen | | V02 | [[Screens/09 V02 Public Formular nicht verfuegbar|V02 Public Formular nicht verfuegbar]] | Public Blocker | Bauen | Variante von S04 | Subframe Draft / Review offen | | V03 | [[Screens/10 V03 Public Captcha oder Submit Fehler|V03 Public Captcha oder Submit Fehler]] | Public Error | Bauen | Variante von S04 | Subframe Draft / Review offen | | S05 | [[Screens/11 S05 Antworten Tabelle|S05 Antworten Tabelle]] | Builder Tab | Bauen | `/forms/:id/edit` | Subframe Draft / Review offen | | E03 | [[Screens/12 E03 S05 Keine Antworten|E03 S05 Keine Antworten]] | Empty State | Bauen | `/forms/:id/edit` | Subframe Draft / Review offen | | E04 | [[Screens/13 E04 S05 Export Fehler|E04 S05 Export Fehler]] | Error State | Bauen | `/forms/:id/edit` | Subframe Draft / Review offen | | S01C | [[Screens/81 S01C Website Formular Editor|S01C Website Formular Editor]] | Spaeter / Referenz | Bauen | `/forms/:id/edit` | Subframe Draft / Referenz | | S01D | [[Screens/82 S01D Umfrage Editor|S01D Umfrage Editor]] | Spaeter / Referenz | Bauen | `/forms/:id/edit` | Subframe Draft / Referenz | | S01E | [[Screens/83 S01E Internes Formular Editor|S01E Internes Formular Editor]] | Spaeter / Referenz | Bauen | `/forms/:id/edit` | Subframe Draft / Referenz | ### Detailnotizen ohne eigene Review-Screens Diese Eintraege sind ausgearbeitet, bleiben aber Dokumentation und sind nicht Teil der aktuellen Subframe-Review-Reihenfolge. | 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 | | 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: ```text S02 Einfacher Fragen Editor - Fragen - Lead-Hinweis / Felder zuweisen - Bedingung direkt an der Frage - Design-Tab S03 - Antworten-Tab S05 ``` Dokumentierte Detailnotizen: ```text S02 -> D01 Sharing Panel S02 -> D02 Post-Submit Actions S02 -> D03 Conditional Logic Editor S02 -> D06 Feldkarten Menue -> M01 Feld loeschen Confirm S02 Publish-Kontext -> M02 Unpublish Confirm S02 -> M03 Archive Confirm S02 -> M04 Unsaved Changes Confirm S02 -> D10 Builder Interaktionsfaelle ``` Public Flow: ```text S04 Oeffentliches Formular | +--> V01 Public Erfolg oder Redirect | +--> V02 Public Formular nicht verfuegbar | +--> V03 Public Captcha oder Submit Fehler ``` --- ## 9. Screen-Pakete - [[David Review Checkliste]] - [[Screens/01 S00 Formulare verwalten|S00 Formulare verwalten]] - [[Screens/02 E01 S00 Keine Formulare|E01 S00 Keine Formulare]] - [[Screens/03 E02 S00 Keine Treffer|E02 S00 Keine Treffer]] - [[Screens/04 S01 Formularart auswaehlen|S01 Formularart auswaehlen]] - [[Screens/05 S02 Einfacher Fragen Editor|S02 Einfacher Fragen Editor]] - [[Screens/06 S03 Formular Design|S03 Formular Design]] - [[Screens/07 S04 Oeffentliches Formular|S04 Oeffentliches Formular]] - [[Screens/08 V01 Public Erfolg oder Redirect|V01 Public Erfolg oder Redirect]] - [[Screens/09 V02 Public Formular nicht verfuegbar|V02 Public Formular nicht verfuegbar]] - [[Screens/10 V03 Public Captcha oder Submit Fehler|V03 Public Captcha oder Submit Fehler]] - [[Screens/11 S05 Antworten Tabelle|S05 Antworten Tabelle]] - [[Screens/12 E03 S05 Keine Antworten|E03 S05 Keine Antworten]] - [[Screens/13 E04 S05 Export Fehler|E04 S05 Export Fehler]] - [[Screens/81 S01C Website Formular Editor|S01C Website Formular Editor]] - [[Screens/82 S01D Umfrage Editor|S01D Umfrage Editor]] - [[Screens/83 S01E Internes Formular Editor|S01E Internes Formular Editor]] - [[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/D10 Builder Interaktionsfaelle]] - [[Screens/M02 Unpublish Confirm]] - [[Screens/M03 Archive Confirm]] - [[Screens/M04 Unsaved Changes Confirm]] --- ## 10. Handoff-Check - [x] Jeder Screen ist mit Umsetzung markiert. - [x] Jedes sichtbare Feld hat eine Datenquelle. Als Detail-Brainstorming dokumentiert. - [x] Jeder Button hat eine Aktion. Nach David-Feedback um Interaktionslogik ergaenzt. - [x] Die wichtigsten Klickzustaende sind als Markdown-Detailnotizen dokumentiert. - [x] Die wichtigsten Was-passiert-wenn-Faelle sind in D10 als Case-Matrix dokumentiert. - [x] Canvas ist auf Hauptflow, Public Flow und Scope-Notizen bereinigt. - [x] Banner/Inline-Meldungen sind dokumentiert. - [x] Toasts/Action-Feedback sind dokumentiert. - [x] Meldungs-/Error-State-Matrix ist ausgefuellt. - [x] Blockierende Error States sind mit naechster Aktion definiert. - [x] Relevante Zustaende sind beschrieben. - [x] Offene Fragen sind sichtbar. - [x] Ticket-Handoff-Entwurf ist in `Tickets/Fertige Tickets/` angelegt. - [x] Detail-Brainstorming fuer S02/S04/V01/V02/V03 ist abgeschlossen. - [x] David-Review-Rueckmeldung ist erfolgt. - [x] S01-Interaktionslogik nach David-Feedback ist eingearbeitet. - [ ] David-Freigabe nach S01-Nacharbeit ist erfolgt. - [x] Subframe-Link fuer Flow und Hauptfluss 01-13 ist eingetragen.