Initial wireframe planning

This commit is contained in:
david committed 2026-06-24 23:36:10 +02:00
commit 7ac52911fd
82 files changed
+8105

No files matched your search

@@ -0,0 +1,65 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P2
package: WF-P2 Admin RBAC
id: D01
screen: Rollen-Dropdown in Mitarbeiterliste
typ: Inline-Zustand
umsetzung: Nur dokumentieren
status: In Subframe
route: in S01
subframe: "https://app.subframe.com/f023064a5ca0/design/80f691a7-e8a9-4502-be74-69795066e105/edit"
---
# D01 - Rollen-Dropdown in Mitarbeiterliste
## Ziel
Der Admin kann die Rolle eines Mitarbeiters direkt in der Liste aendern und bei Bedarf zur Rollenverwaltung springen.
## Pattern / Archetyp
Inline Select / Dropdown in Tabelle.
## Daten
- aktuelle Rolle(n) des Mitarbeiters
- verfuegbare Rollen
- Rolle `Admin`
- Rollen, die wegen Policy nicht gesetzt oder entfernt werden duerfen
## Aktionen
- Rolle auswaehlen
- `Rollen und Berechtigungen bearbeiten` -> S02
- Dropdown schliessen
## Verhalten
- Dropdown zeigt aktuelle Rolle und verfuegbare Rollen.
- Unterhalb der Rollen steht ein Eintrag `Rollen und Berechtigungen bearbeiten`.
- Dieser Eintrag navigiert zu `Settings -> Mitarbeiter`, Tab `Rollen und Berechtigungen`.
- Wenn ein Rollenwechsel den letzten Admin entfernen wuerde, wird V01 genutzt.
## Zustaende
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Standard | Rollen auswahlen | Nur dokumentieren |
| Speichern | Rollenwechsel wird gespeichert | Wiederverwenden |
| Keine Berechtigung | Dropdown disabled oder nicht sichtbar | Nur dokumentieren |
| Letzter Admin | Rollenwechsel blockiert | V01 |
## Permissions / Gates
- Rollenwechsel braucht Rollen-/Mitarbeiter-Berechtigung.
- Technische Admin-Schutzregeln koennen Rollenwechsel blockieren.
## Subframe
-
## Notizen
Kein separates Rollen-Modal aus der Mitarbeiterliste. Rollen bearbeiten passiert in S02/M02.
@@ -0,0 +1,59 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P2
package: WF-P2 Admin RBAC
id: D03
screen: Rolle in Nutzung blockiert
typ: Admin Blocker
umsetzung: Nur dokumentieren
status: In Subframe
route: von S02/M02
subframe: "https://app.subframe.com/f023064a5ca0/design/99f96d31-4cb5-4d7c-a252-3f8bef9f1b59/edit"
---
# D03 - Rolle in Nutzung blockiert
## Ziel
Der Admin versteht, warum eine Rolle nicht geloescht werden kann.
## Pattern / Archetyp
Kleines Blocker-Modal / Inline-Blocker.
## Daten
- Rolle
- Anzahl zugewiesener Mitarbeiter
## Aktionen
- `Verstanden`
- Modal schliessen
## Inhalt / Copy-Richtung
Headline: `Rolle kann nicht geloescht werden`
Text: `Diese Rolle kann nicht geloescht werden, solange Mitarbeiter zugewiesen sind. Weise die Mitarbeiter zuerst manuell einer anderen Rolle zu.`
## Zustaende
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Rolle in Nutzung | Loeschen wird blockiert | Nur dokumentieren |
| Rolle ohne Mitglieder | Loeschen ist moeglich | Nur dokumentieren |
## Permissions / Gates
- Loeschen ist nur fuer berechtigte Admins sichtbar.
- Rolle `Admin` hat keine Loeschen-Aktion.
## Subframe
-
## Notizen
Ersatzrolle waehlen und Bulk-Reassign sind Backlog/V2.
@@ -0,0 +1,71 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P2
package: WF-P2 Admin RBAC
id: M01
screen: Mitarbeiter einladen
typ: Modal
umsetzung: Bauen
status: In Subframe
route: von S01
subframe: "https://app.subframe.com/f023064a5ca0/design/0338fed6-2624-4e92-9d42-0b959fafe8c2/edit"
---
# M01 - Mitarbeiter einladen
## Ziel
Der Admin laedt einen neuen Mitarbeiter in den Workspace ein und weist direkt die passende Rolle zu.
## Pattern / Archetyp
A5 Modal / Invite Form.
## Daten
- E-Mail-Adresse, Pflichtfeld
- optional Name
- optional Abteilung
- Rolle, Pflichtauswahl mit Default/Seed-Rollen
- aktueller Workspace
## Aktionen
- Einladung senden
- abbrechen / Modal schliessen
- Rolle auswaehlen
## Layout / Inhalt
1. Headline `Mitarbeiter einladen`.
2. Hinweis, dass die Einladung fuer den aktuellen Workspace gilt.
3. Felder: E-Mail, Name optional, Abteilung optional, Rolle.
4. Aktionen: `Einladung senden`, `Abbrechen`.
## Toasts / Action-Feedback
- Erfolg: Toast `Einladung wurde gesendet`.
- Danach zurueck zu S01; Nutzer erscheint mit Status `Eingeladen`.
## Zustaende
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Leer | Pflichtfelder leer | Bauen |
| Validierungsfehler | E-Mail fehlt/ungueltig, Rolle fehlt | Bauen |
| Einladung existiert | Hinweis mit Option erneut senden | Nur dokumentieren |
| Laden | Einladung wird gesendet | Wiederverwenden |
| Fehler | Einladung konnte nicht gesendet werden | Nur dokumentieren |
## Permissions / Gates
- Admin oder Rolle mit Mitarbeiter-einladen-Berechtigung.
## Subframe
- Umsetzung als echtes Subframe-Modal mit `DialogLayout`-Root, nicht als nachgebautes Overlay ueber einer duplizierten Mitarbeiterliste.
## Notizen
Kein eigener Fullscreen. Der Invite bleibt ein kompaktes Modal aus der Mitarbeiterliste.
@@ -0,0 +1,92 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P2
package: WF-P2 Admin RBAC
id: M02
screen: Rolle erstellen/bearbeiten
typ: Grosses Modal
umsetzung: Bauen
status: In Subframe
route: von S02
subframe: "https://app.subframe.com/f023064a5ca0/design/3d51deee-0d41-456f-a507-ccfc284e6e0a/edit"
---
# M02 - Rolle erstellen/bearbeiten
## Ziel
Der Admin erstellt eine eigene Rolle oder bearbeitet eine vorhandene/Seed-Rolle und sieht, wie Berechtigungen pro Bereich gesetzt werden.
## Pattern / Archetyp
Grosses Modal / Role Editor.
## Daten
- Rollenname
- Beschreibung
- Typ: Systemrolle, Seed-Rolle, Eigene Rolle
- optional Vorlage
- Permission-Bereiche als Arbeitsgeruest
- konkrete Permission-Zeilen nach Beispielmuster
## Aktionen
- speichern
- abbrechen / Modal schliessen
- Rolle loeschen, wenn erlaubt
- Permission-Auswahl aendern
- Permission suchen
- Sidebar-Bereich oeffnen
## Layout / Inhalt
1. Grosses Modal ueber S02, mit Schliessen-Icon.
2. Kopfbereich mit Rollenname, Beschreibung und optional Vorlage.
3. Globale Suche ueber alle Permissions.
4. Linke Sidebar mit Bereichen: Ueberblick, Mitarbeiter, Rollen und Berechtigungen, Workspace Settings, Abrechnung, Audit & Sicherheit, Integrationen/API, CRM/Kunden, Leads/Vertrieb, Projekte/Auftraege, Aufgaben/Dateien, Kommunikation/Support.
5. Startzustand `Ueberblick`: scrollbare Liste aller Bereiche und Permissions.
6. Footer mit `Speichern` und `Abbrechen`.
## Permission-Zeilenmuster
Eine Permission wird konkret vorgebaut, damit das Muster klar ist:
| Element | Inhalt |
|---|---|
| Ueberschrift | `Mitarbeiter ansehen` |
| Beschreibung | `Darf Mitarbeiterliste und Mitarbeiterprofile im Workspace lesen.` |
| Control | Segmented Control `Aus`, `Read-only`, `Bearbeiten` |
Verhalten:
- `Aus`: kein Zugriff.
- `Read-only`: lesen, aber nicht bearbeiten.
- `Bearbeiten`: lesen und aendern.
- Binaere Permissions koennen spaeter als einfacher Toggle `Aus/An` umgesetzt werden.
- Weitere Permissions werden Development-seitig nach diesem Muster ergaenzt.
## Zustaende
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Neue Rolle | leere Felder + Permission-Auswahl | Bauen |
| Rolle bearbeiten | vorhandene Werte vorausgefuellt | Bauen |
| Seed-Rolle bearbeiten | Seed-Rolle ist editierbar | Bauen |
| Admin-Rolle | kritische Felder/Loeschen geschuetzt | Nur dokumentieren |
| Rollenname existiert | Inline-Fehler am Namen | Nur dokumentieren |
| Rolle in Nutzung loeschen | Loeschen blockiert | D03 |
## Permissions / Gates
- Nur Admins oder Rollen mit Rollen-/Berechtigungsverwaltung.
- Systemrolle `Admin` darf nicht geloescht werden.
## Subframe
- Umsetzung als echtes grosses Subframe-Modal mit `DialogLayout` + `Dialog.Content`, nicht als freie Page-Shell.
## Notizen
Die Permission-Bundles sind fuer v1 ein Arbeitsgeruest, kein finaler Rechtekatalog. Wichtig ist das UI-Muster und der Einstieg fuer Development.
@@ -0,0 +1,71 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P2
package: WF-P2 Admin RBAC
id: M03
screen: Mitarbeiter deaktivieren
typ: Confirm Modal
umsetzung: Bauen
status: In Subframe
route: von S01
subframe: "https://app.subframe.com/f023064a5ca0/design/11e3f3dc-451b-4abb-aedf-3aad63704c51/edit"
---
# M03 - Mitarbeiter deaktivieren
## Ziel
Der Admin bestaetigt bewusst, dass ein Mitarbeiter keinen Zugriff mehr auf den Workspace haben soll.
## Pattern / Archetyp
A5 Confirm-Modal.
## Daten
- Name des Mitarbeiters
- E-Mail des Mitarbeiters
- aktueller Status
- ob der Mitarbeiter letzter Admin ist
## Aktionen
- `Deaktivieren`
- `Abbrechen`
- Modal schliessen
## Layout / Inhalt
1. Headline `Mitarbeiter deaktivieren?`
2. Name und E-Mail des Mitarbeiters.
3. Kurzer Hinweis: Nach der Deaktivierung hat der Mitarbeiter keinen Zugriff mehr auf den Workspace.
4. Hinweis: Der Mitarbeiter bleibt in der Liste mit Status `Deaktiviert` sichtbar.
5. Aktionen: Danger-Button `Deaktivieren`, sekundar `Abbrechen`.
## Toasts / Action-Feedback
- Erfolg: Toast `Mitarbeiter wurde deaktiviert`.
- S01 zeigt danach Status `Deaktiviert`.
## Zustaende
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Confirm | kurze Sicherheitsfrage | Bauen |
| Laden | Deaktivierung wird gespeichert | Wiederverwenden |
| Letzter Admin | Aktion wird blockiert | V01 |
| Fehler | Deaktivierung fehlgeschlagen | Nur dokumentieren |
## Permissions / Gates
- Nur Admins oder Rollen mit Mitarbeiter-deaktivieren-Berechtigung.
- Letzter Admin darf nicht deaktiviert werden.
## Subframe
- Umsetzung als echtes Subframe-Confirm-Modal mit `DialogLayout`-Root, ohne duplizierte Mitarbeiterliste oder manuell nachgebauten Overlay-Hintergrund.
## Notizen
Kein Reassign in v1. Offene Verantwortlichkeiten bleiben Backlog/V2.
@@ -0,0 +1,78 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P2
package: WF-P2 Admin RBAC
id: S01
screen: Mitarbeiterliste
typ: Admin List
umsetzung: Bauen
status: In Subframe
route: Settings -> Mitarbeiter, Tab Mitarbeiter
subframe: "https://app.subframe.com/f023064a5ca0/design/a9571d72-15e0-4897-968b-1f700ee4bfbc/edit"
---
# S01 - Mitarbeiterliste
## Ziel
Der Admin findet Mitarbeiter schnell, prueft Rollen/Status und startet Einladung, Rollenaenderung oder Deaktivierung.
## Pattern / Archetyp
A2 List + A6 Settings.
## Daten
- Mitarbeiter: Avatar, Name, E-Mail, Telefonnummer optional
- Abteilung
- aktuelle Rolle(n)
- Status: Aktiv, Eingeladen, Deaktiviert
- 2FA-Status
- verfuegbare Rollen fuer das Rollen-Dropdown
## Aktionen
- `Mitarbeiter einladen` -> M01
- Rolle direkt in der Tabellenzeile aendern -> D01
- `Rollen und Berechtigungen bearbeiten` -> S02
- Zeilenaktion `Deaktivieren` -> M03
- ggf. `Einladung erneut senden`
## Layout / Inhalt
1. Header `Mitarbeiter` mit primaerem CTA `Mitarbeiter einladen`.
2. Tabs innerhalb `Settings -> Mitarbeiter`: `Mitarbeiter`, `Rollen und Berechtigungen`.
3. Toolbar mit Suche nach Name, E-Mail und Telefonnummer.
4. Filter: Rolle, Abteilung, Status, 2FA.
5. Tabelle mit Spalten: Mitarbeiter, Abteilung, Rolle, Status, 2FA, Aktionen.
6. Aktionen rechts als 3-Punkte-Menue.
## Toasts / Action-Feedback
- Einladung gesendet: Toast.
- Rolle geaendert: kurzer Toast oder Inline-Saved-State.
- Mitarbeiter deaktiviert: Toast nach M03.
## Zustaende
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Standard | Mitarbeiterliste mit Suche, Filtern und Tabelle | Bauen |
| Keine Treffer | Suche/Filter ergibt keine Ergebnisse | Bauen |
| Eingeladener Nutzer | Status `Eingeladen`, ggf. `Einladung erneut senden` | Nur dokumentieren |
| Deaktivierter Nutzer | Status `Deaktiviert`, bleibt sichtbar | Bauen |
| Letzter Admin betroffen | kritische Aktion blockieren | V01 |
## Permissions / Gates
- Nur Admins oder Rollen mit entsprechender Mitarbeiter-/RBAC-Berechtigung.
- Normale Nutzer sehen diesen Settings-Bereich nicht.
## Subframe
-
## Notizen
Reassign offener Aufgaben ist nicht Teil von v1. Deaktivieren bleibt ein kleiner Confirm-Flow.
@@ -0,0 +1,78 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P2
package: WF-P2 Admin RBAC
id: S02
screen: Rollen und Berechtigungen
typ: Settings Subpage
umsetzung: Bauen
status: In Subframe
route: Settings -> Mitarbeiter, Tab Rollen und Berechtigungen
subframe: "https://app.subframe.com/f023064a5ca0/design/87c24709-4f22-4181-8543-e21ff169c4d5/edit"
---
# S02 - Rollen und Berechtigungen
## Ziel
Der Admin verwaltet Systemrolle, Seed-Rollen und eigene Rollen in einer kompakten Rollen-Tabelle.
## Pattern / Archetyp
A2 List + A6 Settings.
## Daten
- Rollenliste
- Typ: Systemrolle, Seed-Rolle, Eigene Rolle
- Beschreibung
- Mitgliederanzahl / Avatar-Stack
- Status: Aktiv, Pruefen
- Permission-Bundles als Arbeitsgeruest
## Aktionen
- `Rolle anlegen` -> M02
- Zeilenaktion `Bearbeiten` -> M02
- Zeilenaktion `Duplizieren` -> M02 mit kopierter Rolle
- Zeilenaktion `Loeschen`
- bei Rolle in Nutzung -> D03
## Layout / Inhalt
1. Header `Rollen und Berechtigungen` mit CTA `Rolle anlegen`.
2. Toolbar mit Suche nach Rollenname und Beschreibung.
3. Filter: Typ, Permission-Bundle, In Nutzung.
4. Tabelle mit Spalten: Rolle, Beschreibung, Typ, Mitglieder, Status, Aktionen.
5. Aktionen rechts pro Zeile als 3-Punkte-Menue.
6. Nur eine sichtbare Systemrolle: `Admin`.
## Rollen / Beispiele
- Admin als einzige Systemrolle.
- Seed-Rollen: Geschaeftsfuehrer, Projektleiter, Verwaltung, Vertriebler, Kundensupporter, Monteur.
- Eigene Rollen koennen frei benannt werden.
## Zustaende
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Standard | Rollen-Tabelle mit Suche/Filtern | Bauen |
| Keine Treffer | Suche/Filter ohne Ergebnis | Bauen |
| Admin-Rolle | Systemrolle ohne Loeschen-Aktion | Bauen |
| Rolle ohne Mitglieder loeschen | Loeschen moeglich mit Confirm/Pattern | Nur dokumentieren |
| Rolle in Nutzung | Loeschen blockiert | D03 |
## Permissions / Gates
- Nur Admins oder Rollen mit Rollen-/Berechtigungsverwaltung.
- Normale Nutzer sehen diesen Tab nicht.
## Subframe
-
## Notizen
Die Tabelle orientiert sich am validierten Referenzbild: klare Settings-Sidebar, Rollenliste, Mitglieder-Spalte, Status, 3-Punkte-Menue.
@@ -0,0 +1,61 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P2
package: WF-P2 Admin RBAC
id: V01
screen: Letzter Admin blockiert
typ: Admin Blocker
umsetzung: Nur dokumentieren
status: In Subframe
route: von S01/M03/Rollenwechsel
subframe: "https://app.subframe.com/f023064a5ca0/design/3e05bfb3-3842-4008-964e-f4c68dea0d9e/edit"
---
# V01 - Letzter Admin blockiert
## Ziel
Das System verhindert, dass ein Workspace ohne Admin bleibt.
## Pattern / Archetyp
Blocker-State im jeweiligen Kontext.
## Ausloeser
- letzter Admin soll deaktiviert werden
- letzter Admin soll seine Admin-Rolle verlieren
- Rollenwechsel wuerde dazu fuehren, dass kein Admin mehr existiert
## Aktionen
- `Verstanden`
- ggf. weiteren Admin bestimmen, wenn spaeter vorhanden
- abbrechen
## Inhalt / Copy-Richtung
Headline: `Letzter Admin kann nicht entfernt werden`
Text: `Dieser Workspace braucht mindestens einen Admin. Weise zuerst einem anderen Mitarbeiter die Admin-Rolle zu.`
## Zustaende
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Deaktivieren blockiert | M03 kann nicht ausgefuehrt werden | Nur dokumentieren |
| Rollenwechsel blockiert | D01 speichert nicht | Nur dokumentieren |
| Erweiterter Admin-Schutz | genauere Policy spaeter | Backlog |
## Permissions / Gates
- Greift unabhaengig davon, ob der ausloesende Nutzer grundsaetzlich Adminrechte hat.
## Subframe
-
## Notizen
Der konkrete Policy-Feinschliff fuer Selbst-Deaktivierung und kritische Rollenwechsel bleibt Backlog/V2.