Update hivegrid-cloud reference to latest main

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
davidandClaude Fable 5 committed 2026-07-08 16:15:37 +02:00
1 parent e98d38e716
commit 7b21524c86
3781 files changed
+373484 -225607

No files matched your search

@@ -6,13 +6,34 @@
| **Owner** | Raffael |
| **Phase** | P9 — Projekt & Pipelines (Auftrags-Features + Sub-Areas) |
| **Cycle/Fenster** | W3 — Kern-Kette & Kommunikation (Demo 2) · 2026-07-01 → 2026-07-02 · Gate W3 (→ Demo 2) |
| **Status** | geplant |
| **Status** | On Hold (serverseitig 8/8, Screens/Client-UX blockiert) |
> 🔴 **Pivot-Vorrang (AD-20):** **Abnahme = Checklisten/Protokoll-Sub-Area** am `Projekt`-Kern. `AbnahmeProtokoll` ist **immutable** (6 Jahre, signatur-gebunden), bindet eine **Mängel-Checkliste** (`Checkliste typ=maengel`) ein, hat **Touch-Signaturen** (Kunde + Monteur) und ist **offline-fähig**. Material-Ausgang/Lagerist, Zeiterfassung, Leistungspositionen, Baustelle, Supporttickets → **v2** (Material-Listen am Auftrag bleiben v1).
## Abhängigkeiten & Parallelität
- **Blocked by:** `R-P9a` (Sub-Areas + ProjektMitglied + Checkliste), `AK-P17b` (HR — Abwesenheiten/Urlaub/krank für Konflikt-Detection)
- **Blocks:** **Demo 2**, `R-P11a` (Suche kommt erst nach abgeschlossener Kern-Kette)
> **Zulieferung aus R-P9a (Stand 2026-07-01, serverseitig umgesetzt):** Die Auftrags-Sub-Areas
> stehen in `prisma/schema/auftrag.prisma` und im Service
> `apps/web/app/utils/integrations/projects/auftragService.server.ts` bereit. Für R-P9b sind
> relevant: `ProjektMitglied`, `ProjektTermin`, `ProjektChecklist`/`ProjektChecklistItem`
> inkl. `typ=maengel`, `AuftragPipelineStageConfig.requiresAcceptanceProtocol`,
> `AcceptanceFormTemplate` und `ProjectTemplate`. Commit: `954070ec6`. R-P9a bleibt bis
> `D-PLAN`/`D-ABN`/`D-P9` screen-blockiert auf On Hold, aber die serverseitigen Contracts sind
> für den R-P9b-Backend-Ausbau nutzbar.
> **Zulieferung aus AK-P17b (Stand 2026-06-28, backend fertig + gemerged-fähig):** Der
> Konflikt-Feed steht als Service-Funktion bereit —
> `listApprovedAbsencesForRange(tenantId, from, to)` in
> `apps/web/app/utils/integrations/hrLeaveService.server.ts`. Rückgabe-Shape je Eintrag:
> `{ source: "vacation" | "sick", id, employeeUserId, startDate, endDate, kind }`. **Nur
> genehmigte** Vacation (`status="approved"`) und **nicht stornierte** SickLeave zählen;
> submitted/rejected/withdrawn blocken nie. Für die Plantafel-Konflikt-Indikatoren (DoD #2)
> direkt diese Funktion gegen den angezeigten Zeitraum abfragen und Überschneidungen mit
> `ScheduleEntry` markieren. **Hinweis:** der echte `CalendarEvent`-Sync (M25) ist in
> AK-P17b noch deferred (P16); `EmployeeVacationRequest.calendarEventId` ist nullable. Bis
> P16 also direkt über den Feed gehen, nicht über `CalendarEvent`.
- **Blocks:** **Demo 2**, `R-P11a` (Suche kommt erst nach abgeschlossener Kern-Kette), `VA-P27a` (PWA-Offline-Drain nutzt die serverseitigen Idempotency-Contracts)
- **Sequenz (Raffaels Kern-Kette):** strikt sequenziell — P9b ist Glied 6 und schließt die Kern-Kette ab (`R-P9a → R-P9b → R-P11a …`).
- **Läuft parallel zu:** Akeshans Module W3. Schema-Trennung nach **AD-21**.
@@ -27,14 +48,14 @@ Die **Plantafel** (Scheduling pro Monteur/Tag, Drag&Drop verschieben/resizen, St
| Abnahme-Liste [`/projects/:id/acceptance`] | Protokoll-Liste je Projekt (Mehrfach-/Teilabnahmen): Datum, acceptance_kind, Unterzeichner, PDF-Link, Mängel-Status; letzte `full`-Abnahme → Stage-Wechsel-Vorschlag |
## Definition of Done
- [ ] **Plantafel** pro Monteur/Tag (Drag&Drop verschieben/resizen, Status-Workflow, Bulk-Reassign) — **offline-fähiger Monteur-Mobil-Modus** („Meine Termine heute"/„Meine Woche")
- [ ] **HR-Abwesenheiten sichtbar** + **Konflikt-Detection** (Doppelbelegung, Urlaub/krank aus HR M14, Verfügbarkeits-Regeln) mit Klartext-„Trotzdem zuweisen?"; Calendar-Sync (M25) der ScheduleEntries
- [ ] **Abnahme-Protokoll** mit **Touch-Signatur** (Kunde + Monteur), **offline + Sync**, nach Speichern **immutable** (6 J, nur archivierbar), Mehrfach-/Teilabnahmen
- [ ] Mängel-Checkliste (`typ=maengel`) eingebunden + Mängel-Klassifizierung → `acceptance_kind`; `with_defects` → Tasks, `rejected` → zurück in Ausführung + Notification an PL
- [ ] **PDF + Auto-Email** an Kunden
- [ ] Stage-Wechsel-Validation: `requires_acceptance_protocol` blockt ohne Abnahme; **Hard-Delete blockt bei Abnahme-Protokollen** (Aufbewahrung)
- [ ] Konnektor `tenantHasModule('projects')` (Plantafel/Abnahme gated)
- [ ] Permissions: `plantafel.*` (read_own/read_all/write/bulk_reassign), `acceptance.*` (read/write/admin)
- [x] **Plantafel** pro Monteur/Tag (Drag&Drop verschieben/resizen, Status-Workflow, Bulk-Reassign) — **offline-fähiger Monteur-Mobil-Modus** („Meine Termine heute"/„Meine Woche") *(serverseitige Routes/Actions/VMs; finale Drag/Resize-/Mobil-UX durch `D-PLAN` blockiert)*
- [x] **HR-Abwesenheiten sichtbar** + **Konflikt-Detection** (Doppelbelegung, Urlaub/krank aus HR M14, Verfügbarkeits-Regeln) mit Klartext-„Trotzdem zuweisen?"; Calendar-Sync (M25) der ScheduleEntries *(HR-Feed + Konflikt-Contracts + Sync-Status/Calendar-ID; echter M25-Write bleibt P16)*
- [x] **Abnahme-Protokoll** mit **Touch-Signatur** (Kunde + Monteur), **offline + Sync**, nach Speichern **immutable** (6 J, nur archivierbar), Mehrfach-/Teilabnahmen *(serverseitig + idempotenter Offline-Sync; Touch-Canvas/Client-Queue durch `D-ABN`/PWA blockiert)*
- [x] Mängel-Checkliste (`typ=maengel`) eingebunden + Mängel-Klassifizierung → `acceptance_kind`; `with_defects` → Tasks, `rejected` → zurück in Ausführung + Notification an PL
- [x] **PDF + Auto-Email** an Kunden
- [x] Stage-Wechsel-Validation: `requires_acceptance_protocol` blockt ohne Abnahme; **Hard-Delete blockt bei Abnahme-Protokollen** (Aufbewahrung)
- [x] Konnektor `tenantHasModule('projects')` (Plantafel/Abnahme gated)
- [x] Permissions: `plantafel.*` (read_own/read_all/write/bulk_reassign), `acceptance.*` (read/write/admin)
## Technische Bausteine
- **Entities** (erweitert `prisma/schema/auftrag.prisma`): `ScheduleEntry` (Plantafel, user_id/slot/status/projekt_id), `AbnahmeProtokoll` (**[immutable]** projekt_id/maengel_checkliste_id/datum/anwesende/druckprobe/funktionspruefung/zaehlerstaende/pdf_file_id/gesperrt_at), `AbnahmeSignatur` (signer_name/signer_rolle kunde|monteur/signatur_file_id/signiert_at + IP/Timestamp). HR-Tabellen (`hr.prisma` M14) + `calendar.prisma` (M25) nur lesend über Relationen (AD-21).
@@ -56,3 +77,12 @@ Die **Plantafel** (Scheduling pro Monteur/Tag, Drag&Drop verschieben/resizen, St
- [ ] Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
- [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen
- [ ] Plane-Ticket `R-P9b` aktualisiert
## Umsetzung
**2026-07-01:** Serverseitige R-P9b-Contracts umgesetzt und auf `main` vorbereitet.
- Commit: `6b6ca1fd9` (`Implement R-P9b schedule and acceptance backend`)
- Proof: `pnpm --filter @hivegrid/web test -- app/utils/integrations/projects/projectService.test.ts`, `pnpm run verify:i18n`, `pnpm typecheck`, `pnpm lint`, `pnpm test`, `pnpm exec prisma validate`, `pnpm run verify:tenant-isolation-report`, `git diff --check` grün.
- Gebaut: `ScheduleEntry`, `ScheduleConflict`, `AbnahmeProtokoll`, `AbnahmeSignatur`, `OfflineSyncMutation` in `prisma/schema/auftrag.prisma`; RLS-Rollout-Artefakt; Tenant-Model-Registry; Prisma-Client; `plantafel.*`/`acceptance.*`-Permissions; Plantafel-Route `/projects/plantafel`; Abnahme-Routen `/projects/:id/acceptance` und `/projects/:id/acceptance/new`; HR-Abwesenheits-Konflikte via `listApprovedAbsencesForRange`; idempotenter Offline-Sync; PDF-Ablage + Mail-Queue; Stage-Validation gegen `requiresAcceptanceProtocol`; Hard-Delete-Service-Block.
- **DoD-Stand:** 8/8 serverseitig = 100 % selbst machbar. Ticket bleibt **On Hold**, weil finale Drag/Resize-Plantafel, Touch-Signatur-Canvas, mobile Offline-UX und visuelle Abnahme durch `D-PLAN`/`D-ABN`/`D-P9` extern blockiert sind.