--- 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.