Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/R-UX4.md
T
raffaelandClaude Opus 5.5 d09f79b673 chore(infra): Gitea-Host auf git.hg-int.dev umstellen
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>
2026-11-11 18:53:32 +01:00

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

  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
  • 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 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.