Add D-FORM form builder handoff

This commit is contained in:
david committed 2026-07-09 21:38:28 +02:00
1 parent 2de481bf25
commit ef07e3d005
49 files changed
+5758 -12

No files matched your search

@@ -0,0 +1,661 @@
---
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.