32 KiB
VR-P32d · KWP-Inbound Projekt-Upsert + Pipeline-Routing
| Typ | Dev (Code) |
| Owner | Raffael |
| Phase | v2-P5 — KWP-Integration |
| Cycle/Fenster | v2-W2 · 2026-07-24 → 2026-07-26 |
| Status | Done · 14/14 DoD = 100 % done · Design-Nachzug offen |
🎨 design-nachzug: offen (seit 2026-07-23) — Interim-UI aus ~/ui wird im gemeinsamen
P32b/P32d-PR gebaut; finale Subframe-Optik aus VD-P32 bleibt ausstehend.
🟢 CR-004 Scope-Entscheidung 2026-07-23: Wegen fehlender garantierter Pagination behauptet dieses Ticket keinen KWP-Vollimport. Es liefert einen gezielten, wiederholbaren User-Flow: Projekt suchen → Details laden → Status-Routing festlegen → neues HiveGrid-Projekt anlegen oder ein sichtbares bestehendes verknüpfen → Projekt-/Rechnungs-/Bauherradresse verbinden → optional je Rolle einen primären Ansprechpartner wählen → dauerhaft read-only synchronisieren. P32b und P32d werden in einem PR geliefert, intern weiterhin strikt P32b vor P32d.
🟢 CR-006 Scope-Entscheidung 2026-07-24: Eine bestätigte Verbindung baut automatisch einen lokalen, tenant-/connectiongebundenen KWP-Projektkatalog auf. Discovery verwendet ausschließlich den laut Tenant-OpenAPI einstellungsabhängigen Platzhalterbestand aus
LoadProjekteNachFilter; gezielte Suchen ergänzen denselben Katalog read-through. Ohne Provider-Pagination wird kein darüber hinausgehender Vollbestand behauptet. Der Import validiert ausschließlich seine konsumierte Response-Projektion, damit ungenutzte Nullable-Abweichungen keinen falschen Capability-Stopp auslösen.
🟢 Superseding Scope-Entscheidung 2026-07-22: Dieses Ticket bleibt ausschließlich KWP→HiveGrid. Es liest KWP-Projekte und mutiert nur den tenant-gebundenen HiveGrid-Projektkern; es sendet keine fachliche Mutation an KWP. Project-/Auftrag-Create, Writeback und M091 sind in
VEXT-6geparkt und blockieren das Inbound-Ticket nicht. Historische Notizen zum früheren Outbound-Gegenpfad bleiben als Entscheidungsprotokoll erhalten.
Abhängigkeiten & Parallelität
- Blocked by:
VR-P32b. Im gemeinsamen CR-004-PR wird P32b intern zuerst vollständig umgesetzt und verifiziert.VEXT-1ist seit dem stabilen Refresh-Dauer-Proof vom 2026-07-22 4/4 Done. - Erfüllte Voraussetzungen:
R-P20bliefert die stabilen Pipeline-/Stage-IDs;R-P12cliefert den produktiven Inbound-Event-/Executor-Unterbau. Beide sind umgesetzt und keine offenen Blocker. - Lokaler Verifikationsvertrag: Schema-valide KWP-Fixtures und tenant-/RLS-gebundene Integrationstests
belegen Mapping, Reconciliation, Replay, Quarantäne und Konfliktpfade.
VN-1/VN-2sind keine Implementierungs-Blocker;VN-2besitzt exklusiv den späteren Live-Geerkens-E2E. - Blocks:
VN-2als nachgelagerter Live-Proof - Abgrenzung:
VR-P32aliefert ausschließlich Connector/Health/Mandantenbindung; dieses Ticket besitzt den fachlichen read-only KWP→HiveGrid-Projektimport. Ein späterer Outbound-Vertrag wird separat überVEXT-6neu geschnitten. - Dependency-Stand 2026-07-22:
R-P20bliefert die stabile Drei-Pipeline-/Fünf-Stage-Baseline und den inaktiven Metadaten-Keyshk.kwp-project-routing.v1;R-P12cist 7/7 umgesetzt. Der Bootstrap selbst führt weiterhin keine KWP-Automation aus. - Runtime-Dependency-Stand 2026-07-21: Der echte Staging-Erst-Proof umfasste OAuth, einen geschützten
read-only Core-Aufruf und mehrere Refresh-Rotationen; ein späterer Refresh setzte die Connection jedoch auf
broken, daher bleibtVEXT-1für Dauerbetrieb offen. Der Pilot enthielt keinen Projekt-Pull oder -Write. KWP hat außerdem ausdrücklich bestätigt, dass es weder Delta-Cursor noch „geändert seit“-Filter gibt. Die Implementierung muss deshalb eine konservative cursorlose Reconciliation aus dem real dokumentierten Endpoint- und Pagination-Vertrag ableiten. CR-003/AD-32 legen dafür keine konkrete Vollabzug-, Partitionierungs- oder lokale Cursorstrategie fest; eine providerseitige Delta-Semantik wird nicht erfunden.
Was wir bauen
KWP-Projekte werden über den freigegebenen read-only Polling-Vertrag idempotent in den typisierten
Projekt-Kern übernommen und anhand einer expliziten stabilen Mapping-Konfiguration geroutet. Der User sucht
gezielt ab zwei Zeichen, prüft den Detail-Diff und entscheidet zwischen Neuanlage und Verknüpfung. Die lokale
HiveGrid-Projektnummer bleibt unverändert; KWP-projNr wird als externe Referenz gespeichert und in der
normalen HiveGrid-Suche auffindbar.
Projekt-, Rechnungs- und Bauherradresse werden je Rolle explizit mit einem vorhandenen CRM-Kontakt verbunden oder bewusst neu angelegt. Vorhandene External-Bindings gewinnen; danach sind nur Vorschläge über exakt normalisierte E-Mail oder exakten Namen plus Anschrift erlaubt. Es gibt kein automatisches Fuzzy-Merge und keine ungefragte Massenübernahme von Ansprechpartnern. Fehlende oder mehrdeutige Status-Mappings landen in Quarantäne; HiveGrid rät keine Pipeline oder Stage und mutiert KWP nicht.
Definition of Done
- Gezielte Suche:
Projekt/Searchund Projektdetails sind schema-validiert; Suchbegriffe unter zwei Zeichen werden abgewiesen und kein Vollimport behauptet - Create/Link: neues HiveGrid-Projekt oder explizites Linken eines sichtbaren bestehenden Projekts nach Diff; lokale Projektnummer bleibt unverändert
- Adressen: Projekt-, Rechnungs- und Bauherrrolle können jeweils vorhandene CRM-Daten wählen oder bewusst dedupliziert neu anlegen
- Ansprechpartner: pro Rolle höchstens eine ausgewählte Person; keine automatische Massenübernahme
- Dauerhaftes Mapping: connectiongebundene eindeutige
AppEntityBindings bleiben über Runs und Reconnects stabil;AppSyncItembleibt Laufhistorie - Status-Routing: jeder auftretende KWP-Status verwendet gespeicherte stabile Pipeline-/Stage-IDs; unbekannte Statuswerte oder archivierte Ziele quarantänisieren
- Ownership/Unlink: KWP-eigene Felder sind serverseitig gegen lokale Änderung, Stage-Move, Archivierung und Binding-Übernahme beim Duplizieren geschützt; Trennen behält lokale Projekt-/CRM-Daten
- Drei-Phasen-Sync: Provider-I/O läuft außerhalb langer DB-Transaktionen; lokaler Projekt-/CRM-Upsert, Binding, Audit, Activity, Search und Outbox werden atomar geschrieben
- Betriebssicherheit: gemeinsames Rate-Budget, Lease, Replay, Retry und Quarantäne verhindern Dopplungen und behandeln 429/401/403/404/5xx ohne lokale Teilmutation
- UI und Querschnitt: Interim-UI, Suche nach KWP-Nummer, Audit, Activity, i18n, Error-/Empty-/Loading-State und Permission-404-Gates sind mit VM-Unit, Smoke, Hot-Swap, Visual und Forced-RLS-Test belegt
- Semantische Response-Projektion: Search, Projekt- und Adressdetails pausieren nur bei ungültigen konsumierten Feldern; ungenutzte OpenAPI-Felder mit abweichender Nullable-Semantik werden redigiert ignoriert und ein unveränderter Vertrag kann revisionssicher wieder aktiviert werden
- Automatischer Projektkatalog: aktive bestätigte Connections erhalten ohne User-Suchaktion einen lease-/replay-sicheren Discovery-/Refresh-Lauf über die Import-Queue; große Bestände werden in begrenzten Batches unter dem gemeinsamen Rate-Budget verarbeitet
- Skalierbare Cache-Suche: schema-valide Live-Treffer und Discovery-Platzhalter werden dauerhaft tenant-/connectiongebunden gespeichert; die Suche arbeitet cache-first über einen trigram-indizierten normalisierten Suchtext und ergänzt kontrolliert live, ohne leere Provider-Suche
- Katalog- und UI-Recovery: Import-VM und Interim-UI zeigen Katalogstatus/Alter/Fortschritt, Search-/Select-/Button-Layout überlappt nicht, Error-/Loading-/Empty-State und Forced-RLS-/Visual-Proof decken den neuen Flow ab
Technische Bausteine
- Transport: zentraler serverseitiger Resource-Client in
packages/integrations/src/kwp/**mitsearchProjects({ connectionId, query }),loadProjectDetails({ connectionId, projectNumber })undloadAddressDetails({ connectionId, addressCode }). Er injiziert Access-Token und bestätigten Mandanten, blockiertunconfirmed, validiert jede Response mit Zod und erlaubt ausschließlichPOST /api/Projekt/Search,GET /api/Projektampel/LoadProjektDetails,GET /api/Adresse/LoadAdressKomplettsowie Tenant-OpenAPI für den Sentinel. - Schreibschutz KWP:
Projekt/Save,Adresse/Save*,Adresse/Add*und alle anderen fachlichen KWP-Schreiboperationen werden vom Allowlist-Client abgewiesen. Resource-Calls führen keine eigene Refresh-Token-Anforderung aus; der dauerhafte zentrale Refresh-/Health-Pfad bleibt alleiniger Besitzer der Rotation. - Persistenz: providerneutrales
AppEntityBindinginappsEngine.prisma; KWP-spezifischKwpApiContractSnapshot,KwpCapabilityState,KwpErrorReportundKwpProjectRoutinginkwp.prisma. Alle Tabellen sind tenant-scoped, RLS-gebunden und in der Tenant-Registry eingetragen. - Feld-Ownership: KWP besitzt Projektname, KWP-Status und daraus abgeleitete Pipeline/Stage, Beginn, Auftragswert, externe Projektnummer sowie gebundene KWP-Adressen/-Kontaktdaten. Vor jeder Überschreibung wird der alte lokale Stand im Binding gesichert. IBAN, Bank, Kreditlimit, Steuerdaten, Geburtstag, interne KWP-Hinweise und Benutzerfelder werden nicht gespeichert.
- CRM-Matching: External-Binding zuerst; danach nur exakte normalisierte E-Mail oder exakter Name plus Anschrift. Derselbe KWP-Adresscode wird nur einmal angelegt. Architektenadresse und weitere Ansprechpartner sind außerhalb dieses Slices.
- Permissions: Ansicht/Suche
integrations.read; Erstellen/Verknüpfen/Mapping/Trennen zusätzlichintegrations.connectundprojects.write. Bestehende Projekte bleiben durch normale Projektsichtbarkeit geschützt. Fehlende Berechtigung liefert 404. - Scheduler: Projekte alle 15 Minuten, gebundene Adressen alle 60 Minuten oder sofort bei geändertem Adresscode, Sentinel täglich und beim ersten Lauf einer neuen Revision. Maintenance plant; die vorhandene Import-Queue führt aus.
- Seiteneffekte: Erstimport schreibt Search, Audit und Activity, aber kein Workflow-Event. Spätere
KWP-Stage-Änderungen veröffentlichen
project.stage_changedmitsource=kwp; reine Name-/Wert-/ Adressänderungen schreiben nur Audit, Activity und Search. - Fehlerregeln: 429 jobweiter Backoff mit Jitter; 401 wartet auf zentralen Refresh/Health-Pfad; 403
pausiert nur die Projekt-Capability; 404/fehlender Treffer markiert
missing; unbekannter Status oder ungültiges Routing quarantänisiert; Schemafehler pausiert wegen Contract-Drift; Netzwerk/5xx retryt ohne lokale Teilmutation.
Quellen
.planning/ticket-docs/VR-P32a.md,VR-P32b.md,VR-P32c.md,R-P20b.md,R-P12c.md,VN-2.md.planning/KWP-API-CONTRACT.mddocs/ARCHITECTURE-DECISIONS.md→ AD-1, AD-20, AD-21
Umsetzungs-Notiz
Historischer Stand vor dem Scope-Recut: VR-P32d war 0/7 und durch VR-P32b, R-P20b, R-P12c,
VN-1 sowie den widersprüchlichen Delta-Cursor-Vertrag blockiert.
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 wurde als Runtime-Blocker entfernt.
Da sämtliche sieben DoD-Punkte zu diesem Zeitpunkt weiterhin von VR-P32b, R-P12c, VN-1 oder der
offenen Delta-Scope-Entscheidung abhingen, blieb
VR-P32d: 0/7 DoD = 0 % done · 7 Punkte offen, davon 7 blockiert · 0 selbst machbar.
Superseding Scope-Impact 2026-07-22: Der fehlende KWP-Create-/Write-Vertrag ist kein Blocker mehr, weil
VR-P32d ausschließlich read-only importiert. VEXT-6 hält diese externe Zukunftscapability getrennt nach.
R-P20b und R-P12c sind erfüllt; die Grenze ohne erfundene Delta-, Cursor- oder Webhook-Semantik ist oben
festgelegt. Offen bleiben der
vorgelagerte Schutz-/Konflikt-Slice VR-P32b und die eigentliche Implementierung. Der konkrete
Reconciliation-Mechanismus wird erst aus dem realen Endpoint-/Pagination-Vertrag abgeleitet; CR-003/AD-32
erfinden keinen Cursorersatz. Lokale schema-valide Fixtures und Integrationstests schließen die sieben
Implementierungs-DoD; VN-1/VN-2 folgen ausschließlich als nachgelagerter Live-Proof. Nach der
ticketgebundenen Reihenfolge beginnt VR-P32d erst nach VR-P32b. VR-P32d: 0/7 DoD = 0 % done · 7 Punkte
offen · Start wartet auf VR-P32b · kein externer Live-Proof blockiert die Implementierung.
CR-004 Scope-/Dependency-Impact 2026-07-23: Die sieben alten DoD werden durch zehn überprüfbare Import-DoD ersetzt. Der gemeinsame PR liefert P32b zuerst und P32d danach; P32c konsumiert später denselben providerneutralen Binding-/Sentinel-Unterbau, ohne dass Plantafel-, Doku-, Task- oder Material-Scope vorgezogen wird. VN-2 bleibt exklusiver Live-Geerkens-Proof. VD-P32 bleibt offener Design-Nachzug; die Interim-UI ist nach AD-28 Done-fähig. VR-P32d: 0/10 DoD = 0 % done · 10 Punkte offen · Start intern nach VR-P32b · kein externer Live-Proof blockiert die Implementierung.
Interim-UI (umgesetzt 2026-07-23): Der Import-Wizard unter
/{tenant}/settings/integrations/kwp/import ist aus ~/ui mit View-Model als Prop gebaut. VM-/Route-,
Permission-404-, Smoke-Manifest-, Hot-Swap- und Interim-Visual-Proof sind grün. Refactor-Nachzug offen:
finale Subframe-Optik aus VD-P32 (Plane-Label design-nachzug).
Implementierungsnachweis 2026-07-23: Scope-Recut d39a2d926, persistenter Transport-/Domain-/Sync-Slice
5e5442923 und User-/Admin-Flow 9a13edcfc. Die exakte Read-Allowlist akzeptiert ausschließlich
Projekt-Suche, Projekt-/Adressdetails und das Sentinel-OpenAPI; sie blockiert unbestätigte Mandanten und alle
KWP-Mutationen. Create/Link erhält die lokale Projektnummer, dedupliziert die drei CRM-Rollen ohne Fuzzy-Merge
und speichert je Rolle höchstens einen ausgewählten Ansprechpartner. Status-Routing, durable
External↔Local-Bindings, serverseitige Ownership-Gates, Unlink/Restore, Drei-Phasen-Sync, gemeinsames
Redis-Budget, Queue-Leases, Replay/Retry und Quarantäne sind fixture- und RLS-validiert. Erstimport erzeugt
kein Workflow-Event; spätere Stage-Wechsel nutzen project.stage_changed mit source=kwp. Proof: Root-Testlauf
1.028 Dateien / 7.384 Tests bestanden, 55 übersprungen, test:packages einschließlich 286
Integrations-Tests, i18n/Tenant-Policy/Forced-RLS/strikter Live-RLS-Migrationskettenlauf, Migration-Parity,
CI-Baseline, Source-Health, Coverage, Hot-Swap, Interim-Visual-Snapshot und Produktions-Build grün.
VR-P32d: 10/10 DoD = 100 % done · 0 Punkte offen.
OpenAPI-Größenlimit-Hotfix 2026-07-24: PR #227 wurde nach 11/11 grünen CI-Jobs normal, ohne
Squash, als Main-Merge 46782ddd79678116639713d5359d8e874fdf3f7b übernommen; Staging-Deploy 11091
war vollständig grün. Der danach ausgeführte read-only Smoke importierte kein Projekt, fand aber vor der
eigentlichen Suche einen separaten Sentinel-Fehlalarm: Das gültige Tenant-OpenAPI umfasst
2.062.387 Byte und überschritt das gemeinsame 1-MiB-Limit. HTTP 200, valides JSON, alle drei
konsumierten Operationen sowie sämtliche konsumierten Schemas/Felder wurden redigiert bestätigt.
Adapterrevision kwp-project-v3 verwendet nun für OpenAPI ein hartes 8-MiB-Limit, während Search, Details
und Address weiterhin bei 1 MiB fail-closed bleiben. Commit ebdd48678; lokaler Proof: 31/31
fokussierte Tests, Integrationspaket 295/295, Root 1.028 Dateien / 7.392 Tests bestanden,
55 übersprungen, Typecheck, Lint, i18n/RLS/CI/Hot-Swap und Produktions-Build grün. Follow-up-PR #228
lief in CI-Run 11093 mit 11/11 Jobs grün und wurde ohne Squash als normaler Merge
f5da0bbe22e413abb0bdfbe4b3917e4035afcae5 übernommen. Staging-Deploy 11094 war mit 44/44 grünen
Schritten erfolgreich; Web und API meldeten öffentlich exakt diese Revision als healthy und ready. Der
read-only Live-Smoke bestätigte eine aktive KWP-Verbindung, kwp-project-v3, übereinstimmende genehmigte
Fingerprints und 0 offene Fehlerberichte. Suche lieferte Treffer; gewählte Projektdetails und eine
referenzierte Adresse wurden schema-validiert. Es wurde kein Projekt importiert und keine KWP-
Schreiboperation ausgeführt. Create/Link, CRM-Bindung, Routing, Ownership und Read-only-Grenzen ändern sich
nicht. VR-P32d: 10/10 DoD = 100 % done · 0 Punkte offen.
Abschlussnachweis 2026-07-23: PR #222 lief in CI-Run 11077 mit 11/11 Jobs grün; der
bytegleiche History-Repair PR #223 lief in CI-Run 11080 ebenfalls mit 11/11 Jobs grün und wurde
ausdrücklich per normalem Merge, nicht per Squash, auf Main
28db89b1afa21dda8c76278283294450cbc2817f übernommen. Damit sind die sechs ursprünglichen
Implementierungscommits d39a2d926, 5e5442923, 9a13edcfc, 527e17ea7, e80040c1e und
bf89c1262 Vorfahren von Main. Der Dateibaum blieb unverändert. Staging-Deploy 11078 einschließlich
Migration 20260723132500_kwp_project_inbound, Live-Schema-Prüfung und Runtime-Health war grün; die
Main-Automation 11081 nach dem History-Repair war ebenfalls grün. Der Live-Contract-Smoke validierte
Project Search, Project Details und Address Details ohne Projektimport. Plane wurde als Raffael kommentiert
und auf Done gesetzt. design-nachzug bleibt offen; kontrollierter Reconnect, credential-geschützte
read-only Live-Suche und Live-Geerkens-E2E bleiben in VN-2.
Connector-Regression-Impact 2026-07-23: Suche, Create/Link, CRM-Bindung, Routing, Ownership,
Drei-Phasen-Sync und UI bleiben implementiert und 10/10 = 100 % done. Der echte credential-geschützte
Staging-Test kann erst nach dem VR-P32a-Fix und einem normalen OAuth-Reconnect fortgesetzt werden. Der Fix
ändert weder Projektimport-Scope noch KWP-Read-only-Grenze. Der lokale Connector-Fix liegt in ccdc74ebe;
sein Staging-Live-Proof bleibt ausschließlich in VR-P32a/VEXT-1.
Projekt-Suche-Hotfix 2026-07-23: Der erste echte Search-Aufruf auf Staging lieferte HTTP 200 und
gültige Treffer, ließ aber gemäß Tenant-OpenAPI optionale Felder wie archAdr, beginn, sachBearb,
vertrieb, einzelne Ortsfelder und rechnungsmailadresse weg. Die bisherige Zod-Grenze wertete dieses
zulässige Weglassen fälschlich als contract_drift, pausierte dadurch die Projekt-Capability und ließ die
Route vor dem Capability-Banner in den generischen 500er laufen. Adapterrevision kwp-project-v2
normalisiert fehlende konsumierte Felder auf null, ignoriert Architekt und weitere nicht konsumierte
Felder weiterhin vollständig und behält die strikte Typ-, Größen-, Allowlist- und Read-only-Grenze bei.
Die Route rendert Capability-Fehler nun als Klartextzustand; einen uninitialisierten Alt-Fehlalarm
revalidiert der Sentinel und wiederholt die Suche genau einmal. Netzwerk-/5xx-Fehler werden dabei nicht
verschluckt. Implementierungs-Commit 949f7da46. Lokaler Proof: echte redigierte Shape-Diagnose gegen
Search, Details und Adresse ohne Projektimport, fokussierter KWP-/Route-Satz 29/29, test:packages
einschließlich 293/293 Integrations-Tests, Root-Testlauf 1.028 Dateien / 7.389 Tests bestanden,
55 übersprungen, Typecheck, Lint, Coverage, Hot-Swap und Produktions-Build grün. Alle Importgrenzen
bleiben unverändert.
VR-P32d: 10/10 DoD = 100 % done · 0 Punkte offen.
Response-Schema-Recovery-Hotfix 2026-07-24: Eine spätere Staging-Suche traf auf einen persistenten
Pause-Zustand, obwohl genehmigter und beobachteter semantischer Fingerprint identisch waren und die
aktuelle Search-Response den Adapter kwp-project-v4 validierte. Commit 580279093 lässt die
Import-Route bei einem unveränderten Sentinel genau diese Read-Anfrage einmal durch den pausierten Adapter
revalidieren. Die Entsperrung erfolgt nur mit gleichem Fingerprint, aktuellem Adapter, Schema-Fehlergrund
und Revisions-Guard; echte Drift, fehlende KWP-Rechte, ungültige Responses und Parallelkonflikte bleiben
pausiert. Der Flow schreibt ausschließlich Capability-State, Fehlerauflösung und Audit, niemals in KWP.
Create/Link, CRM-Bindung, Routing, Ownership und die Importgrenzen bleiben unverändert. Lokaler Proof:
59/59 fokussierte Tests, Root 1.029 Dateien / 7.395 Tests bestanden, 55 übersprungen, Typecheck,
Lint und EU-Import-Guard grün. Es wurde kein Realprojekt importiert.
VR-P32d: 10/10 DoD = 100 % done · 0 Punkte offen.
Suchstatus-Optionalität-Hotfix 2026-07-24: Der echte read-only Staging-Search lieferte 28
OpenAPI-valide Treffer; genau ein Treffer enthielt keinen auftragStatus. Commit 85c73a9af bildet diese
zulässige Optionalität im Resource-Adapter ab und filtert den nicht routbaren Treffer aus der
Importauswahl, statt einen Status zu erfinden oder die gesamte Capability zu pausieren. Routbare Treffer
bleiben suchbar; ein vorhandener Wert außerhalb des konsumierten KWP-Enums löst weiterhin
contract_drift aus. Proof: 36/36 fokussierte KWP-/Route-Tests, Integrationspaket 323/323,
Root-Testlauf 1.029 Dateien / 7.395 Tests bestanden, 55 übersprungen, Typecheck, Lint,
Prisma-/RLS-/Migration-/i18n-/Coverage-/Hot-Swap-Gates und Produktions-Build grün. Kein Realprojekt wurde
importiert und keine Provider-Mutation ausgeführt. Create/Link, CRM-Bindung, Routing und Ownership bleiben
unverändert. VR-P32d: 10/10 DoD = 100 % done · 0 Punkte offen.
CR-006 Scope-/Dependency-Impact 2026-07-24: Der echte redigierte Staging-Proof hat Projekt-Suche und
Details mit HTTP 200 validiert. Die Adressresponse erfüllt alle von HiveGrid konsumierten Felder, weicht
aber in fünf ungenutzten Nullable-Feldern von der Tenant-OpenAPI ab. Deshalb ersetzt eine enge
Zod-Projektion die falsche Vollobjekt-Pause im Importpfad. Der neue Katalog verwendet
LoadProjekteNachFilter ausschließlich als einstellungsabhängige Discovery, reichert asynchron an und
ergänzt sich durch jede gezielte Suche. Vier neue DoD sind offen; die zehn bereits abgenommenen
Import-/Ownership-/Sync-DoD bleiben erfüllt. VR-P32d: 10/14 DoD = ~71 % done · 4 Punkte selbst machbar ·
In Progress.
CR-006 Implementierungsnachweis 2026-07-24: Die konsumierten Search-, Projekt- und
Adressprojektionen ignorieren ungenutzte Nullable-Abweichungen und halten tatsächlich konsumierte Typen
weiterhin fail-closed; Adapterrevision kwp-project-v5 kann einen gleich gebliebenen Vertrag
revisionssicher entsperren. KwpProjectCatalogState und KwpProjectCatalogItem speichern ausschließlich
normalisierte, erlaubte Projektfelder tenant-/connectiongebunden unter erzwungenem RLS. Die
Maintenance-Planung startet aktive Verbindungen automatisch, die Import-Queue hydratisiert höchstens 20
Projekte pro Lauf unter dem gemeinsamen 50-Requests/Minute-Budget und setzt große Bestände per verzögerter
Continuation fort. Die Import-Suche arbeitet cache-first über den trigram-indizierten Suchtext und ergänzt
gezielt read-through, ohne Search(""); der Screen zeigt Katalogstatus und Fortschritt ohne überlappende
Controls. Atomare Commits: 5a95c2363, 4aed86dff, 61d3b0a2c, b304bb4b0, a65de8685,
40d6be07c, 8e564dc91, 437fd4422. Lokaler Proof: Root 1.029 Dateien / 7.404 Tests bestanden,
55 übersprungen, Integrationspaket 328/328, Queue 131/131, Worker-Einstieg 65/65,
View-Models 586/586, KWP-Route-/Visualtests, Typecheck, Lint, i18n, Tenant-Policy 301/301,
RLS-Readiness 299/299 Modelle und 254/254 Policies, Migration-Parity, CI-Baseline, Source-Health,
Coverage, Hot-Swap und Produktions-Build grün. prisma migrate status war lokal nur wegen des nicht
laufenden wegwerfbaren PostgreSQL-Dienstes auf Port 5434 nicht erreichbar; Schema-Validierung und die
reproduzierbare Migrations-Parität sind grün. Es wurde kein Realprojekt importiert und keine
KWP-Schreiboperation ausgeführt. VD-P32 bleibt als design-nachzug offen; VN-2 bleibt der kontrollierte
Live-Geerkens-E2E. VR-P32d: 14/14 DoD = 100 % done · 0 Punkte offen.
Details-Interaktions-Hotfix 2026-07-24: Die redigierte Staging-Diagnose bestätigte eine aktive
Projekt-Capability auf Adapterrevision kwp-project-v5, ausschließlich gelöste ältere Drift-Reports und
erfolgreich zwischengespeicherte Projektdetails. Der Klick erreichte damit bereits den read-only
Detailpfad; die Vorschau wurde jedoch ohne unmittelbaren Ladezustand unter der vollständigen Trefferliste
gerendert und wirkte dadurch wie eine wirkungslose Aktion. Commit 7a59116e1 zeigt den gewählten Treffer
sofort als „Details werden geladen“, verhindert parallele Auswahlaktionen und scrollt erst nach der
erfolgreichen Antwort zur eindeutig markierten Vorschau. Der neue Interaktionstest deckt Aktion,
Zwischenzustand und Scroll-Ziel ab; der Interim-Visual-Snapshot wurde nachgezogen. Proof: 12/12
betroffene KWP-Tests, Root 1.030 Dateien / 7.405 Tests bestanden, 55 übersprungen, Typecheck, Lint,
i18n, CI-Baseline, Source-Health, Coverage, Hot-Swap und Produktions-Build grün. Es wurde kein
Realprojekt importiert und keine KWP-Schreiboperation ausgeführt. VD-P32 bleibt als
design-nachzug offen; VN-2 bleibt der kontrollierte Live-Geerkens-E2E.
VR-P32d: 14/14 DoD = 100 % done · 0 Punkte offen.
Background-Queue-Hotfix 2026-07-24: Die Post-Deploy-Kontrolle fand trotz 48 durch gezielte
Suchen gespeicherter Katalogeinträge noch keinen automatischen KwpProjectCatalogState. Der
Maintenance-Scheduler plante KWP-Jobs korrekt, aber der Staging-Import-Worker konsumierte im aktiven
Portal-/GDPR-Modus ausschließlich hivegrid.exports; die gemeinsam verwendete generische
hivegrid.imports-Queue blieb absichtlich gegatet. Commit f0398f1d9 isoliert deshalb alle
KWP-Projekt-, Katalog-, Contract- und Archivjobs auf hivegrid.kwp-imports. Der Import-Worker besitzt
diese Queue in jedem gültigen Gate-Modus; generische Dateiimporte und Exporte bleiben unabhängig
fail-closed. Vor dem Rollout erzeugte KWP-Jobs auf der alten Queue bleiben replaybar. Startup prüft alle
KWP-Services fail-closed. Lokaler Proof: fokussierte Queue-/Worker-Suite 390/390, Root-Testlauf
1.030 Dateien / 7.409 Tests bestanden, 55 übersprungen, Paket-Tests, Typecheck, Lint,
Import-Boundary, CI-Baseline 35/35, Source-Health und Produktions-Build grün. Es wurde kein
Realprojekt importiert und keine KWP-Schreiboperation ausgeführt. VR-P32d: 14/14 DoD = 100 %
implementiert · Release-Proof offen · Plane bleibt bis grüner CI und Staging-Autosync in Progress.
Background-Queue Release-Proof 2026-07-24: Die drei atomaren Commits f0398f1d9,
9e55ff754 und d24e8c6e6 liefen in PR #242 auf dem exakten Head
d24e8c6e65293fdacff2e68e547d5146e46b732b durch CI-Run 11148 mit 11/11 grünen Jobs.
Der PR wurde ausdrücklich ohne Squash als normaler Zwei-Parent-Merge
ab0e84f0160dc6471e6a4ca3e6c4089d811a99cc nach main übernommen. Deploy-Run 11149
schloss für exakt diese Revision terminal grün ab; Staging-Migration, alle Kern- und abhängigen
Runtime-Healthchecks, Worker-Rollout, Portal-Domain-Controller, Signatur, Sentry-Markierung und
CDN-Purge waren erfolgreich.
Der secretsichere read-only Staging-Proof bestätigte alle fünf Worker auf dem Merge-SHA. Der
Import-Worker konsumierte im aktiven Portal-/GDPR-Modus hivegrid.kwp-imports; der regulär in Redis
registrierte 15-Minuten-Scheduler lief ohne manuellen Trigger und schloss eine Maintenance sowie zwei
dedizierte KWP-Jobs mit 0 Fehlern ab. Der daraus entstandene lokale Katalog war ready: eine aktive
Connection, 51 aktive Katalogeinträge, 6 aktive Capabilities, kein Katalogfehler und 0 offene
KWP-Fehlerberichte. Es wurde kein HiveGrid-Realprojekt importiert und keine KWP-Schreiboperation
ausgeführt. VD-P32 bleibt als design-nachzug offen; der kontrollierte fachliche Geerkens-Live-E2E
bleibt ausschließlich in VN-2. VR-P32d: 14/14 DoD = 100 % done · 0 Punkte offen.
Demand-Refresh-Impact 2026-07-31: Projektkatalog, gezielte Suche, Details und laufende read-only Reconciliation behalten ihre bestehenden Cache-, Routing-, Binding-, Sentinel- und 50-Requests/Minute- Grenzen. Der gemeinsame Resource-Adapter erneuert den Access-Token nur noch direkt vor einem tatsächlich fälligen Provider-Fenster; gleichzeitige Katalog-/Projektjobs verwenden denselben durable Token-Claim. Import-Mapping, Ownership, Create/Link und die KWP-Mutationssperre bleiben unverändert. VR-P32d: 14/14 DoD = 100 % done · 0 Punkte offen.
Demand-Refresh-Live-Abschluss 2026-08-01: Der gemeinsame Resource-Adapter aus VR-P32a bestand nach
PR #312, Deploy-Run 11609 und normalem OAuth-Reconnect 20/20 Demand-Rotationen und acht gesunde
Health-Sweeps. Projektkatalog, Vertragsprüfung und read-only Reconciliation können den technischen
Staging-Betrieb damit wieder nutzen; Mapping, Ownership, KWP-Mutationssperre und VN-2-Scope bleiben
unverändert. VR-P32d: 14/14 DoD = 100 % done · 0 Punkte offen.
Shared-Request-Budget-Hotfix 2026-08-01: Die anschließende Staging-Beobachtung zeigte keinen weiteren
Token- oder Connection-Fehler, aber eine lokale Budgetkollision: Katalog-, Contract- und Projektjobs
verbrauchten denselben 50-Requests/Minute-Sicherheitstopf; der bisherige Adapter warf beim ausgeschöpften
Topf sofort rate_limit_exceeded und ließ den Projektjob dadurch in die BullMQ-Retry-Kette laufen. Commit
6e49701df behält die 10-Request-Sicherheitsreserve unter KWP's 60er-Hard-Cap bei, bindet den durable
Redis-Zähler korrekt an die gemeinsame OAuth-Client-ID statt an einzelne Kundenkürzel und wartet bei lokaler
Erschöpfung bis resetAt plus 100 ms, bevor er atomar neu reserviert. Vor dem Reset findet kein Provider-I/O
statt; ein Redis-Ausfall bleibt fail-closed. Provider-429, Token-Claim, Mapping, Ownership und
Mutationssperre ändern sich nicht. Lokaler Proof: fokussierte KWP-/Worker-Suite 46/46, vollständiges
Integrationspaket 416/416, Root 1.160 Testdateien / 8.183 Tests bestanden / 60 übersprungen,
Typecheck, Lint, CI-Baseline und Source-Health grün. Ein Test belegt zwei Verbindungen mit verschiedenen
Kundenkürzeln und derselben OAuth-Client-ID: Call 51 wartet ohne Provider-Aufruf und läuft nach dem Reset
erfolgreich weiter. VR-P32d: 14/14 DoD = 100 % done · 0 Punkte offen · Release-/Staging-Proof offen.
Shared-Request-Budget Release- und Dauer-Proof 2026-08-01: PR #317 lief auf dem exakten Head
69482e94bac69c594312a7056ad2d62b1cbf9088 in CI-Run 11624 mit 11/11 grünen Jobs und wurde
ausdrücklich ohne Squash als normaler Zwei-Parent-Merge
28b2c0258e3a0bd62f9287c12d117d9a6350f971 nach main übernommen. Staging-Deploy 11625 schloss
für exakt diese Revision am 01.08.2026 um 02:19:33 UTC terminal grün ab; drei aufeinanderfolgende
Web-/API-Health- und Readiness-Proben meldeten denselben Merge-SHA. Nachfolgende Main-Rollouts behielten den
Fix; die am Ende öffentliche Revision 0141ad43bd52205a660425f673099d0a7ccfc961 enthält den Merge
nachweislich als Vorfahren.
Die secretsichere read-only Beobachtung von 02:24:48 bis 04:24:47 UTC umfasste neun automatische
Health-Sweeps und neun KWP-Maintenance-Zyklen. Jeder Health-Sweep meldete checked=1, unhealthy=0 und
null Tenant-Fehler; jeder Maintenance-Zyklus endete mit failures=0. Mindestens 29 protokollierte
Budget-Waits, darunter ein zweiter Wartezyklus bis 60,1 Sekunden, liefen ohne lokalen
rate_limit_exceeded weiter. Mindestens 14 Demand-Refreshes endeten mit outcome=refreshed; es gab
keinen Claim-, Provider- oder Persistenzfehler. Am Ende blieb die Connection active, der Katalog ready
mit 102 aktiven Einträgen, alle sechs Capabilities aktiv und die Zahl offener KWP-ErrorReports bei null.
Es wurde keine KWP-Mutation und kein manueller Realprojektimport ausgelöst. Die bestehende 20-Verzeichnisse-
Grenze des Archiv-Inbound-Readers erzeugte getrennt drei terminale KwpInboundLimitError-Jobs; sie änderte
weder Budget-, Token- noch Connectionstatus und gehört nicht in diesen Hotfix.
VR-P32d: 14/14 DoD = 100 % done · 0 Punkte offen.