chore(repo): sync wireframe structure and references

This commit is contained in:
david committed 2026-08-08 03:09:06 +02:00
1 parent 05d2d5777f
commit d953a79e95
453 files changed
+36639 -621

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. 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. 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 D-FORM-Flow neben S02/S02L/E05, S03, S04 und S05.
- 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. |
Die alten Advanced-Detailframes sind aus dem Obsidian-Handoff entfernt. 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 D-FORM-Flow neben S02L/E05, S03, S04 und S05.
- 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,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 D-FORM-Flow als optionale Referenzvariante.
- 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 D-FORM-Flow als optionale Referenzvariante.
- 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 D-FORM-Flow als optionale Referenzvariante.
- Wiederhergestellte Layout-Version vom 2026-07-07; alte kaputte Subframe-ID wurde ersetzt.
@@ -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: Detailnotiz, 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: Detailnotiz im S02-Kontext
umsetzung: Nur dokumentieren
status: Vor Subframe / dokumentiert
route: Detailnotiz, 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 Detailbereich innerhalb des einfachen Builders.
## 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 `Nach Absenden` zeigt die Action-/Lead-Optionen im selben S02-Kontext.
- `Add Action` oeffnet eine kleine Typ-Auswahl als Popover oder Auswahlpanel.
- Nach Auswahl eines Action-Typs oeffnet sich die Detailkonfiguration im selben Bereich.
- 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 im selben Builder-Kontext. |
## 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 zur betroffenen Zuweisung. |
| Nutzer loescht Action | Confirm nur bei aktiver/published-relevanter Action. |
## Subframe
Kein eigener Hauptscreen. Actions bleiben Arbeitsbereich im einfachen Builder. 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: Detailnotiz im S02-Kontext
umsetzung: Nur dokumentieren
status: Vor Subframe / dokumentiert
route: Detailnotiz, kein eigener Screen
subframe: "-"
---
# D03 - Conditional Logic Editor
## Ziel
Interne Nutzer koennen einfache Anzeige-/Ausblende-Regeln fuer Formularfelder erstellen und pruefen.
## Pattern / Archetyp
Einfache Bedingung direkt an der Frage; komplexere Regel-Liste bleibt nur dokumentiert.
## 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 `Bedingung` oeffnet die einfache Logik direkt an der Frage.
- `Neue Regel` oeffnet kein Modal, sondern bleibt inline im Builder-Kontext.
- 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: Detailnotiz, 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,134 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-FORM
package: WF-D-FORM Form Builder
id: D10
screen: Builder Interaktionsfaelle
typ: Case-Matrix im S02-Kontext
umsetzung: Nur dokumentieren
status: Vor Subframe / dokumentiert
route: Detailnotiz, 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:
- [[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.