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,106 @@
---
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/{tenant}/{slug}
subframe: "https://app.subframe.com/f023064a5ca0/design/c06ecfc3-1f86-4dfe-9cfd-cec8b8629253/edit"
---
# V01 - Public Erfolg oder Redirect
## Ziel
Der Submitter versteht sicher, dass die Einreichung angekommen ist, oder wird sauber an ein konfiguriertes Redirect-Ziel weitergeleitet.
## Pattern / Archetyp
BESPOKE-Public Feedback.
## Daten
- Tenant-Logo/Fallback.
- Erfolgstitel.
- Erfolgstext aus Form-Konfiguration.
- Optionales Redirect-Ziel.
- Optionaler Link zur Website/zurueck.
## Detail-Brainstorming
Der wichtigste Punkt: Nach erfolgreichem Submit darf nichts so wirken, als sei die Anfrage unsicher oder verloren. Duch wenn Actions im Hintergrund fehlschlagen, bleibt die Public-Bestaetigung auf die gespeicherte Einreichung bezogen.
### Varianten
| Variante | Wann | UI |
|---|---|---|
| Success ohne Redirect | Kein Redirect konfiguriert. | Danke-Ansicht mit Erfolgstitel, Text und optionalem Zurueck-Link. |
| Success mit Auto-Redirect | Redirect URL konfiguriert. | Kurze Bestaetigung + Countdown/Weiterleitungshinweis. |
| Success mit manuellem Redirect | Auto-Redirect wird nicht sofort ausgefuehrt oder soll bestaetigt werden. | Button "Weiter" zur Zielseite. |
| Redirect fehlerhaft | Weiterleitung klappt nicht, Submission ist aber gespeichert. | Erfolg bleibt sichtbar; Link erneut oeffnen oder Anbieter kontaktieren. |
### Copy-Vorschlag
| Zustand | Copy-Richtung |
|---|---|
| Erfolg | "Danke, Ihre Dngaben wurden uebermittelt." |
| Naechster Schritt | "Wir melden uns, falls weitere Informationen benoetigt werden." |
| Redirect | "Sie werden gleich weitergeleitet." |
| Redirect-Fehler | "Ihre Dngaben sind angekommen. Die Weiterleitung konnte nicht geoeffnet werden." |
### Nicht zeigen
- Keine Action-Ausfuehrung.
- Kein Lead-/Projekt-/Task-Hinweis.
- Kein Webhook-/Automation-Status.
- Keine interne Submission-ID, ausser spaeter bewusst als Referenznummer geplant.
## Aktionen
- Bei Success ohne Redirect: Seite schliessen oder zur Website zurueck.
- Bei Redirect: automatisch oder per Button weiter.
## Banner / Hinweise
- Kein technischer ActionLog im Public UI.
- Keine internen Begriffe wie Lead, Projekt, Webhook oder Automation.
## Toasts / Action-Feedback
- Keine Toasts; Success-State ist die Rueckmeldung.
## Meldungsentscheidung
| Ereignis | UI-Form | Blockiert? | Umsetzung | Copy/Notiz |
|---|---|---|---|---|
| Submit erfolgreich | Success-State | nein | Bauen | Anfrage ist angekommen. |
| Redirect konfiguriert | Success + Weiterleitung | nein | Bauen | Falls Redirect dauert, klare Zwischenmeldung. |
## Zustaende
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Erfolgstext | Danke-/Bestaetigungsansicht. | Bauen |
| Redirect | Nutzer wird weitergeleitet. | Bauen |
## Blockierende Error States
| Zustand | Was sieht der Nutzer? | Primaeraktion | Sekundare Aktion |
|---|---|---|---|
| Redirect-Ziel nicht erreichbar | Kurzer Fehler nach Submit, Einreichung bleibt erfolgreich. | Link erneut oeffnen | Anbieter kontaktieren |
## Permissions / Gates
- Keine Rolle.
## Subframe
https://app.subframe.com/f023064a5ca0/design/c06ecfc3-1f86-4dfe-9cfd-cec8b8629253/edit
## Notizen
Wichtig: Wenn Submit gespeichert wurde, darf ein kaputter Redirect nicht so wirken, als sei die Einreichung verloren.
@@ -0,0 +1,115 @@
---
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/{tenant}/{slug}
subframe: "https://app.subframe.com/f023064a5ca0/design/f96ec12a-5e6a-471d-9a9c-6babcb57c74c/edit"
---
# V02 - Public Formular nicht verfuegbar
## Ziel
Externe Nutzer landen nicht auf einem rohen 404/500, sondern bekommen eine ruhige, verstaendliche Meldung mit naechster Handlung.
## Pattern / Archetyp
BESPOKE-Public Blocker / A7 Public Error.
## Daten
- Tenant-Logo/Fallback, falls Tenant noch aufloesbar ist.
- Kurzer Titel.
- Klartext-Grund, soweit sicher:
- Formular nicht veroeffentlicht
- Formular archiviert
- Formular geschlossen
- Link ungueltig
- Optionaler Kontakt-/Website-Link.
## Detail-Brainstorming
Dieser Zustand ersetzt rohe Fehlerseiten. Der Nutzer ist blockiert, deshalb braucht er eine ruhige Erklaerung und eine naechste Handlung.
### Blocker-Typen
| Zustand | Interner Grund | Public-Copy-Richtung | Primaeraktion |
|---|---|---|---|
| Nicht veroeffentlicht | `status=draft` oder `is_public=false` | "Dieses Formular ist aktuell nicht verfuegbar." | Anbieter kontaktieren oder zurueck |
| Drchiviert | `status=archived` | "Dieses Formular ist nicht mehr aktiv." | Anbieter kontaktieren |
| Geschlossen | `submission_close_at` vorbei | "Der Dnnahmezeitraum ist beendet." | Anbieter kontaktieren |
| Limit erreicht | `submission_limit` erreicht | "Dieses Formular nimmt aktuell keine weiteren Einreichungen an." | Anbieter kontaktieren |
| Link ungueltig | Tenant/Slug nicht gefunden | "Der Link ist ungueltig oder nicht mehr aktuell." | Link pruefen / Anbieter kontaktieren |
| Tenant nicht aufloesbar | Tenant fehlt/gesperrt | Neutraler Fehler ohne interne Details. | Zurueck |
### Was David zeigen sollte
| Element | Notiz |
|---|---|
| Logo/Fallback | Nur wenn sicher, dass Tenant aufloesbar ist. |
| Titel | Kurz, nicht alarmistisch. |
| Klartext | Kein 404, kein Stacktrace, keine internen IDs. |
| Kontakt/Zurueck | Nur wenn bekannt/konfiguriert. |
| Erneut laden | Nur bei potentiell temporaeren Fehlern. |
### Nicht zeigen
- Kein interner Form-Name, wenn Link/Tenant unsicher ist.
- Keine technischen Statuscodes.
- Keine Aussage, ob ein bestimmter Kunde/Tenant existiert, falls das Datenschutz-/Security-riskant ist.
## Aktionen
- Zur Anbieter-Website zurueck.
- Anbieter kontaktieren.
- Erneut laden.
## Banner / Hinweise
- Keine technischen Details.
- Keine Aussage, die interne Form-Namen oder IDs leakt.
## Toasts / Action-Feedback
- Keine Toasts.
## Meldungsentscheidung
| Ereignis | UI-Form | Blockiert? | Umsetzung | Copy/Notiz |
|---|---|---|---|---|
| Formular nicht veroeffentlicht | Screen | ja | Bauen | Dieses Formular ist aktuell nicht verfuegbar. |
| Formular geschlossen | Screen | ja | Bauen | Dnnahmezeitraum ist beendet. |
| Formular nicht gefunden | Screen | ja | Bauen | Link pruefen oder Anbieter kontaktieren. |
| Tenant nicht aufloesbar | Screen | ja | Bauen | Neutral, ohne interne Details. |
## Zustaende
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Nicht veroeffentlicht | Entwurf/Unpublished. | Bauen |
| Drchiviert/geschlossen | Keine Einreichung mehr moeglich. | Bauen |
| Nicht gefunden | Slug/Tenant passt nicht. | Bauen |
## Blockierende Error States
| Zustand | Was sieht der Nutzer? | Primaeraktion | Sekundare Aktion |
|---|---|---|---|
| Nicht verfuegbar | Ruhiger Public-Blocker. | Anbieter kontaktieren | Zurueck |
## Permissions / Gates
- Public Gate: `status=published` und `is_public=true`.
## Subframe
https://app.subframe.com/f023064a5ca0/design/f96ec12a-5e6a-471d-9a9c-6babcb57c74c/edit
## Notizen
Dieser Zustand ist wichtig fuer Vertrauen. Ein externes Formular darf nicht wie eine kaputte App wirken.
@@ -0,0 +1,117 @@
---
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/{tenant}/{slug}
subframe: "https://app.subframe.com/f023064a5ca0/design/95c96bc9-35d4-47ce-b510-7d8ea1f41936/edit"
---
# V03 - Public Captcha oder Submit Fehler
## Ziel
Der Submitter kann einen Captcha- oder Submit-Fehler verstehen und korrigieren, ohne Vertrauen in das Formular zu verlieren.
## Pattern / Archetyp
BESPOKE-Public Error / A7 Error-State.
## Daten
- Aktuelle Feldwerte sollen erhalten bleiben, soweit technisch moeglich.
- Captcha-Status.
- Dllgemeiner Submit-Status.
## Detail-Brainstorming
V03 ist kein eigener neuer Flow, sondern ein Public-Fehlerzustand von S02. Er wird gebaut, weil die Copy und das Vertrauen wichtig sind.
### Fehlerarten
| Fehler | Ort | UI | Werte behalten? |
|---|---|---|---|
| Captcha fehlt | Captcha-Bereich | Inline-Hinweis | ja |
| Captcha fehlgeschlagen | Captcha-Bereich oder Banner nah am Submit | Erneut pruefen | ja |
| Netzwerkfehler | Submit-Bereich | Banner + Retry | ja |
| Serverfehler vor Speicherung | Submit-Bereich | Banner + Retry | ja |
| Serverfehler nach Speicherung | Success bevorzugen, falls Speicherung sicher war | Nicht als Verlust darstellen | ja |
| Datei-Upload fehlgeschlagen | Datei-Feld | Inline + Datei erneut waehlen | andere Werte ja |
### Copy-Richtung
| Zustand | Copy |
|---|---|
| Captcha fehlt | "Bitte bestaetigen Sie die Sicherheitspruefung." |
| Captcha fehlgeschlagen | "Die Sicherheitspruefung konnte nicht bestaetigt werden. Bitte versuchen Sie es erneut." |
| Submit Fehler | "Das Formular konnte gerade nicht gesendet werden. Bitte versuchen Sie es erneut." |
| Wiederholter Fehler | "Wenn der Fehler bestehen bleibt, kontaktieren Sie bitte den Anbieter." |
| Datei-Fehler | "Diese Datei konnte nicht hochgeladen werden. Bitte pruefen Sie Typ und Groesse." |
### Retry-Regeln
| Regel | Grund |
|---|---|
| Eingaben erhalten | Lange Public-Formulare duerfen nicht neu ausgefuellt werden muessen. |
| Submit waehrend Retry sperren | Doppel-Submit verhindern. |
| Ersten Fehler sichtbar machen | Nutzer soll nicht suchen muessen. |
| Technische Details verstecken | Vertrauen bewahren. |
| Kontakt nur als Fallback | Nicht sofort vom Formular wegschicken. |
## Aktionen
- Captcha erneut bestaetigen.
- Formular erneut senden.
- Seite neu laden.
- Anbieter kontaktieren, falls Fehler bleibt.
## Banner / Hinweise
- Captcha-Fehler in der Naehe des Captcha-Bereichs.
- Submit-Fehler als Banner oberhalb des Submit-Bereichs.
- Keine internen Begriffe wie ActionLog, Webhook, DB oder Queue.
## Toasts / Action-Feedback
- Keine Toasts im Public UI.
## Meldungsentscheidung
| Ereignis | UI-Form | Blockiert? | Umsetzung | Copy/Notiz |
|---|---|---|---|---|
| Captcha fehlt | Inline beim Captcha | ja | Bauen | Bitte bestaetigen, dass Sie kein automatisierter Zugriff sind. |
| Captcha fehlgeschlagen | Inline/Banner | ja | Bauen | Bitte erneut versuchen. |
| Netzwerkfehler beim Submit | Banner | ja | Bauen | Einreichung konnte nicht gesendet werden. |
| Serverfehler nach Submit | Banner | ja | Bauen | Keine technischen Details, erneut versuchen. |
## Zustaende
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Captcha Error | Bot-Schutz blockiert. | Bauen |
| Submit Error | Speicherung/Einreichung klappt nicht. | Bauen |
| Retry Loading | Nutzer sendet erneut. | Wiederverwenden |
## Blockierende Error States
| Zustand | Was sieht der Nutzer? | Primaeraktion | Sekundare Aktion |
|---|---|---|---|
| Captcha fehlgeschlagen | Fehler am Captcha. | Captcha erneut pruefen | - |
| Submit mehrfach fehlgeschlagen | Banner mit Hilfehinweis. | Erneut versuchen | Anbieter kontaktieren |
## Permissions / Gates
- Public. Kein Login.
## Subframe
https://app.subframe.com/f023064a5ca0/design/95c96bc9-35d4-47ce-b510-7d8ea1f41936/edit
## Notizen
Wenn moeglich, sollen eingegebene Antworten erhalten bleiben. Das ist besonders wichtig bei langen SHK-Dufnahmeformularen mit Fotos oder Text.