- Flow-Editor auf n8n-Stil umgestellt: V1 Vollbild minimal als Basis (Vollbild-Canvas, Umschalter Bauen/Aktivität/Auswertung, Probelauf unten Mitte, Aktiv-Toggle + History im Header) - Baustein-Konfig als Modal entschieden (Dialog-Komponente); S05a Vorplanung mit allen 31 Panels, 30 v1-Panels in Subframe gebaut (K-Seiten, Nacht-Build 2026-07-12) - Subframe-Links + Abgleich-Notizen in P12-Screens und Tracker nachgetragen - D-FORM Form Builder: Review-Stand, Simple-Builder-Neuausrichtung, aufgeräumte Varianten - P15 Kommunikation + P16 Termine Pakete, Map/Canvas-Pflege Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
226 lines
10 KiB
Markdown
226 lines
10 KiB
Markdown
---
|
|
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 Auth/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.
|