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

56 lines
4.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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: