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,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.