Track HiveGrid Cloud planning reference
This commit is contained in:
1 parent
b3d5ea6764
commit
e341c5938a
5784 files changed
+1104929
-3
No files matched your search
@@ -0,0 +1,57 @@
|
||||
# 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
|
||||
Reference in new issue
Block a user