252 lines
12 KiB
Markdown
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.
|