Refresh HiveGrid Cloud reference snapshot
This commit is contained in:
1 parent
5e99e14772
commit
7f88026f79
5955 files changed
+1177325
-188362
No files matched your search
@@ -16,6 +16,10 @@
|
||||
- **Läuft parallel zu:** Raffaels Kern-Kette (P6/P7). **HR hängt nur an P1/P2** (User/RLS/Verschlüsselungs-Fundament) — KEINE Abhängigkeit von R-P5/R-P6, daher früh in W2 baubar. Eigene `prisma/schema/hr.prisma` (AD-21); `core.prisma` nur für User-Relation berührt.
|
||||
- **Konflikt-Risiko:** keines auf Schema-Ebene — disjunkte HR-Domäne.
|
||||
|
||||
**UX-Nachzug (2026-07-25):** `R-UX3` übernimmt die rollenbasierte Personal-IA; `R-UX4` löst den
|
||||
Passwort-Safe als eigenständigen Bereich heraus. Datenmodell, Verschlüsselung und historische
|
||||
AK-P17a-Umsetzung bleiben unverändert und werden von beiden Nachzügen weiterverwendet.
|
||||
|
||||
## Was wir bauen
|
||||
Den **verschlüsselten HR-Kern** (Quiply-Ablösung): **MA-Stammdaten** (HrEmployeeProfile, Standorte), **Personaldokumente** und den **verschlüsselten Team-Passwort-Safe**. Sensible Daten liegen **AES-256-GCM** mit KMS-backed Envelope-Encryption (AD-8) vor; sensible Tabellen haben **zusätzlich** zum RLS einen App-Permission-Layer — Werte werden **nie automatisch angezeigt** (Reveal on-demand + Audit-Eintrag). Strikte Trennung **MA-Sicht** (eigener Bereich, eigene Daten) vs. **HR-Admin-Sicht** (`/admin/hr/...`). Passwort-Safe: Werte nie in der Liste, Reveal/Copy entschlüsselt on-demand mit Permission-Check, Copy mit 30s-Auto-Clear, DSGVO-Export.
|
||||
|
||||
@@ -34,7 +38,14 @@ Den **verschlüsselten HR-Kern** (Quiply-Ablösung): **MA-Stammdaten** (HrEmploy
|
||||
- [x] **MA-Bereich vs. HR-Admin-Bereich strikt getrennt**; sensible Tabellen zusätzlich App-Permission-gegated
|
||||
- [x] **Verschlüsselter Passwort-Safe mit Audit-Trail**: Reveal/Copy entschlüsselt on-demand + Permission-Check + Audit-Eintrag; Werte nie in Liste; Copy mit 30s-Auto-Clear; DSGVO-Export — *Backend komplett: Ver-/Entschlüsselung jetzt scharf (R-P5-Envelope); Audit/Permission/Never-List/Export gebaut. 30s-Clear = UI (David).*
|
||||
- [x] MA-Verzeichnis + Standorte (Admin-CRUD) + eigene Dokumente (Upload + read-only Büro-Uploads) — *Backend + funktionale Routen; finale Optik wartet auf Davids D-HR-Delta.*
|
||||
- [x] Konnektor `tenantHasModule('hr')`; RLS auf allen Tenant-Tabellen; sensible Felder verschlüsselt — *Konnektor (Feature/Blueprint/Plan) + RLS-SQL (deferred-Aktivierung wie P4b) + sensible Felder verschlüsselt (R-P5-Envelope) stehen.*
|
||||
- [x] Konnektor `tenantHasModule('hr')`; RLS auf allen Tenant-Tabellen; sensible Felder verschlüsselt — *Konnektor (Feature/Blueprint/Plan) + RLS-SQL (deferred-Aktivierung wie P4b) + sensible Felder verschlüsselt (R-P5-Envelope) stehen. Seit Cutover `20260713190000_appwide_rls_cutover` (14.07.) ist RLS auf allen HR-Tabellen LIVE; HR-Tabellen sind im generierten Policy-Contract.*
|
||||
|
||||
**Nachgetragene DoD-Punkte (Stand-Audit 2026-07-19 — AGENTS.md-Pflicht-DoD, fehlten in der Liste):**
|
||||
- [x] **VM-Unit-Tests (DoD 18):** alle HR-VM-Builder mit Fixture-Tests (Commit `7c3867039`; vorher nur 3/14 VMs getestet)
|
||||
- [x] **Smoke-Test (DoD 19):** `tests/e2e/hr-core-smoke.spec.ts` — Login → Hub → Directory → Passwort-Safe (Never-List-Assertion) (Commit `f309ecbce`)
|
||||
- [x] **Hot-Swap-Drill (DoD 20):** HR-Fixture-Pages in `packages/ui-mock` + `scripts/verify-ui-hot-swap.ts`, Drill grün (Commit `b216848c4`)
|
||||
- [x] **Registry-Nachzug:** `UI_NAV_IDS.appHr` + Sidebar auf Konstante + HR-Surface in `docs/ui-inventory/surfaces.json` (Commit `bb230e6b6`)
|
||||
- [ ] **Visual-Regression (DoD 21):** bleibt deferred (kein Component-Screenshot-Harness, R-P5-Präzedenz) — Baseline wird beim `design-nachzug` gegen die finale D-HR-Optik gezogen · `blockiert`
|
||||
|
||||
## Technische Bausteine
|
||||
- **Entities** (eigene `prisma/schema/hr.prisma`): `HrEmployeeProfile` (user_id 1:1, personal_number, hire_date, position, team, location_id, manager_user_id, emergency_contact_*), `HrLocation` (name, address_*, geo, image_file_id), `HrEmployeeDocument` (employee_user_id, document_kind, file_id, visibility), `HrResource`/`HrQuickLink`, `EmployeePasswordSafeVault` (+ `Entry`/`Access` — username/password/notes **AES-256-GCM**, permission_level read/write/admin). `core.prisma` nur für User-Relation (AD-21).
|
||||
@@ -46,9 +57,8 @@ Den **verschlüsselten HR-Kern** (Quiply-Ablösung): **MA-Stammdaten** (HrEmploy
|
||||
## Quellen (granular)
|
||||
- `ENTITY-MODEL.md` → **Domäne 10: HR-Hub** (HrEmployeeProfile, HrLocation, HrEmployeeDocument, HrResource/QuickLink, EmployeePasswordSafeVault — viel Verschlüsselung)
|
||||
- `REQUIREMENTS.md` → `REQ-hr-datenmodell`, `REQ-hr-passwort-safe`
|
||||
- `ROADMAP.md` → Phase 17 · `PHASE-SOURCES.md` → Phase 17 (M133-stammdaten, M134-dokumente; M138 Drittanbieter-Onboarding → v2)
|
||||
- `ROADMAP.md` → Phase 17 · Milestones: (M133-stammdaten, M134-dokumente; M138 Drittanbieter-Onboarding → v2)
|
||||
- `designer-briefs/P17-hr-hub.md` (MA- vs. HR-Admin-Trennung, Passwort-Safe-Reveal, sensible Daten)
|
||||
- `_bmad-output/specs/M14-hr-hub.md`
|
||||
|
||||
## Umsetzungs-Notiz
|
||||
|
||||
@@ -126,8 +136,20 @@ Refactor-Nachzug offen: finale Subframe-Optik aus `D-HR` (Plane-Label `design-na
|
||||
Visual-Regression bleibt **deferred** (kein Screenshot-Harness im Repo, R-P5-Präzedenz). Demo-Seed (`is_demo_data`)
|
||||
für Profile/Standorte/Vault als Folge-Task.
|
||||
|
||||
**Stand-Audit + Restwork 2026-07-19 (Akeshan) — Drift korrigiert, Test-/Registry-DoD nachgezogen. 8/9 DoD (nur Visual-Regression deferred).**
|
||||
|
||||
Befund des Drei-Quellen-Audits (Doc vs. Plane vs. Code):
|
||||
- **Hash-Korrektur:** Die Interim-UI-Commits aus der Notiz vom 08.07. (`e0f8affd2`/`f840fcf24`) existieren nicht mehr — sie gingen umgeschrieben via **PR #54** als `553065a3c` (P17a-Screens) / `96e84d6bc` (P17b-Screens) / `270f0df30` (Doc-Tag + Screen-Tests) auf `main`. Alle „Branch lokal, nicht gepusht"-Vermerke sind überholt.
|
||||
- **PR #55** (nicht in der Doc vermerkt gewesen): Self-Service-Dokumenten-Upload + Notfallkontakt-Set-UI + **Demo-Seed `scripts/ops/seed-hr-demo.mts`** (idempotent, nur Demo-Tenants) sind seit 15.07. auf `main` — der „Demo-Seed als Folge-Task"-Punkt ist damit erledigt.
|
||||
- **RLS:** Cutover 14.07. deckt alle HR-Tabellen ab (`20260713190000_appwide_rls_cutover`); Services binden `withTenantRLS`, der HR-Worker-Cron nutzt `notifyWithTenantRlsContext` — die R-P1b-notify-Regression trifft HR nicht.
|
||||
- **Restwork umgesetzt** (Branch `fix/ak-p17-audit-restwork`): Registry-Nachzug `bb230e6b6` · VM-Tests `7c3867039` · ui-mock/Hot-Swap `b216848c4` · e2e-Smoke `f309ecbce`. Verifiziert: web/view-models/db/worker-typecheck 0 Fehler, `verify:i18n`/`verify:sidebar-routes`/`verify:cross-cutting-models` Exit 0, `pnpm run test:hot-swap` grün, view-models-Suite 567 Tests grün.
|
||||
- **Kein Schema-Change** → keine neue Migration nötig (AD-21).
|
||||
- Subframe-Projekt geprüft (MCP, 2026-07-19): weiterhin **keine** D-HR-Pages — `design-nachzug` bleibt korrekt offen, Interim-UI bleibt der gültige Stand.
|
||||
|
||||
**Sichtbar unter:** lokal `pnpm dev:local` → `http://app.localhost:3000/<tenant>/hr` (Hub), `/hr/directory`, `/hr/password-safe`, Screens in `apps/web/app/components/screens/hr/*`.
|
||||
|
||||
## Dev-Nachzug (nach Davids `D-HR`-Delta)
|
||||
- [ ] Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
|
||||
- [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen
|
||||
- [ ] REQUIREMENTS/ROADMAP nachgezogen
|
||||
- [ ] Plane-Ticket `AK-P17a` aktualisiert
|
||||
- [ ] Finale `D-HR`-Optik in `<XPage>`-Internals getauscht (VM/Loader/Route unverändert), Visual-Baseline gezogen, `design-nachzug`-Tag auf erledigt
|
||||
Reference in new issue
Block a user