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