Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/ticket-docs/VEXT-1.md
T

3.6 KiB
Raw Blame History

VEXT-1 · KWP-API-Zugang nutzen + Recut-Detailplanung gegen API-Doku

Typ Setup (Externals — typ:external)
Owner Raffael
Phase Phase 32 (v2-P5) — KWP-Integration (Vorlauf)
Cycle/Fenster v2-W2 — KWP/Portal/Mobile-Start · fällig 2026-07-20
Status geplant · 🟠 block-2 (Partner-API offen, agil)

🟠 block-2 — Partner-API offen, agil: Dies ist der Vorlauf-Task, der den block-2-Zustand der gesamten KWP-Phase auflöst. KWP-API-Zugang lt. Hersteller ~19./20.07. — der härteste Kalender-Anker des v2-Sprints (KWP = das v2-Hauptverkaufsargument). Ohne diesen Task keine belastbare Recut-Detailplanung.

Was zu tun

KWP-API-Zugang aktivieren und die Recut-Detailplanung pro Milestone gegen die echte API-Doku durchführen — nicht gegen Annahmen. Konkret die 7 offenen Vertrags-Fragen aus dem bindenden Recut klären und je Milestone (M089–M095) entscheiden:

  1. Auth-Methode (API-Key / OAuth2 / mTLS?) → bestimmt DataConnection.type (rest-api/oauth2) + Credential-Handling
  2. Endpoints + Capabilities (welche Entitäten les-/schreibbar: Aufträge, Stammdaten, Belege, Plantafel, Dokumente?)
  3. Webhook-Support (KWP→HiveGrid Push?) → entscheidet M094 (Trigger-Pull vs. Cron-Pull) und M092
  4. Rate-Limits → bestimmt Replay-Rate (M091) und Pull-Intervalle
  5. Versionierung/Changelog → bestimmt Umfang M092 (eigenständig vs. in M089)
  6. Dokumenten-API (Listing + Download) → Voraussetzung M095
  7. Konflikt-Felder (version_hash/last_modified in Responses?) → Voraussetzung M093/M094

In v1 bereits erledigt (Andockpunkte): Callback-URL https://app.hivegrid.de/integrations/kwp/oauth/callback an KWP gemeldet (feste URL, Tenant im state, OAuth Auth-Code + PKCE); bnWin.net-8.1-N3-Update bei Geerkens angestoßen. Staging-Redirect-URI (staging-app.…) bei KWP mitregistrieren.

Warum / blockt

Ohne aktiven Zugang + Detailplanung gegen die echte Doku ist der KWP-Bau (VR-P32a/b/c) reine Spekulation. Liefert die konkreten Parameter (Auth-Typ, Endpoints, Webhook-Support, Rate-Limits, Konflikt-Felder), die jeden der drei Dev-Tickets steuern. kwpsync.exe NICHT bauen (Recut bindend, M089 = Connector statt Windows-Client). ⚠ Creds liegen bei API-Anbindung verschlüsselt in der Cloud (DataConnection.config, Per-Tenant-DEK) — Spec-19.1.2 gilt nicht mehr 1:1 → Vermerk an AVV/Subprozessoren (VR-P31/M166) weiterreichen.

Abhängigkeiten

  • Blocked by: — (extern: KWP-Hersteller-Zugang ~19./20.07.)
  • Blocks: VR-P32a (Connector — braucht Auth/Endpoints/Webhook-Klärung), VN-1 (KWP-Vorbereitung/Validierung)
  • Parallel: v1-Andockpunkte (Apps-Engine M33a, Extension-Points) stehen bereits — dieser Task füllt nur die Vertrags-Lücken.

Definition of Done

  • KWP-API-Zugang aktiv (Auth/Endpoints/Webhook-Support geklärt)
  • Recut-Detailplanung pro Milestone (M089–M095) gegen die echte Doku — alle 7 Vertrags-Fragen beantwortet
  • kwpsync.exe NICHT gebaut (Recut bindend bestätigt)
  • Staging-Redirect-URI bei KWP registriert; AVV/Subprozessor-Vermerk an VR-P31 weitergereicht

Quellen (granular)

  • docs/milestones/M19-KWP-API-RECUT.md (bindend) → 7 offene Vertrags-Fragen, appsEngine.prisma-Übernahme-Liste, Credential-Hinweis
  • ROADMAP-V2.md → §v2-P5 + §Offene Vorlauf-Tasks #1 (KWP-API-Vertrag ~20.07.)
  • ROADMAP.md → Phase 32 · PHASE-SOURCES.md → Phase 32 (Callback-URL gemeldet, bnWin.net-8.1-N3, Andockpunkte v1)
  • abhängig-für: ticket-docs/VR-P32a.md/VR-P32b.md/VR-P32c.md