131 lines
8.9 KiB
Markdown
131 lines
8.9 KiB
Markdown
# 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.**
|