240 lines
14 KiB
Markdown
240 lines
14 KiB
Markdown
# 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.
|