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-P32anochVR-P32b/c/d,VN-2oder einen anderen read-only Connector-/Inbound-Pfad. Es wird jetzt keinVR-P32eangelegt 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-P32eentsteht erst nach 4/4 DoD und separater ausdrücklicher Produktfreigabe - Keine Abhängigkeit:
VN-1/VN-2verproben 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_auftragauf 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.