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