Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/ticket-docs/VR-P32c.md
T

58 lines
4.6 KiB
Markdown

# VR-P32c · KWP: Plantafel-Sync + Doku-Archiv + Task-ERP-Sync (M094/095/074)
| | |
|---|---|
| **Typ** | Dev (Code) |
| **Owner** | Raffael |
| **Phase** | Phase 32 (v2-P5) — KWP-Integration (Recut) |
| **Cycle/Fenster** | v2-W2 — KWP/Portal/Mobile-Start · fällig 2026-07-26 · **E2E mit Geerkens Fr 24.07.** |
| **Status** | geplant · 🟠 **block-2 (Partner-API offen, agil)** |
> 🟠 **block-2 — Partner-API offen, agil:** Plantafel-Sync (M094) hängt davon ab, ob KWP **Webhook-Support** liefert (Trigger-Pull) oder nur Cron-Pull möglich ist; Doku-Archiv-Sync (M095) braucht eine **Dokumenten-API** (Listing + Download) auf KWP-Seite. Beides aus `VEXT-1` zu klären. Agil, sobald der Vertrag steht. **E2E mit Geerkens Fr 24.07.** ist der Beweis-Termin (→ `VN-2`).
## Abhängigkeiten & Parallelität
- **Blocked by:** `VR-P32b` (abgesicherte Sync-Schicht: Sentinel + Konflikt), `R-P9b` (v1-Plantafel/Auftrag-Extension-Points + Material — KWP dockt rückwirkend an)
- **Blocks:** `VN-2` (E2E-Validierung mit Geerkens Fr 24.07.)
- **Läuft parallel zu:** `VA-P27` (Mobile-PWA, Akeshan) — kein Schema-Konflikt; nutzt v1-`@toolctrl/storage` + FileEntityLink (Doku-Archiv) und die Task-Domäne (M074).
- **Konflikt-Risiko:** keines auf Schema-Ebene.
## Was wir bauen
Die **Sync-Familie**: **Plantafel-Sync** (bidirektional über die API — `syncPush` + Webhook/Cron-Pull), **Dokumenten-Archiv-Sync** (KWP-Doc → `@toolctrl/storage`) und **Task-ERP-Sync (M074)**. Alles idempotent über `AppSyncItem`, abgesichert durch den Contract-Sentinel und die „KWP gewinnt"-Regel aus VR-P32b. Im Recut laufen alle drei über die API (kein Client-Dateizugriff mehr). Abschluss-Beweis ist die **E2E-Validierung mit Geerkens am Fr 24.07.**
## Benötigte Screens (Backend bedient — Design liefert `D-P32`/Akeshan)
| Screen [Route] | Kern-Inhalt |
|---|---|
| (nutzt die Screens aus VR-P32a/b) | Sync-Log [`/integrations/kwp/log`] zeigt zusätzlich Plantafel-/Doku-/Task-Sync-Items; Doku im Auftrag-/Projekt-Detail aus dem Archiv sichtbar |
*(Keine neuen eigenständigen Screens — Plantafel/Doku/Tasks erscheinen in den bestehenden Auftrag-/Projekt-/Task-Views aus v1.)*
## Definition of Done
- [ ] **Plantafel-Sync bidirektional** über die API (`syncPush` + Webhook-Pull falls KWP-Support, sonst Cron-Pull)
- [ ] **Dokumenten-Archiv-Sync** KWP → `@toolctrl/storage` (FileEntityLink an Auftrag/Projekt)
- [ ] **Task-ERP-Sync (M074)**, idempotent über `AppSyncItem`
- [ ] **E2E mit Geerkens Fr 24.07.** grün (Won→Auftrag→KWP, Plantafel, Doku, Tasks durchgespielt)
- [ ] Material-Listen am Auftrag mit KWP-Daten befüllt (v1-Extension-Point genutzt)
## Technische Bausteine
- **Entities** (`prisma/schema/appsEngine.prisma` + Domänen-Schemata, AD-21): `AppSyncItem` (idempotente Mappings für Plantafel/Doku/Task), `ProjektExternesFeld` [v2] (`projekt_id`, `system='kwp'`, `feld_key`, `wert` — KWP-Felder am Projekt, in v1 NICHT vorhanden). Doku über v1-`@toolctrl/storage` + `FileEntityLink`; Tasks über die v1-Task-Domäne (M074, Task-ERP-Sync).
- **Plantafel-Sync:** bidirektional via API — `syncPush` für HiveGrid→KWP, Webhook-Pull (falls KWP-Support) oder Cron-Pull für KWP→HiveGrid; idempotent über `AppSyncItem`.
- **Dokumenten-Archiv-Sync:** KWP-Dokumenten-Endpoint (Listing + Download, aus VEXT-1) → `@toolctrl/storage`; FileEntityLink an Auftrag/Projekt.
- **Task-ERP-Sync (M074):** Tasks ↔ KWP-Aufträge idempotent über `AppSyncItem`; nutzt v1-Task-Entity-Links (M071↔M042, in P6 nachverdrahtet).
- **RLS:** alles Tenant-bezogene mit `app.tenant_id`.
- **Konnektor:** `tenantHasModule('kwp_integration')`.
- **`is_demo_data`:** Demo-Plantafel/-Doku/-Task-Sync für Demo-Tenant seedbar.
## Quellen (granular)
- `ROADMAP-V2.md` → §v2-P5 (Success-Criteria 5, E2E Geerkens Fr 24.07.) — **Hauptquelle**
- `ROADMAP.md` → Phase 32
- **`docs/milestones/M19-KWP-API-RECUT.md` (bindend)** → M094 (Plantafel via API, Webhook/Cron-Pull), M095 (Doku-Endpoint → `@toolctrl/storage`), offene Vertrags-Fragen 2/3/6 (Capabilities/Webhook/Doku-API)
- `PHASE-SOURCES.md` → Phase 32 (M094/095/074); M074 → Phase 32 verschoben (braucht Apps-Engine + KWP-Foundation); Retro-Integrationen wandern mit (Auftrag-Archiv/Material/Task-ERP)
- `ENTITY-MODEL.md` → `ProjektExternesFeld` [v2], `AppSyncItem`, Material-Listen am Auftrag (v1)
- `designer-briefs/P32-kwp-integration.md` (Sync-Log, Recut)
- `_bmad-output/specs/M19-kwp-integration.md`
## Dev-Nachzug (nach Davids `D-P32`-Delta + Recut-Detailplanung VEXT-1)
- [ ] Spec/ENTITY-MODEL an reale KWP-API + Davids UI-Entscheidungen angepasst
- [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen
- [ ] Plane-Ticket `VR-P32c` aktualisiert