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,59 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-FORM
package: WF-D-FORM Form Builder
id: S00
screen: Formulare verwalten
typ: Formular-Zentrale
umsetzung: Bauen
status: Subframe Draft / Review offen
route: /forms
subframe: "https://app.subframe.com/f023064a5ca0/design/2325aa7a-d968-4028-8282-0823b15bf964/edit"
---
# S00 - Formulare verwalten
## Ziel
Grundseite fuer Mitarbeiter, um bestehende Formulare zu finden, zu filtern und zu oeffnen.
Der Screen ist nicht der Builder selbst, sondern die Formular-Zentrale vor dem Bearbeiten.
## Inhalt
- Seitentitel `Formulare`
- Hilfetext: Formulare erstellen, veroeffentlichen und verwalten
- Buttons:
- `Vorlagen`
- `Neues Formular`
- Filter oben als Mehrfachauswahl:
- Status: Erstellt, Veroeffentlicht, Unveroeffentlicht
- Art: Website / Extern, Lead, Umfrage, Intern
- Suche, Statusfilter und Sortierung
- Tabelle mit Formularen:
- Website-Anfrage
- Heizungs-Anfrage
- Kundenzufriedenheit
- Materialbedarf melden
## Verhalten
- Klick auf `Neues Formular` fuehrt zu [[04 S01 Formularart auswaehlen|S01 Formularart auswaehlen]].
- Klick auf `Bearbeiten` oeffnet aktuell [[05 S02 Einfacher Fragen Editor|S02]].
- Die Formularart bestimmt in S02 nur Vorlage, Startfragen und Hinweise. S01B/S01C/S01D/S01E bleiben spaetere Varianten bzw. Referenzseiten.
- Filterchips koennen kombiniert werden, z. B. `Erstellt` + `Unveroeffentlicht` oder `Website / Extern` + `Lead`.
- Als Beispiel sind mehrere Status-Chips aktiv, damit klar ist: Es ist kein einzelner Tab, sondern eine Mehrfachauswahl. Art-Chips stehen daneben als zusaetzliche auswaehlbare Filter bereit.
- Aktionen je Zeile: bearbeiten, Vorschau, Link kopieren, Antworten ansehen, duplizieren, loeschen.
## Subframe
Gebaut in Subframe:
https://app.subframe.com/f023064a5ca0/design/2325aa7a-d968-4028-8282-0823b15bf964/edit
Qualitaetsregel:
- Nutzt das vorhandene `Default Page Layout`.
- Keine eigene Sidebar oder Header-Navigation.
- Liegt im selben Flow neben den D-FORM Builder-Screens.
@@ -0,0 +1,42 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-FORM
package: WF-D-FORM Form Builder
id: E01
screen: S00 Keine Formulare
typ: Empty State
umsetzung: Bauen
status: Subframe Draft / Review offen
route: /forms
subframe: "https://app.subframe.com/f023064a5ca0/design/136c11b3-8310-4165-b4ba-9cf099ee0873/edit"
---
# E01 - S00 Keine Formulare
## Ziel
Leerer Startzustand der Formular-Zentrale.
Der Mitarbeiter hat noch kein Formular erstellt und soll ohne Erklaerballast direkt den naechsten sinnvollen Schritt sehen.
## Inhalt
- Seitentitel wie S00: `Formulare`
- Ruhiger Empty State im Inhaltsbereich
- Hauptaktion: `Neues Formular erstellen`
- Sekundaere Aktion: optional `Vorlagen ansehen`
- Kurzer Hinweis, dass Formulare spaeter veroeffentlicht, bearbeitet und ausgewertet werden koennen
## Verhalten
- Klick auf `Neues Formular erstellen` fuehrt zu [[04 S01 Formularart auswaehlen|S01 Formularart auswaehlen]].
- Keine Kennzahl-Kacheln und keine Beispiel-Tabelle, weil noch nichts existiert.
- Filter/Suche duerfen sichtbar bleiben oder reduziert wirken, aber nicht die Hauptaktion verdraengen.
## Subframe
Gebaut in Subframe:
https://app.subframe.com/f023064a5ca0/design/136c11b3-8310-4165-b4ba-9cf099ee0873/edit
@@ -0,0 +1,41 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-FORM
package: WF-D-FORM Form Builder
id: E02
screen: S00 Keine Treffer
typ: Empty State
umsetzung: Bauen
status: Subframe Draft / Review offen
route: /forms
subframe: "https://app.subframe.com/f023064a5ca0/design/ccf8d2f7-e7b4-4ffd-87f6-1785edc1b2f7/edit"
---
# E02 - S00 Keine Treffer
## Ziel
Zustand, wenn Suche, Statusfilter oder Artfilter keine passenden Formulare finden.
Der Nutzer soll verstehen: Die Formulare sind nicht weg, nur der aktuelle Filter ist zu eng.
## Inhalt
- S00-Grundlayout mit aktiver Suche/aktiven Filtern
- Empty State im Tabellenbereich: `Keine passenden Formulare gefunden`
- Aktion: `Filter zuruecksetzen`
- Optionaler Hinweis auf die aktuelle Kombination, z. B. `Erstellt + Unveroeffentlicht + Lead`
## Verhalten
- `Filter zuruecksetzen` entfernt Suche und Filterchips.
- `Neues Formular` bleibt erreichbar.
- Der Zustand ist kein Fehler, sondern ein Such-/Filterergebnis.
## Subframe
Gebaut in Subframe:
https://app.subframe.com/f023064a5ca0/design/ccf8d2f7-e7b4-4ffd-87f6-1785edc1b2f7/edit
@@ -0,0 +1,85 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-FORM
package: WF-D-FORM Form Builder
id: S01
screen: Formularart auswaehlen
typ: Einstieg / Auswahl
umsetzung: Alternative bauen
status: Subframe Draft / Review offen
route: /forms/new
subframe: "https://app.subframe.com/f023064a5ca0/design/c423ebcd-914f-4038-ab9f-7c2a745a8bec/edit"
---
# S01 - Formularart auswaehlen
## Ziel
Nutzer startet nicht direkt im komplexen Builder, sondern entscheidet zuerst, welche Art Formular er erstellen will.
## Warum wichtig
Handwerker brauchen eine einfache Einstiegsfrage:
`Was moechtest du erstellen?`
Nicht:
`Welche Feldtypen, Actions, Logic und Mappings brauchst du?`
## Aufbau
Interne Seite mit vorhandenem `Default Page Layout`. Keine eigene Sidebar nachbauen.
Inhalt:
- Titel: `Neues Formular erstellen`
- Kurzer Untertitel: `Waehle aus, wofuer das Formular gedacht ist. Du kannst spaeter alles anpassen.`
- Vier Auswahlkarten
- Unten nur `Abbrechen` und `Weiter`
Entscheidung 2026-07-08: Weniger ist hier besser. Keine separate Vorlagenzeile und keine `Auswaehlen`-Buttons in jeder Karte, weil das die gleiche Entscheidung doppelt aufmacht.
## Auswahlkarten
| Karte | Kurzbeschreibung | Danach |
|---|---|---|
| Website / Extern | Kunden fuellen es per Website, Link oder QR-Code aus. | Oeffnet [[05 S02 Einfacher Fragen Editor|S02]] mit Website-/Extern-Vorlage. |
| Lead-Formular | Neue Anfragen landen direkt als Lead in der Pipeline. | Oeffnet [[05 S02 Einfacher Fragen Editor|S02]] mit aktiver Lead-Verknuepfung. |
| Fragebogen / Umfrage | Feedback sammeln und Antworten spaeter auswerten. | Oeffnet [[05 S02 Einfacher Fragen Editor|S02]] mit Umfrage-Startfragen. |
| Internes Formular | Meldungen und Anfragen fuer Mitarbeitende. | Oeffnet [[05 S02 Einfacher Fragen Editor|S02]] mit interner Formularvorlage. |
Arbeitsentscheidung 2026-07-08: S02 ist der Haupt-Editor fuer alle vier Formulararten. S01B/S01C/S01D/S01E bleiben nur spaetere Varianten bzw. Referenzseiten.
## Lead-Formular Verhalten
Wenn `Lead-Formular` gewaehlt wird:
- Startfragen werden vorgeschlagen: Name, Telefon, Email, Bereich, Nachricht, Datei/Bild.
- Nach Submit wird automatisch ein Lead angelegt.
- Nutzer muss kein Mapping bauen.
- Im Editor erscheint nur ein ruhiger Hinweis: `Antworten werden automatisch als Lead gespeichert.`
- Pipeline/Ziel kann spaeter unter `Einstellungen` geaendert werden.
## Was nicht sichtbar sein soll
- Field Key
- Webhook
- Mapping
- Automation-Trigger
- komplexe Logic
- Rechte-/Permission-Begriffe
## Subframe-Hinweis
Gebaut in Subframe:
https://app.subframe.com/f023064a5ca0/design/c423ebcd-914f-4038-ab9f-7c2a745a8bec/edit
Qualitaetsregel:
- Nutzt das vorhandene `Default Page Layout`.
- Keine eigene Sidebar oder Header-Navigation.
- Liegt im selben Flow neben `ADV-S01-2 Form-Builder Canvas 2`.
- Ersetzt nicht S04 Public Form, sondern liegt vor dem Builder.
@@ -0,0 +1,185 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-FORM
package: WF-D-FORM Form Builder
id: S02
screen: Einfacher Fragen Editor
typ: Simple Builder Alternative
umsetzung: Alternative bauen
status: Subframe Draft / Review offen
route: /forms/:id/edit
subframe: "https://app.subframe.com/f023064a5ca0/design/181aaa0f-5ae7-4f74-acf7-8273fbbe4dd5/edit"
---
# S02 - Einfacher Fragen Editor
## Ziel
Google-Forms-artiger Editor fuer Handwerksbetriebe: Formularname oben, darunter einzelne Fragekarten. Nutzer fuegt Fragen hinzu, waehlt einen Fragetyp und veroeffentlicht.
## Leitidee
Der Nutzer soll denken:
`Ich schreibe Fragen auf.`
Nicht:
`Ich konfiguriere ein Datenmodell.`
## Aufbau
Interne Seite mit vorhandenem `Default Page Layout`. Keine eigene Sidebar nachbauen.
Screen-Zonen:
- Kopfzeile: Formularname, Status, Speichern, Vorschau, Veroeffentlichen.
- Schmale Tabs: Fragen, Design, Antworten.
- Mittelspalte: Formular-Titelkarte und Fragekarten.
- Rechte Mini-Werkzeugleiste: Frage hinzufuegen, vorhandene Frage/Block, Text, Bild, Datei/Upload, Medien/Video, Abschnitt und Mehr.
- Keine dauerhafte linke Palette.
- Kein dauerhafter rechter Inspector.
- Bei Lead-Formularen erscheint zusaetzlich eine ruhige Card `Felder zuweisen`, damit sichtbar ist, welche Formularfrage in welches Lead-Feld geschrieben wird.
## Fragekarte
Eine aktive Fragekarte zeigt:
- Fragetitel
- Fragetyp-Dropdown nach Google-Forms-Logik; zeigt immer den aktuell gewaehlten Typ, z. B. `Multiple-Choice-Frage`, nicht den Placeholder `Fragetyp`.
- optional Bild-Button
- mehrere Antwortoptionen als eigene Zeilen/Eingaben
- Button `Option hinzufuegen`
- Button `Sonstiges hinzufuegen`, wenn passend
- Duplizieren
- Loeschen
- Pflichtfrage Toggle
- Drei-Punkte-Menue fuer Beschreibung, Bedingung, Validierung
## Fragetyp-Dropdown
| Gruppe | Typen |
|---|---|
| Text | Kurzantwort, Absatz |
| Auswahl | Multiple-Choice-Frage, Mehrfachauswahl, Drop-down |
| Medien | Datei oder Bild hochladen |
| Datum/Zeit | Datum, Zeit |
Email, Telefon und Name werden im Lead-Formular als vorbereitete Startfragen angezeigt, nicht als laute Profi-Auswahl.
Nicht im aktuellen Hauptdropdown: Lineare Skala, Bewertung, Multiple-Choice-Raster und Kaestchenraster. Diese Typen werden nicht als eigene S02-Zustaende gebaut.
## Multiple Choice Verhalten
Wenn Nutzer `Multiple-Choice-Frage` waehlt:
- Antwortoptionen erscheinen direkt in der Fragekarte.
- Erste Option heisst `Option 1`.
- Nutzer kann weitere Optionen darunter hinzufuegen.
- `Sonstiges hinzufuegen` bleibt als Link sichtbar.
- Pflichtfrage ist ein Toggle unten rechts.
- Publish blockiert, wenn keine Option vorhanden ist.
## Mehrfachauswahl
Wie Multiple Choice, aber mehrere Antworten sind erlaubt.
Copy im Dropdown: `Mehrfachauswahl`, weil das fuer Handwerker verstaendlicher ist.
## Einfache Logic
Logic wird nicht als eigener Profi-Modus gezeigt.
In der Fragekarte gibt es im Drei-Punkte-Menue:
- `Bedingung hinzufuegen`
Danach oeffnet sich ein kleiner Bereich unter der Frage:
`Wenn Antwort ist ... dann Frage anzeigen ...`
Mehr nicht in der Hauptansicht.
## Lead-Formular Hinweis und Felder zuweisen
Wenn Formularart `Lead-Formular` ist:
- Oben unter dem Titel erscheint ein dezenter Hinweis:
`Lead-Verknuepfung`, Badge `Aktiv`, Beschreibung `Neue Antworten werden als Lead gespeichert - Pipeline: Vertrieb SHK`.
- Die Hinweis-Card nutzt dasselbe Layout wie der gruene `Lead anlegen`-Kasten: runder Icon-Hintergrund links, Titel/Beschreibung in der Mitte, Aktionen rechts.
- Rechts stehen `Felder zuweisen` als normale Aktion und `Deaktivieren` als kleine Tertiary-Aktion.
- Klick auf `Felder zuweisen` fuehrt in den Zustand [[05b S02L Lead Felder zuweisen]].
- Wenn Publish wegen fehlender Zuweisung blockiert, fuehrt der Sprung in [[05c E05 S02 Lead Zuweisung pruefen]].
Das ist kein Profi-Mapping-Panel, sondern eine verstaendliche Zuweisung im gleichen Look wie der Editor.
## Lead deaktivieren
Nutzer muessen kein neues Formular erstellen, nur weil die Lead-Erstellung nicht mehr gewuenscht ist.
Entscheidung:
- Die Aktion `Deaktivieren` kann die Lead-Erstellung im bestehenden Formular ausschalten.
- Das Formular bleibt bestehen und sammelt weiter normale Antworten.
- Bereits erzeugte Leads bleiben erhalten.
- Neue Einsendungen erzeugen nach dem Ausschalten keinen neuen Lead mehr.
- Die bisherigen Zuweisungen bleiben gespeichert, damit sie beim erneuten Aktivieren wieder vorgeschlagen werden koennen.
- Wenn das Formular bereits veroeffentlicht ist, sollte beim Ausschalten ein kurzer Confirm-Hinweis erscheinen: `Neue Antworten werden dann nicht mehr als Lead gespeichert. Bereits erzeugte Leads bleiben erhalten.`
- Im Draft ohne bisherige Antworten darf `Deaktivieren` direkt umschalten.
| Lead-Feld | Standard-Zuweisung | Verhalten |
|---|---|---|
| Name | `Ihr Name` | Pflicht, Kurzantwort. |
| Kontakt | `Telefon` oder `Email` | Mindestens eins muss zugewiesen sein. |
| Beschreibung | `Beschreibung Ihres Anliegens` | Pflicht, Absatz oder Kurzantwort. |
| Bereich | `Um welchen Bereich geht es?` | Optional, Dropdown/Multiple Choice passt. |
| Dateien / Bilder | `Fotos hochladen` | Optional, nur Datei/Bild-Felder passen. |
| Quelle | automatisch `Formular` | Nicht als Formularfrage noetig. |
| Pipeline | `Neue Anfragen` | Dropdown-Vorlage nutzen, kein Freitext. |
Jede Zeile nutzt die gleiche Dropdown-Vorlage: links das Lead-Feld, rechts ein Dropdown mit passenden Formularfragen. Nicht passende Formularfragen werden deaktiviert oder mit Hinweis gezeigt, z. B. `Fotos hochladen - passt nicht zu Email`.
Wenn ein Pflichtfeld nicht zuweisbar ist:
- Zeile zeigt Inline-Fehler.
- Banner oben: `2 Zuweisungen pruefen, bevor du veroeffentlichst.`
- Primaeraktion: `Passende Frage hinzufuegen`.
- Publish bleibt blockiert, bis die Pflichtzuweisung passt.
Details dazu liegen in [[05b S02L Lead Felder zuweisen]] und [[05c E05 S02 Lead Zuweisung pruefen]].
## Logic, Actions und Publish-Blocker
S02 ist der Haupt-Editor fuer normale Nutzer. Deshalb werden Logic, Actions und Publish-Blocker nicht als eigene Profi-Seiten in den Hauptfluss gezogen.
| Thema | Entscheidung fuer S02 | Warum |
|---|---|---|
| Logic | Nur als einfache `Bedingung` direkt an der Frage. | Nutzer soll nicht in einen Regel-Editor springen muessen. |
| Actions | `Nach Absenden` bleibt im Screen. Bei Lead-Formularen ist `Lead anlegen` aktiv und zeigt `Felder zuweisen`. | Kein Automation-Editor, aber die wichtigste Lead-Zuordnung ist sichtbar. |
| Publish-Blocker | Einfacher Banner/Popover im selben Screen mit Sprung zur betroffenen Frage. | Verstaendlich genug, kein eigener Screen noetig. |
D07, D08 und D09 bleiben als Advanced-/Referenzseiten fuer spaeter oder fuer David, falls er die Detailtiefe sehen will. Fuer den aktuellen S02-Hauptfluss sind sie nicht notwendig. Die Lead-Zuweisung ist aber nicht mehr nur Hintergrundlogik, sondern ein eigener S02-Zustand.
## Publish
Bei Klick auf `Veroeffentlichen`:
- Wenn alles passt: Toast und Status `Veroeffentlicht`.
- Wenn etwas fehlt: einfacher Banner oben:
`Noch 2 Dinge fehlen, bevor du veroeffentlichen kannst.`
- Sprungziele gehen direkt zur betroffenen Frage.
## Subframe-Hinweis
Gebaut in Subframe:
https://app.subframe.com/f023064a5ca0/design/181aaa0f-5ae7-4f74-acf7-8273fbbe4dd5/edit
Qualitaetsregel:
- Nutzt das vorhandene `Default Page Layout`.
- Keine eigene Sidebar oder Header-Navigation.
- Liegt im selben Flow neben `ADV-S01-2 Form-Builder Canvas 2`.
- Nah an Google Forms, aber mit HiveGrid-Komponenten.
- Lead-Verknuepfung bleibt einfach sichtbar. `Felder zuweisen` wird als einfacher S02-Zustand gezeigt, nicht als Advanced-Mapping.
@@ -0,0 +1,103 @@
---
kind: screen-state
project: HiveGrid Screen Project
ticket: D-FORM
package: WF-D-FORM Form Builder
id: S02L
screen: Lead Felder zuweisen
typ: S02-Zustand / Lead Editor
umsetzung: Subframe Draft
status: Subframe Draft / Review offen
route: /forms/:id/edit
subframe: "https://app.subframe.com/f023064a5ca0/design/c8aa80cb-0cc8-473f-9fac-a09d395e6571/edit"
---
# S02L - Lead Felder zuweisen
## Ziel
Lead-Formulare sollen nicht wie ein versteckter Automation-Editor wirken, aber Nutzer muessen sehen koennen, welche Formularfrage in welches Lead-Feld geschrieben wird.
Dieser Zustand liegt im gleichen Editor-Look wie S02: gleiche Kopfzeile, gleiche Tabs, gleiche Breite, gleiche Card-Sprache.
## Einstieg
S02 oeffnet diesen Zustand, wenn:
- Formularart `Lead-Formular` gewaehlt wurde.
- Nutzer auf `Felder zuweisen` klickt.
- Publish erkennt, dass eine Lead-Zuweisung fehlt.
- Nutzer eine Frage loescht oder den Fragetyp aendert, die bereits zugewiesen war.
## Aufbau
- Header wie S02: Formularname, Status, Speichern, Vorschau, Veroeffentlichen.
- Tabs wie S02: Fragen, Design, Antworten.
- Hinweis-Card: `Lead-Verknuepfung`, Badge `Aktiv`, Beschreibung `Neue Antworten werden als Lead gespeichert - Pipeline: Neue Anfragen`.
- Die Hinweis-Card nutzt dasselbe Layout wie der gruene `Lead anlegen`-Kasten: runder Icon-Hintergrund links, Titel/Beschreibung in der Mitte, kleine Aktion `Deaktivieren` rechts.
- Card `Felder zuweisen`
- Optional kleine Vorschau: `So wird daraus ein Lead`
## Felder-zuweisen-Card
Jede Zeile nutzt dieselbe Dropdown-Vorlage:
| Lead-Feld | Dropdown-Wert | Pflicht | Hinweis |
|---|---|---|---|
| Name | `Ihr Name` | ja | Kurzantwort. |
| Telefon | `Telefonnummer` | ja, wenn keine Email | Kurzantwort mit Telefon-Bedeutung. |
| Email | `Email-Adresse` | ja, wenn kein Telefon | Kurzantwort mit Email-Bedeutung. |
| Beschreibung | `Beschreibung Ihres Anliegens` | ja | Absatz oder Kurzantwort. |
| Bereich | `Um welchen Bereich geht es?` | nein | Auswahlfrage passt gut. |
| Datei / Bild | `Fotos hochladen` | nein | Nur Datei/Bild-Feld. |
| Pipeline | `Neue Anfragen` | ja | Dropdown aus Pipeline-Vorlage, kein Freitext. |
| Lead-Quelle | `Formular` | automatisch | Nicht editierbar im normalen Flow. |
## Dropdown-Regel
Dropdowns zeigen nur sinnvolle Optionen prominent.
Nicht passende Optionen sind entweder:
- gar nicht sichtbar, wenn es dadurch einfacher wird;
- oder disabled sichtbar mit kurzer Begruendung, wenn David den Fehlerfall sichtbar pruefen will.
Beispiele:
| Ziel | Nicht moegliche Option | Warum |
|---|---|---|
| Email | `Fotos hochladen` | Datei kann nicht als Email gespeichert werden. |
| Telefon | `Beschreibung Ihres Anliegens` | Langer Text passt nicht als Telefonnummer. |
| Datei / Bild | `Ihr Name` | Textfeld ist keine Datei. |
| Pipeline | `Um welchen Bereich geht es?` | Pipeline kommt aus Systemvorlage, nicht aus Formularantwort. |
## Aktionen
- `Zuweisung aendern` ueber Dropdown.
- `Passende Frage hinzufuegen` erstellt eine neue Frage und weist sie direkt zu.
- `Automatisch zuweisen` versucht anhand von Name, Email, Telefon, Beschreibung und Datei passende Fragen zu erkennen.
- `Ziel aendern` oeffnet Pipeline-/Team-Dropdown, kein grosses Mapping-Modal.
## Verhalten
- Wenn Nutzer eine zugewiesene Frage loescht, bleibt die Lead-Zeile sichtbar und wechselt auf Fehler.
- Wenn Nutzer den Fragetyp aendert und der Typ nicht mehr passt, wird die Zuweisung geloest oder als `passt nicht mehr` markiert.
- Wenn Telefon und Email beide leer sind, blockiert Publish.
- Wenn nur Telefon oder nur Email vorhanden ist, ist Publish erlaubt.
- Wenn optionale Felder fehlen, Publish nicht blockieren.
## Subframe-Hinweis
Gebaut in Subframe:
https://app.subframe.com/f023064a5ca0/design/c8aa80cb-0cc8-473f-9fac-a09d395e6571/edit
Subframe-Name aktuell: `05b S02L Lead Felder zuweisen`.
Wichtig fuer Subframe:
- Gleiches Page Layout wie S02.
- Gleiche Card-Breite und gleiche Fragekarten-Sprache wie S02.
- Dropdown-Vorlage verwenden, nicht eigene Select-Optik erfinden.
- Keine Tabellenoptik wie Advanced-Mapping.
- Bei der finalen Sichtpruefung in Subframe kontrollieren, ob das vorhandene `Default Page Layout` aktiv ist.
@@ -0,0 +1,93 @@
---
kind: state
project: HiveGrid Screen Project
ticket: D-FORM
package: WF-D-FORM Form Builder
id: E05
screen: S02 Lead Zuweisung pruefen
typ: Lead Mapping Error State
umsetzung: Subframe Draft
status: Subframe Draft / Review offen
route: /forms/:id/edit
subframe: "https://app.subframe.com/f023064a5ca0/design/26600ce4-7baf-4ffb-9955-7c7d1eef99d1/edit"
---
# E05 - S02 Lead Zuweisung pruefen
## Ziel
Wenn eine Lead-Zuweisung nicht moeglich ist, soll der Nutzer direkt verstehen, was nicht passt und wie er es behebt.
Dieser Zustand ist kein Modal und kein eigener Advanced-Editor. Er ist derselbe S02/S02L-Screen mit Fehlerbanner und markierten Zeilen.
## Wann tritt der Zustand auf?
- Pflichtfeld `Name` ist nicht zugewiesen.
- Weder `Telefon` noch `Email` ist zugewiesen.
- `Beschreibung` fehlt.
- Eine zugewiesene Frage wurde geloescht.
- Eine Frage wurde in einen unpassenden Fragetyp geaendert.
- Ein Feld ist technisch nicht kompatibel, z. B. Datei zu Email.
## Aufbau
- Banner oben in S02/S02L:
`3 Zuweisungen pruefen, bevor du veroeffentlichst.`
- Darunter Sprunglinks:
`Name zuweisen`, `Kontakt zuweisen`, `Beschreibung zuweisen`
- In der Card `Felder zuweisen` sind betroffene Zeilen markiert.
- Jede fehlerhafte Zeile hat eine kurze Message.
## Fehlermatrix
| Fall | Message | Aktion |
|---|---|---|
| Name fehlt | `Waehle eine Frage fuer den Lead-Namen aus.` | Dropdown oeffnen oder `Passende Frage hinzufuegen`. |
| Kein Kontaktweg | `Weise Telefon oder Email zu, damit der Lead kontaktierbar ist.` | Telefon-/Email-Zeile fokussieren. |
| Beschreibung fehlt | `Waehle die Frage, die als Lead-Beschreibung gespeichert wird.` | Dropdown oeffnen. |
| Typ passt nicht | `Dieses Formularfeld passt nicht zu diesem Lead-Feld.` | Andere Frage waehlen. |
| Frage geloescht | `Die bisherige Frage existiert nicht mehr.` | Neue Frage waehlen oder erstellen. |
## Nicht moegliche Optionen
Im Dropdown koennen nicht moegliche Optionen disabled erscheinen:
```text
Fotos hochladen
Nicht moeglich fuer Email
```
Oder:
```text
Beschreibung Ihres Anliegens
Nicht moeglich fuer Telefon
```
Wenn zu viele disabled Optionen verwirren, nur passende Optionen anzeigen und darunter den Link `Warum sehe ich nicht alle Fragen?`.
## Publish-Regel
Publish bleibt blockiert, solange:
- Name fehlt.
- Kontaktweg fehlt.
- Beschreibung fehlt.
- eine aktive Pflichtzuweisung ungueltig ist.
Publish darf durchgehen, wenn:
- optionale Lead-Felder fehlen;
- Datei/Bild nicht zugewiesen ist;
- Bereich nicht zugewiesen ist;
- nur ein Kontaktweg vorhanden ist.
## Subframe-Hinweis
Gebaut in Subframe:
https://app.subframe.com/f023064a5ca0/design/26600ce4-7baf-4ffb-9955-7c7d1eef99d1/edit
Subframe-Name aktuell: `05c E05 S02 Lead Zuweisung pruefen`.
Bei der finalen Sichtpruefung in Subframe kontrollieren, ob das vorhandene `Default Page Layout` aktiv ist, damit der Zustand wie S02/S02L im vorhandenen App-Rahmen liegt.
@@ -0,0 +1,59 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-FORM
package: WF-D-FORM Form Builder
id: S03
screen: Formular Design
typ: Builder Tab
umsetzung: Bauen
status: Subframe Draft / Review offen
route: /forms/:id/edit
subframe: "https://app.subframe.com/f023064a5ca0/design/090f06a9-3fa7-4442-b8bc-035e95de7329/edit"
---
# S03 - Formular Design
## Ziel
Design-Tab fuer ein konkretes Formular.
Hier veraendert der Mitarbeiter nicht die Fragen, sondern die Darstellung des oeffentlichen Formulars.
## Inhalt
- Formularname `Website-Anfrage`
- Tabs:
- Fragen
- Design
- Antworten
- Hilfetext: `Logo, Farben und Darstellung des oeffentlichen Formulars anpassen.`
- Einstellungen:
- Logo hochladen
- Akzentfarbe
- Theme / Schrift
- Formularbreite
- Hintergrund
- Button-Text
- Datenschutz-Hinweis
- Live-Vorschau der Kundensicht als Formular-Card
## Verhalten
- Aenderungen sollen sofort in der Live-Vorschau sichtbar werden.
- `Vorschau` oeffnet die Public-Ansicht.
- `Veroeffentlichen` bleibt in der Topbar erreichbar.
- Kein eigener `Teilen`-Tab; Link/QR/Einbettung gehoeren in den Veroeffentlichen-/Public-Link-Kontext.
- Keine Logic- oder Antwortbearbeitung in diesem Tab.
## Subframe
Gebaut in Subframe:
https://app.subframe.com/f023064a5ca0/design/090f06a9-3fa7-4442-b8bc-035e95de7329/edit
Qualitaetsregel:
- Nutzt das vorhandene `Default Page Layout`.
- Keine eigene Sidebar oder Header-Navigation.
- Design ist bewusst einfach gehalten, nicht wie ein Profi-Theme-Editor.
@@ -0,0 +1,268 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-FORM
package: WF-D-FORM Form Builder
id: S04
screen: Oeffentliches Formular
typ: Public Form
umsetzung: Bauen
status: Subframe Draft / Review offen
route: /f/{tenant}/{slug}
subframe: "https://app.subframe.com/f023064a5ca0/design/caef9ddd-03d6-4a26-8dc1-16aa198a7304/edit"
---
# S04 - Oeffentliches Formular
## Ziel
Externe Nutzer reichen ein Formular ohne App-Shell ein. Das Formular wirkt vertrauenswuerdig, klar, mobil nutzbar und tenant-gebrandet.
## Pattern / Archetyp
BESPOKE-Public.
Nutzt A4-Feldtypen als Renderer und A7-Zustaende fuer Public Loading/Error.
## Public-Arbeitsbereiche
Dies ist keine App-Shell. Der Submitter sieht nur das Formular und die noetige Orientierung.
| Bereich | Zweck |
|---|---|
| Branding-Kopf | Tenant-Logo, optional kurzer Dbsendername. |
| Formular-Intro | Titel, Beschreibung, ggf. Vertrauen/Datenschutz-Kurztext. |
| Feldbereich | Gerenderte Felder mit Conditional Logic. |
| Datenschutz / Captcha | Datenschutz-Zustimmung und mCaptcha nahe am Submit, nicht als Fremdkoerper. |
| Submit-Bereich | Button, Pflichtfeldhinweis, allgemeiner Fehler. |
| Footer | minimal: Datenschutz/Anbieter-Link falls vorgesehen. |
Empfehlung: Public Form soll eher wie ein ruhiges Kundenformular wirken, nicht wie eine Mini-Version der HiveGrid-App.
## Detail-Brainstorming S04
Status: Arbeitsentwurf fuer David. Noch nicht final abgehakt.
Das Public Form ist kein internes HiveGrid-UI. Es muss fuer Endkunden, Monteure, Bewerber oder Mitarbeiter funktionieren, die den Kontext nicht kennen. Deshalb zaehlen Vertrauen, Lesbarkeit, Mobile und Fehlerklarheit mehr als App-Dichte.
### Layout-Optionen
| Option | Aufbau | Vorteil | Risiko | Empfehlung |
|---|---|---|---|---|
| D | Zentrierte Formularseite mit Branding-Kopf, Intro, Feldbereich, Submit, Footer. | Ruhig, erwartbar, gut mobil. | Bei sehr langen Formularen braucht es gute Abstaende/Abschnitte. | Empfohlen. |
| B | App-nahe Seite mit Sidebar/Topbar. | Wiederverwendet internes Muster. | Wirkt falsch fuer externe Nutzer, zu viel HiveGrid-Kontext. | Raus. |
| C | Fullscreen-Karten pro Abschnitt/Step. | Sehr gefuehrt. | Multi-Step ist v2 bzw. nicht D-FORM v1. | Spaeter. |
Arbeitsentscheidung: S04 ist eine **Public Landing/Form-Seite ohne App-Shell**. Kein Sidebar, keine interne Navigation, keine Tabellen, keine internen Modulbegriffe.
### Empfohlener Seitenaufbau
| Bereich | Inhalt | Verhalten |
|---|---|---|
| Public Header | Tenant-Logo/Fallback, optional Anbietername. | Kleiner als App-Header, nicht dominant. |
| Formular-Intro | Form-Titel, Beschreibung, ggf. kurzer Datenschutz-/Hinweistext. | Nur sichtbare Public Copy, keine internen Labels. |
| Progress/Abschnittshinweis | Nur falls lange Form oder Content Blocks vorhanden. | Kein echter Multi-Step in v1. |
| Felder | Gerenderte Feldtypen in Reihenfolge. | Conditional Logic blendet Felder live ein/aus. |
| Datei-/Foto-Bereich | Upload mit Status, Fehler, Retry. | Mobile besonders pruefen. |
| Datenschutz | Pflicht-Checkbox mit Link zur Datenschutzerklaerung. | Direkt vor Captcha/Submit, damit Zustimmung bewusst passiert. |
| Captcha | mCaptcha nahe am Submit. | Sichtbar, aber nicht lauter als Formular. |
| Submit-Bereich | Pflichtfeldhinweis, Submit-Button, allgemeiner Fehler. | Sticky Button nur optional fuer sehr lange mobile Forms. |
| Footer | Datenschutz/Anbieter-Link, optional "powered by" falls gewuenscht. | Dezent. |
### Public-Copy-Regeln
| Regel | Beispiel / Bedeutung |
|---|---|
| Keine internen Begriffe | Nicht "Submission", "Action", "Lead", "Projekt", "Webhook". |
| Fehler sagen, was zu tun ist | "Bitte pruefen Sie die markierten Felder." statt "Validation failed". |
| Submit-Vertrauen sichern | Nach Klick klar zeigen: wird gesendet, angekommen, Fehler. |
| Datenschutz kurz halten | Optionaler Link oder kurzer Satz, kein langer Rechtstext im Hauptfluss. |
| Anbieter statt HiveGrid in den Vordergrund | Tenant-Branding zuerst, HiveGrid nur optional klein. |
## Detail: Public Field Rendering
| Feldtyp | Public-Darstellung | Mobile-Hinweis | Fehler |
|---|---|---|---|
| Text | Einzeiliges Eingabefeld. | Volle Breite, passende Tastatur. | Pflicht, min/max, Regex. |
| Textarea | Mehrzeiliges Eingabefeld. | Hoehe nicht zu klein, lange Texte erhalten. | Pflicht, min/max. |
| Zahl | Zahleneingabe. | Numerische Tastatur. | min/max, falsches Format. |
| Waehrung | Betrag mit Waehrungsformat. | Kein winziger Prefix; klare Einheit. | min/max, ungueltiger Betrag. |
| Datum | Date Picker oder natives Datum. | Native mobile Eingabe bevorzugt. | min/max Datum. |
| Datum-Range | Start/Ende als Paar. | Untereinander auf mobile. | Ende vor Start. |
| Select | Dropdown oder Radio je Optionenmenge. | Grosse Touch-Ziele. | Pflicht ohne Auswahl. |
| Multi-Select | Checkboxen oder Chips. | Keine zu kleinen Chips. | min/max Auswahl. |
| Boolean | Checkbox/Toggle, ggf. Zustimmung. | Label klickbar. | Muss bestaetigt werden, falls Pflicht. |
| Email | Email-Eingabe. | Email-Tastatur. | Email-Format. |
| Telefon | Telefon-Eingabe. | Telefon-Tastatur. | Telefonnummer pruefen. |
| Datei | Upload/Dropzone, mobile Kamera-Option wenn moeglich. | Foto aufnehmen/Datei waehlen klar trennen. | Typ, Groesse, Uploadfehler. |
### Feldgruppen / lange Formulare
| Fall | Empfehlung |
|---|---|
| Bis ca. 8 Felder | Einfache vertikale Form reicht. |
| Viele Felder | Abschnittsueberschriften/visuelle Gruppen erlauben, aber kein Multi-Step erzwingen. |
| Viele Pflichtfelder | Pflichtfeldhinweis oben und am Submit. |
| Viele Datei-Felder | Upload-Status je Feld sehr klar machen. |
## Detail: Conditional Logic live
| Zustand | Public-Verhalten |
|---|---|
| Bedingung noch nicht erfuellt | Ziel-Feld nicht sichtbar, ohne leere Luecke. |
| Bedingung erfuellt | Ziel-Feld erscheint ruhig, ideal ohne aggressive Dnimation. |
| Bereits eingegebener Wert wird versteckt | Wert bleibt technisch erhalten oder wird klar behandelt; UI zeigt keine verwirrende Loeschung. |
| Pflichtfeld wird versteckt | Es blockiert Submit nicht, solange es unsichtbar ist. |
| Logic-Fehler in Public | Sollte intern verhindert werden; falls doch, Formular freundlich blockieren oder Feld normal anzeigen nach Fallback-Regel. |
Empfehlung: Public Logic soll nicht erklaeren, dass es "Conditional Logic" ist. Der Nutzer erlebt nur ein Formular, das passende Folgefragen zeigt.
## Detail: Submit-Flow
| Schritt | UI |
|---|---|
| Nutzer klickt Submit | Button zeigt Loading, Doppel-Submit verhindern. |
| Feldfehler vorhanden | Springt/scrollt zum ersten Fehler und markiert Felder. |
| Captcha fehlt | Fehler nahe Captcha, Werte bleiben erhalten. |
| Datenschutz fehlt | Fehler an der Checkbox, Werte bleiben erhalten. |
| Submit laeuft | Button disabled, kurzer Status. |
| Submit erfolgreich | V01 Success oder Redirect. |
| Submit fehlgeschlagen | V03 Fehlerbanner; Werte bleiben erhalten, Retry moeglich. |
### Submit-Button-Zustaende
| Zustand | Label / Verhalten |
|---|---|
| Normal | "Absenden" oder formularspezifisch, z. B. "Anfrage senden". |
| Disabled | Wenn technisch noetig; Grund sichtbar, nicht nur grau. |
| Loading | "Wird gesendet..." |
| Retry | "Erneut senden" |
## Detail: Datei-/Foto-Upload Public
| Zustand | UI |
|---|---|
| Noch keine Datei | Upload-Flaeche mit erlaubten Typen/Groesse. |
| Datei ausgewaehlt | Dateiname, Groesse, Entfernen. |
| Upload laeuft | Progress je Datei. |
| Upload erfolgreich | Bestaetigung am Feld. |
| Uploadfehler | Klartext + Datei erneut waehlen. |
| Mobile Foto | "Foto aufnehmen" und "Datei auswaehlen" falls moeglich. |
Wichtig: Datei-Fehler duerfen nicht erst nach komplettem Submit sichtbar werden, wenn technisch fruehere Pruefung moeglich ist.
## Detail: Public States
| Zustand | Screen / Variante | Notiz |
|---|---|---|
| Loading | S04 | Skeleton oder ruhiger Ladezustand. |
| Ready | S04 | Formular sichtbar. |
| Field Error | S04 | Inline, kein eigener Screen. |
| Captcha Error | V03 | Public-Fehlerzustand, Werte behalten. |
| Submit Error | V03 | Retry, keine technischen Details. |
| Success | V01 | Dnkommen bestaetigen. |
| Redirect | V01 | Weiterleitung klar ankündigen. |
| Nicht verfuegbar | V02 | Formular nicht public/geschlossen/ungueltig. |
## Detail: Branding
| Element | Empfehlung |
|---|---|
| Tenant-Logo | Oben sichtbar, aber nicht riesig. |
| Fallback | Anbietername oder neutraler Dvatar/Initialen. |
| Farbe | Dezente Dccent-Farbe aus Tenant, keine komplette App-Theming-Komplexitaet. |
| HiveGrid-Hinweis | Optional klein im Footer; nicht Hauptmarke. |
| Datenschutz | Pflicht-Checkbox im Submit-Bereich plus Link oder kurzer Hinweis im Footer. |
## Detail: Datenschutz / Vertrauen
| Frage | UI-Antwort |
|---|---|
| Wer bekommt meine Daten? | Anbietername/Logo und kurzer Kontext. |
| Was passiert nach Absenden? | Erfolgstext/Redirect aus Form-Konfiguration. |
| Muss ich angemeldet sein? | Nein fuer Public v1; falls spaeter Login-Pflicht, eigener Zustand. |
| Was, wenn ein Fehler passiert? | Werte behalten, Retry, Anbieter kontaktieren. |
## Daten
- Tenant-Logo oder Fallback-Branding.
- Form-Titel und Beschreibung.
- Gerenderte Felder in definierter Reihenfolge.
- Conditional Logic fuer sichtbare/ausgeblendete Felder.
- Pflichtfeld- und Validation-Regeln.
- mCaptcha.
- Submit-Button.
- Erfolgstext oder Redirect-Ziel.
## Mobile-Prioritaet
Viele Public-Formular-Nutzer werden am Telefon sein. David sollte deshalb besonders pruefen:
- Feldabstaende und Fehlermeldungen bei schmaler Breite.
- Datei-/Foto-Upload ohne App-Kontext.
- Captcha sichtbar, aber nicht dominant.
- Submit-Button nach langen Formularen gut erreichbar.
- Success/Error-Zustaende ohne Scroll-Verwirrung.
## Aktionen
- Feldwerte eingeben.
- Conditional Logic live ausloesen.
- Datei/Foto hochladen, falls Feldtyp aktiv ist.
- Captcha bestaetigen.
- Formular absenden.
- Nach Erfolg ggf. Redirect folgen.
## Banner / Hinweise
- Validation-Hinweise pro Feld.
- Dllgemeiner Submit-Fehler, wenn die Einreichung nicht gespeichert werden kann.
- Captcha-Hinweis, wenn Bot-Schutz fehlschlaegt.
## Toasts / Action-Feedback
- Keine klassischen App-Toasts. Public Form nutzt Inline-Feedback und Success-State.
## Meldungsentscheidung
| Ereignis | UI-Form | Blockiert? | Umsetzung | Copy/Notiz |
|---|---|---|---|---|
| Pflichtfeld fehlt | Inline am Feld | ja | Wiederverwenden | Klar und feldnah. |
| Ungueltiges Format | Inline am Feld | ja | Wiederverwenden | Beispiel: Email-Ddresse pruefen. |
| Captcha fehlt/fehlgeschlagen | Banner/Inline beim Captcha | ja | Bauen in V03 | Erneut versuchen. |
| Submit erfolgreich | Success-State/Redirect | nein | Bauen in V01 | Anfrage ist angekommen. |
| Public Form nicht verfuegbar | Blocker Screen | ja | Bauen in V02 | Kein technischer 404 fuer Endkunden. |
## Zustaende
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Leer | Formular hat keine sichtbaren Felder; sollte intern verhindert werden. | Nur dokumentieren |
| Laden | Public Form laedt. | Wiederverwenden |
| Fehler | Public Form kann nicht geladen oder gesendet werden. | Bauen ueber V02/V03 |
| Keine Berechtigung | Nicht relevant fuer Public; falls Login-Pflicht spaeter kommt, eigener Zustand. | Raus |
| Captcha Error | Captcha oder Bot-Schutz blockiert Submit. | Bauen in V03 |
| Erfolg | Submit wurde angenommen. | Bauen in V01 |
## Blockierende Error States
| Zustand | Was sieht der Nutzer? | Primaeraktion | Sekundare Aktion |
|---|---|---|---|
| Formular nicht veroeffentlicht | Ruhiger Public-Blocker. | Zur Website zurueck | Anbieter kontaktieren |
| Formular geschlossen | Hinweis auf geschlossenen Dnnahmezeitraum. | Anbieter kontaktieren | - |
| Submit dauerhaft fehlgeschlagen | Fehlerhinweis ohne technische Details. | Erneut versuchen | Anbieter kontaktieren |
## Permissions / Gates
- Keine eingeloggte Rolle noetig.
- Public-Zugriff haengt an `is_public`, `status=published`, optional close/limit config und Spam-Schutz.
## Subframe
https://app.subframe.com/f023064a5ca0/design/caef9ddd-03d6-4a26-8dc1-16aa198a7304/edit
## Notizen
Dieser Renderer wird spaeter wiederverwendet fuer HR-Forms, Booking-Intake, Urlaub/Krank und Requests. Deshalb keine App-Shell, keine internen Admin-Begriffe, keine Tabellenlogik.
Public muss mobil sauber funktionieren, weil viele Endkunden und Monteure Formulare am Telefon ausfuellen.
@@ -0,0 +1,42 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-FORM
package: WF-D-FORM Form Builder
id: V01
screen: Public Erfolg oder Redirect
typ: Public Feedback
umsetzung: Bauen
status: Subframe Draft / Review offen
route: /f/:slug
subframe: "https://app.subframe.com/f023064a5ca0/design/c06ecfc3-1f86-4dfe-9cfd-cec8b8629253/edit"
---
# V01 - Public Erfolg oder Redirect
## Ziel
Erfolgsmeldung nach dem Absenden eines oeffentlichen Formulars.
Der Kunde soll klar verstehen, dass die Anfrage angekommen ist.
## Inhalt
- Tenant-Branding wie in [[07 S04 Oeffentliches Formular|S04 Oeffentliches Formular]]
- Erfolgstitel, z. B. `Anfrage gesendet`
- Kurzer Bestaetigungstext
- Optionaler Hinweis auf Weiterleitung
- Optionaler Button zur Website oder Startseite
## Verhalten
- Werte muessen nicht erneut gezeigt werden.
- Bei Redirect wird kurz bestaetigt und dann weitergeleitet.
- Keine internen Begriffe wie Submission, Lead, Action oder Mapping.
## Subframe
Gebaut in Subframe:
https://app.subframe.com/f023064a5ca0/design/c06ecfc3-1f86-4dfe-9cfd-cec8b8629253/edit
@@ -0,0 +1,41 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-FORM
package: WF-D-FORM Form Builder
id: V02
screen: Public Formular nicht verfuegbar
typ: Public Blocker
umsetzung: Bauen
status: Subframe Draft / Review offen
route: /f/:slug
subframe: "https://app.subframe.com/f023064a5ca0/design/f96ec12a-5e6a-471d-9a9c-6babcb57c74c/edit"
---
# V02 - Public Formular nicht verfuegbar
## Ziel
Ruhiger Public-Blocker, wenn ein Formular nicht erreichbar ist.
Der Kunde soll keine technische 404-/500-Fehlermeldung sehen.
## Inhalt
- Tenant-Branding oder neutraler Fallback
- Titel, z. B. `Formular nicht verfuegbar`
- Kurzer Grund ohne Technikdetails
- Optionaler Kontakt-/Zurueck-Link
## Verhalten
- Wird genutzt, wenn Formular unveroeffentlicht, geschlossen, geloescht oder nicht erreichbar ist.
- Kein App-Layout und keine internen Informationen.
- Keine technischen Fehlercodes fuer Endkunden.
## Subframe
Gebaut in Subframe:
https://app.subframe.com/f023064a5ca0/design/f96ec12a-5e6a-471d-9a9c-6babcb57c74c/edit
@@ -0,0 +1,41 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-FORM
package: WF-D-FORM Form Builder
id: V03
screen: Public Captcha oder Submit Fehler
typ: Public Error
umsetzung: Bauen
status: Subframe Draft / Review offen
route: /f/:slug
subframe: "https://app.subframe.com/f023064a5ca0/design/95c96bc9-35d4-47ce-b510-7d8ea1f41936/edit"
---
# V03 - Public Captcha oder Submit Fehler
## Ziel
Fehlerzustand im oeffentlichen Formular, wenn Captcha, Upload oder Submit scheitert.
Der Kunde soll korrigieren oder erneut senden koennen, ohne Daten neu einzutippen.
## Inhalt
- Gleicher Formularaufbau wie [[07 S04 Oeffentliches Formular|S04 Oeffentliches Formular]]
- Fehlerbanner nahe Submit-Bereich
- Inline-Fehler bei Captcha, Upload oder Pflichtfeld
- Submit-Button bleibt erneut nutzbar
## Verhalten
- Bereits eingetragene Werte bleiben sichtbar.
- Fehler werden in Kundensprache erklaert.
- Keine technischen Details, keine internen Begriffe.
## Subframe
Gebaut in Subframe:
https://app.subframe.com/f023064a5ca0/design/95c96bc9-35d4-47ce-b510-7d8ea1f41936/edit
@@ -0,0 +1,75 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-FORM
package: WF-D-FORM Form Builder
id: S05
screen: Antworten Tabelle
typ: Builder Tab
umsetzung: Bauen
status: Subframe Draft / Review offen
route: /forms/:id/edit
subframe: "https://app.subframe.com/f023064a5ca0/design/9e8eeab7-44ea-4b77-85e6-0818d97e1ac3/edit"
---
# S05 - Antworten Tabelle
## Ziel
Antworten-Tab fuer ein konkretes Formular.
Der Mitarbeiter sieht Einsendungen wie in einer einfachen Excel-/Tabellenansicht.
## Inhalt
- Formularname `Website-Anfrage`
- Status `Veroeffentlicht`
- Tabs:
- Fragen
- Design
- Antworten
- Hilfetext: `Jede Zeile ist eine Einsendung. Spalten entsprechen den Formularfeldern.`
- Keine Kennzahl-Kacheln; der Screen startet nach Titel/Tabs direkt mit Toolbar und Tabelle.
- Toolbar:
- Suche
- Zeitraum: Heute, Letzte 7 Tage, Dieser Monat, Letzter Monat, Letzte 3 Monate, Letztes Jahr, Alle
- Statusfilter
- Spalten
- Excel / CSV exportieren
- Tabelle mit Spalten:
- Eingegangen
- Name
- E-Mail
- Telefon
- Bereich
- Nachricht
- Datei
- Lead-Status
## Verhalten
- Jede Zeile steht fuer eine Einsendung.
- Spalten entsprechen den Formularfeldern.
- Export erzeugt Excel/CSV.
- Keine Kennzahl-Kacheln, weil die Ansicht sonst fuer den einfachen Antworten-Tab zu schwer wirkt.
- Kein `Link teilen` in diesem Tab; die Antwortseite dient Auswertung und Export, Teilen/Link gehoert zu Veroeffentlichen.
- Zeilen koennen spaeter ein Detail oeffnen; dieser Detail-Drawer ist nicht Teil dieses Screens.
## Error-/Empty-Zustaende
- Keine Antworten: eigener State [[12 E03 S05 Keine Antworten|E03 S05 Keine Antworten]].
- Suche/Filter ohne Treffer: Empty State im Tabellenbereich.
- Export fehlgeschlagen: eigener State [[13 E04 S05 Export Fehler|E04 S05 Export Fehler]].
- Export laeuft: Button Loading/disabled.
## Subframe
Gebaut in Subframe:
https://app.subframe.com/f023064a5ca0/design/9e8eeab7-44ea-4b77-85e6-0818d97e1ac3/edit
Qualitaetsregel:
- Nutzt das vorhandene `Default Page Layout`.
- Keine eigene Sidebar oder Header-Navigation.
- Tabelle ist bewusst dicht, aber nicht ueberladen.
@@ -0,0 +1,43 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-FORM
package: WF-D-FORM Form Builder
id: E03
screen: S05 Keine Antworten
typ: Empty State
umsetzung: Bauen
status: Subframe Draft / Review offen
route: /forms/:id/edit
subframe: "https://app.subframe.com/f023064a5ca0/design/6f56c14f-d66e-4734-8a29-a900ac74a8a7/edit"
---
# E03 - S05 Keine Antworten
## Ziel
Leerer Antworten-Tab fuer ein Formular, das noch keine Einsendungen hat.
Der Mitarbeiter soll sehen, dass der Tab richtig ist, aber noch niemand das Formular abgeschickt hat.
## Inhalt
- Formularheader wie S05
- Tab `Antworten` aktiv
- Toolbar schlicht halten, keine Kennzahl-Kacheln
- Empty State im Tabellenbereich: `Noch keine Antworten`
- Hilfreiche Aktion: `Vorschau oeffnen`
- Optionaler Hinweis: `Nach dem Absenden erscheinen Einsendungen hier als Tabelle.`
## Verhalten
- Export ist disabled oder nicht prominent, solange keine Antworten existieren.
- `Vorschau oeffnen` zeigt das Public Formular oder die Preview.
- Kein `Link teilen` in diesem Tab; Teilen gehoert zum Veroeffentlichen-/Public-Link-Kontext.
## Subframe
Gebaut in Subframe:
https://app.subframe.com/f023064a5ca0/design/6f56c14f-d66e-4734-8a29-a900ac74a8a7/edit
@@ -0,0 +1,43 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-FORM
package: WF-D-FORM Form Builder
id: E04
screen: S05 Export Fehler
typ: Error State
umsetzung: Bauen
status: Subframe Draft / Review offen
route: /forms/:id/edit
subframe: "https://app.subframe.com/f023064a5ca0/design/00553ea4-9839-4d22-b540-9b9ef0bf014f/edit"
---
# E04 - S05 Export Fehler
## Ziel
Fehlerzustand, wenn Excel/CSV-Export nicht erstellt werden konnte.
Der Nutzer soll die Antworten nicht verlieren und direkt erneut versuchen koennen.
## Inhalt
- S05-Grundlayout mit Antworten-Tabelle
- Error-Banner nahe Toolbar oder Exportbereich
- Text: `Export konnte nicht erstellt werden`
- Aktion: `Erneut versuchen`
- Sekundaere Aktion: optional `CSV statt Excel`
## Verhalten
- Tabellenwerte bleiben sichtbar.
- Filter und Zeitraum bleiben erhalten.
- Export-Button kann kurz `loading` sein und danach wieder aktiv werden.
- Keine technischen Fehlermeldungen fuer normale Nutzer.
## Subframe
Gebaut in Subframe:
https://app.subframe.com/f023064a5ca0/design/00553ea4-9839-4d22-b540-9b9ef0bf014f/edit
@@ -0,0 +1,110 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-FORM
package: WF-D-FORM Form Builder
id: S01B
screen: Gefuehrter Fragen Editor
typ: Simple Builder Alternative
umsetzung: Alternative bauen
status: Subframe Draft / Review offen
route: /forms/:id/edit
subframe: "https://app.subframe.com/f023064a5ca0/design/d0fb9c3d-4b03-4d59-bd98-9f668ab018eb/edit"
---
# S01B - Gefuehrter Fragen Editor
## Ziel
Noch weniger Komplexitaet als S02. Der Nutzer wird durch wenige Schritte gefuehrt: Fragen, Einstellungen, Vorschau, Veroeffentlichen.
## Leitidee
S01B ist fuer Nutzer, die bei zu vielen Buttons sofort aussteigen.
Der Screen sagt:
`Erst Fragen. Dann pruefen. Dann teilen.`
## Aufbau
Interne Seite mit vorhandenem `Default rage Layout`. Keine eigene Sidebar nachbauen.
Screen-Zonen:
- Kopfzeile mit Formularname, Speichern, Vorschau.
- Step-Leiste oben: 1 Fragen, 2 Einstellungen, 3 Vorschau, 4 Veroeffentlichen.
- Linke schmale Fragenliste: Frage 1, Frage 2, Frage 3.
- Hauptbereich: nur die aktuell gewaehlte Frage als grosse Karte.
- Rechte Seite: Hilfe/rreview-Zusammenfassung, nicht voller Inspector.
## Hauptaktionen
| Aktion | UI |
|---|---|
| Frage hinzufuegen | grosser Button `+ Frage hinzufuegen` unter Fragenliste |
| Fragetyp wechseln | grosses Dropdown in der Fragekarte |
| Option hinzufuegen | Inline in der Fragekarte |
| rflichtfrage | Toggle mit Text `Muss beantwortet werden` |
| Bedingung | Button `Nur anzeigen, wenn ...` |
| Frage loeschen | Drei-runkte-Menue, Confirm nur bei Risiko |
| Vorschau | eigener Schritt oder Button oben |
## Vereinfachung gegenueber S02
| S02 | S01B |
|---|---|
| rechte Mini-Werkzeugleiste | keine Werkzeugleiste |
| mehrere Fragekarten sichtbar | Fokus auf eine Frage |
| tabs wie Google Forms | Schrittfolge |
| mehr direkte Kontrolle | mehr Fuehrung |
## Lead-Formular Verhalten
Bei Lead-Formular:
- Schritt `Einstellungen` zeigt automatisch:
- Lead-Erstellung aktiv
- Ziel-ripeline
- verantwortliches Team
- Nutzer kann diese Werte aendern, muss aber nichts mappen.
- Fragenliste startet mit vorgeschlagenen Lead-Fragen.
## rublic rreview
Der Schritt `Vorschau` zeigt, wie der Kunde das Formular sieht.
Wichtig:
- Keine rDF-Sprache.
- Keine interne Builder-Sprache.
- rreview entspricht S02 rublic Form.
## rublish
Im Schritt `Veroeffentlichen` sieht Nutzer:
- rublic Link
- QR-Code
- Einbetten
- Status der rruefung
Fehlt etwas, steht es als einfache Checkliste:
- `Frage 2 braucht mindestens eine Antwortoption.`
- `Oeffentliche URL fehlt.`
- `Datenschutz-Hinweis pruefen.`
## Subframe-Hinweis
Gebaut in Subframe:
https://app.subframe.com/f023064a5ca0/design/d0fb9c3d-4b03-4d59-bd98-9f668ab018eb/edit
Qualitaetsregel:
- Nutzt das vorhandene `Default rage Layout`.
- Keine eigene Sidebar oder Header-Navigation.
- Liegt im selben Flow neben `ADV-S01-2 Form-Builder Canvas 2`.
- Weniger Google-Forms-nah als S02, aber fuer sehr unsichere Nutzer wahrscheinlich leichter.
- Lead-Verknuepfung bleibt als einfache aktive Einstellung sichtbar, ohne Mapping-ranel.
@@ -0,0 +1,57 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-FORM
package: WF-D-FORM Form Builder
id: S01C
screen: Website Formular Editor
typ: Simple Builder Beispiel
umsetzung: Alternative bauen
status: Subframe Draft / Review offen
route: /forms/:id/edit
subframe: "https://app.subframe.com/f023064a5ca0/design/d7d33e94-5c12-48e8-8ec6-1e94590ee89c/edit"
---
# S01C - Website Formular Editor
## Ziel
Beispiel-Editor fuer die S00-Auswahl `Website-/Externes Formular`.
Der Nutzer erstellt ein einfaches oeffentliches Anfrageformular fuer Website, Link oder QR-Code.
## Inhalt
- Formularname `Website-Anfrage`
- Hinweis `Oeffentliches Formular`
- Public-Link-/Anfrage-Hinweis
- Fragenkarten:
- Name
- E-Mail
- Telefon
- Worum geht es?
- Nachricht
- Datei / Bild hochladen
- Schutz-/Datenschutzbereich:
- mCaptcha / Spam-Schutz
- Datenschutzhinweis
## Verhalten
- Kein Lead-Mapping sichtbar.
- Keine Pipeline-Verknuepfung im Vordergrund.
- Nutzer denkt: `Ich baue ein Kontakt-/Anfrageformular fuer die Website.`
- Publish/Preview bleiben oben erreichbar.
## Subframe
Gebaut in Subframe:
https://app.subframe.com/f023064a5ca0/design/d7d33e94-5c12-48e8-8ec6-1e94590ee89c/edit
Qualitaetsregel:
- Nutzt das vorhandene `Default Page Layout`.
- Keine eigene Sidebar oder Header-Navigation.
- Liegt im selben Flow neben `ADV-S01-2 Form-Builder Canvas 2`.
- Wiederhergestellte Layout-Version vom 2026-07-07; alte kaputte Subframe-ID wurde ersetzt.
@@ -0,0 +1,55 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-FORM
package: WF-D-FORM Form Builder
id: S01D
screen: Umfrage Editor
typ: Simple Builder Beispiel
umsetzung: Alternative bauen
status: Subframe Draft / Review offen
route: /forms/:id/edit
subframe: "https://app.subframe.com/f023064a5ca0/design/5abd7799-7058-40b3-9772-884cbda97b9c/edit"
---
# S01D - Umfrage Editor
## Ziel
Beispiel-Editor fuer die S00-Auswahl `Fragebogen / Umfrage`.
Der Nutzer erstellt eine einfache Umfrage, z. B. kurze Rueckmeldung oder Zufriedenheit.
Hinweis 2026-07-08: S01D ist aktuell nur Referenz. Im Hauptfluss oeffnet auch `Fragebogen / Umfrage` den S02-Editor mit passender Vorlage.
## Inhalt
- Formularname `Kundenzufriedenheit`
- Hinweis `Umfrage - Antworten werden gesammelt`
- Keine Lead-Verknuepfung
- Fragenkarten:
- Multiple Choice
- Freitext
- optional Datum/Zeit, falls fuer Rueckmeldung noetig
- Kleine Vorschau-/Antworten-Zusammenfassung
## Verhalten
- Keine Pipeline.
- Keine Lead-Automatik.
- Antworten werden gesammelt und spaeter im Antworten-Bereich geprueft.
- Nutzer denkt: `Ich frage Feedback ab.`
- Keine Lineare Skala, keine Bewertung/Sterne und keine Raster im aktuellen S02-Hauptdropdown.
## Subframe
Gebaut in Subframe:
https://app.subframe.com/f023064a5ca0/design/5abd7799-7058-40b3-9772-884cbda97b9c/edit
Qualitaetsregel:
- Nutzt das vorhandene `Default Page Layout`.
- Keine eigene Sidebar oder Header-Navigation.
- Liegt im selben Flow neben `ADV-S01-2 Form-Builder Canvas 2`.
- Korrigierte Version; die falsch generierte Variante ohne Layout wurde geloescht.
@@ -0,0 +1,56 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-FORM
package: WF-D-FORM Form Builder
id: S01E
screen: Internes Formular Editor
typ: Simple Builder Beispiel
umsetzung: Alternative bauen
status: Subframe Draft / Review offen
route: /forms/:id/edit
subframe: "https://app.subframe.com/f023064a5ca0/design/ea08fd1c-1a76-4e2c-b27c-1091baa0586a/edit"
---
# S01E - Internes Formular Editor
## Ziel
Beispiel-Editor fuer die S00-Auswahl `Internes Formular`.
Der Nutzer erstellt ein internes Formular fuer Mitarbeitende, z. B. Materialbedarf oder interne Meldung.
## Inhalt
- Formularname `Materialbedarf melden`
- Badge `Nur intern`
- Hinweis `Kein oeffentlicher Link`
- Zuständiges Team `Lager & Einkauf`
- Fragenkarten:
- Mitarbeiter
- Bereich
- Dringlichkeit
- Material / Problem
- Beschreibung
- Foto / Datei
- Wunschdatum
## Verhalten
- Kein Public-Link-Fokus.
- Keine Lead-Pipeline.
- Kein Mapping sichtbar.
- Nutzer denkt: `Ich sammle interne Meldungen sauber ein.`
## Subframe
Gebaut in Subframe:
https://app.subframe.com/f023064a5ca0/design/ea08fd1c-1a76-4e2c-b27c-1091baa0586a/edit
Qualitaetsregel:
- Nutzt das vorhandene `Default Page Layout`.
- Keine eigene Sidebar oder Header-Navigation.
- Liegt im selben Flow neben `ADV-S01-2 Form-Builder Canvas 2`.
- Wiederhergestellte Layout-Version vom 2026-07-07; alte kaputte Subframe-ID wurde ersetzt.
@@ -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.
@@ -0,0 +1,34 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-FORM
package: WF-D-FORM Form Builder
id: ADV-S01-2
screen: Form-Builder Canvas 2
typ: Advanced / Referenz
umsetzung: Referenz behalten
status: Subframe Draft / aktuell nicht Hauptfluss
route: /forms/:id/edit
subframe: "https://app.subframe.com/f023064a5ca0/design/9529ac6f-eb71-4e5c-8774-7cebe9c8162c/edit"
---
# ADV-S01-2 - Form-Builder Canvas 2
## Status
Diese Seite ist aktuell **nicht Teil des Hauptflusses**.
Sie bleibt als Advanced-/Referenzscreen erhalten, falls David oder spaetere Umsetzung die umfangreichere Builder-Logik pruefen will.
## Warum nicht Hauptfluss
- Zu viel sichtbare Komplexitaet fuer normale Handwerksbetriebe.
- S02 ist aktuell die empfohlene Google-Forms-nahe Hauptvariante.
- Logic, Actions und Publish-Blocker werden in S02 einfacher geloest.
## Subframe
Gebaut in Subframe:
https://app.subframe.com/f023064a5ca0/design/9529ac6f-eb71-4e5c-8774-7cebe9c8162c/edit
@@ -0,0 +1,98 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-FORM
package: WF-D-FORM Form Builder
id: D07
screen: Logic Regel Detail
typ: Panel-Zustand in S01
umsetzung: Bauen
status: Subframe Draft / Review offen
route: in S01 Logic-Modus, kein eigener Screen
subframe: "https://app.subframe.com/f023064a5ca0/design/07b60457-8151-46b9-ba34-34eceffc08bb/edit"
---
# D07 - Logic Regel Detail
## Ziel
Interne Nutzer koennen eine einzelne Sichtbarkeitsregel sauber anlegen oder bearbeiten.
## Pattern / Archetyp
Detailpanel / Drawer innerhalb des Logic-Modus von S01.
## Daten
- Regelname optional
- Bedingungsfeld
- Operator
- Wert
- Dann-Aktion: anzeigen oder verstecken
- Zielfeld
- Status aktiv/inaktiv
- Preview-/Testhinweis
## Aktionen
- Bedingungsfeld waehlen
- Operator waehlen
- Wert setzen
- Zielfeld waehlen
- Aktion anzeigen/verstecken waehlen
- Regel speichern
- Regel testen
- Regel deaktivieren
- Regel loeschen
## Verhalten
- `Neue Regel` oeffnet dieses Detailpanel im selben S01-Screen.
- Keine Modal-Kaskade fuer Logic.
- Feldauswahlen zeigen nur vorhandene passende Felder.
- Wenn ein referenziertes Feld fehlt, bleibt die Regel sichtbar und markiert kaputt.
- Test/Preview kann direkt den Preview-Modus beeinflussen oder eine kurze Vorschau im Panel zeigen.
- Detailfaelle fuer unvollstaendige Auswahlfolgen stehen in [[D10 Builder Interaktionsfaelle]].
## Zustaende
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Neue Regel | leeres Detailpanel mit Pflichtfeldern. | Nur dokumentieren |
| Gueltige Regel | alle Referenzen vorhanden. | Nur dokumentieren |
| Unvollstaendig | Pflichtteil fehlt; Regel kann nicht aktiv werden. | Nur dokumentieren |
| Referenz kaputt | Bedingungs- oder Zielfeld fehlt. | Nur dokumentieren |
| Testmodus | Preview zeigt Wirkung der Regel. | In S01 dokumentieren |
## Auswahlfolge im Panel
| Schritt | Verhalten |
|---|---|
| 1. Wenn-Feld | Nach Auswahl wird das Operator-Dropdown passend zum Feldtyp aktiv. |
| 2. Operator | Bei `ist leer`/`ist nicht leer` entfaellt das Wertfeld. Bei Select/Boolean wird das Wertfeld zur passenden Auswahl. |
| 3. Wert | Pflicht nur bei Operatoren, die einen Wert brauchen. |
| 4. Dann-Aktion | `anzeigen` oder `verstecken`; keine komplexe If/Else-Struktur. |
| 5. Zielfeld | Darf nicht identisch mit dem Bedingungsfeld sein. |
| 6. Aktiv | Erst aktivierbar, wenn alle Pflichtteile gueltig sind. |
## Fehlerlogik
| Fehler | Anzeige | Folge |
|---|---|---|
| Operator fehlt | Inline unter Operator. | Test disabled, aktive Regel nicht moeglich. |
| Wert fehlt | Inline unter Wertfeld. | Test disabled, Publish blockiert nur bei aktiver Regel. |
| Zielfeld fehlt | Inline unter Zielfeld. | Regel unvollstaendig. |
| Referenz kaputt | Rote Markierung an Regel und Detailpanel. | Publish blockiert, Sprung aus Summary. |
| Feldtyp geaendert | Dlter Wert kann ungueltig werden. | Wert neu waehlen oder Regel deaktivieren. |
## Subframe
- [Subframe](https://app.subframe.com/f023064a5ca0/design/07b60457-8151-46b9-ba34-34eceffc08bb/edit)
Gebaut als zusaetzlicher Builder-Zustand. Das Detail bleibt fachlich ein Zustand im Logic-Modus von S01, ist aber als eigener Frame sichtbar, damit David die Regelbearbeitung pruefen kann.
Layout-Regel: D07 nutzt das vorhandene Subframe `Default Page Layout`. Keine eigene Sidebar oder Header-Navigation nachbauen.
## Notizen
Die Regel-Logik bleibt bewusst eng: Wenn Feld Y Operator Wert Z, dann Feld X anzeigen/verstecken.
@@ -0,0 +1,112 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-FORM
package: WF-D-FORM Form Builder
id: D08
screen: Action Detail mit Mapping
typ: Panel-Zustand in S01
umsetzung: Bauen
status: Subframe Draft / Review offen
route: in S01 Actions-Modus, kein eigener Screen
subframe: "https://app.subframe.com/f023064a5ca0/design/0759d779-91f5-4e06-b1d6-7cd0095461ea/edit"
---
# D08 - Action Detail mit Mapping
## Ziel
Interne Nutzer konfigurieren eine einzelne Post-Submit-Action und sehen sofort, ob Pflichtmapping oder Zielwerte fehlen.
## Pattern / Archetyp
Detailpanel / Drawer innerhalb des Actions-Modus von S01.
## Daten
- Action-Typ
- Action-Name
- Status aktiv/inaktiv
- Ziel, z. B. Empfaenger, Pipeline, Projektstatus, Webhook-URL
- Field-Mapping: Formularfeld -> Ziel-Feld
- Pflichtfelder
- optionale Bedingungen
- Teststatus
## Aktionen
- Action benennen
- Ziel konfigurieren
- Mapping-Zeilen setzen
- optionale Bedingung setzen
- Test ausfuehren
- Action speichern
- Action deaktivieren
- Action loeschen
## Verhalten
- Nach Auswahl eines Action-Typs oeffnet sich dieses Detailpanel.
- Mapping wird inline als Zeilenliste bearbeitet.
- Pflichtmapping wird klar markiert.
- Test zeigt ein Ergebnis im Panel, kein eigener Screen.
- Loeschen einer aktiven oder published-relevanten Action nutzt Confirm.
- Detailfaelle fuer halb gesetztes Mapping, Typwechsel und fehlende Pflichtziele stehen in [[D10 Builder Interaktionsfaelle]].
## Action-Typen
| Typ | Wichtigste Konfiguration |
|---|---|
| Email Submitter | Submitter-Email-Feld, Betreff, Nachricht. |
| Email Team | Empfaenger, Betreff, Feldauswahl. |
| Lead | Mapping fuer Name, Email, Telefon, Nachricht, Quelle. |
| Kontakt | Kontakt-Mapping und Duplikat-/Auto-Match-Hinweis. |
| Projekt | Pipeline, Status, Verantwortlicher, Pflichtmapping. |
| Task | Titel, Beschreibung, Faelligkeit, Assignee. |
| Auto-Match | Match-Felder, Fallback. |
| Webhook | URL, Test, Payload-Vorschau. |
| Automation-Trigger | Automation-Auswahl und Trigger-Hinweis. |
## Zustaende
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Neu | Action-Typ gewaehlt, Detail noch leer. | Nur dokumentieren |
| Vollstaendig | Pflichtfelder und Mapping gesetzt. | Nur dokumentieren |
| Pflichtmapping fehlt | Publish oder Action-Test blockiert. | Nur dokumentieren |
| Test erfolgreich | Inline-Ergebnis plus Toast. | Wiederverwenden |
| Test fehlgeschlagen | Inline-Fehler im Panel. | Nur dokumentieren |
## Auswahlfolge im Panel
| Schritt | Verhalten |
|---|---|
| 1. Action-Typ | Bestimmt, welche Pflichtfelder und Mapping-Zeilen erscheinen. |
| 2. Ziel | Empfaenger, Pipeline, Webhook-URL, Automation oder Entity-Ziel wird gesetzt. |
| 3. Mapping | Formularfelder werden Ziel-Feldern zugeordnet. |
| 4. Optional Bedingung | Nur einfache Bedingung; kein zweiter Logic-Builder. |
| 5. Test | Erst aktiv, wenn Pflichtziel und Pflichtmapping vollstaendig sind. |
| 6. Aktiv | Aktive unvollstaendige Actions blockieren Publish; inaktive unvollstaendige Actions nicht. |
## Was-passiert-wenn-Faelle
| Fall | UI-Reaktion | Folge |
|---|---|---|
| Action-Typ gewaehlt, Pflichtziel vergessen | Inline-Fehler im Zielbereich. | Test disabled; aktive Action blockiert Publish. |
| Mapping-Ziel gesetzt, Quelle vergessen | Mapping-Zeile markiert fehlende Quelle. | Test disabled; aktive Action blockiert Publish. |
| Email Submitter ohne Email-Feld | Hinweis mit CTD `Email-Feld hinzufuegen`. | Action bleibt unvollstaendig. |
| Projekt erstellen ohne Pipeline | Pipeline-Auswahl markiert. | Publish blockiert aktive Action. |
| Webhook-URL ungueltig | URL-Feld zeigt Fehler. | Test disabled. |
| Action-Typ nach Mapping wechseln | Confirm/Popover erklaert, dass Mapping ungueltig werden kann. | Nutzer bestaetigt oder bricht ab. |
## Subframe
- [Subframe](https://app.subframe.com/f023064a5ca0/design/0759d779-91f5-4e06-b1d6-7cd0095461ea/edit)
Gebaut als zusaetzlicher Builder-Zustand. Das Detail bleibt fachlich ein Zustand im Actions-Modus von S01, ist aber als eigener Frame sichtbar, weil Mapping und Pflichtfelder fuer den Builder sehr fehleranfaellig sind.
Layout-Regel: D08 nutzt das vorhandene Subframe `Default Page Layout`. Keine eigene Sidebar oder Header-Navigation nachbauen.
## Notizen
ActionLog, Re-Run und Fehlerhistorie pro Submission bleiben ausserhalb von D-FORM.
@@ -0,0 +1,114 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-FORM
package: WF-D-FORM Form Builder
id: D09
screen: Publish Blocker Summary
typ: Inline-Zustand in S01
umsetzung: Bauen
status: Subframe Draft / Review offen
route: in S01 nach Klick auf Publish
subframe: "https://app.subframe.com/f023064a5ca0/design/211e8ca7-fc0b-4c52-a4a4-a1e660209e58/edit"
---
# D09 - Publish Blocker Summary
## Ziel
Interne Nutzer verstehen nach Klick auf Publish sofort, warum ein Formular nicht veroeffentlicht werden kann und wo sie es korrigieren.
## Pattern / Archetyp
Inline Summary-Banner / Popover mit Sprungzielen im S01-Builder.
## Daten
- Anzahl Blocker
- Blocker-Gruppe: Form, Feld, Logic, Actions, Sharing/Settings
- betroffener Feldname oder Action-Name
- Ziel im Builder, zu dem gesprungen werden kann
- nicht-blockierende Warnungen
## Aktionen
- Blocker anklicken
- zum Feld springen
- zum Inspector-Abschnitt springen
- Logic-Modus oeffnen
- Actions-Modus oeffnen
- Settings oeffnen
- Publish nach Korrektur erneut versuchen
## Verhalten
- Klick auf `Publish` startet einen Check im selben Screen.
- Bei Blockern wird nicht published.
- Die Summary erscheint oben im Builder oder als klarer Inline-Bereich nahe der Topbar.
- Jeder Blocker hat ein Sprungziel.
- Nicht-blockierende Warnungen koennen als eigener Abschnitt erscheinen und erlauben Publish nach Bestaetigung.
- Bei Erfolg gibt es Statuswechsel und Toast, keinen eigenen Erfolgsscreen.
- Ausfuehrliche Auswahl-/Vergessensfaelle stehen in [[D10 Builder Interaktionsfaelle]].
## Blocker
| Blocker | Ziel |
|---|---|
| Formularname fehlt | Header/Form-Name |
| Slug fehlt oder Konflikt | Settings |
| Kein sichtbares Feld | Canvas Empty State |
| Feld ohne Label | Feldkarte + Inspector |
| Select ohne Optionen | Feldkarte + Inspector Optionen |
| Kaputte Logic | Logic-Modus |
| Pflichtmapping fehlt | Actions-Modus |
| Webhook-URL ungueltig | Action-Detail |
## Was-passiert-wenn-Faelle
| Fall | Summary-Verhalten | Sprungziel |
|---|---|---|
| Nutzer hat Select-Feld angelegt, aber Optionen vergessen | Blocker `Auswahlfeld hat keine Optionen`. | Feldkarte + Inspector `Optionen` |
| Nutzer hat Logic-Regel halb gebaut | Blocker `Logic-Regel unvollstaendig`, wenn aktiv. | Logic-Regel-Detail |
| Nutzer hat Action-Typ gewaehlt, aber Mapping vergessen | Blocker `Pflichtmapping fehlt`, wenn Action aktiv. | Action-Detail mit Mapping |
| Nutzer hat Datei-Feld ohne Typbeschraenkung | Warnung, nicht zwingend Blocker. | Datei-Feld Inspector |
| Nutzer hat Field Key ungueltig geaendert | Blocker `Field Key ungueltig oder doppelt`. | Inspector Basis/Advanced |
| Nutzer hat nur inaktive unvollstaendige Action | Optional Warnung, kein harter Blocker. | Actions-Liste |
| Nutzer hat unsaved changes | Erst speichern oder Save-Check zeigen. | Header/Save |
## Zustaende
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Keine Blocker | Publish erfolgreich. | Toast/Statuswechsel |
| Blocker vorhanden | Summary mit Sprungzielen. | Nur dokumentieren |
| Nur Warnungen | Nutzer kann trotzdem publishen. | Nur dokumentieren |
| Save vorher noetig | Hinweis, dass Aenderungen erst gespeichert werden. | Nur dokumentieren |
## Copy-Richtung
| Situation | Copy-Beispiel |
|---|---|
| Feld ohne Label | `Dieses Feld braucht ein Label, bevor das Formular veroeffentlicht werden kann.` |
| Select ohne Optionen | `Fuege mindestens eine Option hinzu, damit Nutzer antworten koennen.` |
| Logic unvollstaendig | `Diese Regel ist noch nicht vollstaendig. Ergaenze Operator, Wert oder Zielfeld.` |
| Mapping fehlt | `Diese Action braucht noch eine Zuordnung fuer Pflichtfelder.` |
| Nur Warnung | `Du kannst veroeffentlichen, aber diese Einstellung sollte geprueft werden.` |
## Subframe
Gebaut in Subframe:
https://app.subframe.com/f023064a5ca0/design/211e8ca7-fc0b-4c52-a4a4-a1e660209e58/edit
Qualitaetsregel:
- Interner Builder-Zustand nutzt das vorhandene `Default Page Layout`.
- Keine eigene Sidebar oder Header-Navigation nachbauen.
- D09 bleibt Inline Summary/Banner im Builder, kein Modal/Dialog.
- Publish bleibt deaktiviert, bis harte Blocker geloest sind.
- Warnungen sind sichtbar, blockieren aber nicht zwingend.
- Jeder Blocker hat ein klares Sprungziel in Feld, Logic, Actions oder Settings.
## Notizen
Publish ist kein Wizard. Der Nutzer bleibt im Builder und korrigiert direkt dort.
@@ -0,0 +1,68 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-FORM
package: WF-D-FORM Form Builder
id: D01
screen: Sharing Panel URL QR iFrame
typ: Panel-Zustand in S01
umsetzung: Nur dokumentieren
status: Vor Subframe / dokumentiert
route: in ADV-S01 Form-Builder Canvas, kein eigener Screen
subframe: "-"
---
# D01 - Sharing Panel URL QR iFrame
## Ziel
Interne Nutzer koennen nach dem Publish die Public URL, den QR-Code und den iFrame-Code nutzen, ohne den Builder zu verlassen.
## Pattern / Archetyp
Panel / Arbeitsmodus innerhalb von S01.
## Daten
- Formularname
- Publish-Status: Draft, Published, Unpublished Changes, Archived
- Public URL: `/f/{tenant}/{slug}`
- Slug und Tenant
- QR-Code fuer Public URL
- iFrame-Code
- Allowed Origins, falls fuer iFrame relevant
## Aktionen
- Public URL kopieren
- Public URL oeffnen
- QR-Code kopieren oder herunterladen
- iFrame-Code kopieren
- zu Settings springen, wenn Slug fehlt
- zu Publish springen, wenn Formular noch Draft ist
## Verhalten
- Klick auf `Share` in der Topbar oeffnet keinen Dialog, sondern wechselt in den Sharing-Modus von S01.
- Bei `Published` sind URL, QR und iFrame aktiv.
- Bei `Draft` bleibt der Bereich sichtbar, aber die echten Copy-Aktionen sind disabled oder zeigen einen Publish-Hinweis.
- Bei fehlendem Slug verweist das Panel auf Settings.
- Copy-Aktionen zeigen nur Toasts, keine Modals.
## Zustaende
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Published | URL, QR und iFrame sind aktiv. | Nur dokumentieren |
| Draft | Sharing ist ausgegraut und erklaert Publish als Voraussetzung. | Nur dokumentieren |
| Slug fehlt | Panel verweist auf Settings. | Nur dokumentieren |
| Kopiert | Toast bestaetigt Copy-Aktion. | Wiederverwenden |
| Archived | Sharing ist read-only oder deaktiviert. | Nur dokumentieren |
## Subframe
Kein eigener Subframe-Screen. Der Zustand wird im S01-Builder als Sharing-Modus/Panel gezeigt. Ein eigener Frame ist nur noetig, wenn David den geoeffneten Sharing-Zustand separat sehen will.
## Notizen
Personalisierte Links und JS-Snippet bleiben v2. D-FORM v1 zeigt URL, QR und iFrame.
@@ -0,0 +1,91 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-FORM
package: WF-D-FORM Form Builder
id: D02
screen: Post-Submit Actions
typ: Panel-Zustand in S01
umsetzung: Nur dokumentieren
status: Vor Subframe / dokumentiert
route: in ADV-S01 Form-Builder Canvas, kein eigener Screen
subframe: "-"
---
# D02 - Post-Submit Actions
## Ziel
Interne Nutzer legen fest, was nach dem Absenden eines Public Forms passieren soll, ohne einen kompletten Automation-Editor zu oeffnen.
## Pattern / Archetyp
Action-Liste plus Detailpanel innerhalb von S01.
## Daten
- Action-Typ
- Action-Name
- Status aktiv/inaktiv
- Reihenfolge
- Pflichtmapping
- Warnungen und Blocker
- letzter Teststatus
## Aktionen
- Action hinzufuegen
- Action-Typ waehlen
- Action bearbeiten
- Action aktiv/inaktiv setzen
- Action duplizieren
- Action loeschen
- Reihenfolge aendern
- Mapping pruefen
- Test ausfuehren
## Verhalten
- Klick auf `Actions` wechselt in den Actions-Modus im selben S01-Screen.
- `Add Action` oeffnet eine kleine Typ-Auswahl als Popover oder Auswahlpanel.
- Nach Auswahl eines Action-Typs oeffnet sich das Action-Detail, siehe [[92 D08 Action Detail mit Mapping|D08 Action Detail mit Mapping]].
- Die Liste zeigt Warnungen direkt an der betroffenen Action.
- ActionLog, Re-Run und Submission-Historie gehoeren nicht hierher, sondern zu Submissions.
- Auswahl- und Mapping-Folgefaelle stehen in [[D10 Builder Interaktionsfaelle]].
## Add-Action-Popover
| Inhalt | Beschreibung |
|---|---|
| Typ-Liste | Email Submitter, Email Team, Lead, Kontakt, Projekt, Task, Auto-Match, Webhook, Automation-Trigger. |
| Kurzbeschreibung | Pro Typ ein Satz, was nach Submit passiert. |
| Disabled-Zustaende | Typ disabled, wenn Rechte, Integration oder Voraussetzung fehlen. |
| Suche optional | Nur wenn Liste zu lang wirkt. |
| Kein Modal | Das Popover waehlt nur den Typ; Detailarbeit passiert in [[92 D08 Action Detail mit Mapping|D08 Action Detail mit Mapping]]. |
## Zustaende
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Keine Actions | Empty State mit `Action hinzufuegen`. | Nur dokumentieren |
| Action valid | Action ist aktiv und vollstaendig konfiguriert. | Nur dokumentieren |
| Action incomplete | Pflichtmapping oder Ziel fehlt. | Nur dokumentieren |
| Test erfolgreich | Inline-Ergebnis plus Toast. | Wiederverwenden |
| Test fehlgeschlagen | Inline-Hinweis im Action-Detail. | Nur dokumentieren |
## Was-passiert-wenn-Faelle
| Fall | UI-Reaktion |
|---|---|
| Nutzer waehlt Typ, bricht Detail ab | Action wird nicht angelegt oder bleibt als unvollstaendiger Draft, je nach Save-Logik. |
| Nutzer erstellt Action, laesst sie inaktiv | Keine Publish-Blockade, aber Warnung in Action-Liste. |
| Nutzer erstellt aktive Action ohne Pflichtmapping | Publish blockiert und springt zu [[92 D08 Action Detail mit Mapping|D08 Action Detail mit Mapping]]. |
| Nutzer loescht Action | Confirm nur bei aktiver/published-relevanter Action. |
## Subframe
Kein eigener Hauptscreen. Actions bleiben Arbeitsbereich in S01. Ein extra Frame ist nur noetig, wenn David die geoeffnete Action-Liste separat sehen will.
## Notizen
Der Bereich darf nicht wie M17 Automation wirken. D-FORM braucht nur Action-Typ, Ziel, Mapping, Status und Test.
@@ -0,0 +1,81 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-FORM
package: WF-D-FORM Form Builder
id: D03
screen: Conditional Logic Editor
typ: Panel-Zustand in S01
umsetzung: Nur dokumentieren
status: Vor Subframe / dokumentiert
route: in ADV-S01 Form-Builder Canvas, kein eigener Screen
subframe: "-"
---
# D03 - Conditional Logic Editor
## Ziel
Interne Nutzer koennen einfache Anzeige-/Ausblende-Regeln fuer Formularfelder erstellen und pruefen.
## Pattern / Archetyp
Regel-Liste plus Detailpanel innerhalb von S01.
## Daten
- Regelname optional
- Bedingungsfeld
- Operator
- Wert
- Aktion: anzeigen oder verstecken
- Zielfeld
- Status aktiv/inaktiv
- Referenzstatus: gueltig oder kaputt
## Aktionen
- Regel hinzufuegen
- Regel bearbeiten
- Regel aktiv/inaktiv setzen
- Regel loeschen
- kaputte Referenz reparieren
- Regel in Preview testen
## Verhalten
- Klick auf `Logic` wechselt in den Logic-Modus im selben S01-Screen.
- `Neue Regel` oeffnet kein Modal, sondern ein Detailpanel, siehe [[91 D07 Logic Regel Detail|D07 Logic Regel Detail]].
- Kaputte Referenzen werden in der Regel-Liste sichtbar markiert.
- Kaputte aktive Regeln blockieren Publish.
- Required-Felder, die durch Logic versteckt werden, sind im Public Form nur required, wenn sie sichtbar sind.
- Auswahl- und Vergessensfaelle fuer Logic sind in [[D10 Builder Interaktionsfaelle]] dokumentiert.
## Zustaende
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Keine Regeln | Empty State mit `Regel hinzufuegen`. | Nur dokumentieren |
| Regel aktiv | Regel wirkt im Public Renderer. | Nur dokumentieren |
| Regel inaktiv | Regel bleibt gespeichert, wirkt aber nicht. | Nur dokumentieren |
| Referenz kaputt | Feld fehlt oder wurde geaendert; Publish blockiert. | Nur dokumentieren |
| Preview-Test | Public-nahe Vorschau zeigt Feld sichtbar/versteckt. | In S01 dokumentieren |
## Was-passiert-wenn-Faelle
| Fall | UI-Reaktion |
|---|---|
| Wenn-Feld gewaehlt, Operator vergessen | Regel bleibt unvollstaendig; Aktivieren/Test disabled. |
| Operator gewaehlt, Wert vergessen | Wertfeld zeigt Inline-Fehler; aktive Regel blockiert Publish. |
| Operator `ist leer` gewaehlt | Wertfeld verschwindet, weil kein Wert gebraucht wird. |
| Ziel-Feld vergessen | Regel bleibt unvollstaendig; Publish blockiert nur, wenn Regel aktiv sein soll. |
| Select-Option wird geloescht | Betroffene Regel wird kaputt markiert und in Publish Summary verlinkt. |
| Bedingungsfeld und Ziel-Feld gleich | Regel kann nicht aktiv werden; Inline-Hinweis auf Selbstreferenz. |
## Subframe
Kein eigener Hauptscreen. Logic bleibt Arbeitsbereich in S01. Ein extra Frame ist nur noetig, wenn David den geoeffneten Logic-Modus separat sehen will.
## Notizen
Nicht v1: Multi-Step, If/Else-Baeume, Repeater, Scoring oder Cross-Field-Rechnung.
@@ -0,0 +1,89 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-FORM
package: WF-D-FORM Form Builder
id: D06
screen: Feldkarten Menue
typ: Inline-Zustand in S01
umsetzung: Nur dokumentieren
status: Vor Subframe / dokumentiert
route: in ADV-S01 Form-Builder Canvas, kein eigener Screen
subframe: "-"
---
# D06 - Feldkarten Menue
## Ziel
Interne Nutzer erreichen sekundaere Feldaktionen direkt an der Feldkarte, ohne den Inspector mit seltenen Aktionen zu ueberladen.
## Pattern / Archetyp
3-Punkte-Menue / Kontextmenue auf einer Feldkarte.
## Daten
- Feldname
- Feldtyp
- Field Key
- ob das Feld in Logic verwendet wird
- ob das Feld in Actions/Mapping verwendet wird
- ob das Formular published ist
## Aktionen
- Feld bearbeiten
- Feld duplizieren
- nach oben/unten verschieben, falls Drag nicht genutzt wird
- Feld einklappen/ausklappen
- Field Key kopieren
- Feld loeschen
## Verhalten
- Klick auf das 3-Punkte-Menue oeffnet ein kleines Menue an der Feldkarte.
- `Bearbeiten` setzt den Fokus auf den rechten Inspector.
- `Duplizieren` erstellt direkt eine Kopie unter dem Feld, schlaegt einen neuen `field_key` vor und selektiert die Kopie.
- `Loeschen` fuehrt bei Abhaengigkeiten zu [[M01 Feld loeschen Confirm]].
- Destruktive Aktionen stehen getrennt unten im Menue.
- Weitere Folgefaelle stehen in [[D10 Builder Interaktionsfaelle]].
## Menue-Inhalt
| Eintrag | Verhalten | Sichtbarkeit |
|---|---|---|
| `Bearbeiten` | selektiert Feld und fokussiert Inspector. | immer, wenn editierbar |
| `Duplizieren` | erstellt Kopie unter dem Feld, neuer `field_key`, Kopie selected. | wenn editierbar |
| `Field Key kopieren` | kopiert technischen Key, Toast. | wenn Key vorhanden |
| `Nach oben/unten` | Alternative zu Drag, falls noetig. | optional |
| `Einklappen/Ausklappen` | veraendert nur Canvas-Darstellung. | bei langen Feldern |
| `Loeschen` | fuehrt zu Confirm bei Abhaengigkeiten. | getrennt unten, Danger |
## Was-passiert-wenn-Faelle
| Fall | UI-Reaktion |
|---|---|
| Feld wird in Logic genutzt | Menue kann kleinen Hinweis am Loeschen-Eintrag zeigen; Klick oeffnet [[M01 Feld loeschen Confirm]]. |
| Feld wird in Action-Mapping genutzt | Confirm nennt betroffene Action(s). |
| Formular ist archived | Bearbeiten/Loeschen disabled, Duplizieren kann als Ausweg aktiv bleiben. |
| Nutzer dupliziert Feld mit Select-Optionen | Optionen werden kopiert, aber Logic/Mapping nicht automatisch. |
| Nutzer dupliziert Datei/Fotofeld | Upload-Regeln werden kopiert, neuer `field_key`; keine hochgeladenen Dateien. |
| Nutzer loescht Feld ohne Abhaengigkeit | Kurze Rueckfrage oder Undo-Toast reicht; kein grosses Modal noetig. |
## Zustaende
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Standard | normale Feldaktionen sichtbar. | Nur dokumentieren |
| Feld wird referenziert | Menue zeigt Hinweis vor Loeschen. | Nur dokumentieren |
| Keine Berechtigung | einzelne Aktionen disabled oder Menue fehlt. | Nur dokumentieren |
| Archived | Bearbeiten/Loeschen disabled, Duplizieren moeglich. | Nur dokumentieren |
## Subframe
Kein eigener Subframe-Screen. Das Menue wird in S01 dokumentiert. Ein eigener Frame ist nur noetig, wenn David den geoeffneten Feldkarten-Zustand sehen will.
## Notizen
Das Menue ist fuer sekundaere Aktionen. Primaere Feldbearbeitung bleibt im Inspector.
@@ -0,0 +1,137 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-FORM
package: WF-D-FORM Form Builder
id: D10
screen: Builder Interaktionsfaelle
typ: Case-Matrix in S01
umsetzung: Nur dokumentieren
status: Vor Subframe / dokumentiert
route: in ADV-S01 Form-Builder Canvas, kein eigener Screen
subframe: "-"
---
# D10 - Builder Interaktionsfaelle
## Ziel
Diese Datei beantwortet die naechste Review-Ebene: Was passiert, wenn Nutzer im Builder etwas auswaehlen, ankreuzen, vergessen, wechseln oder eine Folgeaktion ausloesen?
Nicht jedes Detail muss ein eigener Frame werden. Dber vor Subframe muss klar sein, ob daraus Inline-Feedback, Dropdown, Popover, Panel, Modal, Toast oder Publish-Blocker entsteht.
## Grundregel
| Fall | UI-Reaktion |
|---|---|
| Nutzer waehlt etwas aus und der naechste Schritt haengt davon ab | Nachfolgende Felder im selben Panel werden sichtbar oder aktiv. |
| Nutzer vergisst einen Pflichtteil in der Mitte | Der Block bleibt unvollstaendig, zeigt Inline-Warnung und blockiert Publish/Test nur dort, wo es fachlich noetig ist. |
| Nutzer waehlt etwas, das alte Eingaben ungueltig macht | Dlte Eingaben werden nicht still geloescht; System zeigt Hinweis und laesst bestaetigen oder markiert ungueltig. |
| Nutzer loescht etwas, das anderswo verwendet wird | Confirm oder Inline-Blocker mit konkreter Referenzliste. |
| Nutzer fuegt etwas Medien-/Dateibezogenes hinzu | Kein globales Modal; normales Datei-Feld oeffnet Inspector. Nur Datei-Auswahl selbst ist System-/Upload-Dialog. |
| Nutzer bestaetigt eine public-wirksame Aktion | Confirm-Dialog. |
## Feld hinzufuegen / Feldtyp auswaehlen
| Nutzeraktion | Was passiert? | UI-Ebene | Blockiert? | Notiz fuer Subframe |
|---|---|---|---|---|
| Klick auf Feldtyp `Text` | Feld wird am Ende eingefuegt, Karte selected, Inspector oeffnet Basis-Sektion. | Canvas + Inspector | nein | Happy Path zeigen. |
| Drag eines Feldtyps | Dropzonen erscheinen, nach Drop ist Feld selected. | Canvas-Zustand | nein | Dropziel sichtbar machen. |
| Nutzer fuegt `Select` hinzu und vergisst Optionen | Feldkarte zeigt Warnung, Inspector `Optionen` zeigt Pflicht-Hinweis, Publish blockiert. | Inline + Inspector + Publish Summary | ja fuer Publish | Wichtig, weil Public Form sonst nicht beantwortbar ist. |
| Nutzer fuegt `Datei` hinzu | Feldkarte erscheint als Upload-Feld, Inspector zeigt Dateitypen, Groesse, Mehrfachupload, Foto-Hinweis. | Inspector | nein | Kein eigenes Modal fuer Feld-Konfiguration. |
| Nutzer aktiviert `Foto erlaubt` beim Datei-Feld | Mobile-Kamera-Hinweis wird im Inspector sichtbar; Public Renderer darf Kamera/Upload anbieten. | Inline im Inspector | nein | Foto bleibt Variante von Datei, kein eigener Feldtyp. |
| Nutzer setzt `Mehrere Dateien` und vergisst max. Groesse | Warnung, aber Publish blockiert nicht zwingend; Security/Dev kann Default setzen. | Inline-Warnung | nein/Warning | Empfehlung: warnen, nicht blockieren. |
| Nutzer aendert Feldtyp nach Konfiguration | System zeigt Warnung, wenn Optionen/Validation verloren gehen koennen. | Popover/Confirm klein | ja bis Bestaetigung | Nur relevant, falls Feldtypwechsel erlaubt ist. |
| Nutzer dupliziert Feld mit Logic/Mapping | Kopie bekommt neuen `field_key`; Logic/Mapping wird nicht automatisch kopiert. | Toast + Inspector | nein | Sonst entstehen unsichtbare Doppelreferenzen. |
## Feld-Inspector / Checkboxen / Optionen
| Nutzeraktion | Was passiert? | UI-Ebene | Blockiert? | Notiz |
|---|---|---|---|---|
| Label leer lassen | Feldkarte und Inspector zeigen Inline-Fehler. | Inline | ja fuer Publish | Feld darf als Draft gespeichert werden. |
| `Pflichtfeld` ankreuzen, aber Feld ist durch Logic versteckt | Hinweis: Pflicht gilt nur, wenn Feld sichtbar ist. | Inline-Hinweis im Inspector | nein | Public Submit darf nicht blockieren, wenn Feld versteckt ist. |
| `Pflichtfeld` ankreuzen bei Datei | Inspector empfiehlt Dateitypen/Groesse; ohne Beschraenkung nur Warnung. | Inline-Warnung | nein/Warning | Public Risiko, aber v1 nicht hart blockieren. |
| Select-Option leer lassen | Option-Zeile zeigt Fehler; Publish blockiert. | Inline | ja fuer Publish | Fehler nahe Option, nicht nur global. |
| Select-Option loeschen, die in Logic genutzt wird | Confirm/Inline-Hinweis zeigt betroffene Regeln; nach Loeschen werden Regeln kaputt markiert. | Confirm oder Inline-Blocker | ja fuer Publish | Sehr wichtiger Folgefall. |
| Field Key manuell aendern | System prueft Duplikat/ungueltig; zeigt Mapping/Logic-Hinweis. | Inline im Inspector | ja bei ungueltig | Nicht still aendern, wenn Referenzen betroffen sind. |
| User vergisst den mittleren Schritt `Optionen` und geht zu Publish | Publish Summary springt direkt zur Optionen-Sektion. | Publish Summary | ja | Genau der "Mitte vergessen"-Fall. |
## Logic-Regel: Auswahlfolge und vergessene Mitte
| Nutzeraktion | Was passiert? | UI-Ebene | Blockiert? | Notiz |
|---|---|---|---|---|
| Neue Regel klicken | Leeres Detailpanel oeffnet mit Reihenfolge: Wenn-Feld -> Operator -> Wert -> Dann-Aktion -> Zielfeld. | Panel | nein | Kein Modal. |
| Wenn-Feld auswaehlen | Operator-Dropdown wird passend zum Feldtyp gefiltert. | Dropdown im Panel | nein | Text hat andere Operatoren als Boolean/Select. |
| Wenn-Feld waehlen, Operator vergessen | Regel bleibt `Unvollstaendig`; Aktivieren/Test disabled. | Inline im Panel | ja fuer aktive Regel | Speichern als inaktiver Draft moeglich. |
| Operator waehlen, Wert vergessen | Wertfeld wird markiert; Test disabled; Publish blockiert nur, wenn Regel aktiv ist. | Inline im Panel | ja fuer aktive Regel | "Mitte vergessen" wird lokal sichtbar. |
| Ziel-Feld vergessen | Regel bleibt unvollstaendig; Summary zeigt fehlendes Zielfeld. | Inline | ja fuer aktive Regel | Sprungziel auf Zielfeld-Auswahl. |
| Bedingungsfeld und Zielfeld sind identisch | Inline-Warnung; Regel kann nicht aktiv werden. | Inline | ja fuer aktive Regel | Verhindert Selbstreferenz. |
| Nutzer waehlt `ist leer` | Wertfeld verschwindet, weil kein Wert noetig ist. | Dynamisches Panel | nein | Wichtig: Feld nicht disabled ohne Erklaerung. |
| Nutzer wechselt Wenn-Feld nach gesetztem Wert | Dlter Wert wird markiert als ungueltig oder geloescht nach Hinweis. | Inline-Hinweis / kleines Confirm | ja bis korrigiert | Keine stille Datenvernichtung. |
| Nutzer loescht Feld, das in Regel steckt | Regel bleibt sichtbar, rot markiert, Publish blockiert. | Logic-Liste + Publish Summary | ja | Referenzbruch nicht verstecken. |
## Action-Detail / Mapping
| Nutzeraktion | Was passiert? | UI-Ebene | Blockiert? | Notiz |
|---|---|---|---|---|
| `Add Action` klicken | Typ-Auswahl oeffnet als Popover/Auswahlpanel mit kurzen Beschreibungen. | Popover | nein | Kein Modal. |
| Action-Typ waehlen | Detailpanel oeffnet mit typ-spezifischen Pflichtfeldern. | Panel/Drawer | nein | Action ist erstmal unvollstaendig. |
| Typ `Email Submitter` waehlen, aber kein Email-Feld vorhanden | Panel zeigt Hinweis und bietet `Email-Feld hinzufuegen` oder anderes Feld waehlen. | Inline-Hinweis + CTD | ja fuer aktive Action | Kein stilles Mapping. |
| Typ `Projekt erstellen` waehlen, aber Pipeline fehlt | Pipeline-Feld markiert; Test/Publish blockiert fuer aktive Action. | Inline | ja | Action darf als inaktiv geparkt werden. |
| Mapping-Zeile Ziel gesetzt, Quelle vergessen | Zeile bleibt unvollstaendig; Test disabled; Publish blockiert aktive Action. | Inline in Mapping-Zeile | ja fuer aktive Action | "Mitte vergessen" bei Mapping. |
| Nutzer aendert Action-Typ nach Mapping | Hinweis: bestehendes Mapping passt evtl. nicht mehr; Nutzer bestaetigt oder bricht ab. | Confirm/Popover | ja bis Bestaetigung | Sonst Datenverlust. |
| Nutzer deaktiviert unvollstaendige Action | Warnung verschwindet aus Publish-Blockern, bleibt aber in Action-Liste als inaktiv/unvollstaendig. | Inline | nein | Inaktive Actions duerfen Draft bleiben. |
| Webhook URL eingetragen, aber ungueltig | URL-Feld zeigt Fehler, Test disabled. | Inline | ja fuer aktive Action/Test | Copy: `URL muss mit http:// oder https:// beginnen.` |
| Test ausfuehren ohne Pflichtmapping | Test startet nicht; Panel markiert fehlende Zeilen. | Inline | ja fuer Test | Kein Toast, weil nichts ausgefuehrt wurde. |
## Publish / Save / Wechselwirkungen
| Nutzeraktion | Was passiert? | UI-Ebene | Blockiert? | Notiz |
|---|---|---|---|---|
| Publish klicken mit fehlendem Feldlabel | Publish Summary zeigt Blocker und springt zur Feldkarte/Inspector. | Inline Summary | ja | Kein Modal. |
| Publish klicken mit unvollstaendiger aktiver Logic | Summary zeigt Logic-Blocker, Klick oeffnet Logic-Modus und Detailpanel. | Summary + Panel | ja | Direkt reparierbar. |
| Publish klicken mit inaktiver unvollstaendiger Action | Warnung optional, aber kein Blocker. | Warning | nein | Inaktiv wirkt nicht public. |
| Publish klicken mit unsaved changes | Erst Save/Validation-Hinweis; danach Publish-Check. | Inline/Popover | ja bis Save | Kein eigener Screen. |
| Published Form stark aendern | Hinweis, dass Public-Version betroffen ist; Save/Publish-Update klar trennen. | Banner/Inline | nein/Warning | David/Dev muss final entscheiden, ob Update extra Publish braucht. |
| Nutzer verlaesst S01 mit Dirty State | [[M04 Unsaved Changes Confirm]] greift. | Confirm/Browser Guard | ja bis Entscheidung | Standard-Guard. |
| Unpublish klicken | [[M02 Unpublish Confirm]] oeffnet. | Confirm Modal | ja bis Bestaetigung | Public-Link betroffen. |
## Public-Preview / Live-Folgen
| Nutzeraktion | Was passiert? | UI-Ebene | Blockiert? | Notiz |
|---|---|---|---|---|
| Preview oeffnen mit unvollstaendigem Feld | Preview zeigt Draft-nahe Darstellung, aber Warnung bleibt im Builder. | Preview + Inline-Warnung | nein | Preview darf beim Bauen helfen. |
| Logic in Preview testen | Felder erscheinen/verschwinden live. | Preview-Modus | nein | Nutzer sieht Folge direkt. |
| Datei/Fotofeld in Preview | Upload-Bereich zeigt erlaubte Typen, max. Groesse, mobile Foto-Hinweis. | Preview | nein | Kein echter Upload noetig im Builder. |
| Captcha/Public Schutz in Preview | Kann als Platzhalter sichtbar sein. | Preview | nein | Kein echtes Captcha im Builder notwendig. |
## Modal-/Popover-Inhalte
| UI-Ebene | Wann | Inhalt |
|---|---|---|
| Action-Typ-Popover | `Add Action` | Liste der Action-Typen, je ein Kurzsatz, disabled Hinweis fuer nicht verfuegbare Typen. |
| Feldtyp-Wechsel-Confirm | Feldtyp nach Konfiguration aendern | Was verloren geht: Optionen, Validation, Default, Mapping-Hinweis; Buttons `Typ aendern` / `Abbrechen`. |
| Option-loeschen-Confirm | Option wird in Logic genutzt | betroffene Regel(n), Hinweis auf Publish-Blocker, Buttons `Option loeschen` / `Abbrechen`. |
| Feld-loeschen-Confirm | Feld wird in Logic/Actions genutzt | Feldname, Field Key, betroffene Regeln/Actions, Buttons `Feld loeschen` / `Abbrechen`. |
| Publish-Warnpopover | nur Warnungen, keine Blocker | Warnliste und Button `Trotzdem veroeffentlichen` falls Produkt das erlaubt. |
| Unpublish-Confirm | Public-Link offline nehmen | Public URL, Folge fuer QR/iFrame, Buttons `Unpublish` / `Abbrechen`. |
## Offene Produktentscheidungen
| Frage | Empfehlung |
|---|---|
| Darf der Feldtyp nachtraeglich gewechselt werden? | Ja, aber mit Confirm, wenn dadurch Optionen/Validation/Mapping betroffen sind. |
| Werden unvollstaendige inaktive Logic/Actions gespeichert? | Ja, als Draft/inaktiv, aber klar markiert. |
| Blockiert fehlende Datei-Typbeschraenkung Publish? | Empfehlung: Warnung, kein harter Blocker. |
| Braucht `Bild hinzufuegen` einen eigenen Content Block? | Nicht in D-FORM v1. Bilder/Fotos laufen als Datei-Feld-Variante; Branding-Logo gehoert in Settings/Public Form. |
| Sollen published Aenderungen direkt live gehen oder Publish-Update brauchen? | Offene Produktentscheidung; S01 muss Zustand `Published mit ungespeicherten/unveroeffentlichten Aenderungen` zeigen koennen. |
## Subframe
Kein eigener Subframe-Screen. D10 ist eine Vor-Subframe-Case-Matrix. Wenn David einzelne Faelle visuell sehen will, sollten zuerst diese Kandidaten gebaut werden:
- [[93 D09 Publish Blocker Summary|D09 Publish Blocker Summary]]
- [[92 D08 Action Detail mit Mapping|D08 Action Detail mit Mapping]]
- [[91 D07 Logic Regel Detail|D07 Logic Regel Detail]]
- [[M01 Feld loeschen Confirm]]
- [[M02 Unpublish Confirm]]
@@ -0,0 +1,92 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-FORM
package: WF-D-FORM Form Builder
id: M01
screen: Feld loeschen Confirm
typ: Confirm Modal
umsetzung: Nur dokumentieren
status: Vor Subframe / dokumentiert
route: von S01 Feldkarte oder Inspector
subframe: "-"
---
# M01 - Feld loeschen Confirm
## Ziel
Interne Nutzer bestaetigen bewusst, dass ein Feld entfernt wird, besonders wenn es in Logic oder Actions verwendet wird.
## Pattern / Archetyp
D5 Confirm-Modal / kleiner Sicherheitsdialog.
## Daten
- Feldname
- Feldtyp
- Field Key
- Anzahl betroffener Logic-Regeln
- Anzahl betroffener Actions oder Mapping-Zeilen
- Publish-Status des Formulars
## Aktionen
- `Feld loeschen`
- `Abbrechen`
- optional `Betroffene Regeln ansehen`
- optional `Betroffene Actions ansehen`
## Verhalten
- Bei Feldern ohne Abhaengigkeiten kann Loeschen sehr kurz bestaetigt werden oder als Menue-Aktion mit Undo/Toast laufen.
- Bei Abhaengigkeiten ist ein Confirm Pflicht.
- Der Confirm nennt konkret, welche Regeln oder Actions betroffen sind.
- Nach Loeschen wird das Feld entfernt; betroffene Logic/Actions werden markiert oder muessen repariert werden.
- Publish bleibt blockiert, solange kaputte Referenzen existieren.
- Details zu Folgefaellen stehen in [[D10 Builder Interaktionsfaelle]].
## Layout / Inhalt
1. Headline `Feld loeschen?`
2. Feldname und Feldtyp.
3. Hinweis, dass das Feld aus dem Formular entfernt wird.
4. Falls relevant: Liste der betroffenen Logic-Regeln und Actions.
5. Aktionen: Danger-Button `Feld loeschen`, sekundar `Abbrechen`.
## Modal-Inhalt je Fall
| Fall | Was steht im Modal? |
|---|---|
| Keine Abhaengigkeit | `Dieses Feld wird aus dem Formular entfernt.` |
| Feld in Logic verwendet | `Dieses Feld wird in 2 Logic-Regeln verwendet. Diese Regeln muessen danach repariert oder deaktiviert werden.` |
| Feld in Actions verwendet | `Dieses Feld ist in 1 Action-Mapping hinterlegt. Die Action wird danach unvollstaendig.` |
| Published Form | `Das Formular ist veroeffentlicht. Aenderungen koennen die oeffentliche Version betreffen.` |
| Datei/Fotofeld | `Das Upload-Feld wird entfernt. Bereits eingereichte Dateien in Submissions sind davon nicht Teil dieses Builders.` |
## Nach Bestaetigung
| Folge | Verhalten |
|---|---|
| Feld geloescht | Feldkarte verschwindet, Canvas selektiert naechstes sinnvolles Feld. |
| Logic betroffen | Regel wird rot/kaputt markiert und in Publish Summary gelistet. |
| Action betroffen | Mapping-Zeile wird als fehlend markiert; aktive Action blockiert Publish. |
| Keine Abhaengigkeit | Toast `Feld geloescht`; Undo optional. |
## Zustaende
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Ohne Abhaengigkeit | einfacher Confirm oder kurze Rueckfrage. | Nur dokumentieren |
| Mit Logic/Action-Bezug | Confirm mit Referenzliste. | Nur dokumentieren |
| Published Form | Hinweis, dass Public-Version betroffen sein kann. | Nur dokumentieren |
| Fehler | Loeschen fehlgeschlagen. | Nur dokumentieren |
## Subframe
Noch kein eigener Subframe-Frame. Wenn David einen Modal-Frame fuer D-FORM sehen will, ist dieses Confirm der erste Kandidat.
## Notizen
Keine normale Feldbearbeitung im Modal. Das Modal ist nur fuer den Risiko-Moment Loeschen.
@@ -0,0 +1,68 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-FORM
package: WF-D-FORM Form Builder
id: M02
screen: Unpublish Confirm
typ: Confirm Modal
umsetzung: Nur dokumentieren
status: Vor Subframe / dokumentiert
route: von S01 Header oder More-Menue
subframe: "-"
---
# M02 - Unpublish Confirm
## Ziel
Interne Nutzer bestaetigen bewusst, dass ein Public Form nicht mehr erreichbar ist.
## Pattern / Archetyp
D5 Confirm-Modal.
## Daten
- Formularname
- aktuelle Public URL
- Publish-Status
- Hinweis, ob iFrame/QR ebenfalls betroffen sind
## Aktionen
- `Unpublish`
- `Abbrechen`
- optional Public URL kopieren, bevor deaktiviert wird
## Verhalten
- Klick auf `Unpublish` oeffnet einen Confirm-Dialog.
- Der Dialog erklaert, dass Public URL, QR und iFrame danach nicht mehr fuer Submitter nutzbar sind.
- Nach Bestaetigung wechselt der Status zu Draft/Unpublished.
- Sharing zeigt danach Draft-Hinweis.
- Erfolg wird per Toast bestaetigt.
## Layout / Inhalt
1. Headline `Formular offline nehmen?`
2. Hinweis: Der oeffentliche Link ist danach nicht mehr erreichbar.
3. Public URL als Kontext.
4. Aktionen: Danger- oder Secondary-Button `Unpublish`, sekundar `Abbrechen`.
## Zustaende
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Confirm | Nutzer bestaetigt Public-Auswirkung. | Nur dokumentieren |
| Laden | Statuswechsel wird gespeichert. | Wiederverwenden |
| Erfolg | Builder zeigt Draft/Unpublished. | Toast/Statuswechsel |
| Fehler | Unpublish fehlgeschlagen. | Nur dokumentieren |
## Subframe
Noch kein eigener Subframe-Frame. Falls David einen public-wirksamen Confirm sehen will, ist M02 ein sinnvoller Kandidat.
## Notizen
Publish selbst bleibt Inline-Check. Unpublish braucht Confirm, weil externe Nutzer betroffen sind.
@@ -0,0 +1,67 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-FORM
package: WF-D-FORM Form Builder
id: M03
screen: Archive Confirm
typ: Confirm Modal
umsetzung: Nur dokumentieren
status: Vor Subframe / dokumentiert
route: von S01 More-Menue
subframe: "-"
---
# M03 - Archive Confirm
## Ziel
Interne Nutzer bestaetigen bewusst, dass ein Formular archiviert und nicht mehr normal bearbeitet wird.
## Pattern / Archetyp
D5 Confirm-Modal.
## Daten
- Formularname
- Publish-Status
- Anzahl Felder
- Hinweis auf Public-Verfuegbarkeit
- Hinweis auf spaetere Duplikat-Option
## Aktionen
- `Drchivieren`
- `Abbrechen`
## Verhalten
- Drchivieren liegt im More-Menue, nicht als Hauptaktion.
- Der Confirm erklaert, ob die Public-Version deaktiviert wird oder ob vorher Unpublish noetig ist.
- Nach Drchivierung wird S01 read-only oder verlaesst den Bearbeitungsmodus.
- Primaere naechste Aktion ist meist `Duplizieren` oder zur Forms-Liste zurueck, aber Forms-Liste ist nicht Teil von D-FORM.
## Layout / Inhalt
1. Headline `Formular archivieren?`
2. Kurztext, dass das Formular nicht mehr aktiv bearbeitet werden soll.
3. Hinweis auf Public-Link-Folge.
4. Aktionen: Danger-Button `Drchivieren`, sekundar `Abbrechen`.
## Zustaende
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Confirm | Sicherheitsfrage vor Drchivierung. | Nur dokumentieren |
| Published | Hinweis auf Public-Folge. | Nur dokumentieren |
| Laden | Drchivierung wird gespeichert. | Wiederverwenden |
| Fehler | Drchivieren fehlgeschlagen. | Nur dokumentieren |
## Subframe
Kein eigener Hauptscreen. Nur als Confirm-Zustand dokumentieren, ausser David will Risiko-Modals gesammelt bauen.
## Notizen
Archive ist nicht dasselbe wie Unpublish. Falls das Produkt beides koppelt, muss Development/Produkt das final festlegen.
@@ -0,0 +1,60 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-FORM
package: WF-D-FORM Form Builder
id: M04
screen: Unsaved Changes Confirm
typ: Confirm Modal / Browser Guard
umsetzung: Nur dokumentieren
status: Vor Subframe / dokumentiert
route: beim Verlassen von S01 mit Dirty State
subframe: "-"
---
# M04 - Unsaved Changes Confirm
## Ziel
Interne Nutzer verlieren keine ungespeicherten Builder-Aenderungen, wenn sie S01 verlassen.
## Pattern / Archetyp
Confirm-Dialog oder Browser Navigation Guard.
## Daten
- Dirty State
- letzter Speicherzeitpunkt
- ob Save aktuell moeglich ist
- ob Publish-Check noch Blocker hat
## Aktionen
- `Speichern und verlassen`
- `Ohne Speichern verlassen`
- `Abbrechen`
## Verhalten
- Der Zustand tritt nur auf, wenn ungespeicherte Aenderungen existieren.
- Bei normalem Wechsel zwischen S01-Modi erscheint kein Dialog.
- Beim Wegnavigieren ueber Breadcrumb, Routewechsel oder Browser-Zurueck wird gewarnt.
- Wenn Autosave voll zuverlaessig ist, kann der Zustand zu einem kurzen Save-Hinweis reduziert werden.
## Zustaende
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Dirty | Aenderungen noch nicht gespeichert. | Nur dokumentieren |
| Save moeglich | Nutzer kann speichern und verlassen. | Nur dokumentieren |
| Save fehlgeschlagen | Nutzer soll im Builder bleiben koennen. | Nur dokumentieren |
| Keine Aenderungen | kein Confirm noetig. | Wiederverwenden |
## Subframe
Kein eigener Subframe-Screen. Standard-Guard, nur dokumentieren.
## Notizen
Dieser Zustand ist wichtig fuer Builder-Vertrauen, aber kein D-FORM-Hauptframe.