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