Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/VEXT-6.md
T

4.7 KiB

VEXT-6 · [v2+] KWP Write-/Auftrag-Create-Capability nachhalten

Typ Setup (Externals — typ:external)
Owner Raffael
Phase Phase 32+ — KWP-Integration (konditionaler Vorlauf)
Cycle/Fenster kein Cycle / kein Zieltermin · erst bei neuer KWP-Herstellerfreigabe aktivieren
Status Blocked / On Hold · 0/4 DoD = 0 % done

🔒 Scope-Entscheidung 2026-07-22: Der initiale aktuelle KWP-Scope ist ausschließlich read-only. HiveGrid führt keine fachliche KWP-Mutation aus. Dieses Ticket parkt nur eine mögliche spätere Write-/Create-Capability und blockiert weder VR-P32a noch VR-P32b/c/d, VN-2 oder einen anderen read-only Connector-/Inbound-Pfad. Es wird jetzt kein VR-P32e angelegt und keine Push-Queue auf Vorrat gebaut.

Was zu tun ist

Erst wenn KWP eine externe Write-/Create-Capability anbietet, den Herstellervertrag belastbar erheben. Zu klären sind der verbindliche Endpoint zur Neuanlage eines kaufmännischen Auftrags/Projekts, das vollständige Request-/Response-Schema, die benötigten OAuth-Scopes und BNWIN-Rechte sowie der sichere Betriebsvertrag für Idempotenz, Fehler und kontrollierte Tests.

Der aktuelle Herstellerstand aus VEXT-1 lautet ausdrücklich: Die Neuanlage eines Projekts/Auftrags ist nicht vorgesehen; /api/Projekt/Save ändert nur die Bezeichnung eines bereits bestehenden Projekts. Diese Operation darf nicht als Create-Ersatz verwendet werden.

Warum / Trigger

Ohne dokumentierten Create-Endpunkt kann HiveGrid weder kwp.push_auftrag noch eine dafür bestimmte Push-Queue fachlich korrekt bauen. Vor dem Trigger gibt es keine implementierbare Dev-Spec. Auch 4/4 DoD in VEXT-6 autorisieren noch kein Dev-Ticket: Danach ist eine separate, erneute und ausdrückliche Produktfreigabe erforderlich. Erst mit dieser Freigabe wird der technische Scope als eigenes Dev-Ticket neu geschnitten. Bis der externe Vertrag die vier DoD-Punkte erfüllt, bleibt VEXT-6 Blocked / On Hold. Bei 4/4 ist ausschließlich dieses External-Ticket Done; der Writeback bleibt ohne die separate Produktfreigabe weiterhin geparkt und es wird kein spekulatives Dev-Ticket angelegt.

Abhängigkeiten

  • Blocked by: externe KWP-Herstellerfreigabe einer echten Write-/Auftrag-Create-Capability
  • Deferred from: VR-P32a (dessen aktueller M089/M090-Scope ist 5/5 Done und read-only)
  • Vertragsquelle: VEXT-1 (4/4 Done; dokumentiert den aktuellen Herstellerstand „Create nicht vorgesehen“)
  • Blocks: keine aktuellen read-only Tickets; ein späteres VR-P32e entsteht erst nach 4/4 DoD und separater ausdrücklicher Produktfreigabe
  • Keine Abhängigkeit: VN-1/VN-2 verproben kontrollierte read-only Daten und warten nicht auf VEXT-6

Definition of Done

  • KWP bestätigt einen verbindlichen externen Endpoint zur Neuanlage eines kaufmännischen Auftrags/Projekts; keine Umdeutung einer Update-/Rename-Operation
  • Vollständiges Request-/Response-Schema mit Pflichtfeldern, fachlichen IDs und validierbarem Idempotenzvertrag liegt vor
  • Erforderliche OAuth-Scopes, Client-Freischaltung und BNWIN-Benutzerrechte sind schriftlich bestätigt
  • Fehler-/Rate-Limit-/Retry-Vertrag und ein ausdrücklich freigegebener kontrollierter Write-Testpfad sind dokumentiert

Nicht in Scope

  • Kein KWP-Write oder kontrollierter „Probe-Write“ ohne erfüllte DoD
  • Keine Push-Queue, kein M091-Bau und keine Automation-Action kwp.push_auftrag auf Vorrat
  • Keine Änderung oder Rotation bestehender Staging-/Produktions-Credentials
  • Keine Blockade oder Erweiterung des initialen read-only KWP-Scopes
  • CR-005 darf die dokumentierten Mutation-Schemas als nicht ausführbare Contract-Fixtures erfassen. Das ist weder eine Write-Capability noch ein Provider-Idempotenzvertrag und erfüllt keinen DoD-Punkt dieses Tickets.

Umsetzungsstand (2026-07-22)

VEXT-6: 0/4 DoD = 0 % done · Blocked / On Hold · 4 Punkte extern blockiert · 0 selbst machbar. KWP bietet aktuell keinen Create-Vertrag. VR-P32a ist unabhängig davon im read-only Scope 5/5 Done; die Inbound-Tickets arbeiten ohne KWP-Mutation weiter.

CR-005 Impact 2026-07-24: Die echte Tenant-OpenAPI dokumentiert innerhalb der fünf HiveGrid-Scopes 36 mutierende Operationen. Ihre Request-/Response-Schemas werden als runtime-gesperrte, fixture-validierte Contracts erfasst, damit der Adapter vollständig und Drift sichtbar ist. Darunter bleibt weiterhin kein Endpoint zur Neuanlage eines kaufmännischen Projekts/Auftrags; /api/Projekt/Save ist nur Rename. Es fehlen weiterhin Provider-Idempotenz, verbindliche Rechte-/Fehlersemantik und ein freigegebener Live-Write-Testpfad. VEXT-6: 0/4 DoD = 0 % done · 4 Punkte extern blockiert · 0 selbst machbar.