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. **HR hängt nur an P1/P2**; nutzt den Form-Renderer (M05) — der kommt erst in P16 (AK-P16c), liegt aber zeitlich **nach** P17. **Pragma:** Urlaub/Krank/Requests werden als M05-Form-Templates modelliert; bis der Renderer aus P16 steht, dienen schlanke HR-eigene Formulare als Übergang (Nachzug-Punkt). Eigene `prisma/schema/hr.prisma` (gleicher Namespace, additiv — AD-21).
|
||||
- **Konflikt-Risiko:** keines auf Schema-Ebene; Calendar-Relation (M25) über `calendar_event_id` (P16) — read-only.
|
||||
|
||||
**UX-Nachzug (2026-07-25):** `R-UX3` übernimmt den freigegebenen Personal-Hub mit
|
||||
**Für mich / Mein Team / Verwaltung**. AK-P17b bleibt das Workflow-Fundament; M05-, P9- und
|
||||
Permission-Verträge dürfen durch den Nachzug nicht gebrochen werden.
|
||||
|
||||
## Was wir bauen
|
||||
Die **HR-Workflows**: einen **mehrstufigen Urlaubs-Approval-Workflow** (submitted/approved/rejected/withdrawn + Rückfrage) mit **Abwesenheits-Kalender** und **Plantafel-Konflikt-Hinweisen**, **Krankmeldung** (selbst oder durch Büro im Auftrag) mit **verschlüsseltem AU-Upload**, **Announcements** (Audience-Targeting, Acknowledgement-Pflicht + Read-Receipt, Reaktionen, Kommentare), **Lohnabrechnungs-Bulk-Upload** mit Dateiname-Auto-Match + Read-Tracking, **Upload-Erinnerungen** (Cadence + Eskalation), generische **Requests** via Templates, **Surveys** (anonym möglich, mit Auswertung) und den **Mitarbeiter-Self-Service** (Web/PWA; Web-Push als Kanal → v2).
|
||||
|
||||
@@ -34,15 +38,15 @@ Die **HR-Workflows**: einen **mehrstufigen Urlaubs-Approval-Workflow** (submitte
|
||||
> Legende: `[x]` = im **jetzt-machbaren** Scope fertig + verifiziert · `(extern: …)` =
|
||||
> Rest hängt an einem blockierenden Folge-Ticket. Details + %-Stand: Umsetzungs-Notiz unten.
|
||||
|
||||
- [x] **Mehrstufiger Urlaubs-Approval-Workflow** (submitted/approved/rejected/withdrawn + Rückfrage) → **Plantafel-Konflikt-Feed** (R-P9b via `listApprovedAbsencesForRange`). *(extern: CalendarEvent-Write → P16/M25)*
|
||||
- [x] **Mehrstufiger Urlaubs-Approval-Workflow** (submitted/approved/rejected/withdrawn + Rückfrage) → **Plantafel-Konflikt-Feed** (R-P9b via `listApprovedAbsencesForRange`). *CalendarEvent-Write seit Audit-Restwork 2026-07-19 umgesetzt (P16/AK-P16a ist da): Approve erzeugt internes All-Day-Event (`hivegrid_internal`, busy, `internalEntityLink: hr_vacation_request`) und setzt `calendarEventId` — Commit `7a64dd477`, live im Browser bewiesen (Kalender September zeigt „Urlaub").*
|
||||
- [x] **Krankmeldung** (selbst/durch Büro) + **AU-Upload verschlüsselt** (Crypto-Seam, audited Reveal)
|
||||
- [x] **Announcements** (Audience, Acknowledgement-Pflicht + Read-Receipt, Reaktionen, Kommentare)
|
||||
- [x] **Lohnabrechnungs-Bulk-Upload** mit Dateiname-Auto-Match (Personalnummer/Name), Match-Vorschau mit Konfidenz, Read-Tracking, Audit pro Read
|
||||
- [x] **Upload-Erinnerungen** (Cadence once/yearly/every_n_months/on_expiry, Eskalation an Manager via Worker-Cron) + **Requests** via Templates
|
||||
- [x] **Surveys** (anonym möglich, `submitterHash`) mit Auswertung (gegated)
|
||||
- [x] **Mitarbeiter-Self-Service** (Web/PWA) — alle Bereiche reachable. *(extern: M05-Form-Submissions → AK-P16c, bis dahin Übergangs-Formulare; Web-Push → v2/AD-17)*
|
||||
- [x] Konnektor `tenantHasModule('hr')`; App-Permission-Gates; sensible Felder verschlüsselt; RLS-Policies geschrieben. *(extern: RLS-Live-Cutover → R-P2b, wie P17a)*
|
||||
- [ ] **Tests/UI extern blockiert:** finale Subframe-UI + Adapter + Smoke-Tests (`e2e/smoke/hr-*`) + Visual-Regression (M016) + Hot-Swap (M017) → **Davids `D-HR`-Delta** (noch leer)
|
||||
- [x] **Mitarbeiter-Self-Service** (Web/PWA) — alle Bereiche reachable. *M05-Form-Reuse seit Audit-Restwork 2026-07-19 verdrahtet (AK-P16c ist Done): Request-Templates können publizierte `hr_request`-Formulare verlinken, `submitRequest` persistiert dann eine echte `FormSubmission` und setzt `formSubmissionId` (Commit `8247d399c`). Urlaub/Krank tragen laut ENTITY-MODEL bewusst kein `form_submission_id` und bleiben beim schlanken Formular. Web-Push → v2/AD-17.*
|
||||
- [x] Konnektor `tenantHasModule('hr')`; App-Permission-Gates; sensible Felder verschlüsselt; RLS-Policies geschrieben. *RLS ist seit Cutover `20260713190000_appwide_rls_cutover` (14.07.) auf allen HR-Tabellen LIVE; der HR-Worker-Cron nutzt `notifyWithTenantRlsContext` (R-P1b-Regression trifft HR nicht).*
|
||||
- [x] **Tests/UI:** Interim-UI aus `~/ui` (PR #54) + Smoke-Test `tests/e2e/hr-workflows-smoke.spec.ts` (Commit `f309ecbce`) + Hot-Swap-Drill/ui-mock (Commit `b216848c4`) + Screen-/VM-Unit-Tests (Commit `7c3867039`). *Nur Visual-Regression (M016) bleibt deferred (kein Screenshot-Harness, R-P5-Präzedenz) — Baseline beim `design-nachzug` gegen die finale D-HR-Optik · `blockiert`. Die finale Subframe-Optik selbst = getrackter `design-nachzug`, nicht Done-blockierend (AD-28).*
|
||||
|
||||
## Technische Bausteine
|
||||
- **Entities** (eigene `prisma/schema/hr.prisma`, additiv): `EmployeeVacationRequest` (start/end_date, request_kind, status, assigned_approver, calendar_event_id), `EmployeeSickLeaveReport` (start/return_date, certificate_file_id, status — **[verschlüsselt]** AU-Schein), `HrAnnouncement` (+ Read/Reaction/Comment), `EmployeePayslip` (period_year/month, file_id, is_read), `EmployeeUploadReminder` (+ Dispatch), `HrRequest` (+ Template — request_kind, form_submission_id, status, assigned_approver), `HrSurvey` (+ Item/Submission — is_anonymous, submitter_hash). `calendar.prisma`/`forms.prisma` über Relationen (AD-21).
|
||||
@@ -54,13 +58,12 @@ Die **HR-Workflows**: einen **mehrstufigen Urlaubs-Approval-Workflow** (submitte
|
||||
## Quellen (granular)
|
||||
- `ENTITY-MODEL.md` → **Domäne 10: HR-Hub** (EmployeeVacationRequest, EmployeeSickLeaveReport, HrAnnouncement, EmployeePayslip, EmployeeUploadReminder, HrRequest, HrSurvey)
|
||||
- `REQUIREMENTS.md` → `REQ-hr-urlaub-krank`
|
||||
- `ROADMAP.md` → Phase 17 · `PHASE-SOURCES.md` → Phase 17 (M135-urlaub, M136-krankmeldungen, M137-kommunikation, M139-berichte-lohn-export, M140-selbstbedienung; Surveys bleiben v1, M140 ohne Push)
|
||||
- `ROADMAP.md` → Phase 17 · Milestones: (M135-urlaub, M136-krankmeldungen, M137-kommunikation, M139-berichte-lohn-export, M140-selbstbedienung; Surveys bleiben v1, M140 ohne Push)
|
||||
- `designer-briefs/P17-hr-hub.md` (Urlaub/Krank, Lohn-Bulk-Match, Surveys, M05-Renderer wiederverwenden)
|
||||
- `_bmad-output/specs/M14-hr-hub.md`
|
||||
|
||||
## 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-P17b` aktualisiert
|
||||
|
||||
## Umsetzungs-Notiz
|
||||
@@ -179,3 +182,32 @@ Damit ist die finale Subframe-Optik (DoD #43) **kein Done-Blocker** mehr, sonder
|
||||
(Plane-Label `design-nachzug`). Noch selbst machbar: Screen-Unit-Tests, Smoke `e2e/smoke/hr-*`, Hot-Swap-Adapter;
|
||||
Visual-Regression bleibt deferred (kein Screenshot-Harness). Extern blockiert bleibt nur: CalendarEvent-Write
|
||||
(P16), M05-Renderer (AK-P16c), RLS-Live (R-P2b), Web-Push (v2).
|
||||
|
||||
### 2026-07-19 — Stand-Audit + Restwork: alle vormals externen Blocker (außer D-HR) gefallen und abgearbeitet. 9/9 DoD (nur Visual-Baseline deferred)
|
||||
|
||||
**Audit-Befund (Doc vs. Plane vs. Code):** Die Interim-UI-Commits aus der 08.07.-Notiz (`f840fcf24`) existieren
|
||||
nicht mehr — sie gingen umgeschrieben via **PR #54** als `96e84d6bc`/`270f0df30` auf `main`. Drei als „extern
|
||||
blockiert" geführte Punkte waren inzwischen frei: **R-P2b/RLS** (Cutover 14.07. deckt alle HR-Tabellen),
|
||||
**P16-Kalender** (AK-P16a gemergt, `calendar.prisma` da) und **AK-P16c/M05** (Form-Builder seit 11.07. Done).
|
||||
|
||||
**Restwork umgesetzt** (Branch `fix/ak-p17-audit-restwork`):
|
||||
- **CalendarEvent-Sync (DoD 1):** `approveRequest` erzeugt im selben RLS-Kontext ein internes All-Day-Event
|
||||
(Titel = i18n-aufgelöste Kind-Bezeichnung aus der Route, Booking-Präzedenz) und setzt `calendarEventId`;
|
||||
Approve ist im Statemachine terminal, daher kein Cleanup-Pfad nötig. Commit `7a64dd477` + Service-Tests.
|
||||
- **M05-Form-Reuse (DoD 7):** Template-Editor mit Linked-Form-Auswahl (publizierte `hr_request`-Formulare),
|
||||
`submitRequest` schreibt `FormSubmission` (`linkedEntityType: hr_request`) + `formSubmissionId`. Fallback
|
||||
bleibt das Übergangs-Formular, Submission bricht nie an einem fehlenden Formular. Commit `8247d399c` + Tests.
|
||||
- **Tests/Registry (DoD 9 + AGENTS.md-Pflicht):** e2e-Smoke `hr-workflows-smoke.spec.ts` (`f309ecbce`),
|
||||
ui-mock-Fixtures + Hot-Swap-Drill (`b216848c4`), VM-Unit-Tests für alle 8 ungetesteten HR-VMs (`7c3867039`),
|
||||
Registry-Nachzug `UI_NAV_IDS.appHr` + surfaces.json (`bb230e6b6`).
|
||||
|
||||
**Proof:** typecheck web/db/worker/view-models 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 ·
|
||||
**Live-Beweis im Browser** (lokal, `pnpm dev:local`): Antrag gestellt → in Genehmigungen genehmigt →
|
||||
DB zeigt `status=approved` + verlinktes `CalendarEvent` (hivegrid_internal, „Urlaub", all-day, busy) →
|
||||
Kalender-Screen rendert „Urlaub" 01.–04.09. Kein Schema-Change → keine neue Migration (AD-21).
|
||||
|
||||
**Sichtbar unter:** `http://app.localhost:3000/<tenant>/hr/leave` (Workflow), `/hr/requests` +
|
||||
`/hr/admin/request-templates` (M05-Verlinkung), `/calendar` (Absence-Event); Screens in
|
||||
`apps/web/app/components/screens/hr/*`. Subframe: weiterhin keine D-HR-Pages (MCP-Check 19.07.) —
|
||||
`design-nachzug` bleibt korrekt offen.
|
||||
Reference in new issue
Block a user