--- kind: screen project: HiveGrid Screen Project ticket: D-FORM package: WF-D-FORM Form Builder id: ADV-S01 screen: Form-Builder Canvas typ: Bespoke Builder umsetzung: Bauen status: Subframe Draft / Review offen route: /forms/:id/edit subframe: "https://app.subframe.com/f023064a5ca0/design/e5502f88-9858-460e-abae-671f28464270/edit" --- # ADV-S01 - Form-Builder Canvas ## Ziel Interne Nutzer bauen, konfigurieren, pruefen und veroeffentlichen ein Formular an einem Arbeitsort. Der Screen muss Feldaufbau, Validierung, Conditional Logic, Preview, Sharing und Post-Submit-Actions sichtbar machen, ohne in mehrere neue Routen zu zerfallen. ## Pattern / Archetyp BESPOKE Builder. Nutzt A4 Form/Input-Kit fuer die Feldtypen und A7 Zustands-Kit fuer Empty/Loading/Error/Permission. ## Arbeitsbereiche Dies ist keine finale Layout-Vorgabe, sondern die Arbeitslogik fuer David. | Bereich | Zweck | Sichtbarkeit | |---|---|---| | Header / Statusbar | Form-Name, Status, Save, Preview, Publish, Share. | dauerhaft sichtbar | | Feld-Palette | 12 Feldtypen hinzufuegen. | primaer | | Canvas | Feldliste in Reihenfolge, Drag-and-Drop, Empty State, Feldfehler. | primaer | | Feld-Inspector | ausgewaehltes Feld konfigurieren. | primaer | | Logic | Wenn-Dann-Regeln fuer sichtbare Felder. | Sekundaer-Tab/Panel | | Actions | Post-Submit-Actions und Field-Mapping. | Sekundaer-Tab/Panel | | Sharing | Public URL, QR, iFrame. | Sekundaer-Tab/Panel | | Preview | Public-nahe Vorschau. | Umschaltmodus oder Side Preview | | Settings | Slug, Success, Redirect, Branding, technische Public-Settings. | Sekundaer-Tab/Panel | Empfehlung: Der Screen soll sich wie ein Builder anfuehlen, nicht wie eine lange Settings-Seite. Palette, Canvas und Inspector sind die Arbeitsmitte. Alles andere ist nah dran, aber nicht dauernd gleich laut. ## Detail-Brainstorming S01 Status: Arbeitsentwurf fuer David. Nach Review vom 2026-07-06 wurde die Interaktionslogik nachgezogen; finale Subframe-Freigabe bleibt offen. Ziel dieses Blocks: Den riesigen Builder-Umfang so aufteilen, dass David daraus einen echten Subframe-Frame bauen kann, ohne dass wichtige Produktentscheidungen im Kopf bleiben. ### Layout-Optionen | Option | Aufbau | Vorteil | Risiko | Empfehlung | |---|---|---|---|---| | D | Feste Builder-Shell: links Palette, Mitte Canvas, rechts Inspector; oben Header; sekundaere Modi als Tabs/Drawer. | Fuehlt sich wie ein echter Builder an, alle Kernaktionen sind nah beieinander. | Dichte hoch; braucht gute visuelle Hierarchie. | Empfohlen fuer den Advanced Builder. | | B | Getrennte Seiten/Tabs: Felder, Logic, Actions, Sharing, Settings, Preview. | Ruhiger je Bereich. | Zerlegt den Canvas, mehr Navigationslast, weniger Bespoke-Gefuehl. | Nicht fuer v1-Hauptscreen. | | C | Canvas + alles andere in Modals. | Hauptscreen wirkt leerer. | Viele Modal-Wechsel, Mapping und Preview werden unhandlich. | Nur fuer Confirm-/Blocker-Dialoge. | Arbeitsentscheidung: S01 soll als **Builder-Shell** gedacht werden, nicht als Settings-Seite. Der primaere Arbeitszustand zeigt Palette, Canvas und Inspector gleichzeitig. Logic, Actions, Sharing, Preview und Settings sind Modi am selben Datensatz. ### Empfohlene Bildschirmaufteilung | Zone | Inhalt | Verhalten | |---|---|---| | Topbar | Breadcrumb, Form-Name, Status, Save, Preview, Publish, Share, More. | Bleibt dauerhaft sichtbar. | | Linke Palette | Feldtypen, Such-/Filtermöglichkeit, Templates/Abschnitte falls erlaubt. | Schmal, scanbar, Drag oder Klick fuegt Feld hinzu. | | Canvas-Mitte | Feldliste, Dropzonen, Feldkarten, Empty State, Fehleranker. | Hauptarbeitsflaeche; Auswahl steuert rechten Inspector. | | Rechter Inspector | Eigenschaften des ausgewaehlten Felds oder Form-/Modus-Einstellungen. | Kontextsensitiv, kein leerer rechter Bereich. | | Modus-Leiste | Builder, Logic, Actions, Sharing, Preview, Settings. | Als Tabs/Segment im Arbeitsbereich oder rechts oben; keine neuen Routen. | | Bottom/Status-Hinweis | Unsaved Changes, letzte Speicherung, Publish-Blocker kurz. | Dezent, damit es nicht mit Canvas konkurriert. | ### Modus-Matrix | Modus | Hauptfrage | Was David zeigen sollte | Eigener Screen? | |---|---|---|---| | Builder | Welche Felder hat das Formular und wie sind sie konfiguriert? | Palette, Canvas, Inspector. | nein, Kern von S01 | | Logic | Wann werden Felder angezeigt oder verborgen? | Regel-Liste, Regel-Editor, kaputte Referenzen, Test-Hinweise. | nein | | Actions | Was passiert nach Submit? | Action-Liste, Mapping, Test/Preview, Warnungen. | nein | | Sharing | Wie wird das Formular verteilt? | Public URL, QR, iFrame, Copy-Aktionen, Publish-Hinweis. | nein | | Preview | Wie sieht das Public Form aus? | Public-nahe Vorschau, Desktop/Mobile-Umschalter, Logic live. | nein, aber im S01 klar sichtbar | | Settings | Welche Form-Stammdaten steuern die Public-Version? | Slug, Beschreibung, Success, Redirect, Close/Limit, Branding. | nein | Empfehlung: Builder bleibt Default. Preview darf prominent sein, aber nicht die Feldbearbeitung verdraengen. ## Detail: Interaktionslogik / Was passiert nach Klick? Diese Nacharbeit beantwortet Davids Review-Hinweis vom 2026-07-06. S01 muss nicht jede kleine UI-Ebene als eigenen Screen bauen, aber die wichtigsten Klicks brauchen eine klare Entscheidung: inline, Inspector, Menue, Panel/Drawer, Popover oder Confirm-Dialog. ### Grundprinzipien | UI-Form | Wann verwenden? | Regel fuer S01 | |---|---|---| | Inline / Canvas | Schnelle direkte Manipulation am Feld. | Auswahl, Drag, Pflicht-Quicktoggle, Fehleranker bleiben im Canvas. | | Rechter Inspector | Alles, was ein Feld oder ein gewaehltes Objekt dauerhaft konfiguriert. | Feld bearbeiten passiert hier, nicht im Modal. | | 3-Punkte-Menue | Sekundaere Aktionen auf Feld-/Action-/Regel-Karten. | Duplizieren, Loeschen, Deaktivieren, Drchivieren-Einstiege. | | Panel / Drawer im S01 | Komplexere Konfiguration mit mehreren Feldern. | Logic-Regel, Action-Detail, Sharing, Settings bleiben im selben Screen. | | Popover | Kurze Auswahl oder kurzer Statuscheck. | Action-Typ waehlen, Publish-Kurzcheck, Copy/Share-Hilfe. | | Confirm-Dialog | Destruktive oder public-wirksame Aktionen. | Loeschen mit Abhaengigkeiten, Unpublish, Archive, ungespeichert verlassen. | | Toast | Ergebnisfeedback ohne Entscheidung. | Gespeichert, kopiert, veroeffentlicht, dupliziert. | Arbeitsentscheidung: Routinearbeit bleibt im Builder. Modals sind nur fuer echte Risiko-Momente erlaubt. ### Klick-Matrix | Aktion | Einstieg | Was passiert nach Klick? | UI-Form | Eigener Subframe-Frame? | |---|---|---|---|---| | Feld per Palette anklicken | Linke Palette | Feld wird am Ende eingefuegt, markiert und im Inspector geoeffnet. | Inline + Inspector | nein | | Feld per Drag hinzufuegen | Linke Palette -> Canvas | Dropzonen erscheinen, Feld landet an Position, danach selected. | Canvas-Zustand | nein | | Feld auswaehlen | Feldkarte | Fokusrahmen auf Karte, rechter Inspector zeigt Basisdaten. | Inline + Inspector | nein | | Feld bearbeiten | Inspector | Label, Key, Pflichtfeld, Optionen, Validation usw. werden rechts bearbeitet. | Inspector | nein | | Pflichtfeld schnell setzen | Feldkarte oder Inspector | Toggle aendert Pflichtstatus, Dirty State wird gesetzt. | Inline | nein | | Feld duplizieren | Feldkarte-Aktion oder 3-Punkte-Menue | Kopie entsteht unter Original, neuer `field_key` wird vorgeschlagen, Kopie ist selected. | Menue + Toast | nein | | Feld loeschen ohne Abhaengigkeit | 3-Punkte-Menue oder Gefahrenzone | Kurzer Confirm ist optional; danach Feld entfernen und Toast zeigen. | Menue/Confirm klein | nur dokumentieren | | Feld loeschen mit Logic/Action-Bezug | 3-Punkte-Menue oder Gefahrenzone | Confirm zeigt betroffene Regeln/Actions; nach Loeschen werden Referenzen markiert oder geloescht. | Confirm-Dialog | nur dokumentieren | | Feld verschieben | Drag Handle | Reihenfolge aendert sich, Dropziel sichtbar, Dirty State. | Canvas-Zustand | nein | | Feld einklappen | Feldkarte | Karte wird kompakt, bleibt in Reihenfolge sichtbar. | Inline | nein | | Fehler anklicken | Summary oder Feldkarte | Scroll/Focus zum betroffenen Feld und passenden Inspector-Abschnitt. | Inline Navigation | nein | | Logic-Modus oeffnen | Modus-Leiste | Canvas bleibt Kontext, Logic-Liste/Editor wird als Arbeitsbereich sichtbar. | Panel im S01 | nein | | Logic-Regel anlegen | Button im Logic-Modus | Neue Regel startet als Detailbereich im Panel; kein Modal. | Panel/Drawer | nur dokumentieren | | Logic-Regel bearbeiten | Regelkarte | Detailbereich oeffnet/rechts aktualisiert sich. | Panel/Inspector | nein | | Logic-Regel deaktivieren | Toggle auf Regelkarte | Regel bleibt sichtbar, wirkt aber nicht; kein Confirm. | Inline | nein | | Logic-Regel loeschen | 3-Punkte-Menue | Bei aktiver/published Form Confirm, sonst kleine Menue-Aktion mit Undo/Toast. | Menue + Confirm nach Risiko | nur dokumentieren | | Actions-Modus oeffnen | Modus-Leiste | Action-Liste und Detailbereich erscheinen im selben Builder. | Panel im S01 | nein | | Post-Submit-Action hinzufuegen | Button im Actions-Modus | Typ-Auswahl oeffnet als kleines Auswahlpanel/Popover, danach Detailkonfiguration. | Popover + Panel/Drawer | nur dokumentieren | | Action bearbeiten | Actionkarte | Detailpanel zeigt Ziel, Mapping, Test und Warnungen. | Panel/Drawer | nein | | Field-Mapping setzen | Action-Detail | Mapping-Zeilen werden inline bearbeitet. | Inline im Panel | nein | | Action testen | Action-Detail | Ergebnis erscheint inline im Action-Detail, zusaetzlich Toast bei Erfolg. | Inline + Toast | nein | | Action deaktivieren | Toggle auf Actionkarte | Action bleibt sichtbar, wird beim Submit nicht ausgefuehrt. | Inline | nein | | Action loeschen | 3-Punkte-Menue | Confirm, wenn Action aktiv/published oder Mapping besitzt. | Confirm-Dialog | nur dokumentieren | | Sharing oeffnen | Header-Share oder Modus-Leiste | Sharing-Panel mit URL, QR, iFrame wird sichtbar. | Panel im S01 | nein | | Public URL kopieren | Sharing-Panel | Copy-Aktion, danach Toast. | Button + Toast | nein | | QR/iFrame kopieren | Sharing-Panel | Copy/Download, danach Toast; kein Modal. | Button + Toast | nein | | Sharing im Draft | Sharing-Panel | URL/QR/iFrame ausgegraut, Publish-Hinweis und Sprung zu Publish/Settings. | Inline Hinweis | nein | | Preview oeffnen | Header oder Modus-Leiste | Builder wechselt in Public-nahe Vorschau mit Desktop/Mobile-Umschalter. | Modus im S01 | nein | | Settings oeffnen | Modus-Leiste | Slug, Success, Redirect, Branding und Public-Settings erscheinen im Panel/Inspector. | Panel im S01 | nein | | Publish klicken | Header | Publish-Check laeuft inline; bei Blockern Summary mit Sprungzielen. | Inline Check / Popover | nur dokumentieren | | Publish erfolgreich | Header | Status wechselt zu Published, Public URL aktiv, Toast. | Statuswechsel + Toast | nein | | Publish mit Warnungen | Header | Nicht-blockierende Warnungen erscheinen vor Bestaetigung. | Popover/Inline Summary | nur dokumentieren | | Unpublish klicken | Header/More | Confirm erklaert, dass Public-Link nicht mehr erreichbar ist. | Confirm-Dialog | nur dokumentieren | | Archive klicken | More-Menue | Confirm, weil Bearbeitung/Public-Kontext endet. | Confirm-Dialog | nur dokumentieren | | Weg navigieren mit Dirty State | Zurueck/Breadcrumb/Routewechsel | Warnung vor ungespeicherten Aenderungen. | Confirm-Dialog | nur dokumentieren | ### Zusaetzliche dokumentierte Zustaende nach Review Diese Zustaende muessen bewusst beschrieben werden. D07, D08 und D09 sind nach aktueller Empfehlung zusaetzliche Subframe-Zustaende; die restlichen bleiben dokumentiert. | ID | Zustand / Ebene | UI-Form | Empfehlung | |---|---|---|---| | D01 | [[D01 Sharing Panel URL QR iFrame]] | Panel im S01 | In S01 integrieren, kein eigener Screen. | | D02 | [[D02 Post-Submit Actions]] | Panel im S01 | In S01 integrieren, kein eigener Screen. | | D03 | [[D03 Conditional Logic Editor]] | Panel im S01 | In S01 integrieren, kein eigener Screen. | | D06 | [[D06 Feldkarten Menue]] | 3-Punkte-Menue | In S01 dokumentieren, kein eigener Screen. | | M01 | [[M01 Feld loeschen Confirm]] | Kleiner Confirm-Dialog | Nur als Zustand dokumentieren; extra Frame nur wenn David ihn sehen will. | | D07 | [[91 D07 Logic Regel Detail|D07 Logic Regel Detail]] | Panel/Drawer im S01 | Als zusaetzlichen Subframe-Zustand bauen, damit Logic visuell pruefbar ist. | | D08 | [[92 D08 Action Detail mit Mapping|D08 Action Detail mit Mapping]] | Panel/Drawer im S01 | Als zusaetzlichen Subframe-Zustand bauen, weil Mapping komplex ist. | | D09 | [[93 D09 Publish Blocker Summary|D09 Publish Blocker Summary]] | Inline Banner/Popover | Als zusaetzlichen Subframe-Zustand bauen, weil Publish kritisch ist. | | M02 | [[M02 Unpublish Confirm]] | Confirm-Dialog | Nur dokumentieren, weil public-wirksam. | | M03 | [[M03 Archive Confirm]] | Confirm-Dialog | Nur dokumentieren, nicht Hauptscreen. | | M04 | [[M04 Unsaved Changes Confirm]] | Confirm-Dialog | Standardzustand, nur dokumentieren. | | D10 | [[D10 Builder Interaktionsfaelle]] | Case-Matrix | Auswahlfolgen, vergessene Pflichtteile, Dropdowns, Popovers und Folgefehler dokumentieren. | ### Antworten auf Davids Beispiel-Fragen | Frage | Antwort fuer D-FORM | |---|---| | Feld bearbeiten: inline im rechten Inspector oder eigenes Modal? | Rechter Inspector. Kein Modal fuer normale Feldbearbeitung. | | Feld loeschen/duplizieren: Feldkarte, 3-Punkte-Menue oder Confirm? | Duplizieren ueber Feldkarte/3-Punkte-Menue ohne Confirm. Loeschen ueber 3-Punkte-Menue oder Gefahrenzone; Confirm bei Abhaengigkeiten oder published Risiko. | | Logic-Regel anlegen: gleiches Panel, Drawer oder Modal? | Gleiches Logic-Panel bzw. rechter Detailbereich im S01. Kein Modal. | | Post-Submit-Action hinzufuegen: Inline, Drawer oder Modal? | Typauswahl als kleines Auswahlpanel/Popover; Konfiguration im Action-Detail-Panel/Drawer. | | Sharing oeffnen: Tab/Panel, Popover oder Modal? | Panel/Modus im S01. Copy-Aktionen nur mit Toast. | | Publish/Unpublish: Inline-Check, Popover oder Confirm? | Publish als Inline-Check mit Summary/Popover; Unpublish als Confirm-Dialog. | ### Was-passiert-wenn-Faelle Die Detailfaelle fuer Auswahlfolgen, vergessene Zwischenschritte, Checkboxen, Dropdowns, Bild/Datei-Folgen, Modaltexte und Publish-Blocker liegen in [[D10 Builder Interaktionsfaelle]]. Merksatz fuer den Advanced Builder: Jede Auswahl, die Folgefelder veraendert, muss sichtbar machen, was danach wichtig wird. Wenn Nutzer einen mittleren Pflichtschritt vergessen, bleibt der Fehler lokal sichtbar und wird beim Publish/Test mit konkretem Sprungziel aufgegriffen. ## Detail: Header / Statusbar | Element | Zustand / Inhalt | Aktion / Ergebnis | |---|---|---| | Breadcrumb | Formulare > Formularname | Zur Forms-Liste zurueck, aber Forms-Liste ist nicht Teil von D-FORM. | | Form-Name inline | Name, Dirty Marker, ggf. fehlender Name | Klick/Enter bearbeitet Name; leerer Name blockiert Publish. | | Status-Badge | Draft, Published, Archived, Unpublished changes, Error | Erklaert, ob Public-Link aktiv ist. | | Autosave/Save | Ungespeichert, Speichert, Gespeichert, Fehler | Speichert Form-Stammdaten, Felder, Logic, Actions. | | Preview | Desktop/Mobile/Public-nahe Vorschau | Oeffnet Preview-Modus im selben Builder. | | Publish | Draft -> Published | Startet Publish-Check; bei Blockern kein Publish. | | Unpublish | Published -> Draft/private | Zeigt Warnung, weil Public-Link danach nicht mehr nutzbar ist. | | Share | URL/QR/iFrame | Oeffnet Sharing-Modus; bei Draft mit Hinweis. | | More-Menue | Duplizieren, Drchivieren, ggf. Vorlage erstellen | Keine destruktive Aktion ohne Confirm. | ### Header-Zustaende | Zustand | UI-Hinweis | Naechste Aktion | |---|---|---| | Entwurf ohne Fehler | Draft-Badge, Save aktiv wenn dirty | Weiter bearbeiten oder publishen. | | Entwurf mit Blockern | Validation-Summary sichtbar | Fehler anklicken und beheben. | | Published ohne Aenderungen | Published-Badge, Public-Link aktiv | Teilen oder unpublishen. | | Published mit ungespeicherten Aenderungen | Hinweis "Aenderungen noch nicht veroeffentlicht" | Speichern/Publish-Update pruefen. | | Archived | Bearbeitung eingeschraenkt oder read-only | Duplizieren oder zur Liste zurueck. | | Save fehlgeschlagen | Banner/Inline in Headernaehe | Erneut speichern. | ## Detail: Feld-Palette Die Palette soll nicht wie eine lange Komponentenliste wirken, sondern wie ein schneller Baukasten. | Gruppe | Feldtypen | Notiz | |---|---|---| | Text & Kontakt | Text, Textarea, Email, Telefon | Die haeufigsten Felder oben. | | Zahlen & Datum | Zahl, Waehrung, Datum, Datum-Range | Mit kurzem Format-Hinweis. | | Auswahl | Select, Multi-Select, Boolean | Radio/Checkbox-Liste sind Darstellungsvarianten, keine extra Feldtypen. | | Upload | Datei | Foto ist mobile Upload-Variante. | ### Palette-Aktionen | Aktion | Ergebnis | |---|---| | Feld anklicken | Feld wird am Ende des Canvas eingefuegt und direkt ausgewaehlt. | | Feld ziehen | Dropzone im Canvas erscheint; Feld wird an Position eingefuegt. | | Feld suchen | Palette filtert nach Feldtyp/Use Case. | | Feld disabled | Tooltip erklaert, warum Feldtyp nicht verfuegbar ist. | ### Palette-Abgrenzung | Element | In Palette? | Begruendung | |---|---|---| | mCaptcha/Honeypot | nein | Systemschutz, kein normales Formularfeld. | | Signature | nein fuer v1 | Signatur-Kontext bleibt separat/offen. | | Address | nein fuer v1 | Haengt an Maps/Autocomplete, v2 oder Spezialbaustein. | | Section Header / Description | offen | Kann nuetzlich sein, ist aber kein A4-12-Feldtyp. Als "Content Block" spaeter pruefen. | | Hidden Field | nein fuer v1 | Personalisierte Links/URL-Parameter sind v2. | ## Detail: Canvas Der Canvas ist keine freie Zeichenflaeche, sondern eine sortierbare Formularstruktur. | Canvas-Element | Zweck | |---|---| | Formular-Intro | Titel/Beschreibung aus Stammdaten als Kontext, nicht voll editieren im Canvas. | | Feldkarte | Label, Typ, Pflichtmarker, kurzer Helptext, Fehlerstatus, Aktionen. | | Dropzone zwischen Feldern | Zeigt, wo ein neues/gezogenes Feld landet. | | Ausgewaehltes Feld | Sichtbarer Fokusrahmen; Inspector zeigt Details. | | Inline-Fehler | Direkt an Feldkarte, wenn Label/Optionen/Validation fehlen. | | Canvas-Summary | Oben im Canvas: Anzahl Felder, sichtbare Fehler, Logic-Warnungen. | ### Canvas-Aktionen | Aktion | Erwartetes Verhalten | |---|---| | Feld auswahlen | Rechts oeffnet Field Inspector. | | Feld verschieben | Reihenfolge aendert sich; Dirty State wird gesetzt. | | Feld duplizieren | Kopie unter Original; neuer field_key wird vorgeschlagen. | | Feld loeschen | Confirm, wenn Feld in Logic oder Actions verwendet wird. | | Feld einklappen/ausklappen | Lange Formulare bleiben scanbar. | | Feld als Pflicht markieren | Schnellaktion oder Inspector-Setting. | | Fehler anklicken | Springt zum betroffenen Feld/Inspector-Abschnitt. | ### Canvas-Zustaende | Zustand | Darstellung | Umsetzung | |---|---|---| | Empty | Grosse Dropzone mit CTA "Feld hinzufuegen"; Beispiel-Felder optional. | Bauen in S01 | | Dragging | Dropzones sichtbar, Zielposition klar. | In S01 beschreiben | | Feld selected | Fokusrahmen + Inspector offen. | Bauen | | Feld invalid | Feldkarte mit Warnung und Summary oben. | Bauen/dokumentieren | | Lange Liste | Sticky Header, Feldkarten kompakt, ggf. Mini-Navigation. | Beschreiben | | Referenzbruch | Feldkarte zeigt "Wird in Logic/Action verwendet". | Wichtig fuer Delete/Publish | ## Detail: Feld-Inspector Der Inspector ist der eigentliche Produktivbereich fuer Felddetails. Er braucht klare Sektionen, sonst wird der Builder unlesbar. | Inspector-Sektion | Inhalt | Sichtbarkeit | |---|---|---| | Basis | Label, field_key, Beschreibung, Placeholder, Pflichtfeld. | immer | | Darstellung | Breite/Variante, Helptext-Position, Auswahl-Darstellung. | je Feldtyp | | Optionen | Select/Multi-Select-Optionen, Reihenfolge, Default. | Auswahlfelder | | Validation | Min/max, Regex, Datei-Typ/Groesse, Custom Error. | je Feldtyp | | Default | Vorbefuellung, sofern erlaubt. | optional | | Logic-Hinweis | Welche Regeln dieses Feld nutzen. | wenn betroffen | | Mapping-Hinweis | Welche Actions dieses Feld verwenden. | wenn betroffen | | Gefahrenzone | Feld loeschen. | unten, klar getrennt | ### Field-Key-Regel `field_key` soll sichtbar, aber nicht lauter als Label sein. Empfehlung: - Automatisch aus Label erzeugen. - Editierbar in Advanced/Basisdetails. - Warnung, wenn doppelt oder ungueltig. - Beim Umbenennen zeigen, ob Actions/Logic betroffen sind. ## Detail: Feldtypen und Inspector-Properties | Feldtyp | Basis-Properties | Spezielle Properties | Validation | |---|---|---|---| | Text | Label, Key, Helptext, Placeholder, Pflicht | Einzeilig, Default | min/max Laenge, Regex, Custom Error | | Textarea | Label, Key, Helptext, Placeholder, Pflicht | Zeilenhoehe, Markdown-Anmutung optional | min/max Laenge, Custom Error | | Zahl | Label, Key, Helptext, Placeholder, Pflicht | Ganzzahl/Dezimal, Schrittweite | min/max Wert, Custom Error | | Waehrung | Label, Key, Helptext, Pflicht | Waehrung, Dezimalstellen, Format | min/max Betrag | | Datum | Label, Key, Helptext, Pflicht | Datum, optional Zeit als v2/Variante | min/max Datum | | Datum-Range | Label, Key, Helptext, Pflicht | Start-/End-Label, Zeitraum | Ende nach Start, min/max Datum | | Select | Label, Key, Helptext, Pflicht | Optionen, Default, Darstellung Dropdown/Radio | mind. 1 Option, keine leeren Optionen | | Multi-Select | Label, Key, Helptext, Pflicht | Optionen, max. Auswahl, Chips/Checkboxen | min/max Auswahl | | Boolean | Label, Key, Helptext | Checkbox/Toggle, Zustimmungstext | Muss true sein optional | | Email | Label, Key, Helptext, Placeholder, Pflicht | Formatvalidierung, ggf. Submitter-Email markieren | Email-Format | | Telefon | Label, Key, Helptext, Placeholder, Pflicht | Land/Format-Hinweis | Telefonformat | | Datei | Label, Key, Helptext, Pflicht | Erlaubte Dateitypen, max. Groesse, mehrere Dateien, Foto-Hinweis | Datei-Typ, Groesse | ### Feldtypen-Entscheidungen offen fuer David | Frage | Empfehlung | |---|---| | URL als eigener Feldtyp? | Nicht in A4-12, fuer v1 als Text mit URL-Validation oder spaeterer Spezialtyp. | | Foto als eigener Feldtyp? | Nein, als Datei-Upload-Variante mit Mobile-Kamera-Hinweis. | | Signature als Feldtyp? | Nicht in D-FORM v1, weil Signatur-Wizard/Abnahme eigener Kontext ist. | | Section Header/Description Block? | Als optionaler Content Block pruefen, aber nicht als Pflichtbestandteil der 12 Feldtypen. | | Hidden Field? | Raus fuer v1, weil personalisierte Links/URL-Parameter v2 sind. | ### Feld-Interaktionsfaelle Siehe [[D10 Builder Interaktionsfaelle]] fuer: - Select-Feld ohne Optionen. - Datei/Fotofeld mit Upload-, Kamera-, Groessen- und Typ-Hinweisen. - Field Key wird geaendert und betrifft Logic/Actions. - Option wird geloescht, obwohl sie in Logic genutzt wird. - Feldtyp wird nachtraeglich geaendert. ## Detail: Validation Validation muss zwei Ebenen haben: Feldvalidierung beim Bearbeiten und Publish-Validierung fuer das gesamte Formular. | Ebene | Beispiele | UI-Form | |---|---|---| | Feld-Validation | Label fehlt, Option leer, min > max, Datei ohne erlaubte Typen. | Inline am Feld + Inspector. | | Form-Validation | Kein sichtbares Feld, Slug fehlt, Slug-Konflikt, kaputte Logic. | Summary-Banner + klickbare Liste. | | Action-Validation | Pflichtmapping fehlt, Webhook-URL ungueltig, Empfaenger fehlt. | Im Actions-Modus + Publish-Summary. | | Sharing-Validation | Draft nicht public, iFrame ohne Publish, Allowed-Origin-Warnung. | Im Sharing-Modus. | ### Publish-Blocker | Blocker | Warum blockiert? | Wo zeigen? | |---|---|---| | Formularname fehlt | Public/Intern nicht identifizierbar. | Header + Summary | | Slug fehlt oder Konflikt | Public URL kann nicht erzeugt werden. | Settings + Summary | | Kein sichtbares Feld | Public Form waere leer. | Canvas Empty + Summary | | Feld ohne Label | Public Form waere unklar. | Feldkarte + Inspector | | Select ohne Optionen | Submitter kann nicht antworten. | Feldkarte + Inspector | | Datum-Range ungueltig | Regel ist widerspruechlich. | Inspector | | Kaputte Logic-Referenz | Public-Anzeige nicht verlaesslich. | Logic-Modus + Summary | | Pflichtmapping fehlt | Action wuerde fehlschlagen. | Actions-Modus + Summary | ### Nicht blockierend, aber warnen | Warnung | Grund | |---|---| | Required Email ohne Submitter-Email-Markierung | Kann fuer Auto-Match/Antwortmail relevant sein. | | Datei-Upload ohne Typbeschraenkung | Risiko fuer Public Form. | | Sehr langes Formular | Public-Conversion/Mobile leidet. | | Published Form wird stark geaendert | Bestehender Public-Link bleibt aktiv, Aenderung ist relevant. | ## Detail: Conditional Logic V1 soll einfach bleiben: Anzeige/Ausblenden, keine komplexe Verzweigungsmaschine. | Element | Inhalt | |---|---| | Regelname optional | z. B. "Zeige Upload bei Foto vorhanden". | | Wenn-Feld | Nur vorhandene Felder, die als Bedingung sinnvoll sind. | | Operator | ist, ist nicht, enthaelt, enthaelt nicht, ist leer, ist nicht leer. | | Wert | Abhaengig vom Feldtyp, z. B. Option bei Select. | | Dann-Aktion | Feld anzeigen oder Feld verstecken. | | Ziel-Feld | Das Feld, dessen Sichtbarkeit gesteuert wird. | | Aktiv/Inaktiv | Regel testen oder parken. | ### Logic-Regeln | Fall | UI-Verhalten | |---|---| | Bedingungsfeld geloescht | Regel wird rot markiert und blockiert Publish. | | Ziel-Feld geloescht | Regel wird rot markiert und blockiert Publish. | | Ziel-Feld required aber versteckt | Hinweis: Pflicht gilt nur wenn sichtbar. | | Mehrere Regeln fuer ein Feld | Hinweis auf Kombinationslogik; v1 braucht einfache Erklaerung. | | Regel testen | Preview zeigt, welche Felder live erscheinen/verschwinden. | Nicht v1: Multi-Step-Flow, Repeater, Cross-Field-Rechnung, If/Else-Baum, Scoring, A/B-Testing. ## Detail: Publish / Unpublish | Aktion | Ablauf | |---|---| | Publish | Nutzer klickt Publish, System prueft Blocker, bei Erfolg Status Published und Public URL aktiv. | | Publish mit Blockern | Kein Publish; Summary zeigt Fehler mit Sprungziel. | | Update published Form | Hinweis, dass Aenderungen die public Version betreffen; Save/Publish-Update klar trennen falls noetig. | | Unpublish | Confirm mit Hinweis, dass Public URL nicht mehr erreichbar ist. | | Archive | More-Menue, Confirm; nicht als Hauptaktion. | Empfehlung: Publish ist kein eigener Screen. Ein Confirm/Popover reicht, solange Blocker klar im Builder sichtbar sind. ## Detail: Sharing Sharing ist v1, aber nur fuer einfache Verteilung. | Bereich | Inhalt | Aktion | |---|---|---| | Public URL | `app.hivegrid.de/f/{tenant}/{slug}` | Kopieren, oeffnen. | | QR-Code | QR fuer Public URL | Kopieren/downloaden. | | iFrame | Embed-Code mit Breite/Hoehe/Auto-Resize-Hinweis | Code kopieren. | | Publish-Hinweis | Draft/Unpublished zeigt Warnung | Zum Publish springen. | | v2-Abgrenzung | Personalisierte Links, JS-Snippet | Nicht als aktiver UI-Teil. | ### Sharing-Zustaende | Zustand | Darstellung | |---|---| | Draft | URL-Vorschau ausgegraut, Hinweis "erst nach Publish erreichbar". | | Published | URL, QR, iFrame aktiv. | | Slug fehlt | Sharing blockiert und verweist auf Settings. | | Public geschlossen/Limit erreicht | Hinweis, dass Link zwar existiert, Public Form aber blockieren kann. | ## Detail: Post-Submit-Actions Actions sind sichtbar, aber S01 darf nicht wie ein voller Automation-Editor werden. | Action-Typ | Zweck in S01 | Konfiguration | |---|---|---| | Email an Submitter | Bestaetigung senden. | Empfaengerfeld, Betreff, Nachricht/Template. | | Email an Team | Intern informieren. | Empfaenger, Betreff, Felder-Auswahl. | | Lead erstellen | Submission in Lead-Inbox geben. | Mapping: Name, Email, Telefon, Nachricht, Quelle. | | Kontakt erstellen | CRM-Kontakt anlegen. | Mapping, Duplikat-/Auto-Match-Hinweis. | | Projekt erstellen | Projekt/Auftrag anlegen. | Pipeline/Status, Pflichtmapping, Verantwortlicher. | | Task erstellen | Aufgabe erzeugen. | Titel, Beschreibung, Faelligkeit, Assignee. | | Auto-Match | Bestehende Entitaet per Email/Telefon verknuepfen. | Match-Felder, Fallback. | | Webhook | Externes System informieren. | URL, Methode falls noetig, Test. | | Automation-Trigger | M17 Automation starten. | Automation-Auswahl/Trigger. | | KWP Push | Laut M05 vorhanden, aber KWP v1 raus. | Nicht aktiv in D-FORM v1, hoechstens v2/raus markieren. | ### Action-UI | Element | Zweck | |---|---| | Action-Liste | Reihenfolge, Typ, Status, Warnungen. | | Add Action | Typ-Auswahl mit kurzer Erklaerung. | | Action-Detail | Ziel, Bedingungen, Mapping, Test. | | Field-Mapping-Zeilen | Form-Feld -> Ziel-Feld; Pflichtfelder sichtbar. | | Test/Preview | Zeigt, was bei einer Beispiel-Submission erzeugt wuerde. | | Action aktiv/inaktiv | Action parken ohne Loeschen. | ### Action-Blocker | Blocker | UI | |---|---| | Pflichtmapping fehlt | Warnung an Action + Publish-Summary. | | Ziel-Pipeline fehlt | Inline im Projekt-Action-Detail. | | Email-Empfaenger fehlt | Inline im Email-Action-Detail. | | Webhook-URL ungueltig | Inline + Test disabled. | | Automation nicht aktiv/verfuegbar | Warnung mit Erklaerung. | Nicht in S01 bauen: ActionLog, Re-Run, Fehlerhistorie je Submission. Das gehoert zur Submissions-Ansicht. ## Detail: Permissions / Read-only | Permission / Rolle | Darf sehen | Darf tun | |---|---|---| | `forms.basic` | ggf. Submissions, aber nicht Builder-Fokus. | Kein Builder-Hauptflow. | | `forms.builder` | Builder sehen und bearbeiten. | Felder, Logic, Settings speichern. | | `forms.publisher` | Builder + Sharing. | Publish/Unpublish, Export/Submissions ausserhalb D-FORM. | | `forms.admin` | Alles im Builder. | Actions, Templates, administrative Optionen. | ### Permission-Zustaende in S01 | Zustand | UI | |---|---| | Keine Builder-Rechte | Permission-State statt Builder; CTA "Admin kontaktieren" oder zurueck. | | Read-only wegen fehlender Publish-Rechte | Publish disabled mit Tooltip, Bearbeitung ggf. erlaubt. | | Actions nur Admin | Actions-Modus disabled oder read-only mit Hinweis. | | Archived Form | Bearbeitung eingeschraenkt; Duplizieren als naechste Aktion. | ## Daten - Form-Stammdaten: Name, Beschreibung, Slug, Status, Subtype. - Form-Felder: Reihenfolge, Feldtyp, Label, Beschreibung/Hilfe, Placeholder, Pflichtfeld. - Feldtypen v1: Text, Textarea, Zahl, Waehrung, Datum, Datum-Range, Select, Multi-Select, Boolean, Email, Telefon, Datei. - Feld-Konfiguration: Optionen, Default, Validation, Datei-/Foto-Regeln je Feldtyp. - Conditional Logic: einfache Wenn-Dann-Regeln. - Live-Vorschau: gerenderte Form in Public-nahem Zustand. - Sharing: Public URL, QR-Code, iFrame-Code. - Post-Submit-Actions: Lead/Kontakt/Projekt/Task, Email, Webhook, Automation-Trigger, Auto-Match. - Field-Mapping je Action. - Publish-Status und moegliche Publish-Blocker. ## Header / Statusbar | Element | Zweck | |---|---| | Form-Name inline | schnell umbenennen. | | Status-Badge | Draft, Published, Archived, Fehler. | | Save | Entwurf sichern. | | Preview | Public-nahe Vorschau oeffnen/umschalten. | | Publish/Unpublish | Public-Verfuegbarkeit steuern. | | Share | URL, QR und iFrame erreichbar machen. | | Validation-Summary | zeigt, ob Publish blockiert ist. | ## Aktionen - Feld aus Palette hinzufuegen. - Feld per Drag-and-Drop verschieben. - Feld auswaehlen. - Feld bearbeiten. - Feld duplizieren. - Feld loeschen. - Feld als Pflichtfeld markieren. - Validierung konfigurieren. - Optionen fuer Select/Multi-Select/Radio pflegen. - Conditional-Logic-Regel anlegen, bearbeiten, deaktivieren, loeschen. - Vorschau ansehen. - Form speichern. - Form publishen/unpublishen. - Public URL kopieren. - QR-Code kopieren/downloaden. - iFrame-Code kopieren. - Post-Submit-Action hinzufuegen. - Field-Mapping setzen. - Webhook testen oder validieren. ## Feldtypen v1 | Feldtyp | Was David sichtbar machen sollte | |---|---| | Text | Label, Placeholder, Pflicht, min/max Laenge. | | Textarea | Label, Helptext, Pflicht, min/max Laenge. | | Zahl | Label, min/max, Dezimal/Ganzzahl-Hinweis. | | Waehrung | Betrag, Waehrung/Format, min/max. | | Datum | Date-Picker, Pflicht, min/max Datum optional. | | Datum-Range | Start/Ende, Validierung Ende nach Start. | | Select | Optionen, ein Wert. | | Multi-Select | Optionen, mehrere Werte. | | Boolean | Checkbox/Toggle, Pflicht-/Zustimmungsfall. | | Email | Email-Validation automatisch. | | Telefon | Telefonformat-Hinweis. | | Datei | Upload, erlaubte Typen, max. Groesse; Foto als mobile Upload-Variante. | Anti-Spam-Felder wie Honeypot/mCaptcha sind Systemschutz, nicht Teil der sichtbaren 12-Feld-Palette. ## Logic-Arbeitsbereich | Element | Zweck | |---|---| | Regel-Liste | Alle aktiven Regeln scannen. | | Neue Regel | Wenn Feld Y Operator Wert Z, dann Feld X anzeigen/verstecken. | | Feld-Auswahl | Nur vorhandene Felder; kaputte Referenzen sichtbar markieren. | | Operatoren | v1 simpel: ist, ist nicht, enthaelt, ist leer/nicht leer. | | Ziel-Feld | Welches Feld wird angezeigt oder verborgen. | | Regel aktiv/inaktiv | Regel testen oder parken. | Nicht bauen: komplexe If/Else-Baeume, Multi-Step-Flow, Cross-Field-Rechnung. ## Post-Submit-Actions Schnitt | Bereich | In S01 zeigen? | Notiz | |---|---|---| | Action-Typ waehlen | ja | Lead/Kontakt/Projekt/Task, Email, Webhook, Automation-Trigger, Auto-Match. | | Reihenfolge | ja | Actions laufen in definierter Reihenfolge. | | Aktiv/Inaktiv | ja | Einzelne Actions deaktivierbar. | | Field-Mapping | ja | Form-Feld -> Ziel-Feld, Pflichtwarnungen sichtbar. | | Bedingung pro Action | optional | Nur einfache Filter, kein voller Logic-Builder. | | Test/Preview | ja | Was wuerde erzeugt/gesendet? | | Voller ActionLog/Re-Run | nein | Gehoert zur Submissions-Ansicht, nicht zum Builder-Canvas. | ## Sharing-Arbeitsbereich | Element | Zweck | |---|---| | Public URL | Link kopieren, ggf. oeffnen. | | QR-Code | Fuer Print/Monteure/Kundenkontakt. | | iFrame-Code | Einbettung auf Website. | | Publish-Hinweis | Sharing ist erst sinnvoll, wenn published. | | v2-Hinweis intern | Personalisierte Links und JS-Snippet nicht in v1. | ## Settings-Arbeitsbereich | Element | Zweck | |---|---| | Slug | Public URL steuern. | | Success Message | Text nach Submit. | | Redirect URL | optionales Weiterleitungsziel. | | Tenant Branding / Theme | Logo/Farbe/Fallback, soweit v1 vorgesehen. | | Allowed Origins | falls iFrame/API eingeschraenkt wird. | | Submission Limit / Close Date | optional, falls Dev fuer v1 bestaetigt. | ## Banner / Hinweise - Publish-Blocker-Banner: zeigt konkrete fehlende Punkte, z. B. kein sichtbares Feld, fehlender Slug, ungueltige Logic-Regel. - Unsaved-Changes-Hinweis: wenn Nutzer weg navigiert oder publizieren will. - Reuse-Hinweis optional: Public Renderer wird auch fuer HR/Booking-Intake wiederverwendet, aber nicht als sichtbarer Feature-Text im UI. ## Toasts / Action-Feedback - Gespeichert. - Veroeffentlicht. - Entwurf deaktiviert/unpublished. - Public URL kopiert. - QR-Code kopiert/downloadet. - iFrame-Code kopiert. - Action gespeichert. - Test-Webhook erfolgreich/fehlgeschlagen. ## Meldungsentscheidung | Ereignis | UI-Form | Blockiert? | Umsetzung | Copy/Notiz | |---|---|---|---|---| | Keine Felder im Canvas | Empty State im Canvas | nein | Bauen | Feld aus Palette hinzufuegen. | | Feld ohne Label | Inline am Feld + Summary | ja fuer Publish | Nur dokumentieren | Feld konkret benennen. | | Required Email ohne Email-Validation | Inline-Warnung | nein/Publish-Warnung | Nur dokumentieren | Vorschlag: Email-Validation hinzufuegen. | | Logic-Regel referenziert geloeschtes Feld | Inline im Logic-Panel + Summary | ja fuer Publish | Nur dokumentieren | Regel reparieren oder deaktivieren. | | Ungueltige Webhook-URL | Inline im Action-Panel | ja fuer Action | Nur dokumentieren | URL muss http/https und erreichbar sein. | | Publish erfolgreich | Toast + Statuswechsel | nein | Nur dokumentieren | Veroeffentlicht. | | Kopieren erfolgreich | Toast | nein | Nur dokumentieren | In Zwischenablage kopiert. | ## Zustaende | Zustand | Beschreibung | Umsetzung | |---|---|---| | Leer | Neues Formular ohne Felder; Canvas zeigt Drop-Zone und CTA. | Bauen | | Laden | Form-Definition und Actions werden geladen. | Wiederverwenden | | Fehler | Form kann nicht geladen werden. | Nur dokumentieren | | Keine Berechtigung | Nutzer hat keine `forms.builder`/`forms.publish`-Rechte. | Nur dokumentieren | | Dirty State | Ungespeicherte Aenderungen. | Nur dokumentieren | | Publish blocked | Form hat Fehler, die Public-Version verhindern. | Nur dokumentieren | ## Blockierende Error States | Zustand | Was sieht der Nutzer? | Primaeraktion | Sekundare Aktion | |---|---|---|---| | Publish blockiert | Banner mit Liste der fehlenden Punkte. | Fehler beheben | Als Entwurf speichern | | Keine Berechtigung | Permission-State mit Klartext. | Zurueck zu Formularen | Admin kontaktieren | | Form nicht gefunden | Fehler-State. | Zurueck zu Formularen | - | ## Permissions / Gates - `forms.builder`: Felder und Konfiguration bearbeiten. - `forms.publisher`: Publish/Unpublish und Sharing aktivieren. - `forms.admin`: Actions, Mapping und administrative Optionen. ## Subframe - [Subframe](https://app.subframe.com/f023064a5ca0/design/e5502f88-9858-460e-abae-671f28464270/edit) Layout-Regel: Der Advanced Builder nutzt das vorhandene Subframe `Default Page Layout`. Keine eigene Sidebar nachbauen. ## Notizen Der Builder soll nicht den Automation-Flow-Editor nachbauen. Post-Submit-Actions brauchen nur Reihenfolge, Typ, Ziel und Field-Mapping. Conditional Logic ist v1, aber eng: Wenn Feld Y = Wert Z, dann Feld X anzeigen. Kein Repeater, kein Multi-Step, keine Cross-Field-Validation. Wichtig fuer David: Der Screen ist eine Arbeitsflaeche, kein Marketing-Screen. Dichte ist erlaubt, solange die Hauptarbeit gut scannbar bleibt.