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

252 lines
12 KiB
Markdown

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