8.9 KiB
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-6und blockieren wederVR-P32anoch 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
geerkens2umgedeutet. 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-1bleibt dennoch unverändert offen: Für kontrollierte fachliche read-only Datentests muss die konkrete Geerkens-Bindung überMandant/Loadoder eine ausdrückliche manuelle Bestätigung feststehen, und es fehlten weiterhin kontrolliert freigegebene Testdaten. Der vorprovisionierte Pilot bleibt aufKWP_HIVEGRID_TENANT_IDbegrenzt; 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-AufrufAdressen-AdresssperreAdressen-KreditlimitAdressen-DebitorenAktivitaetenmanagement-AufrufAktivitaetenmanagement-NichtEigeneAktivitaetenmanagement-WegDelegierenArchiv-AllgemeinTermine-BenutzerTermine-MonteureTermine-NurSelbstErstellteTermineAenderbarTermine-AbwesenheitLesbarProjekt-AufrufPositionserfassungAufmass-AufrufRegie-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.