# 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