Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/VR-P32c.md
T

330 lines
26 KiB
Markdown

# 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 |
| **Status** | abgeschlossen · **9/9 DoD = 100 % done** · normal gemergt und auf Staging verifiziert |
> 🟢 **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)
- **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 **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 |
|---|---|
| (nutzt die Screens aus VR-P32a/b) | Sync-Log [`/integrations/kwp/log`] zeigt zusätzlich Plantafel-/Doku-/Task-Sync-Items; Doku im Auftrag-/Projekt-Detail aus dem Archiv sichtbar |
*(Keine neuen eigenständigen Screens — Plantafel/Doku/Tasks erscheinen in den bestehenden Auftrag-/Projekt-/Task-Views aus v1.)*
## Definition of Done
- [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-/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`:** 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; kontrollierter Live-E2E separat in `VN-2`) — **Hauptquelle**
- `ROADMAP.md` → Phase 32
- **`.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)
## 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/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.**