Files
HiveGrid-Wireframes/02 Wireframes/D-FORM Formulare/WF-D-FORM Form Builder/Screens/07 S04 Oeffentliches Formular.md
T
2026-07-09 21:38:28 +02:00

12 KiB

kind, project, ticket, package, id, screen, typ, umsetzung, status, route, subframe
kind project ticket package id screen typ umsetzung status route subframe
screen HiveGrid Screen Project D-FORM WF-D-FORM Form Builder S04 Oeffentliches Formular Public Form Bauen Subframe Draft / Review offen /f/{tenant}/{slug} 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.