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,65 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P2
package: WF-P2 Passwort Reset
id: M01
screen: Admin kontaktieren
typ: Auth Modal
umsetzung: Bauen
status: In Subframe
route: von V02
subframe: "https://app.subframe.com/f023064a5ca0/design/dd67e352-227f-4ff9-b20e-8396ede1ffe5/edit"
---
# M01 — Admin kontaktieren
## Ziel
Der Nutzer kann aus dem 2FA-Blocker heraus eine kurze Nachricht an den Workspace-Admin senden.
## Pattern / Archetyp
Kleines Modal im Auth-/Recovery-Kontext.
## Daten
- Account-E-Mail aus Reset-Kontext
- Nachricht an Admin
- optional technische Kontextdaten: Reset angefordert, 2FA nicht verfuegbar
## Aktionen
- Nachricht senden
- Modal schliessen / abbrechen
## Banner / Hinweise
- Kurz erklaeren, dass der Admin nach Identitaetspruefung helfen kann.
- Kein Support-Pfad in v1.
## Toasts / Action-Feedback
- Nachricht wurde an den Admin gesendet.
- Nachricht konnte nicht gesendet werden. Bitte erneut versuchen.
## Zustaende
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Standard | Textarea leer oder vorbefuellt | Bauen |
| Senden | Button loading | Wiederverwenden |
| Fehler | Nachricht konnte nicht gesendet werden | Nur dokumentieren |
## Permissions / Gates
- gueltiger Reset-Kontext
- Account hat aktive 2FA
## Subframe
https://app.subframe.com/f023064a5ca0/design/dd67e352-227f-4ff9-b20e-8396ede1ffe5/edit
## Notizen
Der Button `Admin kontaktieren` in V02 oeffnet dieses Modal. Es gibt keinen separaten Support-CTA.
@@ -0,0 +1,67 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P2
package: WF-P2 Passwort Reset
id: M02
screen: Wiederherstellungscode eingeben
typ: Auth Modal
umsetzung: Bauen
status: In Subframe
route: von V02
subframe: "https://app.subframe.com/f023064a5ca0/design/a5f09736-66ba-4ceb-9cc3-e8bae98c33bc/edit"
---
# M02 — Wiederherstellungscode eingeben
## Ziel
Der Nutzer kann einen zuvor gespeicherten Wiederherstellungscode nutzen, um die verlorene 2FA sicher zurueckzusetzen.
## Pattern / Archetyp
Kleines Security-Modal im Auth-/Recovery-Kontext.
## Daten
- Wiederherstellungscode
- Reset-Token / Reset-Kontext
- Account-ID aus Reset-Kontext
## Aktionen
- Code pruefen und 2FA zuruecksetzen
- abbrechen
## Banner / Hinweise
- Wiederherstellungscodes funktionieren nur, wenn sie vorher gespeichert wurden.
- Jeder Code ist nur einmal nutzbar.
- Nach erfolgreicher Nutzung muss 2FA neu eingerichtet werden.
## Toasts / Action-Feedback
- 2FA wurde zurueckgesetzt.
- Wiederherstellungscode ist ungueltig oder wurde bereits verwendet.
## Zustaende
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Standard | Code-Eingabe leer | Bauen |
| Laden | Code wird geprueft | Wiederverwenden |
| Fehler | Code falsch/abgelaufen/bereits verwendet | Nur dokumentieren |
## Permissions / Gates
- gueltiger Reset-Kontext
- Account hat aktive 2FA
- Wiederherstellungscode ist gueltig und noch nicht verwendet
## Subframe
https://app.subframe.com/f023064a5ca0/design/a5f09736-66ba-4ceb-9cc3-e8bae98c33bc/edit
## Notizen
Nach erfolgreicher Pruefung wird die alte 2FA zurueckgesetzt und der Nutzer kann in `WF-P2 Set Password` fortfahren. Danach sollte ein neues 2FA-Setup verpflichtend angestossen werden.
@@ -0,0 +1,63 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P2
package: WF-P2 Passwort Reset
id: S01
screen: Passwort Reset anfordern
typ: Auth Form
umsetzung: Bauen
status: In Subframe
route: /forgot-password
subframe: "https://app.subframe.com/f023064a5ca0/design/3ced4ee5-d29a-4897-b12e-1ccdc3e2452a/edit"
---
# S01 — Passwort Reset anfordern
## Ziel
Der Nutzer fordert einen Link an, um sein Passwort zurueckzusetzen.
## Pattern / Archetyp
A4 Form / Auth-Card.
## Daten
- E-Mail-Adresse
## Aktionen
- Reset-Link senden
- Abbrechen als kleiner Link -> Login
## Banner / Hinweise
- Nicht schreiben: "E-Mail nicht gefunden".
## Toasts / Action-Feedback
- Kein Toast; nach Absenden geht es zu S02.
## Zustaende
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Leer | E-Mail-Feld leer | Bauen |
| Laden | Link wird angefordert | Wiederverwenden |
| E-Mail fehlt/ungueltig | Standardformularfehler | Nur dokumentieren |
| Zu viele Anfragen | Rate-Limit | Nur dokumentieren |
## Permissions / Gates
- oeffentlicher Auth-Einstieg
## Subframe
-
## Notizen
Der Screen darf keine Account-Existenz verraten.
`Abbrechen` ist kein gleichgewichtiger Button, sondern ein kleiner Textlink unter oder neben der Primaeraktion.
@@ -0,0 +1,64 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P2
package: WF-P2 Passwort Reset
id: S02
screen: Reset-Link gesendet
typ: Auth Feedback
umsetzung: Bauen
status: In Subframe
route: /forgot-password sent
subframe: "https://app.subframe.com/f023064a5ca0/design/56bcee87-b6ba-4f2a-abdb-fd9323f9b72b/edit"
---
# S02 — Reset-Link gesendet
## Ziel
Der Nutzer versteht, dass er sein Postfach pruefen soll.
## Pattern / Archetyp
Auth-Status-Card.
## Daten
- E-Mail-Adresse, wenn eingegeben
- Hinweis auf Postfach und Spam-Ordner
## Aktionen
- Link erneut senden
- Abbrechen als kleiner Link -> Login
## Banner / Hinweise
- Neutraler Text: Wenn ein Konto zu dieser E-Mail existiert, senden wir einen Link.
- Keine sichtbare Unterscheidung zwischen bekannter und unbekannter E-Mail.
## Toasts / Action-Feedback
- Kein Toast; der Status ist der Screen.
## Zustaende
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Gesendet | Postfach pruefen | Bauen |
| Erneut senden | Button loading | Wiederverwenden |
| Rate-Limit | keine harte Fehlermeldung, neutral bleiben | Nur dokumentieren |
## Permissions / Gates
- S01 wurde abgesendet.
## Subframe
-
## Notizen
Dieser Screen ist bewusst copy-kritisch. Er schuetzt gegen Account Enumeration.
`Abbrechen` ist ein kleiner sekundarer Textlink, nicht die Primaeraktion.
@@ -0,0 +1,67 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P2
package: WF-P2 Passwort Reset
id: S03
screen: 2FA bestaetigen
typ: Auth Security
umsetzung: Bauen
status: In Subframe
route: /reset 2fa
subframe: "https://app.subframe.com/f023064a5ca0/design/8792bb49-0460-42b3-89ad-62ec8bea70ba/edit"
---
# S03 — 2FA bestaetigen
## Ziel
Der Nutzer bestaetigt 2FA, bevor er in `WF-P2 Set Password` wechseln darf.
## Pattern / Archetyp
A4 Form / Auth-Security-Step.
## Daten
- 6-stelliger Authenticator-Code
- optional Hinweis auf Recovery-Code, falls spaeter erlaubt
## Aktionen
- Code bestaetigen
- 2FA nicht verfuegbar
- neuen Reset-Link anfordern
- Abbrechen als kleiner Link -> Login
## Banner / Hinweise
- Klarer Sicherheitstext: Fuer diesen Account ist 2FA aktiv.
## Toasts / Action-Feedback
- Kein Success-Toast; nach erfolgreicher 2FA geht es zu `WF-P2 Set Password`.
## Zustaende
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Code eingeben | 2FA-Codefeld sichtbar | Bauen |
| Laden | Code wird geprueft | Wiederverwenden |
| Code falsch | Inline-Fehler | Nur dokumentieren |
| 2FA nicht verfuegbar | siehe V02 | Bauen |
## Permissions / Gates
- Reset-Link ist gueltig.
- Account hat aktive 2FA.
## Subframe
-
## Notizen
Der Reset-Flow darf aktive 2FA nicht umgehen.
`Abbrechen` ist ein kleiner sekundarer Textlink.
@@ -0,0 +1,61 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P2
package: WF-P2 Passwort Reset
id: V01
screen: Reset-Link ungueltig
typ: Auth Blocker
umsetzung: Bauen
status: In Subframe
route: /reset invalid
subframe: "https://app.subframe.com/f023064a5ca0/design/5b085f60-cf07-4426-af52-d91ba8716380/edit"
---
# V01 — Reset-Link ungueltig
## Ziel
Der Nutzer versteht, dass der Reset-Link nicht mehr verwendet werden kann.
## Pattern / Archetyp
Auth-Blocker-Card.
## Daten
- Link ist ungueltig oder abgelaufen
- kurzer Hinweis auf neue Link-Anforderung
## Aktionen
- neuen Link anfordern
- Abbrechen als kleiner Link -> Login
## Banner / Hinweise
- Klarer Blockertext ohne technische Token-Details.
## Toasts / Action-Feedback
- Kein Toast; Blocker ist der Screen.
## Zustaende
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Ungueltig | Link fehlt, Token falsch oder abgelaufen | Bauen |
## Permissions / Gates
- Reset-Link kann nicht validiert werden.
## Subframe
-
## Notizen
Technisch ist der Token aktuell ca. 1 Stunde gueltig. Die UI muss keine exakte Dauer nennen, wenn Produkt/Dev das nicht final freigeben.
`Abbrechen` ist ein kleiner sekundarer Textlink.
@@ -0,0 +1,69 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P2
package: WF-P2 Passwort Reset
id: V02
screen: 2FA nicht verfuegbar
typ: Auth Blocker
umsetzung: Bauen
status: In Subframe
route: /reset 2fa unavailable
subframe: "https://app.subframe.com/f023064a5ca0/design/5057dbae-f5e2-4b6e-a938-6c10785890de/edit"
---
# V02 — 2FA nicht verfuegbar
## Ziel
Der Nutzer versteht, dass der Passwort-Reset nicht ohne zweiten Faktor fortgesetzt werden kann und waehlt einen sicheren Recovery-Pfad.
## Pattern / Archetyp
Auth-Blocker-Card.
## Daten
- Hinweis, dass 2FA fuer den Account aktiv ist
- Hinweis auf Admin-Kontakt
- Hinweis auf Wiederherstellungscode, falls vorhanden
## Aktionen
- Admin kontaktieren
- 2FA mit Wiederherstellungscode zuruecksetzen
- Abbrechen als kleiner Link -> Login
## Banner / Hinweise
- Klarer Text: Aus Sicherheitsgruenden kann 2FA hier nicht uebersprungen werden.
- Keine technische Anleitung zum Umgehen von 2FA.
- Wiederherstellungscode ist ein legitimer Recovery-Pfad, kein Bypass.
## Toasts / Action-Feedback
- Kein Toast; Blocker bleibt im Screen.
## Zustaende
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| 2FA verloren | Authenticator nicht verfuegbar | Bauen |
| Admin kontaktieren | kleines Modal mit Textarea | M01 |
| Wiederherstellungscode verwenden | Code eingeben und 2FA zuruecksetzen | M02 |
| Kein Admin bekannt | spaeter klaeren | Spaeter |
## Permissions / Gates
- Account hat aktive 2FA.
- Nutzer kann 2FA nicht bestaetigen.
## Subframe
https://app.subframe.com/f023064a5ca0/design/5057dbae-f5e2-4b6e-a938-6c10785890de/edit
## Notizen
Dieser Screen ist wichtig, damit der Developer nicht improvisiert. Der Nutzer bekommt zwei sichere Pfade: Admin kontaktieren oder einen zuvor gespeicherten Wiederherstellungscode verwenden.
`Abbrechen` ist ein kleiner sekundarer Textlink.
@@ -0,0 +1,28 @@
{
"nodes":[
{"id":"group-blocker","type":"group","x":980,"y":560,"width":1840,"height":620,"label":"Blocker und Recovery"},
{"id":"group-main","type":"group","x":-80,"y":-100,"width":2440,"height":420,"label":"Hauptflow"},
{"id":"group-notes","type":"group","x":-80,"y":560,"width":820,"height":380,"label":"Regeln"},
{"id":"s01","type":"file","file":"02 Wireframes/P2 Passwort Reset/WF-P2 Passwort Reset/Screens/S01 Passwort Reset anfordern.md","x":0,"y":0,"width":420,"height":200},
{"id":"s02","type":"file","file":"02 Wireframes/P2 Passwort Reset/WF-P2 Passwort Reset/Screens/S02 Reset-Link gesendet.md","x":640,"y":0,"width":420,"height":200},
{"id":"s03","type":"file","file":"02 Wireframes/P2 Passwort Reset/WF-P2 Passwort Reset/Screens/S03 2FA bestaetigen.md","x":1280,"y":0,"width":420,"height":200},
{"id":"outcome-set-password","type":"text","text":"# Outcome\n\nWeiter zu `WF-P2 Set Password`.\n\nDort werden neues Passwort, 2FA-Angebot/Pflicht, Recovery-Hinweis und Abschluss gebaut.","x":1920,"y":0,"width":360,"height":220},
{"id":"v01","type":"file","file":"02 Wireframes/P2 Passwort Reset/WF-P2 Passwort Reset/Varianten/V01 Reset-Link ungueltig.md","x":1080,"y":680,"width":420,"height":200},
{"id":"v02","type":"file","file":"02 Wireframes/P2 Passwort Reset/WF-P2 Passwort Reset/Varianten/V02 2FA nicht verfuegbar.md","x":1700,"y":680,"width":420,"height":200},
{"id":"note-security","type":"text","text":"# Security-Regel\n\nUnbekannte E-Mail zeigt denselben Gesendet-Screen wie bekannte E-Mail.\n\nKein Screen `E-Mail nicht gefunden`.","x":0,"y":680,"width":360,"height":200},
{"id":"note-2fa","type":"text","text":"# 2FA-Regel\n\nWenn 2FA aktiv ist, muss sie vor Set Password bestaetigt werden.\n\nWenn 2FA nicht verfuegbar ist: Admin kontaktieren oder gespeicherten Wiederherstellungscode verwenden.","x":440,"y":680,"width":360,"height":240},
{"id":"m02-recovery","type":"file","file":"02 Wireframes/P2 Passwort Reset/WF-P2 Passwort Reset/Screens/M02 Wiederherstellungscode eingeben.md","x":2360,"y":600,"width":420,"height":200},
{"id":"m01-admin","type":"file","file":"02 Wireframes/P2 Passwort Reset/WF-P2 Passwort Reset/Screens/M01 Admin kontaktieren.md","x":2360,"y":920,"width":420,"height":200}
],
"edges":[
{"id":"edge-s01-s02","fromNode":"s01","fromSide":"right","toNode":"s02","toSide":"left","label":"senden"},
{"id":"edge-s02-s03","fromNode":"s02","fromSide":"right","toNode":"s03","toSide":"left","label":"Link + 2FA"},
{"id":"edge-s03-outcome","fromNode":"s03","fromSide":"right","toNode":"outcome-set-password","toSide":"left","label":"ok"},
{"id":"edge-s02-outcome","fromNode":"s02","fromSide":"bottom","toNode":"outcome-set-password","toSide":"bottom","label":"ohne 2FA"},
{"id":"edge-s02-v01","fromNode":"s02","fromSide":"bottom","toNode":"v01","toSide":"top","label":"ungueltig"},
{"id":"edge-s03-v02","fromNode":"s03","fromSide":"bottom","toNode":"v02","toSide":"top","label":"kein 2FA"},
{"id":"edge-v02-m01","fromNode":"v02","fromSide":"right","toNode":"m01-admin","toSide":"left","label":"Admin kontaktieren"},
{"id":"edge-v02-m02","fromNode":"v02","fromSide":"right","toNode":"m02-recovery","toSide":"left","label":"Recovery-Code"},
{"id":"edge-m02-outcome","fromNode":"m02-recovery","fromSide":"top","toNode":"outcome-set-password","toSide":"bottom","label":"Code ok"}
]
}
@@ -0,0 +1,225 @@
---
kind: wireframe-package
project: HiveGrid Screen Project
ticket: D-P2
package: WF-P2 Passwort Reset
typ: Zubringerflow
status: In Subframe
subframe: "https://app.subframe.com/f023064a5ca0/flow/5782f3c4-4321-4bb9-b048-990e296897a4/edit"
canvas: "02 Wireframes/P2 Passwort Reset/WF-P2 Passwort Reset/WF-P2 Passwort Reset.canvas"
---
# WF-P2 Passwort Reset
Status: In Subframe
Subframe-Link: https://app.subframe.com/f023064a5ca0/flow/5782f3c4-4321-4bb9-b048-990e296897a4/edit
Canvas: [[WF-P2 Passwort Reset.canvas]]
Stand: 2026-06-23
---
## 1. Kurzfassung
`Passwort Reset` ist ein Zubringerflow zum zentralen `WF-P2 Set Password`.
Der Nutzer fordert per E-Mail einen Reset-Link an. Nach dem Oeffnen des Links wird, falls fuer den Account 2FA aktiv ist, erst 2FA bestaetigt. Danach fuehrt der Flow in `WF-P2 Set Password`.
Wenn 2FA nicht mehr verfuegbar ist, bekommt der Nutzer einen klaren Blocker-Screen mit zwei sicheren Pfaden: Admin kontaktieren oder einen zuvor gespeicherten Wiederherstellungscode verwenden.
---
## 2. Intent Check
| Frage | Antwort |
|---|---|
| Welches Ticket/Modul ist betroffen? | D-P2 / Auth |
| Was soll der Nutzer am Ende schaffen? | Passwort-Reset sicher starten und danach in Set Password wechseln |
| Ist es ein Flow, einzelner Screen, Zustand oder nur Dokumentation? | Zubringerflow |
| Welche Planning-Quellen wurden geprueft? | D-P2, Route `/forgot-password`, Route `/reset`, Passwort-Reset-Mail, Password Policy |
| Was ist sicher im Scope? | E-Mail anfordern, Reset-Link gesendet, 2FA-Bestaetigung, Link ungueltig/abgelaufen, 2FA nicht verfuegbar, Admin-Kontakt, Wiederherstellungscode als Recovery-Pfad |
| Was ist sicher nicht im Scope? | Neues Passwort setzen, 2FA neu einrichten im Detail, separater externer Kontaktpfad |
| Gibt es Admin/Normalrolle-Unterschiede? | Nutzer sieht bei verlorener 2FA den Admin-Kontakt und kann optional einen gespeicherten Wiederherstellungscode nutzen |
| Welche Annahmen sind noch unsicher? | Detailverhalten nach erfolgreichem Recovery-Code: ob 2FA direkt neu eingerichtet werden muss oder nach Set Password erzwungen wird |
---
## 3. Scope
| Punkt | Inhalt |
|---|---|
| Ticket/Modul | D-P2 / Auth |
| Nutzerrolle | Nutzer ohne aktuelle Session |
| Startpunkt | Login -> Passwort vergessen |
| Ziel | sicherer Uebergang in `WF-P2 Set Password` |
| Haupt-Archetyp | A4 Form + Auth-Status |
| Bespoke-Anteil | nein |
| Security-Regel | keine User Enumeration: unbekannte E-Mail zeigt denselben Gesendet-Screen |
| Out of scope | Passwortformular, 2FA-Setup, Admin-Reset aus Admin UI |
---
## 4. Brainstorming
### Flow-Frage
Wie viel Sicherheit braucht der Passwort-Reset, bevor der Nutzer ein neues Passwort setzen darf?
### UX-Varianten
| Option | Beschreibung | Vorteil | Nachteil | Empfehlung |
|---|---|---|---|---|
| A | E-Mail eingeben -> Link gesendet -> Set Password | sehr kurz | zu schwach, wenn 2FA aktiv ist | raus |
| B | E-Mail eingeben -> Link gesendet -> 2FA pruefen, falls aktiv -> Set Password | sicherer B2B-Standard | ein zusaetzlicher Schritt bei aktiver 2FA | genommen |
| C | Immer Admin/Support oder Recovery-Code vor Set Password | maximal vorsichtig | zu viel Reibung fuer Standard-Reset | raus |
### Entscheidung
| Entscheidung | Status | Notiz |
|---|---|---|
| Option B | genommen | Reset bleibt schlank, aber 2FA wird respektiert |
| Keine E-Mail-nicht-gefunden-Meldung | genommen | neutraler Gesendet-Screen verhindert Account Enumeration |
| 2FA vor Set Password, wenn aktiv | genommen | Reset darf 2FA nicht umgehen |
| 2FA nicht verfuegbar als eigener Screen | genommen | Nutzer braucht klare Loesung: Admin kontaktieren oder Wiederherstellungscode verwenden |
| Separater externer Kontaktpfad | raus | V1 nutzt nur Admin-Kontakt als Kontaktpfad |
| Wiederherstellungscode als Alternative | genommen | Code ist legitimer Recovery-Pfad, wenn er vorher gespeichert wurde und einmalig verwendet wird |
| Neues Passwort nicht hier bauen | genommen | liegt im zentralen `WF-P2 Set Password` |
| Abbrechen als kleiner Link | genommen | Reset-Flow kann jederzeit ueber kleinen Textlink zum Login verlassen werden |
### Happy Path
1. Nutzer klickt im Login auf Passwort vergessen.
2. Nutzer gibt E-Mail ein.
3. Nutzer sieht neutralen Screen: Reset-Link gesendet.
4. Nutzer oeffnet Link aus der E-Mail.
5. Wenn 2FA aktiv ist, bestaetigt der Nutzer 2FA.
6. Danach geht es zu `WF-P2 Set Password`.
### Varianten / Branches
- Reset-Link ist ungueltig oder abgelaufen.
- 2FA ist aktiv, aber Nutzer hat keinen Zugriff mehr auf Authenticator.
- Nutzer kontaktiert Admin mit kurzer Nachricht.
- Nutzer nutzt einen gespeicherten Wiederherstellungscode, um 2FA zurueckzusetzen.
- E-Mail ist unbekannt: trotzdem S02 anzeigen.
- Zu viele Anfragen: Rate-Limit wird dokumentiert, kein eigener Screen fuer v1.
### Roadblocks
- E-Mail fehlt/ungueltig
- Reset-Link ungueltig/abgelaufen
- 2FA-Code falsch
- 2FA nicht verfuegbar
- Wiederherstellungscode ungueltig oder bereits verwendet
- Rate-Limit
---
## 5. Screen-Kandidaten nach Entscheidung
| Kandidat | Warum eventuell noetig? | Erste Einschaetzung |
|---|---|---|
| Passwort Reset anfordern | Hauptstart | Bauen |
| Reset-Link gesendet | copy-kritischer Status, Anti-Enumeration | Bauen |
| 2FA bestaetigen | Sicherheitspruefung vor Set Password | Bauen |
| Reset-Link ungueltig/abgelaufen | eigener Blocker mit naechster Aktion | Bauen |
| 2FA nicht verfuegbar / Admin kontaktieren | Nutzer ist sonst festgefahren | Bauen |
| Admin kontaktieren Modal | Nutzer soll dem Admin direkt eine kurze Nachricht senden koennen | Bauen |
| Wiederherstellungscode eingeben | sicherer Self-Service-Pfad, wenn Code vorhanden ist | Bauen |
| E-Mail fehlt/ungueltig | Formularzustand | Nur dokumentieren |
| E-Mail nicht gefunden | darf nicht sichtbar sein | Wiederverwenden S02 |
| Zu viele Anfragen | Rate-Limit-Zustand | Nur dokumentieren |
---
## 6. Screen Validation Gate
| ID | Screen/Zustand | Ist eigener Arbeitsmoment? | Neue Struktur/Entscheidung/Risiko? | Entscheidung | Begruendung |
|---|---|---|---|---|---|
| S01 | [[Screens/S01 Passwort Reset anfordern]] | ja | ja, Start des Flows | Bauen | eigener Auth-Einstieg |
| S02 | [[Screens/S02 Reset-Link gesendet]] | ja | ja, copy-kritischer Status | Bauen | Anti-Enumeration muss klar gestaltet sein |
| S03 | [[Screens/S03 2FA bestaetigen]] | ja | ja, Sicherheitspruefung | Bauen | Reset darf 2FA nicht umgehen |
| V01 | [[Varianten/V01 Reset-Link ungueltig]] | ja | ja, Blocker | Bauen | Nutzer braucht neuen Link |
| V02 | [[Varianten/V02 2FA nicht verfuegbar]] | ja | ja, Blocker | Bauen | Nutzer muss Admin kontaktieren oder Recovery-Code nutzen koennen |
| M01 | [[Screens/M01 Admin kontaktieren]] | ja | ja, Kontaktpfad | Bauen | kleines Modal mit Textarea an Admin |
| M02 | [[Screens/M02 Wiederherstellungscode eingeben]] | ja | ja, Security Recovery | Bauen | Code pruefen und 2FA sicher zuruecksetzen |
| D01 | E-Mail fehlt/ungueltig | nein | nein | Nur dokumentieren | Standardformular |
| D02 | E-Mail nicht gefunden | nein | Sicherheit | Wiederverwenden | immer S02 anzeigen |
| D03 | Zu viele Anfragen | nein | technischer Schutz | Nur dokumentieren | Meldung im S01/S02-Kontext |
| D04 | 2FA-Code falsch | nein | nein | Nur dokumentieren | Inline-Fehler in S03 |
### Copy-kritische Zustaende
| Zustand | Bauen? | Warum / Copy-Entscheidung |
|---|---|---|
| Reset-Link gesendet | ja | Nutzer muss wissen, dass auch unbekannte E-Mails gleich behandelt werden, ohne es direkt so zu sagen |
| Reset-Link ungueltig | ja | naechste Aktion muss klar sein |
| 2FA nicht verfuegbar | ja | starker Blocker, Admin-Kontakt oder Wiederherstellungscode notwendig |
| Admin-Nachricht | ja | Nutzer braucht klare Erwartung, was an Admin gesendet wird |
| Wiederherstellungscode | ja | Muss klar als vorher gespeicherter, einmalig nutzbarer Code erklaert werden |
---
## 7. Validierte Screen-Liste
| ID | Screen/Zustand | Typ | Umsetzung | Ort | Status |
| --- | ----------------------------------------------- | ------------- | --------- | -------------------------------- | ----------- |
| S01 | [[Screens/S01 Passwort Reset anfordern]] | Auth Form | Bauen | `/forgot-password` | Validiert |
| S02 | [[Screens/S02 Reset-Link gesendet]] | Auth Feedback | Bauen | nach S01 | Validiert |
| S03 | [[Screens/S03 2FA bestaetigen]] | Auth Security | Bauen | nach Reset-Link, falls 2FA aktiv | Validiert |
| V01 | [[Varianten/V01 Reset-Link ungueltig]] | Auth Blocker | Bauen | Link-Fehler | Validiert |
| V02 | [[Varianten/V02 2FA nicht verfuegbar]] | Auth Blocker | Bauen | Variante von S03 | In Subframe |
| M01 | [[Screens/M01 Admin kontaktieren]] | Auth Modal | Bauen | von V02 | In Subframe |
| M02 | [[Screens/M02 Wiederherstellungscode eingeben]] | Auth Modal | Bauen | von V02 | In Subframe |
---
## 8. Subframe-Grid
Hauptflow:
```text
S01 Passwort Reset anfordern -> S02 Reset-Link gesendet -> E-Mail-Link -> S03 2FA bestaetigen -> WF-P2 Set Password
```
Ohne aktive 2FA:
```text
S02 Reset-Link gesendet -> E-Mail-Link -> WF-P2 Set Password
```
Blocker:
```text
E-Mail-Link -> V01 Reset-Link ungueltig
S03 2FA bestaetigen -> V02 2FA nicht verfuegbar
V02 2FA nicht verfuegbar -> M01 Admin kontaktieren
V02 2FA nicht verfuegbar -> M02 Wiederherstellungscode eingeben -> WF-P2 Set Password
```
---
## 9. Screen-Pakete
- [[Screens/S01 Passwort Reset anfordern]]
- [[Screens/S02 Reset-Link gesendet]]
- [[Screens/S03 2FA bestaetigen]]
- [[Varianten/V01 Reset-Link ungueltig]]
- [[Varianten/V02 2FA nicht verfuegbar]]
- [[Screens/M01 Admin kontaktieren]]
- [[Screens/M02 Wiederherstellungscode eingeben]]
Alle Screens nutzen `Abbrechen` als kleinen sekundaren Link, wenn der Nutzer den Reset-Flow verlassen soll.
---
## 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] Relevante Zustaende sind beschrieben.
- [x] Zubringer-/Core-Regel ist dokumentiert.
- [x] Zurueck-/Abbrechen-Aktion ist dokumentiert.
- [x] Offene Fragen sind sichtbar.
- [x] Subframe-Link ist eingetragen.