# 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.**