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

37 KiB

kind, project, ticket, package, id, screen, typ, umsetzung, status, route, subframe
kind project ticket package id screen typ umsetzung status route subframe
screen HiveGrid Screen Project D-FORM WF-D-FORM Form Builder ADV-S01 Form-Builder Canvas Bespoke Builder Bauen Subframe Draft / Review offen /forms/:id/edit 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
D08 [[92 D08 Action Detail mit Mapping D08 Action Detail mit Mapping]] Panel/Drawer im S01
D09 [[93 D09 Publish Blocker Summary D09 Publish Blocker Summary]] Inline Banner/Popover
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

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.