# R-UX4 · Passwörter: Eigenständigen Passwort-Manager-Flow vervollständigen | | | |---|---| | **Typ** | Dev (UX-/Produkt-Nachzug) | | **Owner** | Raffael | | **Phase** | Querschnitt · Tenant UX | | **Cycle/Fenster** | noch nicht eingeplant | | **Status** | umgesetzt · wartet auf lokale Gesamtabnahme | | **Plane** | [HIVEGRID-203](https://project.tool-ctrl.de/toolctrl/projects/35d0d968-8ab3-40cc-97b8-b81d917dc5df/issues/ecf024ce-7dfc-480d-bb27-7d32036491ec) · Parent `HIVEGRID-199` | 🎨 **design-nachzug: offen** · AD-28-Interim-UI ist die verifizierte Abnahmebaseline. ## Abhängigkeiten & Parallelität - **Baut auf:** Passwort-Safe-Teil von `AK-P17a`. - **Design-Bezug:** betroffener Passwort-Safe-Teil von `D-HR`; finales Delta ist nach AD-28 kein Hard-Blocker. - **Abgrenzung zu `R-UX3`:** Personal entfernt Passwort-Navigation und -Komposition; Datenmodell, Verschlüsselung und bestehende Rechte werden nicht dupliziert. - **Hard-Block vor Umsetzung:** vorhandene Vault-/Entry-/Access-/Audit-/Export-Actions, Verschlüsselungsgrenzen und aktuelle Plane-Kommentare erneut lesen. ## Zielnutzer und Hauptaufgaben | Nutzer | Hauptaufgabe | |---|---| | Mitarbeitende | freigegebene Tresore finden, Eintrag öffnen und Wert sicher verwenden | | Vault-Bearbeitende | Einträge anlegen, bearbeiten und archivieren | | Vault-Admin | Mitglieder freigeben, Rechte ändern und entziehen | | Tenant-Passwort-Admin | Tresor-Metadaten und Audit überblicken, ohne automatisch Geheimnisse zu sehen | ## Belegter Ist-Flow 1. Passwörter sind unter Personal/HR versteckt und die Navigation kann unabhängig von echter Nutzbarkeit erscheinen. 2. Nicht bereite oder nicht erlaubte Zustände enden teilweise in einer leeren Fläche. 3. Freigaben verlangen rohe `targetUserId`-Eingaben. 4. Backend-Actions für Bearbeiten, Freigabeliste und Entzug sind nicht vollständig in der UI. 5. Archivierung erfolgt ohne angemessene Bestätigung. 6. Export-UI und Route verwenden unterschiedliche HTTP-Methoden; der Flow endet fehlerhaft. 7. Adminliste kann auf Details verlinken, die ein Metadaten-Admin ohne Vault-Zugriff nicht öffnen darf. 8. Audit, Suche und Bearbeitung sind unvollständig; Reveal blendet Klartext nicht automatisch wieder aus. ## Freigegebener Ziel-Flow 1. **Passwörter** ist ein eigener Hauptnavigationseintrag unter `/:tenant/passwords`. Alte HR-Pfade erhalten sichere Redirects. 2. Tresorliste zeigt nur erlaubte Tresore, Suche über Name/Beschreibung und keine Geheimwerte. 3. Tresordetail verwendet Tabs **Einträge / Freigaben / Aktivitäten**. 4. Einträge zeigen Metadaten; Geheimwerte werden erst nach serverseitig geprüftem Reveal geladen. 5. Reveal wird sichtbar zeitlich begrenzt, kann sofort geschlossen werden und wird ebenso wie Copy auditiert. Clipboard und sichtbarer Klartext werden nach 30 Sekunden geleert. 6. Einträge lassen sich nach Recht anlegen, bearbeiten und mit Klartextdialog archivieren. 7. Freigaben verwenden eine Personen-Combobox mit Name, E-Mail und Rolle; Rechte lassen sich ändern oder entziehen. 8. Export erfolgt ausschließlich per POST, verlangt Bestätigung und das neue Recht `hr.passwordsafe.export` zusätzlich zum Vault-Lesezugriff. 9. Tenant-Passwort-Admins sehen Metadaten/Audit, aber ohne Vault-Recht keine Einträge oder Werte. ## Vorher/Nachher | Vorher | Nachher | |---|---| | Passwort-Safe unter HR | eigener Bereich Passwörter | | rohe User-ID für Freigabe | sichere Personen-Combobox | | unvollständige Eintragsaktionen | Anlegen, Bearbeiten, Archivieren mit Rechteprüfung | | Reveal bleibt sichtbar | Auto-Hide + Clipboard-Clear + Audit | | GET/POST-Drift beim Export | POST-Command mit Exportrecht und Bestätigung | | Admin-Dead-Link | getrennte Metadaten- und Vault-Inhaltssicht | | kein sichtbarer Auditverlauf | Aktivitäten-Tab mit verständlichen Ereignissen | ## Screen- und Komponentenmatrix | Screen | Kernaufgabe | Vorhandene Bausteine | |---|---|---| | Tresorliste `/passwords` | suchen, Tresor öffnen, optional anlegen | `PageShell`, Header, `SearchInput`, Cards/Table, Empty-State | | Tresordetail `/passwords/:vaultId` | Einträge, Freigaben, Aktivitäten | Tabs, Table/mobile Cards, Status, Activity | | Eintrag erstellen/bearbeiten | sichere Felder bearbeiten | Drawer/Dialog, `TextInput`, Password field, Tags | | Reveal/Copy | Wert kurzzeitig nutzen | Reveal-Control, Timer, Copy-Feedback, Audit-Hinweis | | Freigabe verwalten | Person und Recht wählen | Combobox, Rollen-Select, Bestätigungsdialog | | Export | Umfang/Folge bestätigen | `DialogLayout`, Dialog, Download-Ergebnis | | Admin-Metadaten | Tresore/Audit ohne Secret-Leak | Table, Filter, Activity, keine Entry-Links ohne Access | Die `/forms`-Richtung gilt für Header, Suche/Filter, Tabs, klare Action-Zustände, responsive Tabelle/Karten und Dialoge. Der Passwort-Screen bleibt app-chrome-frei. ## Actions und erwartete Ergebnisse | Action | Serverprüfung | Sichtbares Ergebnis | |---|---|---| | `revealEntryField` | Tenant, Vault-read, Feld vorhanden, Audit | Wert mit 30-Sekunden-Timer | | `copyEntryField` | erneute Berechtigung bzw. kurzlebiges Reveal-Token, Audit | Copy-Bestätigung und Clear-Hinweis | | `createEntry` / `updateEntry` | Vault-write, CSRF, typisierte Daten | gespeicherter Eintrag ohne Secret in Liste | | `archiveEntry` | Vault-write, Bestätigung, Objektzugriff | archivierter Eintrag, Undo nur wenn fachlich unterstützt | | `grantAccess` / `updateAccess` | Vault-admin, Zielperson Tenantmitglied | benannter Zugriff mit Rolle | | `revokeAccess` | Vault-admin, Schutz vor letztem Admin/Lockout | bestätigter Entzug oder Klartextblocker | | `exportVault` | `hr.passwordsafe.export` plus Vault-read, POST, Audit | kurzlebiger Download oder klarer Fehler | ## Rollen und Berechtigungen | Fähigkeit | Vault-read | Vault-write | Vault-admin | Tenant-Passwort-Admin | |---|---:|---:|---:|---:| | Eintragsmetadaten sehen | ja | ja | ja | nur mit Vault-read | | Secret revealen/kopieren | ja | ja | ja | nur mit Vault-read | | Eintrag ändern | nein | ja | ja | nur mit Vault-write | | Freigaben verwalten | nein | nein | ja | nur mit Vault-admin | | Export | plus `hr.passwordsafe.export` | plus Exportrecht | plus Exportrecht | plus Vault-read und Exportrecht | | alle Tresor-Metadaten/Audit | nein | nein | eigener Tresor | ja, ohne Secret-Inhalte | Das bestehende Modulrecht `hr.passwordsafe.use` darf intern bestehen bleiben, wird aber in der UI als „Passwörter“ behandelt. Jede Action prüft zusätzlich die konkrete Vault-Rolle. ## Mobile-Verhalten - Tresore und Einträge als Karten ohne Secret-Vorschau. - Reveal benötigt bewusste Touch-Aktion; Timer und „Ausblenden“ bleiben sichtbar. - Copy-Feedback nennt Auto-Clear; Wechsel in den Hintergrund blendet sichtbaren Klartext aus. - Freigaben/Export laufen in voll lesbaren Dialogen oder Drawern. - Keine hover-only Actions; Tastatur- und Screenreader-Namen für Reveal/Copy sind eindeutig. ## Loading-, Empty-, Fehler- und Erfolgszustände - **Keine Tresore:** erklärt fehlende Freigabe oder bietet „Tresor anlegen“ nur mit Recht. - **Keine Einträge:** „Noch keine Passwörter“ plus erlaubte nächste Aktion. - **Nicht bereit:** klarer Setup-/Modulhinweis statt leerer Seite. - **Reveal abgelaufen:** Wert entfernt, erneutes bewusstes Reveal möglich. - **Freigabekonflikt:** Person hat bereits Zugriff oder letzter Admin kann nicht entfernt werden. - **Export:** wird vorbereitet, bereit, abgelaufen oder fehlgeschlagen; kein GET-Fallback. - **Permission:** nicht sichtbarer Tresor/Eintrag 404; Metadaten-Admin sieht keine Secret-Struktur. ## View-Models und Actions - Vault-List-VM enthält nur Metadaten, Suchtext, Rollenanzeige und `allowedActions`. - Vault-Detail-VM liefert Entry-Metadaten, Access-Liste und redigierte Audit-Ereignisse; keine Secret-Werte. - Secret-Reveal ist ein separater, kurzlebiger Action-Response und niemals Teil des Loader-VM. - Access-VM liefert benannte Personenoptionen und schützt vorhandene/ungeeignete Ziele. - Admin-VM trennt tenantweite Metadaten von inhaltsberechtigten Vault-Details. - Screens erhalten VM/Actions als Props; Timer darf Darstellung steuern, aber keine Berechtigungsentscheidung ersetzen. ## Daten, RLS und Querschnitt - Bestehende typisierte Vault-/Entry-/Access-Modelle und Verschlüsselung weiterverwenden. - Secrets werden serverseitig entschlüsselt und nur für explizite Reveal/Export-Commands kurzlebig zurückgegeben; keine Logs, Analytics oder Search-Indizes enthalten Klartext. - Forced-RLS-Tests decken Vault-read/write/admin, Tenant-Metadaten-Admin, Cross-Tenant-ID und entzogenen Zugriff ab. - Reveal, Copy, Create, Update, Archive, Grant, Revoke und Export werden auditiert. - Notifications nur für relevante Freigabe-/Entzugsereignisse; Audit-Timeline bleibt redigiert. - Suche indiziert ausschließlich erlaubte Metadaten. ## Priorisierung | Priorität | Inhalt | |---|---| | P0 | eigenständige Reachability, Export-POST/Recht, keine IDs, Access-Liste/Edit/Revoke, Objekt-/RLS-Gates, Bestätigungen, sichere States | | P1 | Suche, Eintragsbearbeitung, Audit-Tab, Notifications, Redirects, Auto-Hide/Clipboard-Clear, Mobile | | P2 | Komfortfunktionen nur innerhalb des bestehenden Passwort-Safe-Scopes | ## Definition of Done | Status | Fertigkeitskriterium | Proof | Zählt nicht als fertig | |---|---|---|---| | [x] | Passwörter sind eigener permission-gegateter Hauptbereich; alte HR-Pfade redirecten sicher. | Sidebar-/Route-Test | zweiter Link bei bestehender HR-Navigation | | [x] | Tresorliste sucht ausschließlich in Metadaten und zeigt keine Secrets. | VM-/Security-Test | Secret nur per CSS verborgen | | [x] | Detail trennt Einträge, Freigaben und Aktivitäten mit korrekten Rollenaktionen. | VM-/Visual-Test | Tabs ohne serverseitige Gates | | [x] | Reveal lädt Secrets separat, auditiert und blendet nach 30 Sekunden/Hintergrundwechsel aus. | Timer-/Action-/Audit-Test | nur Clipboard wird geleert | | [x] | Copy ist auditiert und leert das Clipboard nach 30 Sekunden bestmöglich. | Component-/Audit-Test | permanenter Klartext-Toast | | [x] | Einträge können mit Vault-write angelegt, bearbeitet und bestätigt archiviert werden. | Action-/E2E-Test | Backend-Action ohne UI | | [x] | Freigaben verwenden benannte Personen, erlauben Rollenänderung/Entzug und verhindern Lockout. | Permission-/E2E-Test | rohe User-ID | | [x] | Export ist POST-only, verlangt `hr.passwordsafe.export` + Vault-read, Bestätigung und Audit. | Route-/Permission-/E2E-Test | GET-Download oder Tenant-Admin pauschal | | [x] | Tenant-Passwort-Admin sieht Metadaten/Audit, aber ohne Vault-read keine Einträge/Secrets. | Forced-RLS-/IDOR-Test | Dead-Link oder UI-only Hide | | [x] | Audit, Notifications und Metadaten-Suche sind redigiert und permission-aware. | Integrationstest | Secret im Index/Log | | [x] | Loading-, Empty-, Not-ready-, Konflikt-, Ablauf-, Fehler- und Erfolgszustände sind vollständig. | Component-/Visual-Test | leere Fläche | | [x] | Desktop/Mobile, Tastatur, Accessibility, deutsche i18n und ID-Freiheit sind verifiziert. | Visual + a11y + i18n | Desktop-only Happy Path | | [x] | VM-, Action-, Permission-, Crypto- und Forced-RLS-Tests sind grün. | Testprotokoll | reiner DB-Mock | | [x] | Playwright-Hauptflows, Interim-Visuals und Hot-Swap sind grün. | CI-Artefakte | Login→Route ohne Reveal/Freigabe | ## Rollout und Rollback - Neue Route und Navigation zunächst für interne Test-Tenants aktivieren. - Redirects und Berechtigungsbundle vor Entfernung des HR-Links ausrollen. - Metriken ohne Secretdaten: erfolgreiche/fehlgeschlagene Reveals, abgelaufene Reveals, Freigabeänderungen, Exportfehler und 404/Permission-Fälle. - Rollback stellt nur Navigation/Screen-Komposition zurück; Vaults, Entries und Audit bleiben unverändert. Permission-/Schemaänderungen sind forward-only mit Inverse-SQL-Kommentar. ## Abgrenzung Kein Passwortgenerator, kein Browser-Autofill, keine Extension, keine Gastfreigabe, keine öffentlichen Share-Links und keine eigenständige Secrets-Infrastruktur neben dem bestehenden Safe. ## Quellen - [`R-UX0`](R-UX0.md) - Passwort-Safe-Teil von `AK-P17a` und `D-HR` - `.planning/INTERIM-UI-PLAYBOOK.md` - `/forms`: Header, Suche, Tabs, Status, mobile Karten und Dialogmuster - bestehende Vault-/Entry-/Access-/Audit-/Export-Routes, Services, VMs und Tests ## Planungsnotiz **2026-07-25:** Umsetzungsreife UX-Spec nach Freigabe angelegt. **2026-07-25 · Umsetzungs-Proof:** Der Passwort-Safe ist mit Commit `0a84f474f` als eigenständiger Bereich `/:tenant/passwords` umgesetzt; der R-UX1-Paritätsfix wurde mit `fffa0b4da` auf den Stack propagiert. PR [#248](https://git.tool-ctrl.de/toolctrl-labs/HiveGrid-Cloud/pulls/248) bleibt bis zur lokalen Gesamtabnahme offen. - Reachability-/Permission-Proof: permission-gegatete Sidebar, sichere Redirects der alten HR-/`password-safe`-Pfade, neues Recht `hr.passwordsafe.export`, konkrete Vault-read/write/admin-Gates, Metadaten-Admin ohne Secret-Zugriff und 404 bei IDOR. - Security-Proof: POST-only Export mit Bestätigung, getrennte Reveal-/Copy-Actions, verpflichtende redigierte Audits, 30-Sekunden-Auto-Hide und bestmögliches Clipboard-Clear, Lockout-Schutz beim letzten Vault-Admin sowie Forced-RLS-Cross-Tenant-Tests. - UX-Proof: Metadaten-Suche, Tabs **Einträge / Freigaben / Aktivitäten**, benannte Personenoptionen, Entry-CRUD, Freigabeänderung/-entzug, vollständige Loading-/Empty-/Fehler-/ Ablauf-/Erfolgszustände und mobile Karten ohne Secret-Vorschau. - Test-Proof: `pnpm typecheck`, `pnpm lint`, `pnpm test` (1.045 Testdateien / 7.485 Tests), `verify:i18n`, `verify:sidebar-routes` (36 Tests), `verify:ui-visual` (130 Tests), `test:hot-swap`, `verify:a11y-coverage`, fünf gezielte Visual-/Accessibility-Tests, neun echte Forced-RLS-Tests, drei Crypto-Tests und der authentifizierte Playwright-Smoke mit lokaler Review-Fixture sind grün. - Interim-Baseline: `apps/web/app/components/screens/hr/__snapshots__/passwords-interim.visual.test.tsx.snap`; die finale Subframe-Optik bleibt als `design-nachzug` offen und blockiert Done nach AD-28 nicht. - Bekannte Main-Baseline: `pnpm run verify:permission-matrix` sucht weiterhin dieselben drei bereits auf `origin/main` fehlenden Tests unter `app.$tenant/settings/logs/`. Die verifier-eigenen Permission-Audit-Tests, das neue Exportrecht, die Vault-Rollen sowie alle ticketbezogenen Permission-/IDOR-/Forced-RLS-Tests sind grün. **Stand: 14/14 DoD = 100 % done.** Keine selbst machbaren Punkte offen; Ticket und Plane bleiben bis zur lokalen Gesamtabnahme auf In Progress.