Gitea läuft seit 2026-11-11 auf hivegrid-control (git.hg-int.dev); git.tool-ctrl.de wird abgeschaltet. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
14 KiB
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 · 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
- Passwörter sind unter Personal/HR versteckt und die Navigation kann unabhängig von echter Nutzbarkeit erscheinen.
- Nicht bereite oder nicht erlaubte Zustände enden teilweise in einer leeren Fläche.
- Freigaben verlangen rohe
targetUserId-Eingaben. - Backend-Actions für Bearbeiten, Freigabeliste und Entzug sind nicht vollständig in der UI.
- Archivierung erfolgt ohne angemessene Bestätigung.
- Export-UI und Route verwenden unterschiedliche HTTP-Methoden; der Flow endet fehlerhaft.
- Adminliste kann auf Details verlinken, die ein Metadaten-Admin ohne Vault-Zugriff nicht öffnen darf.
- Audit, Suche und Bearbeitung sind unvollständig; Reveal blendet Klartext nicht automatisch wieder aus.
Freigegebener Ziel-Flow
- Passwörter ist ein eigener Hauptnavigationseintrag unter
/:tenant/passwords. Alte HR-Pfade erhalten sichere Redirects. - Tresorliste zeigt nur erlaubte Tresore, Suche über Name/Beschreibung und keine Geheimwerte.
- Tresordetail verwendet Tabs Einträge / Freigaben / Aktivitäten.
- Einträge zeigen Metadaten; Geheimwerte werden erst nach serverseitig geprüftem Reveal geladen.
- Reveal wird sichtbar zeitlich begrenzt, kann sofort geschlossen werden und wird ebenso wie Copy auditiert. Clipboard und sichtbarer Klartext werden nach 30 Sekunden geleert.
- Einträge lassen sich nach Recht anlegen, bearbeiten und mit Klartextdialog archivieren.
- Freigaben verwenden eine Personen-Combobox mit Name, E-Mail und Rolle; Rechte lassen sich ändern oder entziehen.
- Export erfolgt ausschließlich per POST, verlangt Bestätigung und das neue Recht
hr.passwordsafe.exportzusätzlich zum Vault-Lesezugriff. - 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- Passwort-Safe-Teil von
AK-P17aundD-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 bleibt bis zur lokalen
Gesamtabnahme offen.
- Reachability-/Permission-Proof: permission-gegatete Sidebar, sichere Redirects der alten
HR-/
password-safe-Pfade, neues Rechthr.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 alsdesign-nachzugoffen und blockiert Done nach AD-28 nicht. - Bekannte Main-Baseline:
pnpm run verify:permission-matrixsucht weiterhin dieselben drei bereits auforigin/mainfehlenden Tests unterapp.$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.