# VD-P32 · Screens P32 — KWP-Setup (Integration) | | | |---|---| | **Typ** | Screen (Design) | | **Owner** | David (mit Akeshan — D-KWP) | | **Phase** | P32 — KWP-Integration (v2-P5, Recut) · bedient `VR-P32a`/`VR-P32b`/`VR-P32c` | | **Cycle/Fenster** | v2-W2 — KWP/Portal/Mobile-Start · 2026-07-20 → fällig 2026-07-26 | | **Status** | geplant (NEU — Phasen-Ticket) | > ♻️ **Löst Sammel-Ticket auf:** Dieses Phasen-Ticket ersetzt — zusammen mit `VD-P22` und `VD-P28` — das alte Sammel-Ticket **`VD-5`** („Public-API-Keys + Admin-Tiefe + KWP-Setup"). VD-P32 = der KWP-Setup-Anteil. > 🔴 **Recut-Sonderfall (Block 2):** KWP wird regulärer **REST/OAuth-Adapter über die Apps-Engine (M33a)** — **`kwpsync.exe` wird NICHT gebaut** (3→2-Komponenten). ⚠ Größter Blocker: der konkrete KWP-API-Vertrag ist noch offen — Zugang ~20.07. ist der härteste Kalender-Anker. ## Abhängigkeiten & Parallelität - **Blocked by:** D0-Baseline (`D-D0a` App-Shell, `D-D0b` Archetypen A2/A3/A5 + Diff-Ansicht) — Setup/Health/Log/Konflikt-Screens komponieren aus den D0-Archetypen; dockt am M33a-Interface an - **Bedient (Dev):** `VR-P32a` (Connector + Health + Push-Queue, M089/090, 20.–22.07.), `VR-P32b` (Contract-Sentinel + Konflikt „KWP gewinnt", 22.–24.07.), `VR-P32c` (Plantafel-Sync + Doku-Archiv + Task-ERP, 24.–26.07.) - **Läuft parallel zu:** `VD-P26` (Portal), `VD-P27` (Mobile-PWA) — v2-W2 - **Subframe:** Pflicht je Route (A5/Wizard, A3/Status, A2, A5 + Diff, Banner) ## Was wir bauen Die **KWP-Setup-/Betriebs-Oberflächen**: KWP als erster konkreter Adapter hinterm M33a-Interface, bidirektional gespiegelt. Setup-Wizard (OAuth/API-Key, DEK-verschlüsselte Credentials, Initial-Sync-Vorschau), Connection-Health-View (Ampel, letzter Sync, Re-Connect), Sync-Log (Push/Pull, KwpErrorReport), Konflikt-Resolution („KWP gewinnt" mit Feld-Diff + Audit-Restore), ein Tenant-Sync-Pausen-Banner bei Contract-Drift sowie die Admin-Sicht pro Tenant mit Contract-Diff-Tool und Sync-Freigabe. Backend-lastig, aber mit klar umrissenen Oberflächen. ## Benötigte Screens | Screen [Route] | Kern-Inhalt | Archetyp | |---|---|---| | KWP-Setup-Wizard [`/integrations/kwp/setup`] | OAuth/API-Key-Verbindung, Credential-Eingabe (DEK-verschlüsselt), Initial-Sync-Vorschau | A5/Wizard | | Connection-Health-View [`/integrations/kwp`] | Verbindungsstatus (verbunden/broken), letzter Sync, Health-Probe, Re-Connect | A3/Status | | Sync-Log [`/integrations/kwp/log`] | Sync-Items (Push/Pull), Status, Zeit, KwpErrorReport-Einträge, Filter | A2 | | Konflikt-Resolution [`/integrations/kwp/conflicts`] | Konflikt-Paare (HiveGrid vs. KWP), Feld-Diff, „KWP gewinnt"-Anzeige + Audit-Restore | A5 + Diff | | Tenant-UI Sync-Pausen-Hinweis [Banner] | Klartext bei Contract-Drift: „KWP-Update erkannt — Sync pausiert für Sicherheit. Wir sind informiert." | Banner | | Admin: KWP-Sync-Status pro Tenant [`admin.hivegrid.de/integrations/kwp`] | Sync-Status je Tenant, Contract-Diff-Tool, Sync-Freigabe nach Adapter-Update | A2 + A3 | ## Features (muss abgedeckt sein) - [ ] KWP-API-Connector als erster konkreter Adapter hinterm M33a-Interface; **kwpsync.exe NICHT bauen** - [ ] Credentials per-Tenant-DEK-verschlüsselt in `DataConnection.config` - [ ] Bidirektionaler Sync: Push (Won→Auftrag) via Outbox + rate-limited Replay; Pull via Webhook/Cron, idempotent über `AppSyncItem` - [ ] Konflikt „KWP gewinnt" (LWW mit Audit-Restore) + Optimistic Locking HiveGrid-seitig - [ ] API-Contract-Sentinel (zod-Validierung + Versions-Check) pausiert Sync bei Drift + alarmiert Plattform-Admin - [ ] Plantafel-Sync + Dokumenten-Archiv-Sync (KWP-Doc → Storage) über die API - [ ] Task-ERP-Sync (M074) ## UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand) Verbindungs-Setup-Wizard (OAuth/API-Key-Eingabe, maskierte Credentials); Initial-Sync-Vorschau (was wird gespiegelt); Connection-Health-Statusanzeige (Ampel + letzter Heartbeat/Sync); Re-Connect-Button; Sync-Log-Tabelle (Push/Pull-Richtung, Status, Fehler-Report-Aufklappen); Konflikt-Diff-Ansicht (Feld-für-Feld HiveGrid vs. KWP, „KWP gewinnt"-Markierung, Restore-Aktion); Sync-Pausen-Banner (Klartext, Kontakt-Hinweis); Admin-Tenant-Sync-Statusliste; Contract-Diff-Tool; Sync-Freigabe-Aktion; Empty-/Loading-/Permission-Denied-States (Klartext). ## Quellen (granular) - `designer-briefs/P32-kwp-integration.md` (vollständiger Brief — diese Doc ist sein Ticket-Destillat) - `ENTITY-MODEL.md` → **Domäne 4: Apps-Engine (M33a)** + `DataConnection`/`AppSyncItem` - `ROADMAP-V2.md` §v2-P5 (Screens/Features = Hauptquelle) · `ROADMAP.md` §Phase 32 · `_bmad-output/specs/M19-kwp-integration.md` + **`docs/milestones/M19-KWP-API-RECUT.md` (bindend)** - Plane-Snapshot: ersetzt Teil von `VD-5`; bedient `VR-P32a`/`VR-P32b`/`VR-P32c` (v2-W2, 20.–26.07.) ## Davids Delta (David füllt aus) - [ ] Überschriebene/geänderte Spec-Punkte: - [ ] Neue UI/UX-Entscheidungen: - [ ] Subframe-Screen-Link(s): - [ ] Offene Fragen an Dev: