--- kind: wireframe-package project: HiveGrid Screen Project ticket: D-P2 package: WF-P2 Workspace Auswahl typ: Flow status: In Subframe subframe: "https://app.subframe.com/f023064a5ca0/flow/08d4bebd-5db8-4ea8-ba59-270f88356f93/edit" canvas: "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 ```text 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 - [[Screens/S01 Workspace Auswahl]] - [[Screens/S02 Neuer Workspace anlegen]] --- ## 10. Handoff-Check - [x] Offener Login-Punkt ist als eigenes Paket erfasst. - [x] Brainstorm-Entscheidung Admin/Workspace ist dokumentiert. - [x] Screen-Kandidaten sind gesammelt. - [x] Blockierende Zustaende sind definiert. - [x] UI-Label Workspace ist geklaert. - [x] Ohne-Workspace-Zustand ist rausgenommen. - [x] Neuer-Workspace-Mikroflow ist als Kandidat aufgenommen. - [x] David hat die Kandidaten validiert. - [ ] Subframe-Link ist eingetragen.