# VN-1 · Kontrollierten KWP-Read-only-Testzugang/Testdaten bereitstellen | | | |---|---| | **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** · minimal berechtigter BNWIN-Benutzer und kontrollierter Geerkens-Datenbereich fehlen | > 🟢 **Superseding Scope-Entscheidung 2026-07-22:** Benötigt wird nur noch ein kontrollierter > **read-only** Testzugang mit ausdrücklich freigegebenen fachlichen Daten. VN-1 autorisiert keinerlei > Mutation im produktiven Geerkens-System. Project-/Auftrag-Create und andere Write-Capabilities liegen > getrennt in `VEXT-6` und blockieren weder `VR-P32a` noch die Planung der read-only Inbound-Tickets. VN-1 > bleibt für deren echten fachlichen E2E-Proof bei **0/1 und Blocked / On Hold**. > 🔴 **Historische Herstellerantwort 2026-07-20:** KWP bietet weder eine separate Sandbox noch einen Testkunden an. > Die wörtliche DoD „KWP-Test-Instanz + Testdaten“ kann damit nicht durch eine KWP-Testumgebung erfüllt werden. > Sie wird nicht still auf den produktiven Mandanten `geerkens2` umgedeutet. Vor einer solchen Alternative ist > eine explizite Produkt-/Scope-Entscheidung erforderlich; bis dahin bleibt das Ticket bei **0/1 = 0 % done**. > 🟢 **Historische Dependency-Klärung 2026-07-21:** Der generische VR-P32a-Verbindungsflow für Discovery, > ausdrückliche bnWin-Mandantenauswahl bzw. bestätigtes „kein Mandant“ ist jetzt freigegeben und wird nicht > mehr durch diese externe Zulieferung blockiert. `VN-1` bleibt dennoch unverändert offen: Für kontrollierte > fachliche read-only Datentests muss die konkrete Geerkens-Bindung über `Mandant/Load` oder eine ausdrückliche > manuelle Bestätigung feststehen, und es fehlten weiterhin kontrolliert freigegebene Testdaten. Der vorprovisionierte Pilot > bleibt auf `KWP_HIVEGRID_TENANT_ID` begrenzt; Mehr-Tenant-/Mehr-Kunden-Provisionierung ist Folge-Scope. ## Was zu tun ist Geerkens stellt einen ausdrücklich freigegebenen, kontrollierten **read-only Datenbereich im bestehenden `geerkens2`-System** und einen minimal berechtigten BNWIN-Testbenutzer bereit. Eine separate Sandbox oder Testinstanz ist weder verfügbar noch erforderlich. Der Benutzer muss den OAuth2-Authorization-Code-/PKCE-Login interaktiv mit seinem **BNWIN-Anmeldekürzel** abschließen; das Passwort wird weder an HiveGrid übergeben noch gespeichert. Geerkens muss außerdem bestätigen, ob in kwp-bnWin.net ein Mandant eingerichtet ist und, falls ja, welches Kürzel als `mandant` zu senden ist. Alternativ darf der freigegebene Setup-Flow diese Bindung über `GET /api/Mandant/Load` ermitteln und vom Benutzer bestätigen lassen. Schlägt die Discovery wegen fehlender Berechtigung fehl, ist weiterhin eine ausdrückliche manuelle Angabe oder `none`-Bestätigung nötig; `KWP_MANDANT` ist keine neue processweite Mapping-Quelle. ### Von KWP benannte Benutzerrechte Die OAuth-Client-Scopes stellen laut KWP nur die Lizenzierung bereit. Für die vorgesehenen Prozesse müssen die Benutzerrechte separat unter **Benutzer im Netz** gesetzt werden: Für den aktuellen Scope werden daraus nur die für lesende Endpunkte tatsächlich notwendigen Rechte vergeben. Rechte mit möglicher Schreibwirkung sind keine Freigabe für Mutationen und werden nicht allein für den read-only Test aktiviert. - `Adressen-Aufruf` - `Adressen-Adresssperre` - `Adressen-Kreditlimit` - `Adressen-Debitoren` - `Aktivitaetenmanagement-Aufruf` - `Aktivitaetenmanagement-NichtEigene` - `Aktivitaetenmanagement-WegDelegieren` - `Archiv-Allgemein` - `Termine-Benutzer` - `Termine-Monteure` - `Termine-NurSelbstErstellteTermineAenderbar` - `Termine-AbwesenheitLesbar` - `Projekt-Aufruf` - `Positionserfassung` - `Aufmass-Aufruf` - `Regie-Aufruf` ## Warum / Ziel Die tenant-spezifische OpenAPI für `geerkens2` ist seit 12.07.2026 erreichbar, ersetzt aber keinen kontrollierten fachlichen Datenzugang mit minimal berechtigtem BNWIN-Benutzer. Für das E2E werden keine Writes gegen KWP- Produktivdaten ausgeführt. Benötigt werden kontrolliert freigegebene read-only Testdaten sowie ein Benutzer, dessen Rechte die fünf vereinbarten `*-extern`-Scopes abbilden. Diese Bereitstellung entblockt VN-2. Der freigegebene Datenbereich darf im bestehenden produktiven `geerkens2`-System liegen, muss aber fachlich begrenzt und ausdrücklich für den Test bestätigt sein. Diese Freigabe und der Testbenutzer stehen noch aus. Jeder Test bleibt read-only; Push, manueller Write-Sync und Schreibtests sind ausgeschlossen. ## Abhängigkeiten - **Blocked by:** externe Zulieferung durch Noah/Geerkens: ausdrücklich freigegebener kontrollierter read-only Datenbereich und minimal berechtigter BNWIN-Testbenutzer. Die Produkt-/Scope-Entscheidung ist mit CR-003/AD-32 getroffen; sie ist kein offener Blocker mehr. - **Blocks:** VN-2 (read-only KWP-Inbound-E2E-Verprobung). Der schmale read-only Erst-Proof von VEXT-1 wurde am 2026-07-21 mit einem echten Geerkens/BNWIN-Login erbracht und wird nicht als Ersatz für die hier geforderten kontrollierten fachlichen Testdaten umgedeutet. Der generische Mandanten-Verbindungsflow in VR-P32a ist hiervon ausdrücklich nicht mehr blockiert. ## Definition of Done - [ ] Kontrollierter read-only KWP-Testzugang und ausdrücklich freigegebene fachliche Testdaten bei Geerkens bereit; keine KWP-Mutation erlaubt ## Historischer Umsetzungsstand (2026-07-20) **VN-1: 0/1 DoD = 0 % done.** OAuth-Client und Scopes wurden geliefert; kein Secret-Wert steht in Git oder dieser Doc. Das aktuell provisionierte Secret bleibt für lokale Tests und Staging unverändert und ist kein Rotations-Blocker. Ohne separate Testinstanz, kontrollierte Datenfreigabe und die konkrete `mandant`-Auskunft ist der vollständige Token-/Resource-Proof nicht erbracht. Offen: 1 Punkt, extern blockiert; 0 selbst machbar. Lokaler Retest-Proof: HiveGrid erreicht Keycloak mit vollständigem Auth-Code-/PKCE-Request; die registrierte Staging-Callback-URL wird akzeptiert, die nicht registrierte Localhost-URL erwartungsgemäß abgelehnt. KWP meldet über `Core/GetVersion` jetzt **2.81.62**. Der frühere Versionsblocker ist damit weg, der interaktive BNWIN-Zugang war zu diesem Zeitpunkt noch nicht bewiesen. **Staging-Retest 2026-07-20:** Ein interaktiver BNWIN-Login samt Zustimmung war möglich und erreichte den HiveGrid-Callback. Der anschließende Token-/Aktivierungspfad scheiterte vor der Persistenz, daher sind weder Token noch geschützter Resource-Aufruf bewiesen. KWP stellt weiterhin keine separate Testinstanz oder kontrollierten Testdaten bereit; aus dem Login wird keine solche Freigabe abgeleitet. Es gab keine Rotation und keine Produktionsänderung. **VN-1 bleibt 0/1 DoD = 0 % done; 1 Punkt extern blockiert, 0 selbst machbar.** **Dependency-Update 2026-07-21:** Ein erneuter echter BNWIN-Login schloss Auth-Code, Token-Austausch, geschützten read-only `Core/GetApiVersion`-Aufruf und automatische Refresh-Rotation erfolgreich ab. Damit ist der echte Auth-/Resource-Erst-Proof von `VEXT-1` erbracht, ohne dass eine KWP-Sandbox, ein Testkunde oder kontrollierte Testdaten bereitgestellt wurden. Ein späterer Refresh schlug fehl; `VEXT-1` bleibt deshalb für den Dauerbetrieb offen. Der Lauf enthielt keine fachlichen Daten- oder Schreiboperationen und begründet keine stillschweigende Freigabe des produktiven Geerkens-Datenbestands. Die konkrete Geerkens-`mandant`-Auskunft bleibt ebenfalls offen; `KWP_MANDANT` bleibt ungesetzt. **VN-1: 0/1 DoD = 0 % done · 1 Punkt extern blockiert · 0 selbst machbar.** **Scope-Impact 2026-07-21:** Die Userfreigabe für den vollständigen Mandanten-Verbindungsflow ändert weder die VN-1-DoD noch den Fortschritt. Sie erlaubt nur, Discovery, Auswahl, `none`-Bestätigung und verschlüsselte 1:1-Bindung generisch zu bauen. Eine konkrete Auswahl im produktiven Geerkens-System ist kein Ersatz für die weiterhin fehlende Testinstanz bzw. kontrollierten Testdaten. **VN-1 bleibt 0/1 DoD = 0 % done · 1 Punkt extern blockiert · 0 selbst machbar.** **Dauer-Proof-Impact 2026-07-22:** Revision `2938f29da` lief nach einem normalen OAuth-Reconnect mit einem erfolgreichen geschützten Health-Probe, neun aufeinanderfolgenden automatischen Refresh-Rotationen und einem anschließenden gesunden Resource-Probe stabil; `VEXT-1` ist damit 4/4 Done. Dieser read-only Runtime-Proof liefert weiterhin weder eine KWP-Sandbox noch kontrollierte fachliche Testdaten und ändert deshalb keinen VN-1-DoD-Punkt. **VN-1: 0/1 DoD = 0 % done · 1 Punkt extern blockiert · 0 selbst machbar.** **Superseding Scope-Impact 2026-07-22:** Der aktuelle Testvertrag ist read-only. Eine separate Sandbox oder Testinstanz wird nicht verlangt. Erforderlich sind ausschließlich die ausdrückliche Geerkens-Freigabe für einen kontrollierten bestehenden Datenbereich und ein minimal berechtigter BNWIN-Testbenutzer. Der laufende Runtime-Proof ersetzt diese fachlichen Testdaten nicht. **VN-1: 0/1 DoD = 0 % done · Blocked / On Hold · 1 Punkt extern blockiert · 0 selbst machbar.**