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

23 KiB

R-P5 · P5 Apps-Engine & Integrations-Framework

⚠️ KI→MCP-Pivot (AD-26): Die KI-App-Kategorie bleibt im Katalog. Da HiveGrid kein eigenes LLM/RAG mehr hostet, sondern MCP-Server wird (VR-MCP), ist diese Kategorie der Andockpunkt für MCP-Server und künftige KI-Provider als reguläre Apps-Engine-DataConnection — kein Sonderbau. Framework selbst unverändert.

Typ Dev (Code)
Owner Raffael
Phase P5 — Apps-Engine & Integrations-Framework
Cycle/Fenster W2 — Plattform & CRM (Demo 1) · fällig 2026-06-21 · Gate W2 (Noah-Demo #1)
Status done (2026-07-07, Regressions-Fix 2026-07-17) — 10/10 DoD = 100 %; Backend seit 2026-06-28, Interim-UI (AD-28) + Run-Detail + Katalog-Seed via PR #50, Sidebar-Reachability-Fix via PR #51; Plane auf Done, Label design-nachzug gesetzt. RLS-Cutover-Regression im Worker-notify (DoD #4) am 2026-07-17 per Audit gefunden und gefixt (s. Umsetzungs-Notiz)

🎨 design-nachzug: offen (seit 2026-07-07) — Interim-UI aus ~/ui steht; finale Subframe-Optik aus D-P5 ausstehend.

Abhängigkeiten & Parallelität

  • Blocked by: R-P2b (RLS + Permissions — DataConnection ist tenant-bezogen + verschlüsselt)
  • Blocks: R-P6 (CRM nutzt das Framework später), AK-P14a (Email/OAuth), AK-P15a (Telefonie/AirCall), AK-P16a (Kalender/Signatur), EXT-08/09/10 (App-spezifische Setups)
  • Läuft parallel zu: Akeshans AK-P3 (Querschnitts-Oberflächen) — Paar AK-P3 ‖ R-P5. Disjunkte Domänen (Apps-Engine vs. Audit/Notif-UI), eigene prisma/schema/apps.prisma → kein Schema-Konflikt (AD-21). Berührung nur Sidebar/Admin-Routen — additiv.
  • Konflikt-Risiko: gering — db push auf Branch, Migration erst beim Merge.

Was wir bauen

Das eine, typsichere Integrations-Framework, über das später Gmail, Outlook, AirCall, Signatur-Adapter (SES-Default/PandaDoc-BYOK), Legacy-Provider und KWP laufen. Ein Admin stellt eine DataConnection über OAuth2-Connect oder API-Key-Connect in der Settings-UI her; die type-safe Adapter-Registry erlaubt neue Connection-Typen ohne Kern-Änderung (Build-Time-Scan, Drift-Check); AppSyncRun/AppSyncItem/AppSyncRunLog protokollieren Sync-Läufe in Klartext; Connection-Health-Monitoring zeigt active/degraded/broken/revoked/pending mit Klartext + Lösungs-Hinweisen; OAuth-Tokens per-Tenant-DEK-verschlüsselt (AD-8). Mehrere Connections pro App pro Tenant (z.B. drei Gmail-Mailboxen).

⚙️ Recut (KWP → v2, aktualisiert 2026-07-12): KWP = DataConnection type='oauth2' (Authorization Code + PKCE, Kundenkürzel + dynamische Relay-Auflösung) — kein kwpsync.exe-Windows-Client-Flow und kein KWP-API-Key-Setup. windows_client bleibt im Datenmodell, hat in v1 keinen UI-Flow. Apps selbst werden erst in ihren Modul-Phasen angedockt; P5 liefert das Framework + die generische Katalog-/Wizard-UI.

Benötigte Screens (Backend bedient — Design liefert D-P5 aus D-D0a/D-D0b)

Screen [Route] Kern-Inhalt Liefert (Design)
Integrations-Katalog [/settings/integrations] App-Karten nach Kategorie (ERP/Kommunikation/Kalender/Signatur/Payment/KI), Status-Ampel, Anzahl Connections, Suche/Filter D-P5 (A6)
App-Detail / Connection-Verwaltung [/settings/integrations/:app] Pro DataConnection: Status-Indikator, Klartext-Hinweis, letzter Sync, Re-Sync/Reconnect/Disconnect, Sync-History; mehrere Connections pro App D-P5 (A6+A2)
Connection-Setup-Wizard [Modal/Flow] Voraussetzungen → auto-generiertes Credential-Formular (aus connection_schema) → Validation/Health-Check → Initial-Sync; OAuth2-Redirect + API-Key-Reveal D-P5 (A5+A6)
Sync-History / Run-Detail […/syncs, …/syncs/:id] AppSyncRun-Liste (Datum/kind/Status/items-Zähler/Summary) + Filter; Run-Detail mit AppSyncItem-Liste + Log D-P5 (A2/A3)

Davids P5-Screens über D-P5 (Compose aus D0; Connection-Card als wiederverwendbares Element).

Definition of Done

  • DataConnection per OAuth2-Connect oder API-Key-Connect — Backend (createConnection: Adapter-Validierung + Envelope-Crypto) + funktionale Route-Action fertig; finale Wizard-Optik = Davids D-P5.
  • Type-safe Adapter-Registry (Drift-Check → Klartext-Warnung) — neue Typen ohne Kern-Änderung
  • AppSyncRun/AppSyncItem/AppSyncRunLog mit Klartext-Summary
  • Connection-Health-Monitoring + Token-Refresh-Worker + degraded/broken → notify() — Health-Probe + notify + Worker-Crons (token-refresh 1m, health-sweep 15m) über geteiltes @hivegrid/integrations-Paket. Worker-notify seit 2026-07-17 RLS-gebunden über M011-notify() mit tx-Client (Cutover-Regression, s. Umsetzungs-Notiz).
  • OAuth-Tokens per-Tenant-DEK-verschlüsselt (AD-8)
  • Lifecycle: Connect / Reconnect (gleiche ID, kein History-Verlust) / Disconnect (Status revoked statt Hard-Delete) — Backend + Route-Actions; finale Wizard-Optik = D-P5.
  • Mehrere DataConnections pro App pro Tenant (mit User-Label)
  • Manueller Re-Sync + Schema-Drift-Sentinel + Webhook-Storm-Schutz (triggerWebhookSync via withIdempotency)
  • Permissions: integrations.read/.connect/.disconnect/.manual_sync/.view_logs/.admin
  • (→ v2) kwpsync.exe-Windows-Client-Flow ausgeschlossen (KWP = OAuth2/PKCE-Adapter)

Technische Bausteine

  • Entities (eigene prisma/schema/apps.prisma): App (key, category, connection_type oauth2/api_key, connection_schema, phase — global, kein RLS), DataConnection (tenant_id, app_id, credentials verschlüsselt, connection_status, last_health_check), AppSyncRun, AppSyncRunLog, AppSyncItem (entity_type/id ↔ external_id, polymorph). core.prisma nur für Tenant-Relationen berühren (AD-21).
  • RLS auf DataConnection/AppSyncRun/AppSyncItem; App global ohne RLS (Definitions-Tabelle).
  • Per-Tenant-DEK-Verschlüsselung (AD-8) für OAuth-/API-Key-Credentials; DEK-Master-Key aus EXT-06.
  • Konnektor tenantHasModule() für Admin-Integrations-Routen.
  • Adapter-Registry = Build-Time-Scan + Drift-Check (Klartext-Warnung im Plattform-Admin P19).
  • is_demo_data auf Demo-Connections (Onboarding).

Quellen (granular)

  • ENTITY-MODEL.md → Domäne 4: Apps-Engine (App/DataConnection/AppSyncRun/AppSyncRunLog/AppSyncItem) + Cross-Cutting (DataConnection)
  • REQUIREMENTS.md → REQ-apps-engine-datenmodell, REQ-apps-engine-lifecycle
  • ROADMAP.md → Phase 5 · Milestones: (M008/M009/M010)
  • designer-briefs/P05-apps-engine-integrations-framework.md
  • docs/ARCHITECTURE-DECISIONS.md → AD-8 (per-Tenant-DEK)

Umsetzungs-Notiz

2026-07-22 (Raffael) — Dependency-Impact des laufenden KWP-Haltbarkeits-Nachzugs; DoD unverändert.

Auf Staging lief Revision d4daa0421. Der KWP-Pfad erneuerte das Token um 03:04:47 CEST erfolgreich; der nächste Lauf um 03:09:53 CEST endete jedoch mit broken / integrations.health.refreshFailed, ohne dass die konkrete Provider-/Transportklassifikation in den verfügbaren Runtime-Diagnosen erhalten blieb. Das ist ein offener KWP-Dauerbetriebsnachweis in VR-P32a/VEXT-1, keine Rücknahme des vorhandenen Apps-Engine-Frameworks.

Der lokal abgeschlossene, noch nicht deployte Nachzug bleibt auf den KWP-spezifischen Refresh-/Health-Pfad begrenzt: Handler-Logger an den strukturierten Runtime-Sink binden, replay-sichere und mehrdeutige Token-POST-Ausgänge eindeutig trennen, einen unklar verbrauchten Einmal-Refresh-Token niemals beim Provider wiederholen, ausschließlich lokale Persistenz-Retries zulassen und den KWP-Refresh-/Health-Gate früher ausführen. Der vollständige Root-Testlauf ist mit 7.115 bestandenen / 55 übersprungenen Tests grün; ebenso Root-Typecheck/-Lint, Worker-Build und die relevanten Deploy-/Runtime-Gates. Ein Deploy-/Live-Proof wird noch nicht beansprucht; die generischen Adapter- und Lifecycle-Verträge aus R-P5 bleiben unverändert. R-P5: 10/10 DoD = 100 %; Ticket bleibt Done · Design-Nachzug weiterhin offen.

2026-07-22 (Raffael) — KWP-Dauer-Proof abgeschlossen; DoD unverändert. PR #210 lief als Revision 2938f29da über Deploy-Run 10995 grün auf Staging. Nach dem normalen OAuth-Reconnect blieben Connection und geschützter Health-Probe active; neun aufeinanderfolgende automatische Refresh-Rotationen endeten mit failed=0 und ohne Provider-/Persistenzfehler. Ein anschließender geschützter Health-Probe blieb ebenfalls gesund. Damit ist der in VR-P32a/VEXT-1 offene KWP-Dauerbetriebsnachweis geschlossen. Die generischen Adapter- und Lifecycle-Verträge aus R-P5 bleiben unverändert. R-P5: 10/10 DoD = 100 %; Ticket bleibt Done · Design-Nachzug weiterhin offen.

2026-07-17 (Akeshan) — Stand-Audit + RLS-Regressions-Fix im Worker-notify (DoD #4), Branch fix/r-p5-integrations-notify-rls.

Voll-Audit (Code vs. Plane vs. Doc) nach dem RLS-Cutover vom 14.07.: 9 von 10 DoD-Punkten unverändert erfüllt (Proof-Pfade gegengelesen: Service/Registry/Schema/Crypto/Permissions/Routen/Sidebar/Seed/Smoke/Hot-Swap/i18n). Befund: notifyOwner in packages/integrations/src/worker-tasks.server.ts rief createNotificationDelivery ohne Client auf → Default-Root-Client außerhalb der withTenantRLS-Transaktion der Crons (der Worker-Helfer setzt nur die GUC im tx, keinen Async-Kontext). Unter FORCE RLS wurde der Insert per Policy abgelehnt und vom .catch(() => undefined) still geschluckt — degraded/broken-Benachrichtigungen gingen auf Staging/Prod verloren. Gleiche Regressions-Klasse wie R-P1b (PR #146); der dortige Fix deckte diesen Pfad nicht ab, weil er nicht über notify() lief.

Fix (Commit 8b72f3326): notifyOwner nutzt jetzt das M011-notify()-Contract auf dem gebundenen tx-Client (erfüllt zugleich den DoD-#4-Wortlaut inkl. Präferenz-Logik) mit sourceKey integrations:connection-unhealthy:<connectionId> — wiederholte 5m/15m-Sweeps upserten eine Delivery statt zu spammen. Regressionstests bilden die Policy nach (Delivery landet nur über den übergebenen Client im Store; alter Code = 0 Deliveries): packages/integrations/src/worker-tasks.test.ts 6/6 grün.

Verifiziert: typecheck @hivegrid/integrations + @hivegrid/worker je 0 Fehler · worker-tasks.test.ts 6/6 · apps/worker/src/notify-rls.test.ts 4/4 · apps/worker/src/handlers.test.ts 110/110 · verify:i18n Exit 0 · lefthook grün. Kein Schema-Delta, keine Migration, keine neuen i18n-Keys (Key existierte de+en).

Stand: R-P5 wieder 10/10 DoD = 100 % (zwischenzeitlich 9/10 durch die Cutover-Regression). Ticket bleibt Done.

2026-07-12 (Raffael) — Settings-Routing konsolidiert, DoD unverändert 10/10 = 100 %. Die Apps-Engine-UI ist jetzt kanonisch vollständig unter /settings/integrations/** verschachtelt, damit die Settings-Innensidebar bei Katalog, Connection-Verwaltung und Sync-History erhalten bleibt. Bestehende /integrations/**-UI-Links werden kompatibel weitergeleitet; die extern registrierten OAuth-Callbacks unter /integrations/<provider>/oauth/callback bleiben unverändert. Die abhängigen Connector-Tickets AK-P14a, AK-P15a und AK-P16a verwenden bereits /settings/integrations/<modul> und benötigen keinen Nachzug.

✅ Stand 2026-06-28 — auf main gemergt. R-P5 lief über den gemeinsamen Branch feat/AK-P17a und ging mit PR #5 (squash, Merge-Commit b0fae1af8, Base main, 2026-06-28 17:50) auf main. Nachzug-Fix packages/integrations/package.json im Docker-deps-Target via PR #8 (0b9d2e46, 18:05). Alle R-P5-Artefakte (appsEngineService, @hivegrid/integrations, crypto.prisma/appsEngine.prisma, Worker-Crons, Admin-Routen-Hülle) liegen im main-Tree. Die älteren „Branch lokal, nicht gepusht"-Notizen unten sind damit überholt. Backend 9/9 DoD grün. Extern offen bleibt nur: Davids D-P5-Optik, RLS-Live/Visual-Regression gegen Staging-DB, App-Tabellen-Katalog-Seed (deferred) (Seed am 2026-07-07 nachgezogen, s.u.), Plane-Ticket auf Done.

2026-06-27 (Akeshan) — Backend-Kern + Crypto-Fundament, Branch feat/R-P5 (lokal, nicht gepusht).

R-P5 an Akeshan übergeben (Plane: Assignee Akeshan). Gebaut in 6 Commits, jeweils mit grünem lefthook:

  • b5aa98b Per-Tenant-DEK-Envelope-Crypto (DoD #5) — packages/foundation/crypto (seal/open + KeyWrapper, CRYPTO_SECRET jetzt, Vault später swappbar) + packages/db/crypto/tenant-envelope.server.ts (DEK je Tenant, Crypto-Shredding) + crypto.prisma. 16 Tests grün. Entsperrt AK-P17a (dort nur noch Seam-Rebind).
  • aed2a8b Schema an ENTITY-MODEL Domäne 4 — App global, DataConnection (+Status/Token/Label/credentialsCiphertext/is_demo_data), Sync-Modelle; RLS-SQL deferred; Consumer (cli/dsgvo) nachgezogen.
  • 51b6b59 Permissions + Entitlements (DoD #9) — integrations.* + Grants + DefaultPermissions-Union; integrations-Feature/Blueprint/Plan; tenantHasModule('integrations').
  • 50bb9dd Adapter-Registry + Drift (DoD #2) — IntegrationAdapter-Contract + Registry + checkCatalogDrift (foundation) + Katalog + sample-data-sync-Referenz-Adapter + Drift-Gate-Test.
  • f2ea4d2 Domain-Service (DoD #1/#3/#6/#7 + #4-Health + #8-Re-Sync) — Lifecycle connect/reconnect/disconnect (Envelope-Crypto + Adapter-Validierung + Audit), Sync-Run/Item/Log, Health-Probe + notify; withTenantRLS, Credentials nie in List-VMs. Pure aggregateSyncOutcome getestet.
  • 0ab0f3a RLS-Gate-Test (env-gegatet) + i18n (de+en).

DoD-Stand: 6/9 voll grün (#2, #3, #5, #6, #7, #9) + Schema + v2-Ausschluss (KWP windows_client nur Datenmodell). Backend von #1 fertig (UI-Wizard blockiert durch D-P5). Teil-offen:

  • #4 Token-Refresh-Worker — architektonisch blockiert: der Worker hängt nur an @hivegrid/db, erreicht die Adapter (in apps/web/app/integrations) nicht. Provider-seitiger Token-Refresh braucht ein geteiltes Adapter-Paket (web+worker). Health-Probe + notify (web-seitig) ist fertig; die zeitbasierte Degradierung-Cron (ohne Adapter) ist selbst machbar.
  • #8 Webhook-Storm-Schutz — withIdempotency()-Wiring an einem Webhook-Ingest noch offen (Schema-Drift-Sentinel via Registry-Drift ist da).
  • Reachability (DoD B/#10): VMs + Admin-Routen-Hülle + Sidebar — selbst machbar (finale Optik wartet auf Davids D-P5).
  • Katalog-Seed (INTEGRATION_CATALOG → App-Tabelle upserten) — selbst machbar.
  • db push + RLS-Live-Verifikation env-gegatet (kein lokales PG); Merge-Migration beim main-Merge (AD-21).

Pre-existing rot (nicht von R-P5): cli/dsgvo „covers every"-Tests für File/Task/AdminTenantNote/EntityLink (merged AK-P4a/b/P19 haben die Registries nie nachgezogen); permissions-seed Windows-fileURL-Flake; roleDisplay i18n. Alle environmental/Fremd-Ticket.

Update 2026-06-28 (Akeshan) — beide Entscheidungen umgesetzt, DoD jetzt 9/9 backend. Co-Dev-Abstimmung: Akeshan macht R-P5. Entscheidungen: (1) geteiltes Adapter-Paket extrahieren, (2) funktionale UI-Hülle jetzt. 4 weitere Commits:

  • f6272c1 @hivegrid/integrations extrahiert (catalog + adapters + registry/drift + worker-tasks) — web+worker importierbar; Contract bleibt in foundation. Worker-Crons integrations-token-refresh (5m) + integrations-health-sweep (15m) pro Tenant via withTenantRLS → DoD #4 komplett.
  • 52b6113 VMs + Admin-Route-Hülle + Sidebar + i18n — app.$tenant/integrations.* (Katalog, Connection-Verwaltung mit connect/disconnect/manual-sync-Actions, Sync-History); Konnektor- + Permission-Gate (404); Credentials nie im VM. DataConnection.appId = bare Katalog-Key (AD-21, kein App-FK).
  • a49d998 Webhook-Storm-Schutz (triggerWebhookSync via withIdempotency, 60s-Dedup) → DoD #8 komplett.

Stand: 9/9 DoD backend grün + Reachability-Hülle. Verifiziert: typecheck alle Pakete + web (0 Fehler, Turbo-Cache-Falle 2x umgangen via direktem tsc), 30 neue Tests grün (Crypto/Registry/Worker-Sweep/VMs/Aggregate), RLS-Gate-Tests skippen sauber, verify:i18n Exit 0. Nur noch offen: finale Subframe-Optik (Davids D-P5), db push + RLS-Live + Visual-Regression/Smoke (env/Staging), App-Tabellen-Katalog-Seed (deferred — Tenant-Flow nutzt Code-Katalog), Merge-Migration (beim main-Merge, AD-21). Branch feat/R-P5, 11 Commits, lokal, nicht gepusht.

Abgleich/Review 2026-06-28 (Akeshan) — Branch gegen Ticket + DoD unabhängig nachgeprüft. Auslöser: R-P5 von Raffael übernommen, vollständiger Soll/Ist-Abgleich vor Übergabe-Doku. Ergebnis bestätigt den Stand oben:

  • Code-Inventar: alle 9 DoD-relevanten Artefakte vorhanden (crypto.prisma/appsEngine.prisma, RLS-SQL crypto+apps-engine, foundation/crypto envelope+key-wrapper, db/crypto tenant-envelope, foundation integration-adapters, Paket @hivegrid/integrations inkl. worker-tasks, appsEngineService, Worker-Maintenance-Cron, apps-engine VMs, Admin-Routen-Hülle, AppSidebar-Eintrag). git diff main..feat/R-P5: 74 Dateien, +6722/-5779.
  • Gates frisch gefahren: pnpm typecheck (alle Pakete + web, react-router typegen + Prisma-Client-Regen) Exit 0, 0 TS-Fehler; gezielte vitest (foundation/crypto + integration-adapters + @hivegrid/integrations registry/worker-tasks + apps-engine VMs) 24/24 grün; verify:i18n Exit 0. Working Tree sauber.
  • Plane abgeglichen: Ticket R-P5 = State In Progress, Assignee Akeshan, blocked-by R-P2b+D-P5, 0 Kommentare → Status-Kommentar mit diesem Stand gesetzt. Identität des Keys via users/me = akeshan (kein Mismatch).
  • Kein Statuswechsel auf Done: Backend ist 9/9, aber DoD #1/#6 tragen den UI-Wizard-Teil (D-P5 blockiert) und mehrere Reachability/Verifikations-Punkte hängen an Staging-DB/David → Ticket bleibt In Progress, bis das D-P5-Delta + Live-DB-Verifikation durch sind.
  • Selbst machbar noch offen: nichts (alle Rest-Punkte extern blockiert: D-P5-Optik, Staging-DB für db push/RLS-Live/Visual-Regression, plus Merge-Migration beim main-Merge). → backend-seitig 100 % der selbst machbaren DoD, gesamt 9/9 backend grün.

2026-07-07 (Akeshan) — Interim-UI (AD-28) + Sync-Run-Detail + Katalog-Seed, Branch akeshan/r-p5-interim-ui.

Die „Baseline functional UI" (nacktes Tailwind in den Routen) wurde durch AD-28-konforme Interim-Screens aus ~/ui ersetzt; damit sind die UI-Anteile von DoD #1/#6 sowie DoD D19/D20 jetzt real erfüllt statt nur „Backend fertig":

  • Screens apps/web/app/components/screens/integrations/: IntegrationsCatalogPage (A6, Karten-Grid nach Kategorie + Suche), ConnectionDetailPage (A6+A2, Banner bei degraded/broken mit Reconnect-Knopf), wiederverwendbare ConnectionCard (Status-Ampel/Klartext/letzter Check/Re-Sync/Reconnect/Trennen), ConnectWizardDialog (echter Dialog M 720 + StepperHorizontal: Voraussetzungen → auto-generiertes Credential-Formular aus connection_schema mit Secret-Reveal → Prüfen & Verbinden; OAuth2-Apps mit Interim-Hinweis), Disconnect-Confirm (XS 420, Klartext „Sync-Jobs gestoppt, History bleibt"), SyncHistoryPage (A2, Status/Kind-Filter + Re-Sync), SyncRunDetailPage (A3). Routen rendern nur noch <XPage vm={} actions={} />, Fetcher/closeSignal in der Route (Layer-DoD A eingehalten).
  • Neu: Sync-Run-Detail — Route integrations.$app.$connectionId.syncs.$runId.tsx + sync-run-detail.vm.ts (Items + Logs, view_logs-gegated, 404-Pattern) — schließt die vierte Screen-Zeile der Tabelle oben.
  • Reconnect-Intent in der $app-Route-Action ergänzt (Service reconnectConnection existierte; UI/Action-Pfad fehlte → DoD #6 jetzt komplett bedienbar).
  • Hot-Swap (D20): Adapter integrationsCatalog (packages/ui-app/src/adapters/) + renderIntegrationsCatalog (ui-subframe) + renderIntegrationsCatalogMock (ui-mock) + integrationsCatalog.hot-swap.test.ts nach rolesList-Muster.
  • Smoke (D19): tests/e2e/integrations.spec.ts — Login → Katalog → sample-data-sync → Wizard öffnet (Schritt 1) → Sync-History; non-mutierend, skippt ohne E2E-Creds.
  • Katalog-Seed (bisher deferred, jetzt drin): buildCatalogSeedPlan() (pur, packages/integrations/src/catalog-seed.ts + Test) + idempotentes App-Upsert im SeedService (global, kein RLS; Tenant-Flow liest weiter den Code-Katalog, DataConnection.appId bleibt bare Key).
  • i18n: ~50 neue Keys de+en (wizard/disconnect/runDetail/syncItem*/syncLogSeverity/Filter), chirurgisch gespliced.

Verifiziert (lokal, Windows): typecheck web+view-models+ui-app+ui-mock+ui-subframe+integrations je 0 Fehler · 434 Tests der 5 angefassten Pakete grün (inkl. 5 neue VM-, 3 Seed-, 5 Hot-Swap-/Mock-Tests; SeedService 19/19) · verify:i18n Exit 0 · verify:sidebar-routes, verify:cross-cutting-models (178/178), verify:phase-c-boundaries, verify:test-density, verify:production-seed-artifact grün · eslint-staged 0 Findings. Kein Prisma-Schema-Delta → keine Migration nötig. Visual-Baseline deferred wie AK-P3/R-P2a/AK-P4b (keine Screen-Snapshot-Harness) — Interim-Baseline wird beim David-Nachzug gezogen.

Nachtrag 2026-07-07 (Browser-Verifikation lokal + Staging): Der Sidebar-Eintrag war trotz Code + Plan-Entitlement nie sichtbar, weil integrations in tenantNavigationFeatureKeys (appData.ts) fehlte (Alt-Bug seit R-P5-Merge, betraf auch dashboard/leads/hr/calendar/emails/booking/forms/automation). Gefixt auf Branch akeshan/verify-fixups inkl. Registry-Guard-Test (sidebarFeatureAccess.test.ts); dazu EmptyState-Dead-Button-Wrapper (DoD B10/E23) und Klartext beim Disconnect (healthMessageKey -> integrations.health.notConnected). Reachability B6/B7 damit real erfüllt und im Browser verifiziert (Sidebar-Eintrag, kompletter Lifecycle inkl. Reconnect-Submit E2E).

Offen (extern): finale Subframe-Optik aus D-P5 (→ Tag oben; Plane-Label design-nachzug gesetzt 2026-07-07). Selbst machbar offen: nichts.

Abschluss 2026-07-07: PR #50 (Interim-UI) und PR #51 (Verifikations-Fixups: Sidebar-productAccess-Keys + Guard-Test, EmptyState-Wrapper, Disconnect-Klartext, Dev-Host-Ports) auf main gemergt und auf Staging deployed; Katalog/Wizard auf Staging verifiziert, kompletter Lifecycle inkl. Reconnect-Submit lokal E2E. Plane: Kommentar + Label design-nachzug + Status Done (Freigabe Akeshan, Chat 2026-07-07).

Dev-Nachzug (nach Davids D-P5-Delta)

Interim-UI (Vorschau, Stand 2026-07-07): Alle vier Flächen aus ~/ui gebaut (AD-28) — apps/web/app/components/screens/integrations/{IntegrationsCatalogPage,ConnectionDetailPage,ConnectionCard,ConnectWizardDialog,SyncHistoryPage,SyncRunDetailPage}.tsx. Proof: Smoke tests/e2e/integrations.spec.ts, Hot-Swap-Adapter integrationsCatalog (packages/ui-app/src/adapters/integrationsCatalog.hot-swap.test.ts) grün; Visual-Baseline deferred wie R-P2a/AK-P3/AK-P4b (keine Snapshot-Harness — Interim-Baseline wird beim David-Nachzug gezogen). Refactor-Nachzug offen: finale Subframe-Optik aus D-P5 (Plane-Label design-nachzug).

  • Katalog/Wizard/Connection-Card an Davids UI angepasst
  • REQUIREMENTS/ROADMAP nachgezogen
  • Plane-Ticket R-P5 aktualisiert