4.6 KiB
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-1zu 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 —
syncPushfür HiveGrid→KWP, Webhook-Pull (falls KWP-Support) oder Cron-Pull für KWP→HiveGrid; idempotent überAppSyncItem. - 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.) — HauptquelleROADMAP.md→ Phase 32docs/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-P32caktualisiert