# Magic-Link Secondary-Flow (Password-Reset-Alternative) **Status:** completed **Task-ID:** #19 **Phase:** 01 **Estimated Effort:** 1 Tag **Owner:** claude (opus-4-7) ## Problem Aktuell hat `/forgot-password` nur einen Pfad: Benutzer gibt Email an → bekommt einen Reset-Link → muss ein neues Passwort setzen. Das ist: - **Friction**: User muss sich ein neues Passwort merken/speichern - **Konversions-Verlust**: viele User brechen ab beim Schritt "neues Passwort setzen" - **Inkonsistent zu modernen SaaS**: Notion, Linear, Vercel etc. bieten Magic-Link als Alternative `apps/web/app/services/auth/magic-link.server.ts` existiert bereits (für Initial-Onboarding). Wir nutzen die existierende Token-Generation-Logik und exposen sie als zweiten Button im `/forgot-password`-Flow. Resultat: User wählt zwischen - "Reset-Link senden" (klassisch, neuer Password-Setup) - "Magic-Link senden" (direkt einloggen ohne Passwort-Change) Beide Pfade bleiben parallel. ## Depends on - `01-tech-debt-foundation/password-policy.md` (#27) — Reset-Pfad nutzt die neue Policy beim Passwort-Setup. Wenn Magic-Link gewählt wird, ist keine Passwort-Eingabe nötig → keine Policy-Berührung, aber Code-Konsistenz wichtig. - `01-tech-debt-foundation/dep-updates.md` (#28) — bcrypt → argon2; bei Magic-Link wird kein Hash neu gesetzt, aber die Session-Erstellung muss konsistent sein. ## Blocks - `01-tech-debt-foundation/magic-link-invitation.md` (#20) — gleiches `magic-link.server.ts`-File. Wenn parallel gearbeitet wird, kommt es zu Merge-Konflikten. Empfohlen: #19 zuerst, #20 danach. ## Approach **Minimal-Invasive Erweiterung** des bestehenden Flows. Kein neuer Auth-Service, kein paralleler Token-Store — wir nutzen `magic-link.server.ts` wie es ist. UI-Änderungen: - `/forgot-password` bekommt zwei Buttons statt einem: - **Primary**: "Passwort zurücksetzen" (existierend) - **Secondary**: "Einmal-Login per Magic-Link senden" (neu) - Beide POSTen an unterschiedliche Action-IDs (`reset` vs `magic`). Backend-Änderungen: - `forgot-password.tsx` Action discriminiert per Form-Field `mode: 'reset' | 'magic'`. - Bei `mode: 'magic'`: signierter Token via `magic-link.server.ts.generateMagicLinkToken({ userId, purpose: 'login', ttl: 15min })` erstellt, Email mit Link `https:///auth/magic-link?token=` versendet. - Neue Route `apps/web/app/routes/auth/magic-link.tsx`: Loader verifiziert Token (single-use, expire-check), erzeugt Session, redirected zu Dashboard. Rate-Limit auf den Trigger-Endpoint: per IP UND per Email-Address (max 3 Requests / 15 Min). Email-basiertes Limit verhindert Email-Bombing. Alternativen verworfen: - **Magic-Link ersetzt Reset-Flow komplett** — Risiko für User die Authenticator-Apps mit gespeicherten Passwörtern nutzen, würden Workflow brechen. - **OAuth-Replacement** — out-of-scope, Phase 09 adressiert das. ## Implementation Steps 1. **Audit `magic-link.server.ts`** - Files: keine (Recherche) - Aktion: Prüfen welche API bereits existiert. Wenn `generateMagicLinkToken({purpose, ttl})` schon polyvalent designed ist → direkt nutzen. Wenn nur invitation-spezifisch → minor Refactor um `purpose: 'login' | 'invitation' | 'reset-alt'`-Param zu unterstützen. - Output: Notiz im PR-Body 2. **Magic-Link-Service polyvalent machen (falls nötig)** - Files: `apps/web/app/services/auth/magic-link.server.ts` - Aktion: - `generateMagicLinkToken({ userId, purpose, ttl, metadata? })` exportieren - `verifyMagicLinkToken(token, expectedPurpose?)` exportieren — Single-Use durch In-DB-Used-Flag oder In-Memory-Nonce-Store (Empfehlung: DB-Flag wenn schon Token-Tabelle existiert, sonst In-Memory mit Redis als Backing). - Tests dafür schreiben. - Commit: `01/magic-link-reset: extend magic-link service with purpose param` 3. **Action-Logic in `/forgot-password`** - Files: `apps/web/app/routes/forgot-password.tsx` (oder wherever die Action lebt) - Aktion: - Form-Field `mode` lesen - Bei `reset`: existierender Pfad - Bei `magic`: 1. User per Email lookup 2. Wenn User existiert: `generateMagicLinkToken({ userId, purpose: 'login', ttl: 15*60*1000 })` 3. Email versenden via existierendem EmailService (Template: `magicLinkLogin`) 4. Response: gleicher generischer Success-Message wie Reset-Pfad ("Wenn ein Account existiert, haben wir dir einen Link geschickt") — kein User-Enumeration-Risk - Bei Nicht-Existenz: identischer Response (anti-enumeration) - Commit: `01/magic-link-reset: add magic-link mode to forgot-password action` 4. **UI mit zwei Buttons** - Files: `apps/web/app/routes/forgot-password.tsx` (Component) ggf. + Übersetzungs-Files - Aktion: - Form mit zwei `