18 KiB
VN-2 · KWP Read-only-Inbound-Live-E2E mit Geerkens
| Typ | Noah-Zulieferung |
| Owner | Dejan/Haris (Noah liefert zu) |
| Cycle/Fenster | — · Blocked / On Hold ohne festes Datum oder Cycle |
| Status | Blocked / On Hold · 0/1 DoD = 0 % done · wartet nur noch auf VN-1 |
🟢 Superseding Scope-Entscheidung 2026-07-22: Das Geerkens-E2E prüft ausschließlich KWP→HiveGrid. Es liest freigegebene Plantafel-/Termin-, Projekt-/Vorgangs-, Archiv-, Task-/ERP- und Materialdaten und weist deren tenant-sicheren Import nach. Kein Test mutiert KWP. Der historische Won→Auftrag→KWP-Pfad entfällt aus der aktuellen DoD; Write-/Create-Capabilities sind in
VEXT-6geparkt und blockieren VN-2 nicht.
🔴 Historischer Dependency-Stand 2026-07-20: KWP bietet keine Sandbox und keinen Testkunden; die in
VN-1vorausgesetzte separate KWP-Testinstanz steht damit nicht zur Verfügung. Außerdem ist die Neuanlage eines Projekts/Auftrags über die API laut Hersteller nicht vorgesehen. Der bisher geplante E2E-Pfad Won→Auftrag→KWP kann deshalb nicht unverändert ausgeführt werden. Beides braucht vor einer Verprobung eine explizite Produkt-/Scope-Entscheidung und wird nicht still auf produktive Geerkens-Daten umgedeutet.
Was zu tun ist
Noah verprobt gemeinsam mit Geerkens die read-only KWP-Inbound-Anbindung End-to-End gegen ausdrücklich
freigegebene Geerkens-Testdaten. Der Live-Lauf startet erst downstream, nachdem VR-P32c und VR-P32d
implementiert sind und VN-1 den kontrollierten bestehenden Geerkens-Datenbereich samt minimal
berechtigtem BNWIN-Testbenutzer geliefert hat. Eine separate Sandbox/Testinstanz wird nicht verlangt.
Warum / Ziel
Die read-only E2E-Verprobung mit kontrollierten Geerkens-Daten ist der Praxisbeweis, dass die KWP→HiveGrid-Synchronisation produktiv tragfähig ist, ohne das KWP-System zu verändern. Sie validiert das erste v2-Modul beim Erstkunden und entblockt die anschließende Härtung/Abnahme (VH-1).
Abhängigkeiten
- Blocked by:
VN-1(kontrollierter bestehender Geerkens-Datenbereich und minimal berechtigter BNWIN-Testbenutzer).VR-P32a,VR-P32cundVR-P32dsind als technische Implementierungsvoraussetzungen abgeschlossen.VEXT-1ist nach dem erneuten stabilen Demand-Refresh- Dauer-Proof vom 2026-08-01 4/4 Done.VEXT-6hält einen möglichen späteren Write-/Create-Vertrag nach und blockiert dieses read-only E2E nicht. - Blocks: VH-1
- Quellen:
VR-P32c,VR-P32d,VN-1; der historische Termin 24.07. ist aufgehoben
Definition of Done
- Read-only KWP→HiveGrid-E2E mit kontrollierten Geerkens-Testdaten verprobt; repräsentative Inbound-Daten tenant-sicher importiert, keine KWP-Mutation ausgeführt
Historischer Umsetzungsstand (2026-07-20)
VN-2: 0/1 DoD = 0 % done. Der lokale Geerkens-Pilot-Slice umfasst nur OAuth-Callback, Token-Lifecycle und einen read-only Health-Aufruf; Pull, Push, manueller Sync und E2E-Schreibpfade sind nicht freigegeben und nicht deployt. Ohne kontrollierten Zugang und angepassten fachlichen Testpfad ist kein E2E-Proof möglich. Offen: 1 Punkt, vollständig blockiert; 0 selbst machbar.
Runtime-Dependency-Update 2026-07-21: Der Staging-Pilot hat BNWIN-Login, Token-Austausch und geschützten
read-only Core-Aufruf echt bewiesen; mehrere Refreshes gelangen, ein späterer setzte die Connection jedoch auf
broken. VEXT-1 bleibt deshalb für den stabilen Dauerbetrieb Blocker. Dieser
Proof enthält bewusst keine fachlichen Daten, Schreiboperationen oder Sync-Strecke und ersetzt weder VN-1
noch VR-P32c/d oder die Project-Create-Entscheidung. VN-2: 0/1 DoD = 0 % done · 1 Punkt vollständig
blockiert · 0 selbst machbar.
Dauer-Proof-Impact 2026-07-22: VEXT-1 ist nach Deploy-Run 10995, neun automatischen
Refresh-Rotationen und automatischen geschützten Health-Probes 4/4 Done und damit kein VN-2-Blocker mehr. Der Proof enthält weiterhin keine
fachlichen Testdaten oder Sync-/Schreibstrecke und ersetzt weder VN-1, VR-P32c/d noch die
Project-Create-Entscheidung. VN-2: 0/1 DoD = 0 % done · 1 Punkt vollständig blockiert · 0 selbst machbar.
Superseding Scope-Impact 2026-07-22: Die Project-Create-Entscheidung ist für VN-2 abgeschlossen: Der
aktuelle Testpfad ist read-only und braucht keine Create-/Write-Capability. Offen bleiben ausschließlich die
Inbound-Implementierung aus VR-P32c/d und kontrollierte fachliche Testdaten aus VN-1. VN-2: 0/1 DoD =
0 % done · 1 Punkt vollständig blockiert · 0 selbst machbar.
CR-004 Dependency-Impact 2026-07-23: VR-P32d liefert jetzt gezielte Suche, explizites Create/Link,
CRM-Bindung für Projekt-/Rechnungs-/Bauherradresse und dauerhafte read-only Reconciliation statt eines nicht
beweisbaren Vollimports. Das verschiebt keinen Live-Proof in den Implementierungs-PR: Der echte Lauf mit
kontrollierten Geerkens-Daten bleibt ausschließlich hier und startet weiterhin erst nach VR-P32c,
VR-P32d und VN-1. VN-2: 0/1 DoD = 0 % done · 1 Punkt vollständig blockiert · 0 selbst machbar.
CR-004 Implementierungs-Impact 2026-07-23: VR-P32d ist lokal 10/10 umgesetzt und fixture-, Queue-,
RLS-, Visual- und Build-validiert; der PR importiert bewusst kein unbestätigtes Realprojekt. VN-2 bleibt bis
zum Merge sowie bis VR-P32c und VN-1 vollständig blockiert. VN-2: 0/1 DoD = 0 % done · 1 Punkt
vollständig blockiert · 0 selbst machbar.
Connector-Regression-Impact 2026-07-23: Die Staging-Connection ist nach einer späteren semantisch
ungültigen Refresh-Antwort broken. VR-P32a ist deshalb bis Fix, Deploy, Reconnect und erneutem
Dauer-Proof zusätzlicher Live-Blocker. VR-P32d bleibt implementiert; es wurde kein Realprojekt importiert.
Der lokale Fix liegt in ccdc74ebe; bis zum Staging-Proof ändert das den Blocker nicht.
VN-2: 0/1 DoD = 0 % done · 1 Punkt vollständig blockiert · 0 selbst machbar.
Demand-Refresh-Dependency-Abschluss 2026-08-01: PR #312, Deploy-Run 11609, ein normaler
OAuth-Reconnect sowie 20/20 erfolgreiche Demand-Rotationen und acht gesunde Staging-Health-Sweeps
schließen VR-P32a/VEXT-1 wieder als technischen Live-Blocker. Der kontrollierte fachliche
Geerkens-Datenbereich und der minimal berechtigte BNWIN-Testbenutzer aus VN-1 bleiben unverändert offen;
es wurde kein Realprojekt importiert und keine KWP-Mutation ausgeführt.
VN-2: 0/1 DoD = 0 % done · 1 Punkt blockiert durch VN-1 · 0 selbst machbar.
OpenAPI-Größenlimit-Hotfix-Impact 2026-07-24: Der nach PR #227 und grünem Staging-Deploy 11091
ausgeführte secretsichere Smoke importierte kein Realprojekt. Er belegte ein gültiges
2.062.387-Byte-Tenant-OpenAPI, das nur am zu kleinen gemeinsamen 1-MiB-Limit scheiterte; Operationen,
Schemas und Felder selbst waren vollständig vorhanden. Commit ebdd48678 führt für Adapterrevision
kwp-project-v3 ein separates hartes 8-MiB-OpenAPI-Limit ein und lässt fachliche Antworten bei 1 MiB.
Follow-up-PR #228 lief in CI-Run 11093 mit 11/11 Jobs grün, wurde normal ohne Squash als Main
f5da0bbe22e413abb0bdfbe4b3917e4035afcae5 gemergt und über Staging-Deploy 11094 mit 44/44 grünen
Schritten ausgerollt. Der erneute read-only Smoke bestätigte eine aktive Verbindung, kwp-project-v3,
passende Fingerprints, Suche, Projektdetails und eine Adresse bei 0 offenen Fehlerberichten. Er
importierte bewusst kein Realprojekt und erfüllt deshalb nicht den kontrollierten VN-2-E2E. Der technische
Regression-Blocker ist aufgelöst; VR-P32c und VN-1 bleiben die fachlichen Blocker.
VN-2: 0/1 DoD = 0 % done · 1 Punkt vollständig blockiert · 0 selbst machbar.
Projekt-Suchvertrag-Hotfix-Impact 2026-07-23: Nach dem erfolgreichen Reconnect blieb die
DataConnection aktiv; der erste Projekt-Suchlauf scheiterte getrennt davon an einer zu strikten lokalen
Optionalitätsannahme und führte keinen Projektimport aus. Adapterrevision kwp-project-v2 ist lokal gegen
die redigierten echten Search-/Details-/Address-Shapes sowie 29 fokussierte Tests validiert. Der spätere
Staging-Smoke darf weiterhin nur read-only suchen und Details laden; ein Realprojektimport bleibt bis zum
kontrollierten VN-2-Lauf verboten. VR-P32c und VN-1 bleiben die fachlichen Blocker.
VN-2: 0/1 DoD = 0 % done · 1 Punkt vollständig blockiert · 0 selbst machbar.
CR-005 Dependency-Impact 2026-07-24: Der P32c-Recut inventarisiert 554 Tenant-OpenAPI-Operationen und
deckt alle 113 Operationen der fünf HiveGrid-Scopes vertraglich ab. Selektive Staging-Probes bleiben
read-only und beweisen nur Transport, Schema und Capability; die 36 Mutation-Contracts werden nie live
aufgerufen. Auch ein erfolgreicher technischer Read-Smoke importiert noch keine kontrollierten
Plantafel-/Archiv-/Task-/Materialdaten und erfüllt VN-2 deshalb nicht. VN-2: 0/1 DoD = 0 % done ·
1 Punkt vollständig durch VR-P32c-Abschluss und VN-1 blockiert · 0 selbst machbar.
VR-P32c Implementierungs-Impact 2026-07-24: Der vollständige read-only Adapter- und Inbound-Scope ist
lokal mit 9/9 DoD umgesetzt: 77 Leseoperationen sind geschützt ausführbar, 36 Mutation-Contracts bleiben
vor HTTP gesperrt, und Plantafel-/Termin-, Aktivitäts-/Task-, Material- und Archivpfade sind
fixture-/integrationsgetestet. Das ersetzt nicht den kontrollierten Geerkens-Live-Lauf und autorisiert
keinen Realprojektimport. Bis zum erfolgreichen PR-/Staging-Rollout bleibt VR-P32c technisch ein Blocker;
danach bleiben insbesondere VN-1 und der gemeinsam freigegebene Testdatenbereich offen.
VN-2: 0/1 DoD = 0 % done · 1 Punkt weiterhin extern blockiert · 0 selbst machbar.
VR-P32c Release-Impact 2026-07-24: PR #230 ist nach 11/11 grünen CI-Jobs als normaler Merge
2626f2c53a162fda49cd0d464d37cb271c16f401 ausgerollt; Deploy 11102 und die vier öffentlichen
Staging-Health-/Ready-Probes sind auf exakt dieser Revision grün. Damit ist VR-P32c kein technischer
VN-2-Blocker mehr. Der Release führte bewusst weder KWP-Mutationen noch einen Realprojektimport aus und
ersetzt deshalb nicht den kontrollierten Geerkens-Lauf. Offen bleiben VR-P32a sowie der durch VN-1
bereitzustellende minimal berechtigte BNWIN-Benutzer und Datenbereich.
VN-2: 0/1 DoD = 0 % done · 1 Punkt weiterhin extern blockiert · 0 selbst machbar.
Response-Schema-Recovery-Impact 2026-07-24: Der Hotfix 580279093 revalidiert bei identischem
semantischem Fingerprint ausschließlich eine KWP-Projektsuche und löst den alten Schema-Pause-Zustand mit
Revisions-Guard. Er führt weder eine KWP-Mutation noch einen HiveGrid-Projektimport aus und ersetzt den
kontrollierten Geerkens-Live-E2E nicht. VN-2: 0/1 DoD = 0 % done · 1 Punkt weiterhin extern blockiert ·
0 selbst machbar.
Suchstatus-Optionalität-Impact 2026-07-24: Der read-only Staging-Search zeigte 28 Treffer und keine
Provider-Mutation; ein laut OpenAPI zulässig statusloser Treffer löste nur wegen der zu strikten lokalen
Response-Grenze eine Capability-Pause aus. Hotfix 85c73a9af lässt routbare Treffer verfügbar und blendet
den statuslosen Treffer aus der Importauswahl aus. Dieser technische Read-Proof importiert bewusst kein
Projekt und ersetzt den kontrollierten Geerkens-Live-E2E nicht.
VN-2: 0/1 DoD = 0 % done · 1 Punkt weiterhin extern blockiert · 0 selbst machbar.
CR-006 Dependency-Impact 2026-07-24: Automatische read-only Discovery, lokaler Projektkatalog und
cache-first Suche verbessern den technischen Vorlauf, führen aber weiterhin keinen HiveGrid-Projektimport
aus und mutieren KWP nicht. Der einstellungsabhängige LoadProjekteNachFilter-Bestand ist kein Beweis für
einen providerweiten Vollbestand. Der kontrollierte Import repräsentativer Geerkens-Daten bleibt exklusiv
in diesem Ticket und wartet weiter auf den freigegebenen VN-1-Datenbereich.
VN-2: 0/1 DoD = 0 % done · 1 Punkt weiterhin extern blockiert · 0 selbst machbar.
Background-Queue-Impact 2026-07-24: Commit f0398f1d9 stellt technisch sicher, dass automatische
KWP-Discovery und gebundene read-only Synchronisation nicht mehr am deaktivierten Dateiimport-Gate
hängen. Der geplante Staging-Proof bleibt auf Queue-Verbrauch, lokalen Katalogzustand und redigierte
Aggregate beschränkt. Er importiert kein Realprojekt und ruft keine der 36 runtime-gesperrten
KWP-Mutationen auf. Deshalb ersetzt dieser Hotfix den kontrollierten Geerkens-Live-E2E nicht.
VN-2: 0/1 DoD = 0 % done · 1 Punkt weiterhin extern blockiert · 0 selbst machbar.
Background-Queue Release-Impact 2026-07-24: PR #242 lief in CI-Run 11148 mit 11/11
grünen Jobs, wurde ohne Squash als normaler Zwei-Parent-Merge
ab0e84f0160dc6471e6a4ca3e6c4089d811a99cc übernommen und über Deploy-Run 11149 vollständig
grün ausgerollt. Der automatische 15-Minuten-Scheduler erzeugte ohne manuellen Trigger zwei dedizierte
KWP-Jobs; der Import-Worker verarbeitete beide auf hivegrid.kwp-imports ohne Fehler. Der aggregierte
read-only Proof zeigte einen ready-Katalog mit 51 aktiven Einträgen, sechs aktiven Capabilities und
null offenen KWP-Fehlerberichten. Dabei wurde weiterhin kein Realprojekt importiert und keine
KWP-Mutation ausgeführt. Der technische Background-Sync-Blocker ist damit aufgelöst; der kontrollierte
Geerkens-Live-E2E wartet unverändert auf den freigegebenen VN-1-Datenbereich.
VN-2: 0/1 DoD = 0 % done · 1 Punkt weiterhin extern blockiert · 0 selbst machbar.
Shared-Request-Budget-Dependency-Impact 2026-08-01: Der lokale Hotfix 6e49701df beseitigt die nach
dem stabilen Demand-Refresh-Proof beobachtete Kollision zwischen Katalog-, Contract- und Projektjobs: Alle
Verbindungen desselben OAuth-Clients teilen den durable 50-Requests/Minute-Topf und warten bei lokaler
Erschöpfung bis zum Reset, statt künstliche 429-Retries zu erzeugen. Das verbessert den technischen Vorlauf,
führt aber weder einen kontrollierten Geerkens-Import noch eine KWP-Mutation aus und ersetzt den VN-2-E2E
nicht. Bis zum Release-/Staging-Proof bleibt dies ein lokaler Nachweis; der einzige fachliche Blocker bleibt
der freigegebene Datenbereich und Testbenutzer aus VN-1.
VN-2: 0/1 DoD = 0 % done · 1 Punkt blockiert durch VN-1 · 0 selbst machbar.
Shared-Request-Budget Release- und Dauer-Proof 2026-08-01: PR #317 lief mit 11/11 grünen CI-Jobs,
wurde als normaler Zwei-Parent-Merge 28b2c0258e3a0bd62f9287c12d117d9a6350f971 übernommen und über
Deploy-Run 11625 terminal grün auf Staging ausgerollt. Im zweistündigen read-only Fenster blieben neun
Health-Sweeps und neun Maintenance-Zyklen gesund; mindestens 29 Budget-Waits liefen ohne lokalen
rate_limit_exceeded, mindestens 14 Demand-Refreshes ohne Claim-, Provider- oder Persistenzfehler. Die
Connection blieb active, Katalog und sechs Capabilities gesund, null KWP-ErrorReports offen. Der
technische Shared-Budget-Blocker ist damit geschlossen.
Die Beobachtung löste weiterhin keinen kontrollierten VN-2-Realprojektimport und keine KWP-Mutation aus.
Der getrennte Live-Befund, dass das bestehende Archivfenster bei mehr als 20 Verzeichnissen terminal
KwpInboundLimitError liefert, erzeugt keinen Reconnect; für ein späteres VN-2-Testprojekt mit dieser
Ordnerzahl braucht er jedoch eine explizite Archivstrategie statt einer stillen Scope-Erweiterung. Der
aktuell einzige freigabeseitige Blocker bleibt der Datenbereich und Testbenutzer aus VN-1.
VN-2: 0/1 DoD = 0 % done · 1 Punkt blockiert durch VN-1 · 0 selbst machbar.
CR-013 Resilienz-Impact 2026-08-01: PR #332 härtet den späteren Live-Lauf gegen den beobachteten
35-Ordner-Bestand und einzelne HTTP-500-Dateiexporte: Kerndomänen werden unabhängig übernommen, das Archiv
läuft fortsetzbar in kleinen Batches und temporäre Dateifehler lassen die Connection aktiv. Der PR führt
keine KWP-Mutation aus und ist noch kein VN-2-Live-Proof. VN-2 wird erst nach Merge, Staging-Deploy und
kontrolliertem tenant-sicheren Import freigegebener Daten abgehakt. VN-2: 0/1 DoD = 0 % done · 1 Punkt
weiterhin blockiert durch den ausstehenden Live-Proof · 0 selbst machbar.
CR-013 Staging-Nachzug 2026-08-01: Deploy-Run 11688 brachte den normalen Merge
1a3c336288d7d7ec06db4dfe07c3514f7db4e9a5 erfolgreich auf Staging. Der automatische read-only Lauf
bestätigte die auf drei Versuche begrenzten, vom Connection-Status entkoppelten Archivdatei-Retries. Die
Discovery-Fortsetzung traf anschließend auf negative, aber gültige KWP-Standardordner-IDs, die der erste
Cursorvertrag noch zurückwies. Der fokussiert mit 70/70 Tests belegte Folgefix erweitert ausschließlich
diese ID-Validierung; Menge, Replay, Cooldown und Read-only-Grenze bleiben unverändert. Weder dieser
technische Lauf noch der Folgefix ersetzen den kontrollierten Import repräsentativer Daten.
VN-2: 0/1 DoD = 0 % done · 1 Punkt bleibt durch den ausstehenden Live-Proof blockiert · 0 selbst machbar.
CR-013 Cursor-Live-Abschluss 2026-08-01: PR #333, CI-Run 11694 mit 11/11 grünen Jobs, normaler
Merge ad1be1e615300a8092d2de9bb8f87220a079822d und erfolgreicher Deploy-Run 11695 schließen den
technischen Cursor-Nachzug. Der kontrollierte Replay desselben Buckets traversierte den realen
35-Ordner-Bestand in 7/7 abgeschlossenen Batches ohne Cursor-, Limit- oder Authfehler. Die Connection
blieb active, alle neuen Sync-Runs waren erfolgreich und es gab keine offenen KWP-ErrorReports. Bereits
terminal fehlgeschlagene Datei-Jobs blieben bei 3/3 Versuchen und wurden nicht erneut gestartet.
Dieser technische Proof importierte weiterhin keine repräsentativen Plantafel-/Task-/Materialdaten; die Archivdatei-Exporte selbst liefern bei KWP weiterhin HTTP 500. Deshalb ersetzt er nicht den kontrollierten, tenant-sicheren Import aus der VN-2-DoD und autorisiert keine Kundenreferenz. Es wurde keine KWP-Mutation ausgeführt. VN-2: 0/1 DoD = 0 % done · 1 Punkt bleibt durch den ausstehenden fachlichen Live-Proof blockiert · 0 selbst machbar.