44 lines
3.6 KiB
Markdown
44 lines
3.6 KiB
Markdown
# 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`
|