Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/ticket-docs/VD-P32.md
T

4.9 KiB
Raw Blame History

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: