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-6geparkt 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 zuVN-2und 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;
unconfirmedblockiert fachliche Calls fail-closed.KWP_MANDANTist keine processweite Consumer-Konfiguration. Der vorprovisionierte Geerkens-Pilot bleibt aufKWP_HIVEGRID_TENANT_IDbegrenzt; 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-1ist 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-1undVN-2sind 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-externoderaktivitaet-externerreichbaren 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
mandantBindingaus den verschlüsselten Credentials der konkretenDataConnection. Beiselectedwird das Kürzel an jeden KWP-Request gehängt, bei bestätigtemnonebewusst nicht;unconfirmeddarf 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,PublishundResetbleiben 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 überVN-1.
Quellen (granular)
ROADMAP-V2.md→ §v2-P5 (Success-Criteria 5; kontrollierter Live-E2E separat inVN-2) — HauptquelleROADMAP.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-P32caktualisiert
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.