Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/VR-P32c.md
T
2026-07-08 16:15:37 +02:00

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-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-@hivegrid/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 → @hivegrid/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 → @hivegrid/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-@hivegrid/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) → @hivegrid/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 → @hivegrid/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