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

26 KiB

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

  • 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
  • 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
  • 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
  • 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
  • Plantafel-/Termin-Inbound-Sync KWP → HiveGrid per Cron-Pull; keine KWP-Mutation und keine angenommenen Webhooks
  • Dokumenten-Archiv-Sync KWP → @hivegrid/storage (FileEntityLink an Auftrag/Projekt)
  • Task-/ERP-Inbound-Sync (M074) KWP → HiveGrid, idempotent über AppSyncItem
  • 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
  • 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
  • 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.