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
+268
@@ -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.
|
||||
Reference in new issue
Block a user