# 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-6` geparkt > und blockieren VN-2 nicht. > 🔴 **Historischer Dependency-Stand 2026-07-20:** KWP bietet keine Sandbox und keinen Testkunden; die in `VN-1` > vorausgesetzte 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-P32c` und `VR-P32d` sind als technische Implementierungsvoraussetzungen abgeschlossen. `VEXT-1` ist nach dem erneuten stabilen Demand-Refresh- Dauer-Proof vom 2026-08-01 4/4 Done. `VEXT-6` hä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.**