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,70 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P2 / Auth-Core
package: WF-P2 2FA Verwalten
id: M01
screen: 2FA verwalten
typ: Modal
umsetzung: Bauen
status: In Subframe
route: von Profil Settings
subframe: "https://app.subframe.com/f023064a5ca0/design/606baf15-a4cc-468c-b196-c51441f8c6ed/edit"
---
# M01 — 2FA verwalten
## Ziel
Der Nutzer sieht den aktuellen 2FA-Status und kann 2FA einrichten, ein Device/Token hinzufuegen, ein bestehendes Device entfernen oder 2FA deaktivieren.
## Pattern / Archetyp
A5 Modal / Security Management.
## Daten
- 2FA-Status: aktiv / nicht aktiv
- Device-/Token-Liste, wenn aktiv
- pro Device: Name, Typ `Authenticator-App`, hinzugefuegt am, optional zuletzt verwendet
## Aktionen
- 2FA einrichten, wenn nicht aktiv
- Device/Token hinzufuegen
- Device entfernen als Row-Action + Confirm
- 2FA deaktivieren
- Modal schliessen
## Banner / Hinweise
- Kurzer Hinweis, dass 2FA das Konto mit einem zweiten Faktor schuetzt.
- Bei aktivem Status: Hinweis, dass Entfernen/Deaktivieren Sicherheitswirkung hat.
## Toasts / Action-Feedback
- Nach Device entfernen: kurzer Toast oder dokumentierte Benachrichtigung.
- Nach 2FA-Aenderungen kann zusaetzlich eine Sicherheitsbenachrichtigung per E-Mail ausgelöst werden.
## Zustaende
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| 2FA nicht aktiv | Status + CTA `2FA einrichten` | Bauen |
| 2FA aktiv | Device-Liste + Aktionen | Bauen |
| Device entfernen | Row-Action + Confirm | Nur dokumentieren |
| Letztes Device entfernen | blockieren oder zu M03 fuehren | Nur dokumentieren |
| Laden | Aktionen werden gespeichert | Wiederverwenden |
## Permissions / Gates
- Nutzer ist eingeloggt.
- Start kommt aus Profil Settings oder einem spaeteren Security-Kontext.
## Subframe
-
## Notizen
`2FA-Code eingeben` ist kein eigener Screen. Codefelder erscheinen in M02 oder M03.
@@ -0,0 +1,69 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P2 / Auth-Core
package: WF-P2 2FA Verwalten
id: M02
screen: Device/Token hinzufuegen
typ: Modal
umsetzung: Bauen
status: In Subframe
route: von M01
subframe: "https://app.subframe.com/f023064a5ca0/design/ec8c6a18-c0dd-498e-a79d-177b2a634d28/edit"
---
# M02 — Device/Token hinzufuegen
## Ziel
Der Nutzer legt ein neues 2FA-Device bzw. einen neuen Authenticator-Token an und validiert ihn mit einem ersten TOTP-Code.
## Pattern / Archetyp
A5 Modal / Authenticator Setup.
## Daten
- Device-Name, optional oder vorgeschlagen
- QR-Code
- manueller Secret-Key
- 6-stelliger TOTP-Code
## Aktionen
- Code bestaetigen
- Secret/Key kopieren
- abbrechen / zurueck zu M01
## Banner / Hinweise
- Kurz erklaeren, dass eine Authenticator-App benoetigt wird.
- Device/Token wird erst gespeichert, wenn der eingegebene Code korrekt ist.
## Toasts / Action-Feedback
- Nach erfolgreicher Einrichtung: zurueck zu M01 mit aktualisierter Liste.
- MFA-Aenderung kann per E-Mail/Toast dokumentiert werden.
## Zustaende
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Setup | QR + manueller Secret-Key + Codefeld | Bauen |
| Laden | Code wird validiert | Wiederverwenden |
| Code falsch | Inline-Fehler am Codefeld | Nur dokumentieren |
| Code abgelaufen | Inline-Hinweis, neuen Code eingeben | Nur dokumentieren |
| Setup fehlgeschlagen | technische Meldung ohne Rohfehler | Nur dokumentieren |
## Permissions / Gates
- Nutzer ist eingeloggt.
- Start aus M01.
## Subframe
-
## Notizen
Das Pattern kann sich an `WF-P2 Set Password / S04 2FA einrichten` orientieren, besitzt hier aber Device-/Token-Kontext.
@@ -0,0 +1,68 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P2 / Auth-Core
package: WF-P2 2FA Verwalten
id: M03
screen: 2FA deaktivieren
typ: Modal
umsetzung: Bauen
status: In Subframe
route: von M01
subframe: "https://app.subframe.com/f023064a5ca0/design/cfaa0e6a-6656-4363-bba7-7409b9c26bc9/edit"
---
# M03 — 2FA deaktivieren
## Ziel
Der Nutzer deaktiviert 2FA bewusst und bestaetigt die Aktion mit einem aktuellen 2FA-Code.
## Pattern / Archetyp
A5 Confirm-Modal mit Inline-Reauth.
## Daten
- Warnhinweis zur Sicherheitsauswirkung
- 2FA-Code
- bestaetigende Checkbox oder Confirm-Text, falls noetig
## Aktionen
- 2FA deaktivieren
- abbrechen / zurueck zu M01
## Banner / Hinweise
- Klarer Hinweis: Nach der Deaktivierung ist fuer den Account kein zweiter Faktor mehr aktiv.
- Keine technische Anleitung zum Umgehen von 2FA.
## Toasts / Action-Feedback
- Nach erfolgreicher Deaktivierung: zurueck zu M01 mit Status `2FA nicht aktiv`.
- MFA-Aenderung kann per E-Mail/Toast dokumentiert werden.
## Zustaende
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Confirm | Warnung + 2FA-Code + Deaktivieren-Action | Bauen |
| Laden | Deaktivierung wird gespeichert | Wiederverwenden |
| Code falsch | Inline-Fehler am Codefeld | Nur dokumentieren |
| Zu viele Versuche | temporaerer Blocker/Retry spaeter | Nur dokumentieren |
| Technischer Fehler | Deaktivierung fehlgeschlagen | Nur dokumentieren |
## Permissions / Gates
- Nutzer ist eingeloggt.
- 2FA ist aktiv.
- Start aus M01.
## Subframe
-
## Notizen
Code-Eingabe und Confirm bleiben in diesem Modal. Es gibt keinen eigenen `2FA bestaetigen`-Flow.
@@ -0,0 +1,21 @@
{
"nodes":[
{"id":"group-main","type":"group","x":-80,"y":-100,"width":1900,"height":420,"label":"Hauptflow"},
{"id":"group-notes","type":"group","x":-80,"y":560,"width":1700,"height":360,"label":"Dokumentierte Zustaende"},
{"id":"m01","type":"file","file":"02 Wireframes/P2 Auth/WF-P2 2FA Verwalten/Screens/M01 2FA verwalten.md","x":0,"y":0,"width":420,"height":200},
{"id":"m02","type":"file","file":"02 Wireframes/P2 Auth/WF-P2 2FA Verwalten/Screens/M02 Device Token hinzufuegen.md","x":640,"y":0,"width":420,"height":200},
{"id":"m03","type":"file","file":"02 Wireframes/P2 Auth/WF-P2 2FA Verwalten/Screens/M03 2FA deaktivieren.md","x":1280,"y":0,"width":420,"height":200},
{"id":"note-inline","type":"text","text":"# Inline-Zustaende\n\n2FA-Code falsch/abgelaufen bleibt Inline in M02/M03.\n\nKein eigener `2FA bestaetigen`-Flow.","x":0,"y":680,"width":420,"height":200},
{"id":"note-remove","type":"text","text":"# Device entfernen\n\nRow-Action + Confirm in M01.\n\nLetztes Device nicht still entfernen: blockieren oder zu M03 leiten.","x":540,"y":680,"width":420,"height":220},
{"id":"note-notify","type":"text","text":"# MFA-Aenderung\n\nNach Setup, Remove oder Disable Security-Benachrichtigung dokumentieren: E-Mail und/oder Toast.\n\nKein eigener Screen.","x":1080,"y":680,"width":420,"height":220}
],
"edges":[
{"id":"edge-m01-m02","fromNode":"m01","fromSide":"right","toNode":"m02","toSide":"left","label":"hinzufuegen"},
{"id":"edge-m01-m03","fromNode":"m01","fromSide":"right","toNode":"m03","toSide":"left","label":"deaktivieren"},
{"id":"edge-m02-m01","fromNode":"m02","fromSide":"bottom","toNode":"m01","toSide":"bottom","label":"validiert"},
{"id":"edge-m03-m01","fromNode":"m03","fromSide":"bottom","toNode":"m01","toSide":"bottom","label":"deaktiviert"},
{"id":"edge-m01-remove","fromNode":"m01","fromSide":"bottom","toNode":"note-remove","toSide":"top","label":"Device entfernen"},
{"id":"edge-m02-inline","fromNode":"m02","fromSide":"bottom","toNode":"note-inline","toSide":"top","label":"Codefehler"},
{"id":"edge-m03-inline","fromNode":"m03","fromSide":"bottom","toNode":"note-inline","toSide":"top","label":"Codefehler"}
]
}
@@ -0,0 +1,201 @@
---
kind: wireframe-package
project: HiveGrid Screen Project
ticket: D-P2 / Auth-Core
package: WF-P2 2FA Verwalten
typ: Auth-Core Modal Flow
status: In Subframe
subframe: "https://app.subframe.com/f023064a5ca0/flow/4de27a18-0e2f-43de-b39b-01a94b0c93b8/edit"
canvas: WF-P2 2FA Verwalten.canvas
---
# WF-P2 2FA Verwalten
Status: In Subframe
Subframe-Link: https://app.subframe.com/f023064a5ca0/flow/4de27a18-0e2f-43de-b39b-01a94b0c93b8/edit
Canvas: [[WF-P2 2FA Verwalten.canvas]]
Stand: 2026-06-23
---
## 1. Kurzfassung
`2FA Verwalten` ist ein eigener wiederverwendbarer Sicherheitsflow.
Der Flow wird aus Profil Settings getriggert, bleibt aber getrennt, damit 2FA spaeter auch aus anderen Sicherheitskontexten gestartet werden kann. Die UI ist als Modal-/Dialogsequenz gedacht.
Wichtig: `2FA-Code eingeben` ist hier kein eigener Flow. Code-Eingaben sind Inline-Zustaende in den jeweiligen Modals, z. B. bei Device hinzufuegen oder 2FA deaktivieren.
---
## 2. Intent Check
| Frage | Antwort |
|---|---|
| Welches Ticket/Modul ist betroffen? | D-P2 / Auth-Core |
| Was soll der Nutzer am Ende schaffen? | 2FA einrichten, vorhandene 2FA-Devices sehen, neue Devices hinzufuegen, Devices entfernen oder 2FA deaktivieren |
| Ist es ein Flow, einzelner Screen, Zustand oder nur Dokumentation? | eigener Sicherheitsflow als Modal-/Dialogsequenz |
| Welche Planning-Quellen wurden geprueft? | D-P2, Profil-und-Sicherheit-Entscheidung, Set-Password-2FA-Pattern |
| Was ist sicher im Scope? | 2FA Status, 2FA aktivieren/einrichten, Device hinzufuegen, Device entfernen, 2FA deaktivieren mit Code + Confirm |
| Was ist sicher nicht im Scope? | Profil bearbeiten, Passwort aendern, Session-Verwaltung, Trust-Device-Liste als eigene Seite |
| Gibt es Admin/Normalrolle-Unterschiede? | nein; gleicher Self-Service-Flow fuer eingeloggte Nutzer |
| Welche Annahmen sind noch unsicher? | ob v1 mehrere Authenticator-Devices wirklich unterstuetzt oder die UI erstmal nur darauf vorbereitet wird |
---
## 3. Scope
| Punkt | Inhalt |
|---|---|
| Ticket/Modul | D-P2 / Auth-Core |
| Nutzerrolle | eingeloggter Nutzer |
| Admin-Variante | keine eigene UI |
| Normale Rolle | gleicher Flow |
| Startpunkt | Trigger aus Profil Settings oder spaeter anderer Sicherheitskontext |
| Ziel | 2FA-Status sicher verwalten |
| Haupt-Archetyp | A5 Modal/Wizard + A4 Auth Form |
| Bespoke-Anteil | nein |
| Out of scope | aktive Sessions, Trust-Device-Liste als eigene Security-Seite, Passwort aendern |
---
## 4. Brainstorming
### Flow-Frage
Wie viel eigene Struktur braucht 2FA-Verwaltung, ohne aus einfachen Code-Eingaben eigene Flows zu machen?
### UX-Varianten
| Option | Beschreibung | Vorteil | Nachteil | Empfehlung |
|---|---|---|---|---|
| A | 2FA komplett im Profil-Screen einbetten | wenig Modals | Profil wird sicherheitslastig und schlechter wiederverwendbar | raus |
| B | Eigener 2FA-Verwalten-Flow, aber Code-Eingaben bleiben Inline-Zustaende | wiederverwendbar, schlank, klarer Security-Kontext | braucht saubere Modal-Zustaende | genommen |
| C | Jede 2FA-Bestaetigung als eigener Flow | sehr formal | zu kompliziert fuer diesen Scope | raus |
### Entscheidung
| Entscheidung | Status | Notiz |
|---|---|---|
| 2FA-Verwaltung ist eigener Flow | genommen | Profil ist nur Trigger |
| UI als Modal-/Dialogsequenz | genommen | bleibt innerhalb der App-Shell |
| 2FA-Code-Eingaben sind keine eigenen Flows | genommen | Codefelder liegen im jeweiligen Modal |
| Inaktiver und aktiver Status liegen in demselben Start-Modal | genommen | spart eigenen Empty-State-Screen |
| Device/Token hinzufuegen ist ein eigener Modal-Step | genommen | QR/Secret + Code brauchen eigenen Arbeitsmoment |
| Device entfernen ist kein eigener Screen | genommen | Row-Action + Confirm reicht |
| Letztes Device nicht still entfernen | genommen | blockieren oder zu 2FA deaktivieren fuehren |
| 2FA deaktivieren ist eigener Confirm-Modal | genommen | hoher Risiko-Branch, aber Code + Confirm im selben Modal |
| MFA-Aenderung benachrichtigen | genommen | E-Mail/Toast nur dokumentieren, kein eigener Screen |
### Happy Path
1. Nutzer klickt in Profil Settings auf 2FA verwalten.
2. Modal `2FA verwalten` oeffnet sich.
3. Wenn 2FA nicht aktiv ist, sieht der Nutzer den Status und kann 2FA einrichten.
4. Wenn 2FA aktiv ist, sieht der Nutzer vorhandene Devices und Aktionen.
5. Nutzer fuegt ein Device hinzu oder entfernt ein Device.
6. Nutzer kann 2FA deaktivieren; dafuer gibt er den 2FA-Code im Deaktivieren-Modal ein und bestaetigt bewusst die Deaktivierung.
### Varianten / Branches
- 2FA ist nicht aktiv: Start-Modal zeigt CTA `2FA einrichten`.
- 2FA ist aktiv: Start-Modal zeigt Device-Liste und Aktionen.
- Neues Device hinzufuegen: QR/Secret + Code im Setup-Modal.
- Device entfernen: Row-Action mit kleiner Confirm-Abfrage.
- Letztes Device entfernen: blockiert oder fuehrt zu `2FA deaktivieren`.
- 2FA deaktivieren: Code + Confirm im selben Modal.
- Code ist falsch: Inline-Fehler, kein eigener Screen.
### Roadblocks
- falscher 2FA-Code
- letztes Device entfernen
- Setup-Code abgelaufen/ungueltig
- technische Setup-/Disable-Fehler
### Meldungs-/Error-State-Brainstorming
| Ereignis | UI-Form | Blockiert? | Bauen? | Copy/Notiz |
|---|---|---|---|---|
| 2FA nicht aktiv | Zustand in M01 | nein | nein | CTA zum Einrichten |
| 2FA aktiv | Zustand in M01 | nein | nein | Device-Liste + Aktionen |
| neues Device hinzufuegen | Modal-Step M02 | ja | pruefen | QR/Secret + Code |
| Device entfernen | Row-Action + Confirm | teilweise | nein | wenn nicht letztes Device |
| letztes Device entfernen | Inline/Confirm-Hinweis | ja | nein | Nutzer soll 2FA deaktivieren statt letztes Device still entfernen |
| 2FA deaktivieren | Modal M03 | ja | pruefen | Code + bewusster Confirm im selben Modal |
| 2FA-Code falsch | Inline im Modal | ja | nein | korrigierbar |
---
## 5. Screen-Kandidaten nach Entscheidung
| Kandidat | Warum eventuell noetig? | Erste Einschaetzung |
|---|---|---|
| 2FA verwalten | Start-Modal fuer aktiven/inaktiven Status | Bauen |
| 2FA einrichten / Device hinzufuegen | QR/Secret + Code | Bauen |
| 2FA deaktivieren | sicherheitskritischer Branch | Bauen |
| Device entfernen | kleinere Aktion | Nur dokumentieren |
| 2FA-Code falsch | Inline-Zustand | Nur dokumentieren |
| Letztes Device entfernen blockiert | Inline-/Confirm-Zustand | Nur dokumentieren |
---
## 6. Screen Validation Gate
| ID | Screen/Zustand | Ist eigener Arbeitsmoment? | Neue Struktur/Entscheidung/Risiko? | Entscheidung | Begruendung |
|---|---|---|---|---|---|
| M01 | 2FA verwalten | ja | ja, eigener Sicherheitsstart | Bauen | Status, Device-Liste, Einstieg zu Aktionen |
| M02 | Device/Token hinzufuegen | ja | ja, QR/Secret + Code | Bauen | eigener Setup-Arbeitsmoment |
| M03 | 2FA deaktivieren | ja | ja, hohes Risiko | Bauen | Code + Confirm im selben Modal |
| D01 | Device entfernen | teilweise | ja, Zugriff wird entzogen | Nur dokumentieren | Row-Action + Confirm reicht |
| D02 | 2FA-Code falsch | nein | nein | Nur dokumentieren | Inline-Fehler |
| D03 | Letztes Device entfernen | nein | ja | Nur dokumentieren | blockieren oder zu 2FA deaktivieren fuehren |
| D04 | MFA-Aenderung Benachrichtigung | nein | ja, Security Audit | Nur dokumentieren | E-Mail/Toast nach Setup, Remove, Disable |
---
## 7. Validierte Screen-Liste
| ID | Screen/Zustand | Typ | Umsetzung | Ort | Status |
|---|---|---|---|---|---|
| M01 | 2FA verwalten | Modal | Bauen | von Profil Settings | Validiert |
| M02 | Device/Token hinzufuegen | Modal | Bauen | von M01 | Validiert |
| M03 | 2FA deaktivieren | Modal | Bauen | von M01 | Validiert |
| D01 | Device entfernen | Row-Action/Confirm | Nur dokumentieren | in M01 | Validiert |
| D02 | 2FA-Code falsch/abgelaufen | Inline | Nur dokumentieren | in M02/M03 | Validiert |
| D03 | Letztes Device entfernen | Inline/Confirm | Nur dokumentieren | in M01 | Validiert |
| D04 | MFA-Aenderung Benachrichtigung | E-Mail/Toast | Nur dokumentieren | nach Setup/Remove/Disable | Validiert |
---
## 8. Subframe-Grid
```text
Profil Settings -> M01 2FA verwalten
M01 -> M02 Device/Token hinzufuegen
M01 -> M03 2FA deaktivieren
M01 -> Device entfernen (dokumentierte Row-Action)
M02/M03 -> 2FA-Code falsch (Inline)
M02/M03/Device entfernen -> MFA-Aenderung Benachrichtigung (dokumentiert)
```
---
## 9. Screen-Pakete
| ID | Datei |
|---|---|
| M01 | [[Screens/M01 2FA verwalten.md]] |
| M02 | [[Screens/M02 Device Token hinzufuegen.md]] |
| M03 | [[Screens/M03 2FA deaktivieren.md]] |
---
## 10. Handoff-Check
- [x] Eigenes Paket ist angelegt.
- [x] Profil ist nur Trigger, nicht Besitzer des Flows.
- [x] 2FA-Code-Bestaetigung ist kein eigener Flow.
- [x] 2FA deaktivieren verlangt Code + Confirm im selben Modal.
- [x] David hat die Kandidaten validiert.
- [ ] Subframe-Link ist eingetragen.