Refresh HiveGrid Cloud reference snapshot

This commit is contained in:
david committed 2026-08-03 15:31:14 +02:00
1 parent 5e99e14772
commit 7f88026f79
5955 files changed
+1177325 -188362

No files matched your search

@@ -0,0 +1,74 @@
# 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.**