246 lines
8.9 KiB
Markdown
246 lines
8.9 KiB
Markdown
---
|
|
kind: wireframe-package
|
|
project: HiveGrid Screen Project
|
|
ticket: D-P2
|
|
package: WF-P2 Login und 2FA
|
|
typ: Flow
|
|
status: In Subframe
|
|
subframe: "https://app.subframe.com/f023064a5ca0/flow/a457cbaa-9cca-412a-98b2-3bef128338ac/edit"
|
|
canvas: "02 Wireframes/P2 Auth/WF-P2 Login und 2FA/WF-P2 Login und 2FA.canvas"
|
|
---
|
|
|
|
# WF-P2 Login und 2FA
|
|
|
|
Status: In Subframe
|
|
Subframe-Link: https://app.subframe.com/f023064a5ca0/flow/a457cbaa-9cca-412a-98b2-3bef128338ac/edit
|
|
Canvas: [[WF-P2 Login und 2FA.canvas]]
|
|
Stand: 2026-06-23
|
|
|
|
---
|
|
|
|
## 1. Kurzfassung
|
|
|
|
Dieses Paket beschreibt den Login-Flow mit E-Mail/Passwort, Magic-Link-Alternative und 2FA.
|
|
|
|
Ziel ist ein einfacher Standard-Auth-Flow, aber mit bewusst gebauten copy-kritischen Auth-Zustaenden wie Magic-Link gesendet, falsche Login-Daten, Captcha nach mehreren Versuchen und 2FA gesperrt.
|
|
|
|
---
|
|
|
|
## 2. Intent Check
|
|
|
|
| Frage | Antwort |
|
|
|---|---|
|
|
| Welches Ticket/Modul ist betroffen? | D-P2 Auth / Identitaet |
|
|
| Was soll der Nutzer am Ende schaffen? | sich sicher einloggen und bei Bedarf 2FA bestaetigen |
|
|
| Ist es ein Flow, einzelner Screen, Zustand oder nur Dokumentation? | Flow mit Hauptscreens und wichtigen Varianten |
|
|
| Welche Planning-Quellen wurden geprueft? | D-P2, SCREEN-MAP Auth-Screens |
|
|
| Was ist sicher im Scope? | Login, Magic-Link, Magic-Link gesendet, 2FA, falsche Login-Daten, Captcha, 2FA gesperrt, Konto-erstellen-Link im Login |
|
|
| Was ist sicher nicht im Scope? | Signup-Flow selbst, Passwort vergessen, Profil-/Tenant-Auswahl als eigener Flow, Session-Verwaltung |
|
|
| Gibt es Admin/Normalrolle-Unterschiede? | Ja, aber nur als Outcome nach erfolgreichem Login |
|
|
| Welche Annahmen sind noch unsicher? | Ob 2FA wirklich immer kommt oder nur bei aktivierter 2FA; fuer Wireframe reicht "bei Bedarf" |
|
|
|
|
---
|
|
|
|
## 3. Scope
|
|
|
|
| Punkt | Inhalt |
|
|
|---|---|
|
|
| Ticket/Modul | D-P2 Auth |
|
|
| Nutzerrolle | eingeloggter Nutzer nach erfolgreicher Authentifizierung |
|
|
| Admin-Variante | Admin geht nach Login zur Tenant-/Workspace-Auswahl oder Admin-Startpunkt |
|
|
| Normale Rolle | hoechste Rolle unter Admin geht nach Login zur Home/App |
|
|
| Startpunkt | `/login` |
|
|
| Ziel | Authentifizierung erfolgreich abschliessen |
|
|
| Haupt-Archetyp | A4 Form + A5 Auth-Step |
|
|
| Bespoke-Anteil | nein |
|
|
| Out of scope | Tenant-Auswahl-Flow, Signup-Flow selbst, Passwort-Reset |
|
|
|
|
---
|
|
|
|
## 4. Brainstorming
|
|
|
|
Screen-Listen entstehen erst nach dem Brainstorming. Hier wurde zuerst entschieden, ob Login E-Mail-first oder klassisch gebuendelt laufen soll.
|
|
|
|
### Flow-Frage
|
|
|
|
Soll Login zuerst nur die E-Mail abfragen oder direkt E-Mail und Passwort zusammen zeigen?
|
|
|
|
### UX-Varianten
|
|
|
|
| Option | Beschreibung | Vorteil | Nachteil | Empfehlung |
|
|
|---|---|---|---|---|
|
|
| A | E-Mail und Passwort zusammen auf einem Login-Screen | einfach, vertraut, wenig Schritte | weniger Security-Guidance | genommen |
|
|
| B | E-Mail-first, danach Passwort oder Magic-Link | kontrollierter, modern | mehr Schritte, komplexer | raus fuer v1 |
|
|
| C | Voller Security-first Flow mit Account-Erkennung und mehreren Pfaden | sehr granular | zu komplex, Risiko fuer Account-Enumeration | raus |
|
|
|
|
### Entscheidung
|
|
|
|
| Entscheidung | Status | Notiz |
|
|
|---|---|---|
|
|
| E-Mail + Passwort zusammen | genommen | einfacher Standardflow; kein E-Mail-Pre-Screen |
|
|
| Magic-Link direkt auf Login sichtbar | genommen | Alternative sichtbar, aber nicht dominant |
|
|
| Magic-Link eigener Anforderungs-Screen | genommen | bewusster Wechsel in alternativen Login |
|
|
| Konto erstellen Link im Login | genommen | Signup ist erreichbar, aber eigener Flow |
|
|
| Wichtige Auth-Zustaende bauen | genommen | Copy soll von Design entschieden werden |
|
|
| Admin-Weiterleitung | dokumentieren | eigener Tenant-/Workspace-Flow spaeter |
|
|
|
|
### Happy Path
|
|
|
|
1. Nutzer oeffnet Login.
|
|
2. Nutzer gibt E-Mail und Passwort ein.
|
|
3. Falls 2FA noetig ist, gibt Nutzer den 6-stelligen Code ein.
|
|
4. Danach geht es je nach Rolle weiter.
|
|
|
|
### Varianten / Branches
|
|
|
|
- Nutzer waehlt Magic-Link.
|
|
- Magic-Link wurde gesendet.
|
|
- Login-Daten sind falsch.
|
|
- Captcha erscheint nach mehreren Fehlversuchen.
|
|
- 2FA ist gesperrt oder zu oft falsch eingegeben.
|
|
|
|
### Roadblocks
|
|
|
|
- falsche Login-Daten
|
|
- Captcha erforderlich
|
|
- 2FA zu oft falsch
|
|
- technische Login-Fehler
|
|
|
|
### Offene Fragen
|
|
|
|
- Kommt 2FA wirklich bei jedem Login oder nur bei aktivierter 2FA?
|
|
- Admin-/Mehrworkspace-Ziel wird in `WF-P2 Workspace Auswahl` geplant; UI-Begriff ist Workspace.
|
|
|
|
---
|
|
|
|
## 5. Screen-Kandidaten nach Entscheidung
|
|
|
|
| Kandidat | Warum eventuell noetig? | Erste Einschaetzung |
|
|
|---|---|---|
|
|
| Login | Hauptscreen | Bauen |
|
|
| Magic-Link anfordern | alternativer Auth-Weg | Bauen |
|
|
| Magic-Link gesendet | copy-kritischer Erfolg | Bauen |
|
|
| 2FA Code eingeben | eigener Security-Schritt | Bauen |
|
|
| Login mit falschen Daten | haeufiger, copy-kritischer Fehler | Bauen |
|
|
| Login mit mCaptcha | Layout aendert sich nach 3 Fehlversuchen | Bauen |
|
|
| 2FA gesperrt | wichtiger Blocker | Bauen |
|
|
| Konto erstellen Link | Nutzer ohne Konto braucht klaren Einstieg | in S01 integrieren |
|
|
| E-Mail-Pre-Screen | alternative UX, aber fuer v1 zu viel Schritt | Raus |
|
|
| Trust Device | Bestandteil von 2FA | in 2FA integrieren |
|
|
| Login erfolgreich | reine Weiterleitung | Raus |
|
|
| Admin-Weiterleitung | Rollen-Outcome | Dokumentieren |
|
|
|
|
---
|
|
|
|
## 6. Screen Validation Gate
|
|
|
|
| ID | Screen/Zustand | Ist eigener Arbeitsmoment? | Neue Struktur/Entscheidung/Risiko? | Entscheidung | Begruendung |
|
|
|---|---|---|---|---|---|
|
|
| S01 | [[Screens/S01 Login]] | ja | ja, Hauptauthentifizierung | Bauen | Hauptscreen |
|
|
| S02 | [[Screens/S02 Magic-Link anfordern]] | ja | ja, alternativer Login-Weg | Bauen | Nutzer entscheidet bewusst Magic-Link |
|
|
| S03 | [[Screens/S03 Magic-Link gesendet]] | ja | ja, naechster Schritt muss klar sein | Bauen | copy-kritischer Zustand |
|
|
| S04 | [[Screens/S04 2FA Code eingeben]] | ja | ja, Security-Schritt | Bauen | eigener Auth-Schritt |
|
|
| V01 | [[Varianten/V01 Login falsche Daten]] | teilweise | ja, sensibler Fehlertext | Bauen | Copy nicht Dev ueberlassen |
|
|
| V02 | [[Varianten/V02 Login mit mCaptcha]] | teilweise | ja, Feld/Struktur kommt hinzu | Bauen | Captcha-Slot muss sichtbar sein |
|
|
| V03 | [[Varianten/V03 2FA gesperrt]] | ja | ja, Blocker | Bauen | Nutzer braucht klare Loesung |
|
|
| D01 | Trust Device | nein | nein | Wiederverwenden | Checkbox in S04 |
|
|
| D02 | Login erfolgreich | nein | nein | Raus | nur Weiterleitung |
|
|
| D03 | Admin nach Login | nein | Rollen-Outcome | Nur dokumentieren | siehe `WF-P2 Workspace Auswahl`; UI-Begriff ist Workspace |
|
|
| D04 | Konto erstellen Link | nein | Navigation zu anderem Flow | Wiederverwenden | Link in S01, Signup ist eigenes Paket |
|
|
| D05 | E-Mail-Pre-Screen | nein | zusaetzlicher Schritt | Raus | fuer v1 nicht noetig |
|
|
|
|
### Copy-kritische Zustaende
|
|
|
|
| Zustand | Bauen? | Warum / Copy-Entscheidung |
|
|
|---|---|---|
|
|
| Magic-Link gesendet | ja | Nutzer muss wissen, was als Naechstes passiert |
|
|
| Falsche Login-Daten | ja | neutraler Sicherheitstext, keine Account-Enumeration |
|
|
| mCaptcha nach 3 Versuchen | ja | Layout aendert sich, Anti-Abuse sichtbar |
|
|
| 2FA gesperrt | ja | starker Blocker, Loesung muss klar sein |
|
|
|
|
---
|
|
|
|
## 7. Validierte Screen-Liste
|
|
|
|
| ID | Screen/Zustand | Typ | Umsetzung | Ort | Status |
|
|
|---|---|---|---|---|---|
|
|
| S01 | [[Screens/S01 Login]] | Auth Form | Bauen | `/login` | Validiert |
|
|
| S02 | [[Screens/S02 Magic-Link anfordern]] | Auth Form | Bauen | von S01 | Validiert |
|
|
| S03 | [[Screens/S03 Magic-Link gesendet]] | Auth Feedback | Bauen | nach S02 | Validiert |
|
|
| S04 | [[Screens/S04 2FA Code eingeben]] | Auth Security | Bauen | nach S01 | Validiert |
|
|
| V01 | [[Varianten/V01 Login falsche Daten]] | Auth Error | Bauen | Variante von S01 | Validiert |
|
|
| V02 | [[Varianten/V02 Login mit mCaptcha]] | Auth Error | Bauen | Variante von S01 | Validiert |
|
|
| V03 | [[Varianten/V03 2FA gesperrt]] | Auth Blocker | Bauen | Variante von S04 | Validiert |
|
|
|
|
---
|
|
|
|
## 8. Subframe-Grid
|
|
|
|
Hauptflow:
|
|
|
|
```text
|
|
S01 Login -> S04 2FA Code eingeben -> Outcome
|
|
```
|
|
|
|
Magic-Link Branch:
|
|
|
|
```text
|
|
S01 Login -> S02 Magic-Link anfordern -> S03 Magic-Link gesendet
|
|
```
|
|
|
|
Login-Varianten:
|
|
|
|
```text
|
|
S01 Login
|
|
|
|
|
v
|
|
V01 Login falsche Daten
|
|
|
|
S01 Login
|
|
|
|
|
v
|
|
V02 Login mit mCaptcha
|
|
```
|
|
|
|
2FA-Variante:
|
|
|
|
```text
|
|
S04 2FA Code eingeben
|
|
|
|
|
v
|
|
V03 2FA gesperrt
|
|
```
|
|
|
|
Outcome nach erfolgreichem Login:
|
|
|
|
| Rolle | Ziel |
|
|
|---|---|
|
|
| Normale Rolle | Home/App |
|
|
| Admin | Tenant-/Workspace-Auswahl oder Admin-Startpunkt |
|
|
|
|
---
|
|
|
|
## 9. Screen-Pakete
|
|
|
|
- [[Screens/S01 Login]]
|
|
- [[Screens/S02 Magic-Link anfordern]]
|
|
- [[Screens/S03 Magic-Link gesendet]]
|
|
- [[Screens/S04 2FA Code eingeben]]
|
|
- [[Varianten/V01 Login falsche Daten]]
|
|
- [[Varianten/V02 Login mit mCaptcha]]
|
|
- [[Varianten/V03 2FA gesperrt]]
|
|
|
|
---
|
|
|
|
## 10. Handoff-Check
|
|
|
|
- [x] Jeder Screen ist mit Umsetzung markiert.
|
|
- [x] Jedes sichtbare Feld hat eine Datenquelle.
|
|
- [x] Jeder Button hat eine Aktion.
|
|
- [x] Banner/Inline-Meldungen sind dokumentiert.
|
|
- [x] Toasts/Action-Feedback sind dokumentiert.
|
|
- [x] Relevante Zustaende sind beschrieben.
|
|
- [x] Rollen-Outcome ist dokumentiert.
|
|
- [x] Offene Fragen sind sichtbar.
|
|
- [x] Subframe-Link ist eingetragen.
|