75 lines
4.7 KiB
Markdown
75 lines
4.7 KiB
Markdown
# 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.**
|