chore(repo): sync wireframe structure and references

This commit is contained in:
david committed 2026-08-08 03:09:06 +02:00
1 parent 05d2d5777f
commit d953a79e95
453 files changed
+36639 -621

No files matched your search

@@ -0,0 +1,82 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P2
package: WF-P2 Profil und Sicherheit
id: S01
screen: Profil Settings
typ: Settings
umsetzung: Bauen
status: In Subframe
route: /settings/profile
subframe: "https://app.subframe.com/f023064a5ca0/design/a99149bf-0e1c-4ba9-ac90-9ac316197e28/edit"
---
# S01 — Profil Settings
## Ziel
Der Nutzer pflegt seine Profilinformationen und startet bei Bedarf die getrennten Sicherheitsflows fuer Passwort und 2FA.
## Pattern / Archetyp
A6 Settings / Profilformular.
Subframe-Basis: `Default Page Layout with inner Sidebar` + `Settings Page` mit Subcomponents (`SectionHeader`, `NeutralCard`, `SettingRow`, `Divider`).
Aktuelle visuelle Richtung: Account-Settings-Layout mit `Basic info` links, `Account security` rechts und `Login info` als breite Karte darunter. In `Basic info` stehen Profilfelder links und Profilbild rechts.
## Daten
- Avatar
- Name
- Telefonnummer
- Abteilung
- Rolle, read-only
- Account-E-Mail, read-only in Login info
- 2FA-Status
## Aktionen
- Profil speichern
- Avatar aendern
- Passwort aendern -> `WF-P2 Change Password`
- 2FA verwalten -> `WF-P2 2FA Verwalten`
## Banner / Hinweise
- Rolle ist read-only und wird durch Admin zugewiesen.
- Keine Theme- oder Bio-Felder in diesem Screen.
## Toasts / Action-Feedback
- Profil gespeichert: Toast.
- Avatar-Upload fehlgeschlagen: Inline/Banner mit Retry.
## Zustaende
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Normal | Profilfelder sichtbar | Bauen |
| Speichern | Button loading | Wiederverwenden |
| Profil gespeichert | Erfolgstoast | Nur dokumentieren |
| Avatar-Upload fehlgeschlagen | Inline/Banner | Nur dokumentieren |
| Flow nicht erreichbar | Passwort-/2FA-Flow kann nicht gestartet werden | Nur dokumentieren |
## Permissions / Gates
- Nutzer ist eingeloggt.
- Rolle wird nur angezeigt und kann nicht selbst geaendert werden.
## Subframe
https://app.subframe.com/f023064a5ca0/design/a99149bf-0e1c-4ba9-ac90-9ac316197e28/edit
## Notizen
Theme und Bio sind bewusst nicht Teil dieses Profil-Screens. Security/Sessions bleibt spaeter.
Die Sicherheitsaktionen sind Trigger zu eigenen Flows, keine eingebetteten Unterseiten:
- Passwort aendern -> `WF-P2 Change Password`
- 2FA verwalten -> `WF-P2 2FA Verwalten`
@@ -0,0 +1,16 @@
{
"nodes":[
{"id":"group-main","type":"group","x":-80,"y":-100,"width":1900,"height":420,"label":"Profil Settings"},
{"id":"group-notes","type":"group","x":-80,"y":560,"width":1700,"height":360,"label":"Trigger und Spaeter"},
{"id":"s01","type":"file","file":"02 Wireframes/P2 Profil und Sicherheit/WF-P2 Profil und Sicherheit/Screens/S01 Profil Settings.md","x":0,"y":0,"width":420,"height":200},
{"id":"change-password","type":"file","file":"02 Wireframes/P2 Change Password/WF-P2 Change Password/WF-P2 Change Password.md","x":640,"y":0,"width":420,"height":200},
{"id":"manage-2fa","type":"file","file":"02 Wireframes/P2 2FA Verwalten/WF-P2 2FA Verwalten/WF-P2 2FA Verwalten.md","x":1280,"y":0,"width":420,"height":200},
{"id":"note-fields","type":"text","text":"# Profilfelder\n\nEditierbar: Avatar, Name, Telefonnummer, Abteilung.\n\nRead-only: Rolle, wird durch Admin zugewiesen.\n\nRaus: Theme, Bio.","x":0,"y":680,"width":420,"height":220},
{"id":"note-security","type":"text","text":"# Security\n\nProfil besitzt keine Passwort- oder 2FA-Screens.\n\nPasswort aendern und 2FA verwalten starten eigene validierte Flows.","x":540,"y":680,"width":420,"height":220},
{"id":"note-later","type":"text","text":"# Spaeter\n\nSecurity/Sessions, Trust Devices und Ueberall abmelden bleiben fuer v1 raus.","x":1080,"y":680,"width":420,"height":180}
],
"edges":[
{"id":"edge-s01-change","fromNode":"s01","fromSide":"right","toNode":"change-password","toSide":"left","label":"Passwort aendern"},
{"id":"edge-s01-2fa","fromNode":"s01","fromSide":"right","toNode":"manage-2fa","toSide":"left","label":"2FA verwalten"}
]
}
@@ -0,0 +1,199 @@
---
kind: wireframe-package
project: HiveGrid Screen Project
ticket: D-P2
package: WF-P2 Profil und Sicherheit
typ: Settings Flow
status: In Subframe
subframe: "https://app.subframe.com/f023064a5ca0/flow/b08776c0-8ef2-4c12-b77c-ae729313f1bc/edit"
canvas: WF-P2 Profil und Sicherheit.canvas
---
# WF-P2 Profil und Sicherheit
Status: In Subframe
Subframe-Link: https://app.subframe.com/f023064a5ca0/flow/b08776c0-8ef2-4c12-b77c-ae729313f1bc/edit
Canvas: [[WF-P2 Profil und Sicherheit.canvas]]
Stand: 2026-06-23
---
## 1. Kurzfassung
Dieses Paket buendelt die Self-Service-Settings aus D-P2: Profil und Trigger zu Sicherheitsflows.
Profil lebt vollstaendig im Settings-Bereich. Der Einstieg kommt entweder ueber das Profilbild oben rechts in der App-Shell oder ueber die Settings-Navigation. Passwort aendern und 2FA verwalten werden hier nur getriggert, sind aber eigene Flows: `WF-P2 Change Password` und `WF-P2 2FA Verwalten`.
---
## 2. Intent Check
| Frage | Antwort |
|---|---|
| Welches Ticket/Modul ist betroffen? | D-P2 Auth / Profile / Sessions |
| Was soll der Nutzer am Ende schaffen? | Profil pflegen und Sicherheitsflows starten |
| Ist es ein Flow, einzelner Screen, Zustand oder nur Dokumentation? | Settings-Paket mit Profilscreen und Triggern zu separaten Sicherheitsflows |
| Welche Planning-Quellen wurden geprueft? | D-P2, SCREEN-MAP §1 Auth-Screens |
| Was ist sicher im Scope? | Settings -> Profil, Einstieg ueber Avatar-Menue/App-Shell, Name, Avatar, Telefon, Abteilung, Rolle read-only, Trigger zu Passwort aendern, Trigger zu 2FA verwalten |
| Was ist sicher nicht im Scope? | Sprache wechseln, Admin-RBAC, Konto loeschen, eigentlicher Passwort-aendern-Flow, eigentlicher 2FA-Verwalten-Flow, Security/Sessions-Seite |
| Gibt es Admin/Normalrolle-Unterschiede? | kaum; Admin kann dieselben Self-Service-Sicherheitsaktionen nutzen |
| Welche Annahmen sind noch unsicher? | keine fuer Profil; offene 2FA-Fragen liegen in `WF-P2 2FA Verwalten` |
---
## 3. Scope
| Punkt | Inhalt |
|---|---|
| Ticket/Modul | D-P2 Auth |
| Nutzerrolle | eingeloggter Nutzer |
| Admin-Variante | keine eigene UI, ausser Admin-spezifische Navigation |
| Normale Rolle | hoechste Rolle unter Admin |
| Startpunkt | Profilbild oben rechts in der App-Shell oder Settings-Navigation |
| Ziel | Profil pflegen und Sicherheitsflows starten |
| Haupt-Archetyp | A6 Settings + A2 Listen |
| Bespoke-Anteil | nein |
| Out of scope | Account-Loeschung, Rollen/Gruppen/Mitarbeiter; Security/Sessions-Seite fuer v1 raus; Passwort-aendern-Flow liegt in `WF-P2 Change Password`; 2FA-Verwalten liegt in `WF-P2 2FA Verwalten` |
---
## 4. Brainstorming
### Flow-Frage
Wie soll der Nutzer Profil, Passwort und 2FA erreichen?
### UX-Varianten
| Option | Beschreibung | Vorteil | Nachteil | Empfehlung |
|---|---|---|---|---|
| A | Profil als Settings-Unterseite; Passwort und 2FA als Trigger zu eigenen Flows | sauber getrennt, wiederverwendbar, Profil bleibt schlank | mehr Flow-Pakete | genommen |
| B | Profil und Security getrennt: `/settings/profile` und `/settings/security` | klare Trennung fuer Sessions/Geraete | aktuell zu breit | raus fuer v1 |
| C | Alles in einem grossen globalen Profil-Menue ausserhalb Settings | schneller Einstieg | bricht Settings-Struktur | raus |
### Entscheidung
| Entscheidung | Status | Notiz |
|---|---|---|
| Profil lebt in Settings | genommen | Unter Settings gibt es eine Zwischen-/Seitennavigation; Profil ist dort ein Bereich |
| Einstieg ueber Profilbild oben rechts | genommen | Avatar-Menue fuehrt zu Profil Settings |
| Einstieg ueber Settings-Navigation | genommen | Profil ist auch regulär ueber Settings erreichbar |
| Profil-Felder | genommen | Name, Avatar, Telefonnummer, Abteilung editierbar, Rolle read-only |
| Theme im Profil | raus | nicht Teil dieses Profil-Screens |
| Beschreibung/Bio | raus | nicht Teil dieses Profil-Screens |
| Rolle read-only | genommen | Rolle wird durch Admin zugewiesen und im Profil nur angezeigt |
| Passwort aendern ist eigener Flow | genommen | Klick startet `WF-P2 Change Password`, nicht direkt `WF-P2 Set Password` |
| 2FA verwalten ist eigener Flow | genommen | Klick startet `WF-P2 2FA Verwalten`; UI kann modal sein |
| Security/Sessions eigene Seite | raus fuer v1 | erstmal schlank halten |
| Sprache bleibt fest DE | genommen | D-P2 explizit: kein Wechsler v1 |
### Happy Path
1. Nutzer oeffnet ueber Avatar-Menue oder Settings die Profil Settings.
2. Nutzer pflegt Profilfelder wie Name, Avatar, Telefonnummer und Abteilung.
3. Nutzer sieht seine Rolle read-only, kann sie aber nicht selbst aendern.
4. Nutzer klickt Passwort aendern und startet `WF-P2 Change Password`.
5. Nutzer klickt 2FA verwalten und startet `WF-P2 2FA Verwalten`.
### Varianten / Branches
- 2FA verwalten: fuehrt zum eigenen Flow `WF-P2 2FA Verwalten`.
- Passwort aendern: fuehrt zum eigenen Flow `WF-P2 Change Password`.
- Sessions/Geraete-Verwaltung: fuer v1 raus/spaeter.
### Roadblocks
- Avatar-Upload fehlgeschlagen
- Change-Password-Flow nicht erreichbar
- 2FA-Verwalten-Flow nicht erreichbar
### Meldungs-/Error-State-Brainstorming
| Ereignis | UI-Form | Blockiert? | Bauen? | Copy/Notiz |
|---|---|---|---|---|
| Profil gespeichert | Toast | nein | nein | Erfolg reicht |
| Avatar-Upload fehlgeschlagen | Inline/Banner | nein | nein | Retry |
| Passwort aendern | Link/Action zu eigenem Flow | ja | nein | startet `WF-P2 Change Password` |
| 2FA verwalten | Link/Action zu eigenem Flow | ja | nein | startet `WF-P2 2FA Verwalten` |
| Session einzeln abmelden | - | - | nein | raus fuer v1 |
| Ueberall abmelden | - | - | nein | raus fuer v1 |
---
## 5. Screen-Kandidaten nach Entscheidung
| Kandidat | Warum eventuell noetig? | Erste Einschaetzung |
|---|---|---|
| Profil Settings | D-P2 Hauptscreen | Bauen |
| Security / Sessions | fuer v1 zu breit | Raus/Spaeter |
| Passwort aendern | Trigger aus Profil | eigener Flow `WF-P2 Change Password` |
| 2FA verwalten | Trigger aus Profil | eigener Flow `WF-P2 2FA Verwalten` |
| Ueberall abmelden Confirm | Security/Sessions-Thema | Raus/Spaeter |
| Trust Devices leer | Security/Sessions-Thema | Raus/Spaeter |
---
## 6. Screen Validation Gate
| ID | Screen/Zustand | Ist eigener Arbeitsmoment? | Neue Struktur/Entscheidung/Risiko? | Entscheidung | Begruendung |
|---|---|---|---|---|---|
| S01 | Profil Settings | ja | ja, D-P2 Route/Settings-Bereich | Bauen | Stammdaten, Avatar, Telefon, Abteilung, Rolle read-only, Passwort- und 2FA-Einstiege |
| S02 | Security / Sessions | nein | nein fuer v1 | Spaeter | erstmal schlank halten |
| D01 | Passwort aendern | ja | ja, Security | Nur dokumentieren | startet eigenes Paket `WF-P2 Change Password` |
| D02 | 2FA verwalten | ja | ja, Security | Nur dokumentieren | startet eigenes Paket `WF-P2 2FA Verwalten` |
| M03 | Ueberall abmelden Confirm | nein | nein fuer v1 | Spaeter | gehoert zu Security/Sessions |
| E01 | Trust Devices leer | nein | nein fuer v1 | Spaeter | gehoert zu Security/Sessions |
### Copy-kritische Zustaende
| Zustand | Bauen? | Warum / Copy-Entscheidung |
|---|---|---|
| Keine im Profil | nein | 2FA-copy-kritische Zustaende liegen in `WF-P2 2FA Verwalten` |
### Blockierende Error States
| Zustand | UI-Form | Primaeraktion | Sekundare Aktion | Inhalt/Copy-Richtung |
|---|---|---|---|---|
| Change-Password-Flow nicht erreichbar | Banner | erneut versuchen | abbrechen | keine Rohfehler |
| 2FA-Verwalten-Flow nicht erreichbar | Banner | erneut versuchen | abbrechen | keine Rohfehler |
---
## 7. Validierte Screen-Liste
| ID | Screen/Zustand | Typ | Umsetzung | Ort | Status |
|---|---|---|---|---|---|
| S01 | Profil Settings | Settings | Bauen | `/settings/profile` | Validiert |
| S02 | Security / Sessions | Settings/List | Spaeter | `/settings/security` | Spaeter |
| D01 | Passwort aendern | Trigger | Nur dokumentieren | von S01 | Validiert |
| D02 | 2FA verwalten | Trigger | Nur dokumentieren | von S01 | Validiert |
---
## 8. Subframe-Grid
```text
App-Shell Avatar-Menue -> S01 Profil Settings
Settings Navigation -> S01 Profil Settings
S01 Profil Settings -> WF-P2 Change Password
S01 Profil Settings -> WF-P2 2FA Verwalten
S02 Security / Sessions -> spaeter
```
---
## 9. Screen-Pakete
| ID | Datei |
|---|---|
| S01 | [[Screens/S01 Profil Settings.md]] |
---
## 10. Handoff-Check
- [x] Paket ist angelegt.
- [x] Hauptscreens aus D-P2 sind erfasst.
- [x] Wiederverwendung von Auth-Core ist markiert.
- [x] David hat die Kandidaten validiert.
- [x] Subframe-Link ist eingetragen.