Files
HiveGrid-Wireframes/02 Wireframes/P2 Auth/WF-P2 Workspace Auswahl/WF-P2 Workspace Auswahl.md
T
2026-06-24 23:36:10 +02:00

12 KiB

kind, project, ticket, package, typ, status, subframe, canvas
kind project ticket package typ status subframe canvas
wireframe-package HiveGrid Screen Project D-P2 WF-P2 Workspace Auswahl Flow In Subframe https://app.subframe.com/f023064a5ca0/flow/08d4bebd-5db8-4ea8-ba59-270f88356f93/edit 02 Wireframes/P2 Auth/WF-P2 Workspace Auswahl/WF-P2 Workspace Auswahl.canvas

WF-P2 Workspace Auswahl

Status: In Subframe
Subframe-Link: https://app.subframe.com/f023064a5ca0/flow/08d4bebd-5db8-4ea8-ba59-270f88356f93/edit
Canvas: WF-P2 Workspace Auswahl.canvas
Stand: 2026-06-23


1. Kurzfassung

Dieses Paket nimmt den offenen Login-Punkt auf: Was passiert nach erfolgreicher Authentifizierung, wenn ein Admin oder eine berechtigte Person einen Workspace auswaehlen oder einen neuen Workspace anlegen soll?

Im UI wird der Begriff Workspace verwendet. Technisch kann das weiter dem Tenant-Modell entsprechen. Fuer Admins erscheint die Workspace-Auswahl immer, auch wenn aktuell nur ein Workspace verfuegbar ist. Einen Zustand ohne Workspace gibt es nicht: Signup/Setup erzeugt immer mindestens einen Workspace.


2. Intent Check

Frage Antwort
Welches Ticket/Modul ist betroffen? D-P2 Auth / Mandantentrennung
Was soll der Nutzer am Ende schaffen? richtigen Workspace auswaehlen oder einen neuen Workspace anlegen
Ist es ein Flow, einzelner Screen, Zustand oder nur Dokumentation? kleiner Post-Login-Flow
Welche Planning-Quellen wurden geprueft? D-P2, SCREEN-MAP §1 Auth-Screens
Was ist sicher im Scope? Workspace-Auswahl fuer Admins/berechtigte Rollen, letzte 5 Workspaces, Suche, neuen Workspace anlegen, Info-I zu Workspace, App-Shell-Dropdown "Workspace wechseln"
Was ist sicher nicht im Scope? App-Dashboard, Plattform-Admin, Zustand ohne Workspace
Gibt es Admin/Normalrolle-Unterschiede? Ja: Admins und berechtigte Rollen sehen Workspace-Auswahl/Wechsel; normale Nutzer ohne Recht nicht
Welche Annahmen sind noch unsicher? ob Template-Auswahl sichtbar vorbereitet wird oder nur im Backlog bleibt

3. Scope

Punkt Inhalt
Ticket/Modul D-P2 Auth
Nutzerrolle eingeloggter Nutzer nach Login/2FA
Admin-Variante sieht die Workspace-Auswahl immer, inklusive letzter 5 Workspaces, Suche, Neu-anlegen-CTA und Info-I
Berechtigte Rolle kann in der App-Shell ueber Dropdown "Workspace wechseln" oeffnen
Normale Rolle sieht keinen Workspace-Wechsel, wenn kein Recht vorhanden ist
Startpunkt nach Login/2FA fuer Admins; in der App-Shell ueber Workspace-Dropdown fuer Admins/berechtigte Rollen
Ziel aktiven Workspace setzen, wechseln oder neuen Workspace anlegen
Haupt-Archetyp A2 List-View light + Auth-Shell
Bespoke-Anteil nein
Out of scope Plattform-Admin, Zustand ohne Workspace, vollstaendiger Workspace-Settings-Bereich

4. Brainstorming

Flow-Frage

Braucht Workspace-Auswahl immer einen Screen oder nur bei Mehrdeutigkeit?

UX-Varianten

Option Beschreibung Vorteil Nachteil Empfehlung
A Fuer Admins immer anzeigen; fuer berechtigte Rollen per App-Shell-Dropdown; normale Nutzer ohne Recht sehen keinen Wechsel Admin-Kontext bleibt klar, Standardnutzer werden nicht unnoetig gebremst Rechte-Gate muss dokumentiert werden genommen
B Immer fuer alle Nutzer nach Login anzeigen sehr explizit zu viel Reibung fuer normale Single-Workspace-Nutzer raus
C Workspace-Auswahl nur in der Topbar, nie Post-Login App bleibt schlank Admin-Start nach Login bleibt unklar raus

Entscheidung

Entscheidung Status Notiz
Workspace als UI-Begriff genommen Tenant bleibt technischer Begriff; im Screen steht Workspace
Admins sehen Workspace-Auswahl immer genommen auch wenn Admin aktuell nur einen Workspace hat
Berechtigte Rollen koennen Workspace in der App-Shell wechseln genommen Dropdown in der Shell, wenn Recht vorhanden
Normale Nutzer ohne Recht sehen keinen Workspace-Wechsel genommen Auswahl/Dropdown ist permission-gated
Zustand ohne Workspace raus Signup/Setup erzeugt immer mindestens einen Workspace
Letzte 5 Workspaces anzeigen genommen schneller Einstieg fuer Admins mit mehreren Workspaces
Suchfeld anbieten genommen ab mehreren Workspaces relevant
Neuen Workspace anlegen als Mikroflow genommen Admin kann von hier einen neuen Workspace starten
Info-I erklaert Workspace genommen kurzer Tooltip/Popover: was ein Workspace ist und was dazugehort
Gesperrter Workspace genommen kein eigener Screen; beim Oeffnungsversuch erscheint ein Toast
Neuer Workspace angelegt genommen direkter Wechsel in neuen Workspace mit Toast; kein eigener Screen

Happy Path

  1. Nutzer hat Login/2FA abgeschlossen.
  2. Admin sieht die Workspace-Auswahl.
  3. Die letzten 5 Workspaces werden angezeigt.
  4. Admin sucht oder waehlt einen Workspace.
  5. App startet im gewaehlten Workspace.

Mikroflow neuer Workspace:

  1. Admin klickt Neuen Workspace anlegen.
  2. Admin gibt die minimalen Workspace-Daten ein.
  3. System legt Workspace an.
  4. Admin landet direkt im neuen Workspace und sieht einen Erfolgstoast.

Varianten / Branches

  • Admin hat genau einen Workspace: Auswahl erscheint trotzdem.
  • Admin hat mehrere Workspaces: letzte 5 + Suche decken den Fall ab.
  • Admin will neuen Workspace anlegen: Mikroflow startet aus S01.
  • Berechtigte Rolle oeffnet Workspace-Wechsel aus der App-Shell.
  • Workspace ist gesperrt, frozen oder suspended: beim Oeffnungsversuch erscheint ein Toast; kein eigener Screen.
  • Nutzer hat sehr viele Workspaces: Suche und zuletzt genutzt werden wichtig.

Roadblocks

  • alle Workspaces gesperrt
  • Permission entzogen nach Login
  • Workspace-Auswahl-Fehler
  • Workspace-Anlage fehlgeschlagen

Meldungs-/Error-State-Brainstorming

Ereignis UI-Form Blockiert? Bauen? Copy/Notiz
Admin nach Login Screen nein ja Auswahl erscheint immer fuer Admin
Mehrere Workspaces Screen nein ja letzte 5 + Suche
Ein Workspace, Admin Screen nein ja trotzdem Auswahl anzeigen
Workspace wechseln aus App-Shell Dropdown/Screen nein ja nur fuer Admins/berechtigte Rollen
Ein Workspace, normale Rolle ohne Recht Redirect/kein Dropdown nein nein nur dokumentieren
Neuen Workspace anlegen Mikroflow ja ja sehr simples Formular, Details spaeter in Workspace-Einstellungen
Workspace gesperrt/frozen Toast ja nein erscheint beim Versuch, den Workspace zu oeffnen
Auswahl fehlgeschlagen Banner ja nein Retry reicht
Workspace-Anlage fehlgeschlagen Banner ja nein Retry/Support
Was ist ein Workspace? Info-Popover nein nein Info-I im Screen

5. Screen-Kandidaten nach Entscheidung

Kandidat Warum eventuell noetig? Erste Einschaetzung
Workspace Auswahl Hauptscreen fuer Admins und Mehr-Workspace-Nutzer Bauen
Workspace wechseln aus App-Shell Einstieg fuer Admins/berechtigte Rollen innerhalb der App In S01 dokumentieren
Neuen Workspace anlegen eigener kurzer Anlage-Moment Bauen
Neuer Workspace angelegt Erfolg + Wechsel in neuen Workspace Nur dokumentieren
Workspace gesperrt/suspended erklaert blockierten Zugriff Nur dokumentieren
Workspace-Info Info-I / Popover im Hauptscreen In S01 integrieren
Ohne Workspace kein moeglicher Zustand Raus
Single-Workspace Redirect fuer normale Rolle ohne Recht kein eigener Arbeitsmoment Nur dokumentieren

6. Screen Validation Gate

ID Screen/Zustand Ist eigener Arbeitsmoment? Neue Struktur/Entscheidung/Risiko? Entscheidung Begruendung
S01 Workspace Auswahl ja ja, Post-Login-Entscheidung fuer Admins Bauen Admins sehen Auswahl immer; letzte 5, Suche, Neu-CTA, Info-I
S02 Neuer Workspace anlegen ja ja, eigener Mikroflow Bauen Admin braucht einen klaren Anlage-Einstieg
S03 Neuer Workspace angelegt nein nein, Toast/Redirect reicht Nur dokumentieren direkt in neuen Workspace wechseln und Toast anzeigen
V01 Workspace gesperrt/suspended nein nein, Toast reicht Nur dokumentieren beim Oeffnungsversuch Toast anzeigen
D01 Ohne Workspace nein nein Raus Signup/Setup erzeugt immer einen Workspace
D02 Genau ein Workspace, normale Rolle ohne Recht nein nein Nur dokumentieren direkte Weiterleitung / kein Dropdown
D03 Workspace-Info nein ja, Erklaerung In S01 integrieren Info-I/Tooltip/Popover
D04 App-Shell Workspace-Dropdown nein ja, Navigation/Gate Nur dokumentieren Einstieg fuer Admins/berechtigte Rollen

Copy-kritische Zustaende

Zustand Bauen? Warum / Copy-Entscheidung
Workspace gesperrt nein Toast reicht; muss Status erklaeren ohne Rohsystemsprache
Workspace-Info nein Info-I reicht; Inhalt muss trotzdem formuliert werden
Neuer Workspace angelegt nein direkter Wechsel + Toast reicht

Blockierende Error States

Zustand UI-Form Primaeraktion Sekundare Aktion Inhalt/Copy-Richtung
Workspace gesperrt Toast anderen Workspace waehlen Admin kontaktieren konkreter Status, keine Interna
Workspace-Anlage fehlgeschlagen Banner erneut versuchen abbrechen/Support keine Rohfehler

Neuer Workspace: Daten-Outline

Der Flow soll bewusst simpel bleiben. Details werden spaeter in Workspace-Einstellungen gepflegt.

Feld Pflicht? Notiz
Workspace-Name ja sichtbarer Name in Auswahl/App-Shell
Workspace-Slug/URL-Kuerzel ja, mit Vorschlag aus Name generieren, editierbar, Reserved Words blocken
Organisations-/Firmenname optional nur falls abweichend; sonst spaeter in Workspace-Einstellungen
Template-Auswahl optional/Platzhalter vorbereitet, obwohl noch keine Templates existieren; kann auch Backlog bleiben
Logo/Avatar spaeter in Workspace-Einstellungen
USt-ID/Rechnungsdaten spaeter in Workspace-Einstellungen/Billing
Mitglieder einladen/erstellen spaeter in Workspace-Einstellungen bzw. Admin-User-Flow
Rechtliches/AVV spaeter/Reuse Signup nicht erneut im Workspace-Anlageflow
Standort/Land raus alles Deutschland; nicht im Anlageflow
Zeitzone raus alles Deutschland; nicht im Anlageflow

V1-Minimum fuer den Screen:

  1. Workspace-Name.
  2. Slug/URL-Kuerzel mit Vorschlag.
  3. Optional Organisations-/Firmenname, falls abweichend.
  4. Optional Template-Auswahl als vorbereiteter Platzhalter oder Backlog.

7. Validierte Screen-Liste

Noch nicht validiert.

ID Screen/Zustand Typ Umsetzung Ort Status
S01 Screens/S01 Workspace Auswahl Auth List Bauen nach Login/2FA fuer Admins Validiert
S02 Screens/S02 Neuer Workspace anlegen Auth Form Bauen von S01 oder App-Shell-Dropdown Validiert
D05 Neuer Workspace angelegt Toast/Redirect Nur dokumentieren nach S02 Validiert
V01 Workspace gesperrt/suspended Toast Nur dokumentieren beim Oeffnungsversuch Validiert

8. Subframe-Grid

Login/2FA Admin -> S01 Workspace Auswahl -> App
Login/2FA normale Rolle mit mehreren Workspaces -> S01 Workspace Auswahl -> App
Login/2FA normale Rolle mit einem Workspace -> App
S01 Workspace Auswahl -> S02 Neuer Workspace anlegen -> App im neuen Workspace + Toast
App-Shell Workspace-Dropdown -> S01 Workspace Auswahl
S01 Workspace Auswahl -> Toast Workspace gesperrt/suspended

9. Screen-Pakete


10. Handoff-Check

  • Offener Login-Punkt ist als eigenes Paket erfasst.
  • Brainstorm-Entscheidung Admin/Workspace ist dokumentiert.
  • Screen-Kandidaten sind gesammelt.
  • Blockierende Zustaende sind definiert.
  • UI-Label Workspace ist geklaert.
  • Ohne-Workspace-Zustand ist rausgenommen.
  • Neuer-Workspace-Mikroflow ist als Kandidat aufgenommen.
  • David hat die Kandidaten validiert.
  • Subframe-Link ist eingetragen.