Refresh HiveGrid Cloud reference snapshot
This commit is contained in:
1 parent
5e99e14772
commit
7f88026f79
5955 files changed
+1177325
-188362
No files matched your search
@@ -1,23 +1,68 @@
|
||||
# VR-P32c · KWP: Plantafel-Sync + Doku-Archiv + Task-ERP-Sync (M094/095/074)
|
||||
# VR-P32c · KWP Inbound: Plantafel + Doku-Archiv + Task-ERP (M094/095/074)
|
||||
|
||||
| | |
|
||||
|---|---|
|
||||
| **Typ** | Dev (Code) |
|
||||
| **Owner** | Raffael |
|
||||
| **Phase** | Phase 32 (v2-P5) — KWP-Integration (Recut) |
|
||||
| **Cycle/Fenster** | v2-W2 — KWP/Portal/Mobile-Start · fällig 2026-07-26 · **E2E mit Geerkens Fr 24.07.** |
|
||||
| **Status** | geplant · 🟠 **block-2 (Partner-API offen, agil)** |
|
||||
| **Cycle/Fenster** | v2-W2 — KWP/Portal/Mobile-Start · fällig 2026-07-26 |
|
||||
| **Status** | abgeschlossen · **9/9 DoD = 100 % done** · normal gemergt und auf Staging verifiziert |
|
||||
|
||||
> 🟠 **block-2 — Partner-API offen, agil:** Plantafel-Sync (M094) hängt davon ab, ob KWP **Webhook-Support** liefert (Trigger-Pull) oder nur Cron-Pull möglich ist; Doku-Archiv-Sync (M095) braucht eine **Dokumenten-API** (Listing + Download) auf KWP-Seite. Beides aus `VEXT-1` zu klären. Agil, sobald der Vertrag steht. **E2E mit Geerkens Fr 24.07.** ist der Beweis-Termin (→ `VN-2`).
|
||||
> 🟢 **CR-005 Scope-Erweiterung 2026-07-24:** Die vollständige Tenant-OpenAPI enthält 554 Operationen. Der
|
||||
> von HiveGrid angeforderte und lizenzierte Umfang der fünf `*-extern`-Scopes umfasst 113 eindeutige
|
||||
> Operationen in den Bereichen Adresse, Aktivität, Aktivitätsverwaltung, Archiv, Monteursteuerung, Projekt,
|
||||
> Projektampel, Termin, Vorgangsanzeige und VorgangInfo. 77 davon sind semantisch lesend, 36 mutierend.
|
||||
> VR-P32c liefert für alle 113 einen festen schema-validierten Adaptervertrag. Nur die 77 Leseoperationen
|
||||
> sind im Runtime-Transport erlaubt. Die 36 Mutation-Contracts werden gegen Fixtures geprüft, bleiben aber
|
||||
> vor Budget, Relay-Auflösung und HTTP technisch gesperrt. Es entstehen keine Write-Action, Queue oder UI.
|
||||
|
||||
> 🟢 **Superseding Scope-Entscheidung 2026-07-22:** Der initiale aktuelle KWP-Sync ist ausschließlich
|
||||
> **KWP→HiveGrid**. Plantafel-, Archiv-, Task- und Materialdaten werden nur gelesen/importiert; VR-P32c sendet
|
||||
> keine Mutation an KWP. Project-Create, Writeback und M091 sind in `VEXT-6` geparkt und blockieren dieses
|
||||
> Ticket nicht. Die älteren datierten Hinweise zum früher geplanten Won→Auftrag-Pfad bleiben als Historie
|
||||
> erhalten, gelten aber nicht mehr für die aktuelle DoD.
|
||||
|
||||
> 🟡 **Vertragsstand 2026-07-12:** Termin-/Monteursteuerungs-Operationen sowie Archiv-Listing und Export sind
|
||||
> im Geerkens-Vertrag bestätigt. Es gibt keine dokumentierten Webhooks/Callbacks; Phase 1 plant deshalb
|
||||
> Cron-Pull. Archivdateien laufen über Azure Blob: `ExportDatei` → `exchangeFileUri` → JSON → Downloadlink;
|
||||
> Austauschdateien verfallen nach 24 Stunden. Runtime-Scopes, Poll-Limits und echte Geerkens-Testdaten bleiben
|
||||
> offen. Der spätere Live-Abschlussbeweis mit Geerkens gehört ausschließlich zu `VN-2` und ist keine
|
||||
> Implementierungs-DoD dieses Tickets.
|
||||
|
||||
> 🟢 **Herstellerstand 2026-07-20:** KWP bestätigt, dass es keine Änderungs-Webhooks oder
|
||||
> authentifizierten Änderungs-Callbacks, keine Delta-Cursor und keine „geändert seit“-Filter gibt. Der Pull muss deshalb ohne
|
||||
> Hersteller-Delta-Vertrag auskommen und das Hard-Cap von **60 Requests/Minute pro Client** selbst einhalten;
|
||||
> KWP nennt kein empfohlenes Polling-Intervall und keine weiteren Vorgaben zu Parallelität, Backoff, Jitter
|
||||
> oder `429`. KWP bietet außerdem keine Sandbox und keinen Testkunden. Die Neuanlage eines Projekts/Auftrags
|
||||
> über die API ist ausdrücklich nicht vorgesehen; der in DoD 4 genannte Weg Won→Auftrag→KWP ist damit in der
|
||||
> bestehenden Form nicht ausführbar und braucht eine explizite Produkt-/Scope-Entscheidung.
|
||||
|
||||
> 🟢 **Mandanten-Consumer-Vertrag 2026-07-21:** Der in VR-P32a freigegebene Setup-Flow bindet genau
|
||||
> einen HiveGrid-Tenant an ein KWP-Kundenkürzel plus einen bestätigten bnWin-Mandanten oder die ausdrücklich
|
||||
> bestätigte Abwesenheit eines solchen Mandanten. Alle späteren Plantafel-, Archiv-, Task- und Material-Calls
|
||||
> aus diesem Ticket müssen diese per-Tenant-DEK verschlüsselte Bindung verwenden; `unconfirmed` blockiert
|
||||
> fachliche Calls fail-closed. `KWP_MANDANT` ist keine processweite Consumer-Konfiguration. Der
|
||||
> vorprovisionierte Geerkens-Pilot bleibt auf `KWP_HIVEGRID_TENANT_ID` begrenzt; sichere
|
||||
> Mehr-Tenant-/Mehr-Kunden-Provisionierung ist Folge-Scope.
|
||||
|
||||
## Abhängigkeiten & Parallelität
|
||||
- **Blocked by:** `VR-P32b` (abgesicherte Sync-Schicht: Sentinel + Konflikt), `R-P9b` (v1-Plantafel/Auftrag-Extension-Points + Material — KWP dockt rückwirkend an)
|
||||
- **Blocks:** `VN-2` (E2E-Validierung mit Geerkens Fr 24.07.)
|
||||
- **Erfüllte Runtime-Voraussetzung:** `VEXT-1` ist nach dem Staging-Dauer-Proof vom 2026-07-22 4/4 Done;
|
||||
Auth, geschützter Resource-Probe und neun automatische Refresh-Rotationen sind erbracht.
|
||||
- **Lokaler Verifikationsvertrag:** Die Implementierung wird mit schema-validen KWP-Fixtures sowie
|
||||
tenant-/RLS-gebundenen Integrations-, Replay- und Fehlerpfadtests abgeschlossen. `VN-1` und `VN-2` sind
|
||||
keine Implementierungs-Blocker; sie liefern ausschließlich den nachgelagerten Live-Proof mit kontrollierten
|
||||
Geerkens-Daten.
|
||||
- **Blocks:** `VN-2` (spätere Live-E2E-Validierung mit Geerkens), `VJ-3` (Website-Launch bleibt bis zum
|
||||
belegten read-only Inbound-Umfang offen)
|
||||
- **Läuft parallel zu:** `VA-P27` (Mobile-PWA, Akeshan) — kein Schema-Konflikt; nutzt v1-`@hivegrid/storage` + FileEntityLink (Doku-Archiv) und die Task-Domäne (M074).
|
||||
- **Konflikt-Risiko:** keines auf Schema-Ebene.
|
||||
|
||||
## Was wir bauen
|
||||
Die **Sync-Familie**: **Plantafel-Sync** (bidirektional über die API — `syncPush` + Webhook/Cron-Pull), **Dokumenten-Archiv-Sync** (KWP-Doc → `@hivegrid/storage`) und **Task-ERP-Sync (M074)**. Alles idempotent über `AppSyncItem`, abgesichert durch den Contract-Sentinel und die „KWP gewinnt"-Regel aus VR-P32b. Im Recut laufen alle drei über die API (kein Client-Dateizugriff mehr). Abschluss-Beweis ist die **E2E-Validierung mit Geerkens am Fr 24.07.**
|
||||
Die **read-only Inbound-Sync-Familie**: Plantafel-/Termin-Daten per Cron-Pull, Dokumenten-Archiv über den
|
||||
bestätigten KWP-Azure-Austausch nach `@hivegrid/storage` und Task-/ERP-Daten KWP→HiveGrid (M074). Alles wird
|
||||
idempotent über `AppSyncItem` importiert, durch Sentinel und „KWP gewinnt" abgesichert. Kein
|
||||
Client-Dateizugriff, kein angenommener Webhook-Pfad und keine KWP-Mutation.
|
||||
|
||||
## Benötigte Screens (Backend bedient — Design liefert `D-P32`/Akeshan)
|
||||
| Screen [Route] | Kern-Inhalt |
|
||||
@@ -27,31 +72,258 @@ Die **Sync-Familie**: **Plantafel-Sync** (bidirektional über die API — `syncP
|
||||
*(Keine neuen eigenständigen Screens — Plantafel/Doku/Tasks erscheinen in den bestehenden Auftrag-/Projekt-/Task-Views aus v1.)*
|
||||
|
||||
## Definition of Done
|
||||
- [ ] **Plantafel-Sync bidirektional** über die API (`syncPush` + Webhook-Pull falls KWP-Support, sonst Cron-Pull)
|
||||
- [ ] **Dokumenten-Archiv-Sync** KWP → `@hivegrid/storage` (FileEntityLink an Auftrag/Projekt)
|
||||
- [ ] **Task-ERP-Sync (M074)**, idempotent über `AppSyncItem`
|
||||
- [ ] **E2E mit Geerkens Fr 24.07.** grün (Won→Auftrag→KWP, Plantafel, Doku, Tasks durchgespielt)
|
||||
- [ ] Material-Listen am Auftrag mit KWP-Daten befüllt (v1-Extension-Point genutzt)
|
||||
- [x] **Vollständiger Scoped-Contract:** alle 554 OpenAPI-Operationen inventarisiert; die 113 über
|
||||
`adresse-extern`, `archiv-extern`, `termin-extern`, `vorgang-extern` oder `aktivitaet-extern`
|
||||
erreichbaren Operationen besitzen stabile IDs, Methode/Pfad, Capability und rekursiv geschlossene
|
||||
Request-/Response-Schemas; kein generischer URL-Pass-through
|
||||
- [x] **Read-Adapter-Coverage:** alle 77 semantisch lesenden Scoped-Operationen sind explizit allowlisted,
|
||||
schema-validiert und über den credential-/mandant-/rate-budget-geschützten Resource-Adapter ausführbar
|
||||
- [x] **Mutation-Contract-Coverage:** alle 36 mutierenden Scoped-Operationen sind schema- und
|
||||
fixture-validiert erfasst, werden aber zur Runtime garantiert vor Budget, Relay-Auflösung und HTTP
|
||||
blockiert; kein Web-/Worker-Export, keine Action, Queue oder UI-Aktion
|
||||
- [x] **Capability-Sentinel:** semantischer Fingerprint und Response-Drift pausieren ausschließlich Adresse,
|
||||
Aktivität, Archiv, Termin/Plantafel oder Vorgang/Projekt; Mutation-Capabilities bleiben unabhängig davon
|
||||
nicht ausführbar
|
||||
- [x] **Plantafel-/Termin-Inbound-Sync** KWP → HiveGrid per Cron-Pull; keine KWP-Mutation und keine angenommenen Webhooks
|
||||
- [x] **Dokumenten-Archiv-Sync** KWP → `@hivegrid/storage` (FileEntityLink an Auftrag/Projekt)
|
||||
- [x] **Task-/ERP-Inbound-Sync (M074)** KWP → HiveGrid, idempotent über `AppSyncItem`
|
||||
- [x] **Lokale schema-valide Fixture-/Integrationstests** für vollständigen Contract, Plantafel-/Termin-,
|
||||
Doku-, Task-/ERP- und Material-Inbound grün; RLS-Isolation, Idempotenz, Replay, Capability-Drift,
|
||||
Mutation-Deny und Fehlerpfade abgedeckt
|
||||
- [x] **Material-Listen** am Auftrag mit KWP-Daten befüllt (v1-Extension-Point genutzt)
|
||||
|
||||
## Technische Bausteine
|
||||
- **Entities** (`prisma/schema/appsEngine.prisma` + Domänen-Schemata, AD-21): `AppSyncItem` (idempotente Mappings für Plantafel/Doku/Task), `ProjektExternesFeld` [v2] (`projekt_id`, `system='kwp'`, `feld_key`, `wert` — KWP-Felder am Projekt, in v1 NICHT vorhanden). Doku über v1-`@hivegrid/storage` + `FileEntityLink`; Tasks über die v1-Task-Domäne (M074, Task-ERP-Sync).
|
||||
- **Plantafel-Sync:** bidirektional via API — `syncPush` für HiveGrid→KWP, Webhook-Pull (falls KWP-Support) oder Cron-Pull für KWP→HiveGrid; idempotent über `AppSyncItem`.
|
||||
- **Dokumenten-Archiv-Sync:** KWP-Dokumenten-Endpoint (Listing + Download, aus VEXT-1) → `@hivegrid/storage`; FileEntityLink an Auftrag/Projekt.
|
||||
- **Task-ERP-Sync (M074):** Tasks ↔ KWP-Aufträge idempotent über `AppSyncItem`; nutzt v1-Task-Entity-Links (M071↔M042, in P6 nachverdrahtet).
|
||||
- **Plantafel-/Termin-Inbound:** ausschließlich Cron-Pull für KWP→HiveGrid; Pull-Intervall konservativ und
|
||||
pro Connection konfigurierbar. Da es keinen Delta- oder „geändert seit“-Vertrag gibt, muss die spätere
|
||||
Abrufstrategie das clientweite Hard-Cap von 60 Requests/Minute aggregiert einhalten; KWP gibt kein
|
||||
empfohlenes Intervall vor.
|
||||
- **Dokumenten-Archiv-Sync:** `LoadVerzeichnisse`/`LoadDateienByVerzeichnisId`/`LoadEintragDetails` →
|
||||
`ExportDatei` → `exchangeFileUri`-JSON → Blob-Download → `@hivegrid/storage`; FileEntityLink an Projekt.
|
||||
- **Task-/ERP-Inbound (M074):** KWP-Daten → HiveGrid-Tasks/Projektbezug idempotent über `AppSyncItem`; nutzt v1-Task-Entity-Links (M071↔M042, in P6 nachverdrahtet).
|
||||
- **Gebundener KWP-Kontext:** Jede Operation liest `mandantBinding` aus den verschlüsselten Credentials der
|
||||
konkreten `DataConnection`. Bei `selected` wird das Kürzel an jeden KWP-Request gehängt, bei bestätigtem
|
||||
`none` bewusst nicht; `unconfirmed` darf keinen fachlichen Sync starten.
|
||||
- **RLS:** alles Tenant-bezogene mit `app.tenant_id`.
|
||||
- **Konnektor:** `tenantHasModule('kwp_integration')`.
|
||||
- **`is_demo_data`:** Demo-Plantafel/-Doku/-Task-Sync für Demo-Tenant seedbar.
|
||||
- **`is_demo_data`:** nur lokale HiveGrid-Fixtures; KWP bietet keine Sandbox und keinen Testkunden.
|
||||
- **Scoped-API-Vertrag:** 554 Operationen inventarisiert; 113 lizenzierte Operationen als eingecheckter,
|
||||
tenant-neutraler Contract-Slice. Die Roh-OpenAPI mit kundenspezifischem Server bleibt außerhalb des Repos.
|
||||
- **Runtime-Grenze:** Read-POSTs werden semantisch allowlisted. `Save`, `Add`, `Delete`, `Remove`, `Import`,
|
||||
`Publish` und `Reset` bleiben unabhängig von der HTTP-Methode gesperrt. Der Fachcode erhält nie freie
|
||||
URL-/Pfad-/Token-/Mandant-Parameter.
|
||||
- **Live-Proof-Grenze:** Dieses Ticket verwendet keine produktiven Geerkens-Daten als Implementierungs-Gate.
|
||||
Den späteren kontrollierten Live-E2E besitzt ausschließlich `VN-2`, zugeliefert über `VN-1`.
|
||||
|
||||
## Quellen (granular)
|
||||
- `ROADMAP-V2.md` → §v2-P5 (Success-Criteria 5, E2E Geerkens Fr 24.07.) — **Hauptquelle**
|
||||
- `ROADMAP-V2.md` → §v2-P5 (Success-Criteria 5; kontrollierter Live-E2E separat in `VN-2`) — **Hauptquelle**
|
||||
- `ROADMAP.md` → Phase 32
|
||||
- **`docs/milestones/M19-KWP-API-RECUT.md` (bindend)** → M094 (Plantafel via API, Webhook/Cron-Pull), M095 (Doku-Endpoint → `@hivegrid/storage`), offene Vertrags-Fragen 2/3/6 (Capabilities/Webhook/Doku-API)
|
||||
- `PHASE-SOURCES.md` → Phase 32 (M094/095/074); M074 → Phase 32 verschoben (braucht Apps-Engine + KWP-Foundation); Retro-Integrationen wandern mit (Auftrag-Archiv/Material/Task-ERP)
|
||||
- **`.planning/KWP-API-CONTRACT.md` (bindend)** → M094 (Plantafel via API, zunächst Cron-Pull; Webhook nur nach separater Bestätigung), M095 (Azure-Exchange → `@hivegrid/storage`), Vertragsfragen 2/3/6
|
||||
- Historische Milestone-Zuordnung: Phase 32 (M094/095/074); M074 → Phase 32 verschoben (braucht Apps-Engine + KWP-Foundation); Retro-Integrationen wandern mit (Auftrag-Archiv/Material/Task-ERP)
|
||||
- `ENTITY-MODEL.md` → `ProjektExternesFeld` [v2], `AppSyncItem`, Material-Listen am Auftrag (v1)
|
||||
- `designer-briefs/P32-kwp-integration.md` (Sync-Log, Recut)
|
||||
- `_bmad-output/specs/M19-kwp-integration.md`
|
||||
|
||||
## Dev-Nachzug (nach Davids `D-P32`-Delta + Recut-Detailplanung VEXT-1)
|
||||
|
||||
**Dependency-Impact 2026-07-20:** **VR-P32c: 0/5 DoD = 0 % done.** Der schmale lokale Callback-/Health-Slice
|
||||
aus `VR-P32a` enthält keinen Pull, Push, manuellen Sync, Archiv- oder Task-Sync und ist nicht deployt. Die
|
||||
Herstellerantworten klären die Planungsgrenzen, schließen aber keinen DoD-Punkt. Insbesondere bleiben
|
||||
Runtime-Proof, kontrollierter E2E-Zugang und die Produktentscheidung zum nicht unterstützten Project-Create
|
||||
offen.
|
||||
|
||||
**Runtime-Dependency-Update 2026-07-21:** Der echte BNWIN-OAuth-/Health-Erstlauf auf Staging war erfolgreich;
|
||||
ein späterer Refresh setzte die Connection jedoch auf `broken`, daher bleibt `VEXT-1` für Dauerbetrieb offen.
|
||||
Der bewiesene read-only Core-Aufruf enthält außerdem
|
||||
keinen Pull, Push, Archiv-, Plantafel-, Task- oder Schreib-Sync. `VR-P32b`, `VN-1`, die konkrete
|
||||
`mandant`-Auskunft und die Produktentscheidung zum nicht unterstützten Project-Create bleiben unverändert
|
||||
offen. **VR-P32c: 0/5 DoD = 0 % done · 5 Punkte offen, davon 5 blockiert · 0 selbst machbar.**
|
||||
|
||||
**Mandantenflow-Impact 2026-07-21:** Die Userfreigabe in VR-P32a löst nur den generischen Setup-Bau aus. Sie
|
||||
ist keine konkrete Geerkens-Bindung, keine Freigabe produktiver Daten und zieht keinen Plantafel-, Archiv-,
|
||||
Task-, Material-, Pull- oder Schreib-Sync vor. VR-P32c übernimmt später lediglich den bestätigten
|
||||
verschlüsselten Kontext. **VR-P32c bleibt 0/5 DoD = 0 % done · 5 Punkte offen, davon 5 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 Runtime-Blocker mehr.
|
||||
Der Proof enthält weiterhin keinen Pull, Push, Archiv-, Plantafel-, Task-, Material- oder Schreib-Sync;
|
||||
`VR-P32b`, `VN-1` und die
|
||||
Project-Create-Entscheidung bleiben offen. **VR-P32c: 0/5 DoD = 0 % done · 5 Punkte offen, davon 5 blockiert ·
|
||||
0 selbst machbar.**
|
||||
|
||||
**Superseding Scope-Impact 2026-07-22:** Die Produktentscheidung ersetzt den früher geplanten
|
||||
bidirektionalen/Won→Auftrag-Testpfad durch ein ausschließlich read-only Inbound-E2E. Project-Create und
|
||||
Writeback werden in `VEXT-6` nachgehalten und sind kein Blocker für VR-P32c. Offen bleiben die tatsächliche
|
||||
Inbound-Implementierung, `VR-P32b` und die v1-Andockpunkte. Die fünf Implementierungs-DoD werden lokal mit
|
||||
schema-validen Fixtures und Integrationstests belegt; `VN-1`/`VN-2` folgen ausschließlich als Live-Proof.
|
||||
**VR-P32c: 0/5 DoD = 0 % done · 5 Punkte offen · Start wartet auf `VR-P32b`/`R-P9b` · kein externer
|
||||
Live-Proof blockiert die Implementierung.**
|
||||
|
||||
**CR-004 Dependency-Impact 2026-07-23:** Der gemeinsame P32b/P32d-PR erweitert die Schutzschicht um das
|
||||
providerneutrale dauerhafte `AppEntityBinding`, das P32c später ebenfalls für Plantafel-, Doku-, Task- und
|
||||
Material-Zuordnungen konsumiert. Die External-/Local-Eindeutigkeitsgrenzen, Lease-, Replay-, RLS- und
|
||||
Sentinel-Verträge bleiben damit kompatibel. Der PR zieht keine der fünf P32c-DoD vor und ändert den
|
||||
zusätzlichen `R-P9b`-Blocker nicht. **VR-P32c: 0/5 DoD = 0 % done · 5 Punkte offen · Start wartet weiter auf
|
||||
`VR-P32b`/`R-P9b`.**
|
||||
|
||||
**CR-004 Implementierungs-Impact 2026-07-23:** Der providerneutrale Binding-/Lease-/Sentinel-Unterbau ist
|
||||
in `5e5442923` lokal vollständig umgesetzt und Forced-RLS-/Replay-validiert. P32c darf ihn nach Merge
|
||||
konsumieren, erhält dadurch aber keinen Plantafel-, Doku-, Task- oder Material-DoD vorgezogen; `R-P9b` bleibt
|
||||
unverändert offen. **VR-P32c: 0/5 DoD = 0 % done · 5 Punkte offen · vor Merge weiter durch
|
||||
`VR-P32b`/`R-P9b`, danach ausschließlich durch den verbleibenden eigenen Scope und `R-P9b` blockiert.**
|
||||
|
||||
**Projekt-Adapter-Hotfix-Impact 2026-07-23:** Adapterrevision `kwp-project-v2` korrigiert ausschließlich die
|
||||
Optionalität der bereits konsumierten Projekt-/Adress-Responses und den Recovery-Pfad eines
|
||||
uninitialisierten Sentinel-Fehlalarms. `AppEntityBinding`, Lease, Replay, RLS, Quarantäne und die
|
||||
External-/Local-Eindeutigkeitsgrenzen ändern sich nicht. P32c konsumiert später denselben korrigierten
|
||||
Read-only-Unterbau, erhält aber weiterhin keinen Plantafel-, Doku-, Task- oder Material-DoD vorgezogen.
|
||||
**VR-P32c: 0/5 DoD = 0 % done · 5 Punkte offen · wartet weiter auf den eigenen Scope und `R-P9b`.**
|
||||
|
||||
**OpenAPI-Größenlimit-Hotfix-Impact 2026-07-24:** Adapterrevision `kwp-project-v3` trennt ausschließlich
|
||||
das hart begrenzte Sentinel-OpenAPI-Limit (8 MiB) vom unveränderten 1-MiB-Limit der fachlichen
|
||||
Projekt-/Adressantworten. Binding, Lease, Replay, RLS, Quarantäne und External-/Local-Eindeutigkeit bleiben
|
||||
unverändert. Commit `ebdd48678` ist lokal vollständig grün; PR `#228`, CI-Run `11093` mit **11/11 Jobs**,
|
||||
normaler Main-Merge `f5da0bbe22e413abb0bdfbe4b3917e4035afcae5` und Staging-Deploy `11094` mit
|
||||
**44/44 grünen Schritten** belegen den Rollout. Der read-only Live-Smoke bestätigte `kwp-project-v3`,
|
||||
passende Fingerprints, Suche, Projektdetails und eine Adresse ohne Projektimport oder KWP-Schreiboperation.
|
||||
P32c erhält keinen Plantafel-, Doku-, Task- oder Material-DoD vorgezogen. **VR-P32c: 0/5 DoD = 0 % done ·
|
||||
5 Punkte offen · wartet weiter auf den eigenen Scope und `R-P9b`.**
|
||||
|
||||
**CR-005 Scope-Impact 2026-07-24:** Beide bisherigen Implementierungsblocker sind erledigt:
|
||||
`VR-P32b` ist 4/4 Done und `R-P9b` steht einschließlich Interim-UI bei 100 %. Die echte
|
||||
2.062.387-Byte-Tenant-OpenAPI wurde secretsicher und ohne fachlichen Import gelesen: 554 Operationen
|
||||
gesamt, 113 im aktuellen Fünf-Scope-Vertrag, davon 77 read und 36 mutation. Der Ticketumfang wächst von
|
||||
5 auf 9 DoD. Mutation-Contracts werden gebaut und fixture-validiert, bleiben aber runtime-gesperrt; dadurch
|
||||
bleibt AD-32 intakt und `VEXT-6` unverändert extern blockiert. **VR-P32c: 0/9 DoD = 0 % done · 9 Punkte
|
||||
selbst machbar · In Progress.**
|
||||
|
||||
**Umsetzungs-Notiz 2026-07-24:** Die sechs atomaren Commits `4471830df`, `fb3f62073`, `e4ff0c9cf`,
|
||||
`2414b311e`, `a5aaef33a` und `86fa9bf36` liefern den CR-005-Recut, den tenant-neutralen Contract für alle
|
||||
113 lizenzierten Operationen, den geschützten Adapter für alle 77 Leseoperationen, die harte Runtime-Sperre
|
||||
für alle 36 Mutationen, fünf getrennte Capability-Sentinels sowie den dreiphasigen Inbound-Sync für
|
||||
Plantafel/Termine, Aktivitäten/Tasks, Material und Archivdateien. Archivdownloads sind auf HTTPS,
|
||||
SSRF-Schutz, 100 MiB, Storage und Scan-Queue begrenzt. `KwpMaterialPosition` besitzt Forward-only-Migration,
|
||||
Inverse-SQL, Forced RLS, Tenant-Registry und eine schreibgeschützte Materialansicht am Auftrag.
|
||||
|
||||
Lokaler Proof: `pnpm typecheck`, `pnpm lint`, `pnpm test` mit **1.029 Testdateien / 7.394 grünen Tests /
|
||||
55 skips**, `pnpm run verify:i18n`, `pnpm test:hot-swap`, der P9-Visual-Snapshot sowie die fokussierten
|
||||
KWP-/Queue-/Worker-/RLS-/Migrationstests sind grün. Die Fixture-Suite kompiliert und validiert die
|
||||
Request-/Response-Schemas aller 113 Operationen; Mutation-Deny, Replay, Lease, Retry, 401/403/404/429/5xx,
|
||||
Capability-Drift, Archivgrenzen und tenant-/projektgebundenes Material-Loading sind abgedeckt. Es wurde keine
|
||||
KWP-Mutation und kein Realprojektimport ausgeführt. **VR-P32c: 9/9 DoD = 100 % done · 0 Punkte offen ·
|
||||
PR-, CI- und Staging-Rollout werden vor dem Plane-Abschluss ergänzt.** `VD-P32` bleibt als nicht
|
||||
Done-blockierender Design-Nachzug offen; `VN-2` besitzt weiterhin allein den kontrollierten
|
||||
Geerkens-Live-E2E.
|
||||
|
||||
**Release-Proof 2026-07-24:** PR `#230` lief auf dem exakten Head
|
||||
`a3f035569e804a85ebc342dab69bf3bfa6e4d17d` mit **11/11 grünen CI-Jobs** durch und wurde ohne Squash als
|
||||
normaler Zwei-Parent-Merge `2626f2c53a162fda49cd0d464d37cb271c16f401` nach `main` übernommen.
|
||||
Deploy-Run `11102` schloss alle 44 Schritte terminal ab: 43 erfolgreich, ein bedingter
|
||||
Production-Migrations-Nachcheck bewusst übersprungen, kein Fehler und kein Rollback. Staging-Web und
|
||||
Staging-API melden auf `/healthz` und `/readyz` jeweils HTTP 200 sowie exakt die Merge-Revision
|
||||
`2626f2c53a162fda49cd0d464d37cb271c16f401`. Es wurde weiterhin keine KWP-Mutation und kein
|
||||
Realprojektimport ausgeführt. Der kontrollierte fachliche Geerkens-Live-E2E verbleibt ausschließlich in
|
||||
`VN-2`. **VR-P32c: 9/9 DoD = 100 % done · 0 Punkte offen.**
|
||||
|
||||
- [ ] Spec/ENTITY-MODEL an reale KWP-API + Davids UI-Entscheidungen angepasst
|
||||
- [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen
|
||||
- [ ] Plane-Ticket `VR-P32c` aktualisiert
|
||||
- [ ] REQUIREMENTS/ROADMAP nachgezogen
|
||||
- [x] Plane-Ticket `VR-P32c` aktualisiert
|
||||
|
||||
**Response-Schema-Recovery-Impact 2026-07-24:** Commit `580279093` ändert ausschließlich die
|
||||
Wiederaufnahme der Projekt-Suche nach einem einmaligen, inzwischen nicht mehr reproduzierbaren
|
||||
Response-Schemafehler. Die 77 Read-Operationen, 36 weiterhin vor HTTP gesperrten Mutationen, fünf
|
||||
Scoped-Capabilities sowie Plantafel-/Termin-, Aktivitäts-/Task-, Material- und Archivpfade bleiben
|
||||
unverändert. Echte semantische Drift und Capability-spezifische Rechtefehler werden nicht automatisch
|
||||
entsperrt. **VR-P32c: 9/9 DoD = 100 % done · 0 Punkte offen.**
|
||||
|
||||
**CR-006 Dependency-Impact 2026-07-24:** Der neue lokale Projektkatalog ergänzt den bestehenden
|
||||
read-only Transport und die Import-Queue, ändert aber weder die 77 ausführbaren Read-Operationen noch die
|
||||
36 vor HTTP gesperrten Mutationen. P32c-Plantafel-, Aktivitäts-, Material- und Archivbindungen bleiben
|
||||
unverändert. Generische Scoped-Operationen behalten ihre vollständige Contract-Validierung; nur der
|
||||
fachliche P32d-Projektimport nutzt eine engere konsumierte Zod-Projektion. **VR-P32c: 9/9 DoD = 100 % done
|
||||
· 0 Punkte offen.**
|
||||
|
||||
**Background-Queue-Impact 2026-07-24:** Commit `f0398f1d9` verschiebt KWP-Projekt-, Katalog-,
|
||||
Contract- und Archivjobs von der absichtlich gegateten Dateiimport-Queue auf die immer konsumierte,
|
||||
dedizierte `hivegrid.kwp-imports`-Queue. Damit erreichen auch die bereits implementierten
|
||||
Plantafel-/Termin-, Aktivitäts-/Task-, Material- und Archivpfade ihren Handler unabhängig vom
|
||||
Dateiimport-Gate. Die 77 Read-Verträge und 36 vor HTTP gesperrten Mutationen bleiben unverändert; alte
|
||||
KWP-Jobs auf der generischen Queue bleiben replaybar. Lokaler Queue-/Worker-Proof und der vollständige
|
||||
Root-Lauf sind grün. Es wurde keine KWP-Mutation und kein Realprojektimport ausgeführt.
|
||||
**VR-P32c: 9/9 DoD = 100 % done · 0 Punkte offen.**
|
||||
|
||||
**Demand-Refresh-Impact 2026-07-31:** Alle 77 ausführbaren Read-Operationen laufen weiter über den
|
||||
bestehenden credential-/Mandanten-/Budget-/Sentinel-geschützten Resource-Adapter. Dieser stellt den
|
||||
Access-Token nun unmittelbar vor dem tatsächlichen Inbound-Fenster sicher, statt KWP im Minutentakt warm zu
|
||||
halten. Plantafel-, Aktivitäts-/Task-, Material- und Archivverträge sowie die harte Sperre aller 36
|
||||
Mutationen bleiben unverändert; parallele Jobs teilen einen durable Refresh-Claim.
|
||||
**VR-P32c: 9/9 DoD = 100 % done · 0 Punkte offen.**
|
||||
|
||||
**Demand-Refresh-Live-Abschluss 2026-08-01:** Der von allen KWP-Read-Operationen konsumierte Connector aus
|
||||
`VR-P32a` bestand nach PR `#312`, Deploy-Run `11609` und normalem OAuth-Reconnect **20/20**
|
||||
Demand-Rotationen und acht gesunde Health-Sweeps. Der technische Staging-Betrieb ist damit wieder aktiv;
|
||||
Adapterinventar, Inbound-Verträge und KWP-Mutationssperre bleiben unverändert.
|
||||
**VR-P32c: 9/9 DoD = 100 % done · 0 Punkte offen.**
|
||||
|
||||
**Shared-Request-Budget-Impact 2026-08-01:** Commit `6e49701df` ändert ausschließlich den bereits von allen
|
||||
77 Read-Operationen konsumierten gemeinsamen Resource-Budget-Gate. Der durable Redis-Topf wird nun über die
|
||||
OAuth-Client-ID über Verbindungen hinweg geteilt und wartet bei lokaler Erschöpfung bis zum Reset, statt
|
||||
einen künstlichen Provider-429 samt Worker-Retry-Sturm zu erzeugen. Das 50-Requests/Minute-Sicherheitslimit,
|
||||
der fail-closed Redis-Pfad, alle Response-Verträge, die fünf Capability-Sentinels und die harte Sperre der
|
||||
36 Mutationen bleiben erhalten. Lokaler Proof: **46/46** fokussierte KWP-/Worker-Tests, **416/416** Tests im
|
||||
Integrationspaket und Root **1.160 Testdateien / 8.183 Tests bestanden / 60 übersprungen**; Typecheck, Lint,
|
||||
CI-Baseline und Source-Health grün. **VR-P32c: 9/9 DoD = 100 % done · 0 Punkte offen · Release-/Staging-Proof offen.**
|
||||
|
||||
**Shared-Request-Budget Release- und Dauer-Proof 2026-08-01:** PR `#317`, CI-Run `11624` mit **11/11 grünen
|
||||
Jobs**, normaler Zwei-Parent-Merge `28b2c0258e3a0bd62f9287c12d117d9a6350f971` und terminal grüner
|
||||
Staging-Deploy `11625` bringen den gemeinsamen Gate auf alle KWP-Read-Pfade. Der erste echte Budget-Stau
|
||||
wartete **45,1 Sekunden** und lief ohne lokalen `rate_limit_exceeded` weiter. Über das zweistündige Fenster
|
||||
von **02:24:48 bis 04:24:47 UTC** wurden mindestens **29** Wait-Ereignisse mit bis zu zwei Wartezyklen und
|
||||
maximal **60,1 Sekunden** beobachtet. Neun Health-Sweeps und neun Maintenance-Zyklen blieben gesund;
|
||||
mindestens **14** Demand-Refreshes waren erfolgreich, ohne Claim-, Provider- oder Persistenzfehler. Die
|
||||
Connection blieb `active`, der Katalog `ready` mit **102 aktiven Einträgen**, alle sechs Capabilities aktiv
|
||||
und null KWP-ErrorReports offen. Achtzehn AppSyncRuns schlossen erfolgreich; kein Sync-Run enthielt einen
|
||||
Rate-Limit-, Auth- oder Providerfehler.
|
||||
|
||||
Getrennt davon erreichte der Archiv-Inbound-Reader bei demselben gebundenen Projekt seine absichtliche
|
||||
20-Verzeichnisse-Grenze: drei Queue-Jobs endeten nach ihren Retries terminal als `KwpInboundLimitError`;
|
||||
die zugehörigen fachlichen Inbound-Runs blieben fehlgeschlagen. Das ist kein Budget-, Token- oder
|
||||
Connectionfehler und erzeugte keinen Reconnect-Status, ist aber ein eigener Live-Scope-Befund für die
|
||||
Archivstrategie. Er wird in diesem Shared-Budget-Hotfix nicht still erweitert. Es wurde keine KWP-Mutation
|
||||
und kein manueller Realprojektimport ausgelöst.
|
||||
**VR-P32c: 9/9 DoD = 100 % done · 0 Punkte offen.**
|
||||
|
||||
**CR-013 Resilienz-Impact 2026-08-01:** Der ausdrücklich freigegebene Nachzug in PR `#332` entkoppelt
|
||||
Termine, Aufgaben und Material voneinander sowie vollständig vom Archiv. Die Archiv-Discovery wird über
|
||||
replaybare Fünf-Ordner-Batches fortgesetzt; Datei-Exporte erhalten einen sechs Stunden breiten Cooldown und
|
||||
temporäre Providerfehler erzeugen keine Reconnect-Aufforderung. Der Scope bleibt ausschließlich
|
||||
KWP→HiveGrid und ergänzt keine Mutation. Bis PR-Merge, Staging-Deploy und kontrolliertem Live-Proof wird
|
||||
hier kein neuer Abschluss behauptet. **VR-P32c bleibt 9/9 DoD = 100 % done.**
|
||||
|
||||
**CR-013 Staging-Nachzug 2026-08-01:** PR `#332` lief in CI mit **11/11 grünen Jobs**, wurde als normaler
|
||||
Merge `1a3c336288d7d7ec06db4dfe07c3514f7db4e9a5` übernommen und über Deploy-Run `11688` erfolgreich auf
|
||||
Staging ausgerollt. Der erste automatische read-only Lauf belegte die neue Entkopplung: Die vier im ersten
|
||||
Fünf-Ordner-Batch gefundenen Archivdatei-Jobs erhielten jeweils maximal drei Versuche mit exponentiellem
|
||||
60-Sekunden-Backoff; die
|
||||
Provider-HTTP-500 blieben auf diese Jobs begrenzt und erzeugten keinen Reconnect-Status. Dabei zeigte sich,
|
||||
dass KWP für Standardordner auch negative Integer-IDs liefert. Die erste Cursor-Validierung wies diese
|
||||
gültigen Provider-IDs noch ab. Der Folgefix akzeptiert deshalb sichere vorzeichenbehaftete Integer-IDs,
|
||||
behält das 1.000-Ordner-Limit und alle Cursorgrenzen bei und ist lokal mit **70/70** fokussierten
|
||||
Queue-/Inbound-Tests belegt. Bis zum separaten Merge und erneuten Staging-Lauf bleibt der Nachzug offen;
|
||||
die bereits erfüllte Implementierungs-DoD ändert sich nicht. **VR-P32c: 9/9 DoD = 100 % done.**
|
||||
|
||||
**CR-013 Cursor-Live-Abschluss 2026-08-01:** Der Folgefix lief auf PR `#333` in CI-Run `11694` mit
|
||||
**11/11 grünen Jobs**, wurde als normaler Zwei-Parent-Merge
|
||||
`ad1be1e615300a8092d2de9bb8f87220a079822d` übernommen und über Deploy-Run `11695` vollständig erfolgreich
|
||||
auf Staging ausgerollt. Alle fünf Worker-Gruppen liefen gesund auf dieser Revision. Für den Proof wurde
|
||||
ausschließlich der exakt fehlgeschlagene Discovery-Job desselben Sechs-Stunden-Buckets replayt; es wurde
|
||||
kein neuer Bucket erzeugt und kein Datei-Cooldown umgangen.
|
||||
|
||||
Der reale 35-Ordner-Bestand lief danach in **7/7** Fünf-Ordner-Batches (`0` bis `6`) vollständig auf
|
||||
`completed`. Es gab **0** Discovery-Fehler, **0** `KwpInboundLimitError`, **0** Cursor-Validierungsfehler und
|
||||
**0** Authfehler. Drei gemeinsame Budget-Waits begrenzten die Providerlast; zwei Demand-Refreshes waren
|
||||
erfolgreich. Die vier bereits bekannten Datei-Jobs blieben unverändert terminal bei **3/3** Versuchen und
|
||||
wurden durch den Replay nicht erneut gestartet. Die Connection blieb `active` mit gesundem Health-Key,
|
||||
**0 offenen KWP-ErrorReports** und ausschließlich erfolgreichen Sync-Runs im abschließenden
|
||||
15-Minuten-Fenster. Es wurde keine KWP-Mutation ausgeführt. **VR-P32c: 9/9 DoD = 100 % done · 0 Punkte
|
||||
offen.**
|
||||
Reference in new issue
Block a user