Add D-FORM form builder handoff
This commit is contained in:
1 parent
2de481bf25
commit
ef07e3d005
49 files changed
+5758
-12
No files matched your search
+661
@@ -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.
|
||||
Reference in new issue
Block a user