Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/AK-SET-01.md
T

26 KiB

AK-SET-01 · Settings-Informationsarchitektur: 21 Rail-Einträge zu 6 Hubs bündeln

Typ Dev/UI — Informationsarchitektur + Interim-UI-Sanierung
Owner Akeshan + Agent
Status 🟡 READY-TO-VERIFY — Dev-DoD 14/14 erfüllt (2026-07-22)
Blocked by — (AK-P21 ist in der Branch-Basis enthalten)
Tracking nur Git-Repo — kein Plane-Ticket (analog zur gelöschten AK-UI-Serie, siehe AK-UI-ENTFALLEN.md); diese Doc ist die alleinige Quelle der Wahrheit

🎨 design-nachzug: offen — die sieben Hubs und der Audit-Export verwenden die freigegebene Interim-UI; die finale Subframe-Optik bleibt ein getrackter Nachzug gemäß AD-28.

Was wir bauen

Die Tenant-Settings unter /app/:tenant/settings reichen der inneren Rail aktuell bis zu 21 Einträge durch. Diese 21 Einträge werden zu 6 Hub-Bereichen + Kundenportal gebündelt. Jeder Hub bekommt eine eigene Layout-Route mit PageHeader und einer permanent sichtbaren horizontalen ~/ui-Tab-Leiste; jeder Tab behält eine eigene URL. Alle Alt-URLs bleiben über 302-Redirects erreichbar.

Zusätzlich wird /settings/audit-export überhaupt erst über die Navigation erreichbar gemacht und auf den Interim-UI-Standard gehoben (heute: handgeschriebenes Tailwind mit bg-blue-600, kein PageHeader, keine Zustände).

Nicht im Scope (verbindlich)

  • apps/web/app/components/ui/layouts/SidebarIconsLayout.tsx und apps/web/app/ui/components/SidebarInside/ werden NICHT angefasst. Hover-Aufklappen, HOVER_OPEN_DELAY_MS/HOVER_CLOSE_DELAY_MS (300/350 ms), die w-[208px], der Content-Reflow beim Aufklappen und die Mobile-Tabs-Leiste bleiben exakt wie sie sind. Geändert wird ausschließlich der Inhalt des items-Arrays, das settings.tsx hineinreicht. Die 17 übrigen Call-Sites der Komponente bleiben dadurch unberührt. — User-Entscheidung 2026-07-21.
  • Der Plattform-Admin-Bereich (routes/admin/settings/*, eigene 8-Punkt-Navigation in AdminSidebar.tsx:325-372) hat dasselbe Problem, ist hier aber bewusst außen vor.
  • Keine Änderung an VM-Buildern, Domain-Services, Prisma-Schema oder Permissions. Loader/Actions ziehen 1:1 mit um.

Ist-Stand (live verifiziert 2026-07-21, Tenant hivegrid-demo)

getTabs() in apps/web/app/routes/app.$tenant/settings.tsx:66-246 baut bis zu 21 Einträge; settings/ enthält ~35 Route-Dateien mit 8.779 LOC.

Befund 1 — die Rail skaliert nicht auf 21 Einträge. Die innere Rail ist eine Hover-Rail: expanded = hovered || focusWithin (SidebarIconsLayout.tsx:37), es gibt keinen Pin/Toggle. Im Ruhezustand nur Icons, davon mehrere doppelt (drei identische Aktivitäts-Kurven für Nutzung/Chat-Audit/Protokolle, zwei identische Dokument-Icons für Rechnungen/Richtlinien). Aufgeklappt ist die Spalte w-[208px] (SidebarInside.tsx:144), abzüglich 32 px Icon-Spalte bleiben ~140 px, der Text hat truncate (SidebarInside.tsx:50) → 7 von 18 sichtbaren Labels sind abgeschnitten: „Datensch…", „Abonnem…", „Rechnun…", „Demo-Da…", „Integratio…", „API-Schlü…", „Benachric…". Mobil rendert dieselbe Komponente alle Einträge als horizontale Tabs-Leiste (SidebarIconsLayout.tsx:132-145) — 21 Tabs scrollen dort ins Nirgendwo.

Befund 2 — settings/audit-export.tsx bricht die Interim-UI-Standards. Kein PageHeader, stattdessen nacktes <h1 className="text-xl font-semibold"> (Z. 109); bg-blue-600/text-blue-600-Buttons (Z. 158, 166) in einer Farbe, die im Rest der App nicht vorkommt; rohe <input type="date"> und <select> statt ~/ui DatePicker/Select; text-gray-500, rounded border px-2 py-1 statt Design-Tokens; keine Empty-, Loading- oder Error-States. Laut .planning/INTERIM-UI-DESIGN-STANDARDS.md §0 ein PR-Block-Tatbestand. Die Seite hat außerdem keinen Rail-Eintrag und ist nur per Deep-Link erreichbar.

Befund 3 — settings/policies.tsx:46 erzeugt eine Redirect-Kette. Die API-Sektion zeigt auf "api" statt settings/api, läuft also über die Legacy-Redirect-Route.

Ziel-Struktur

Sieben Rail-Einträge. Jeder Hub: PageShell + PageHeader + ~/ui-Tabs + <Outlet/>.

┌──────────────────────────────────────────┐
│  💳  Abrechnung                          │  ← PageHeader (Icon, h1, Subtitle)
│  Plan, Verbrauch und Rechnungen          │
├──────────────────────────────────────────┤
│ [ Abo & Plan ] Nutzung   Rechnungen      │  ← ~/ui/components/Tabs
├──────────────────────────────────────────┤
│  <Outlet/>                               │
└──────────────────────────────────────────┘
   /hivegrid-demo/settings/billing/usage

Titel-Längen-Constraint: Die 208 px der Rail bleiben unverändert, also muss jeder Hub-Titel ohne truncate hineinpassen. „Integrationen & Erweiterungen" tut das nicht → Rail-Label ist „Erweiterungen". Die anderen sechs sind kürzer als heute vollständig dargestellte Labels wie „Mitglieder"/„Telefonie". Pro Hub per Screenshot verifizieren.

A · Mein Konto — Basis settings/profile

Tab Neue Datei Aus Gate
Profil settings/profile/index.tsx settings/profile.tsx —
Sicherheit settings/profile/security.tsx settings/security.tsx —
Benachrichtigungen settings/profile/notifications.tsx settings/notifications.tsx —
Meine Daten settings/profile/data.tsx settings/privacy.tsx —

settings/profile.tsx wird neu zum Hub-Layout, bleibt Default-Redirect-Ziel (settings.tsx:248-253). Alle vier Tabs ungated — der DSGVO-Self-Service muss für jeden erreichbar bleiben (DoD B6, so kommentiert in settings.tsx:81-83). buildPrivacyHubVM liefert vier Section-Keys (packages/view-models/src/privacy/privacy-hub.vm.ts:4): export+deletion bleiben hier, subprocessors+avv sind reine Verweise und wandern nach Hub F.

B · Team & Zugriff — Basis settings/team

Tab Neue Datei Aus
Mitglieder settings/team/index.tsx (+ members/new, members/$id) settings/members.tsx, settings/members/*
Rollen & Rechte settings/team/roles.tsx (+ roles/$id, roles/new) settings/roles-and-permissions/*
Gruppen settings/team/groups.tsx (+ $id, new) settings/groups*, settings/members/groups/*

⚠️ MembersPage.tsx:92-97 und RolesPage.tsx rendern bereits eine eigene Tabs-Leiste („Mitglieder | Rollen und Berechtigungen"). Die muss raus, sonst stehen zwei Tab-Leisten übereinander. Der Fallback-Tab-Hack in settings.tsx:203-210 entfällt ersatzlos.

C · Workspace — Basis settings/workspace

Tab Neue Datei Aus
Allgemein settings/workspace/index.tsx settings/account.tsx
Richtlinien settings/workspace/policies.tsx settings/policies.tsx
Demo-Daten settings/workspace/demo-data.tsx settings/onboarding/demo-data.tsx

policies.tsx behält Karten, Texte UND Link-Zeilen (User-Entscheidung 2026-07-21). Begründung: nach der Konsolidierung liegen die sechs Ziele in fünf verschiedenen Hubs, damit werden die Links von Navigations-Dopplung zu nützlichen Querverweisen. Nur die path-Werte in POLICY_SECTIONS (policies.tsx:26-48) ziehen um:

Sektion heute neu
membership settings/members settings/team
roles settings/roles-and-permissions settings/team/roles
billing settings/subscription settings/billing
notifications settings/notifications settings/profile/notifications
audit settings/logs settings/compliance
api api ⚠️ (Redirect-Kette, Befund 3) settings/integrations/api

Keine i18n-Änderung — alle settings.policies.*-Keys bleiben unverändert.

D · Abrechnung — Basis settings/billing · Pilot-Hub

Tab Neue Datei Aus
Abo & Plan settings/billing/index.tsx settings/subscription.tsx
Nutzung settings/billing/usage.tsx settings/usage.tsx
Rechnungen settings/billing/invoices.tsx settings/billing.tsx (alt, wird zum Hub-Layout)

⚠️ Footgun: settings/subscription/invoices.$invoiceId.download.tsx ist ein Download-Endpoint unter dem Eltern-Pfad. Ein Redirect im Layout settings/subscription.tsx würde ihn töten, weil der Eltern-Loader auch für Kinder läuft. Richtig: settings/subscription.tsx wird reiner <Outlet/>-Pass-through ohne Loader-Redirect, der Redirect kommt in ein neues settings/subscription/index.tsx.

settings/credits.tsx redirected heute auf settings/subscription → Ziel direkt auf settings/billing umhängen, keine Kette.

E · Erweiterungen — Basis settings/integrations

Tab Neue Datei Aus
Katalog settings/integrations/_index.tsx bleibt
E-Mail settings/integrations/email._index.tsx bleibt
Kalender settings/integrations/calendar._index.tsx bleibt
Telefonie settings/integrations/telephony.tsx bleibt
Plugins settings/integrations/plugins.tsx (+ $id, $id/audit) settings/plugins*
API-Keys settings/integrations/api/* settings/api/*

integrations.tsx (heute 17 LOC, nur <Outlet/>) bekommt PageHeader + Tab-Leiste; der Breadcrumb-Kommentar dort (Z. 1-4) beschreibt genau diese Layout-Rolle. ⚠️ settings/api/* ist bereits Ziel von Legacy-Redirects aus /:tenant/api/* (routes/app.$tenant/api/*.tsx). Deren Redirect-Ziel direkt auf settings/integrations/api/* umhängen, sonst zweistufige Kette. api/legacy-settings-redirects.test.ts mit anpassen.

F · Compliance & Protokolle — Basis settings/compliance · zuletzt bauen

Tab Neue Datei Aus
Audit-Log settings/compliance/index.tsx (+ events, events.$id) settings/logs/*
Audit-Export settings/compliance/export.tsx settings/audit-export.tsx — + UI-Neubau, Slice 4
Chat-Audit settings/compliance/chat.tsx (+ $id) settings/chat/audit*
AVV settings/compliance/avv.tsx settings/privacy.avv.tsx
Unterauftragsverarbeiter settings/compliance/subprocessors.tsx settings/privacy.subprocessors.tsx
Mandanten-Löschung settings/compliance/tenant-deletion.tsx settings/privacy.deletion.tsx

Damit wird Audit-Export erstmals über die Navigation erreichbar (Befund 2).

Kein Umzug: Kundenportal

settings/customer-portal.tsx bleibt eigener Rail-Eintrag, bekommt intern Tabs Einstellungen | Domain | E-Mail-Vorlagen (Dateien liegen bereits so: customer-portal/domain.tsx, customer-portal/email-templates.tsx). Kein Route-Umzug; der separate Rail-Eintrag für die Mailvorlagen (settings.tsx:153-158) entfällt.

Endpoint-Regel (verbindlich)

Nicht-visuelle Routen ziehen NICHT um. Ihre URLs bleiben Zeichen für Zeichen erhalten:

  • settings/privacy.delete.confirm.$token.tsx — wird per E-Mail verschickt (privacy.tsx:71-75 baut die URL). Ändern = tote Links in bereits versendeten Mails.
  • settings/privacy.export.$jobId.download.ts
  • settings/subscription/invoices.$invoiceId.download.tsx
  • settings/chat/audit.$id.attachments.$fileId.$variant.tsx
  • settings/logs/export.ts und settings/logs/events-export.ts — CSV-Resource-Routes ohne Komponente (durch die Slice-0-Baseline gefunden, im ursprünglichen Plan übersehen; als .ts tauchten sie in der *.tsx-Bestandsaufnahme nicht auf). Sie hängen unter settings/logs/, das nach Hub F zieht → beim Umzug von Hub F muss logs.tsx derselbe <Outlet/>-Pass-through-Trick wie bei subscription.tsx treffen, sonst sterben beide CSV-Exporte.

Definition of Done

  • 1. Route-Manifest-Baseline existiert (routes.settings-manifest.test.ts) und ist nach jedem Hub-Umzug grün — keine Route verschwindet still.
  • 2. buildSettingsHubVM in packages/view-models/src/settings/settings-hub.vm.ts ist pure Funktion (kein React, kein Prisma) mit Unit-Test.
  • 3. SettingsHubShell unter components/screens/settings/ erhält VM als Prop, ist aus ~/ui + PageShell komponiert, kein handgeschriebenes Tailwind für Dinge, die ~/ui anbietet.
  • 4. Alle 6 Hubs + Kundenportal gebaut; die Rail zeigt 7 statt 21 Einträge; jeder Hub-Titel passt ohne truncate in die 208 px (Visual-Baseline rendert und prüft alle sieben Hub-Labels).
  • 5. Redirect-Contract-Test deckt die vollständige Alt→Neu-Matrix ab; jede Alt-URL liefert 302 mit erhaltenem Query-String; keine Redirect-Ketten (Testassertion: Ziel ist selbst kein Redirect-Loader).
  • 6. Die vier Endpoint-Routen (Endpoint-Regel) haben unveränderte URLs; der Rechnungs-Download unter settings/subscription/ funktioniert nachweislich weiter.
  • 7. AuditExportPage neu unter components/screens/audit/: PageHeader, ~/ui-Controls statt bg-blue-600/roher <select>/<input type="date">, Empty-/Loading-/Error-States mit Klartext. Über Hub F per Navigation erreichbar.
  • 8. Doppelte Tab-Leisten entfernt (MembersPage.tsx:92-97, RolesPage.tsx); Fallback-Tab-Hack settings.tsx:203-210 entfällt.
  • 9. POLICY_SECTIONS-Pfade auf die neuen URLs gezogen (Tabelle in §C), inkl. Fix der "api"-Kette.
  • 10. Leerer Hub = 404, nicht leere Seite: hat ein User für keinen Tab eines Hubs die Permission, wirft der Hub-Loader 404 und der Rail-Eintrag wird nicht gerendert (DoD E25).
  • 11. Registry-Gates nachgezogen: UI_NAV_IDS, docs/ui-inventory/surfaces.json, AppSidebar.test.tsx-Fixtures, i18n de und en.
  • 12. git diff gegen SidebarIconsLayout.tsx und ui/components/SidebarInside/ ist leer.
  • 13. Tests grün: VM-Unit, Redirect-Contract, Smoke je Hub, Visual-Baselines (interim markiert), plus die bestehenden Suiten aus §Verifikation.
  • 14. Konsumenten-Sweep abgeschlossen (§Slice 2b): kein Produktions-Code baut mehr eine Alt-URL, die nur noch per 302 erreichbar wäre. Verifiziert per Grep-Kontrolllauf; Suchindex und Command-Palette zeigen direkt auf die neuen Ziele.

Fortschritt: AK-SET-01: 14/14 DoD = 100 % done · 0 Punkte offen · finaler Subframe-Design-Nachzug separat offen und gemäß AD-28 nicht Done-blockierend.

Umsetzungs-Notiz · 2026-07-22

  • Basis aus Akeshans geschlossenem PR #208 übernommen (742fea5a5), erste Route-/Audit-Vertragsfehler in 628483111 repariert; Abschluss in diesem Settings-Reparaturcommit.
  • Vollständige Alt→Neu-Matrix: 41 visuelle Alt-Routen, 83 Redirect-Assertions mit 302, Query-Erhalt und Kettenausschluss. CSV-, Attachment-, Privacy- und Rechnungs-Download-Endpunkte bleiben auf ihren veröffentlichten URLs und werden separat getestet.
  • Permission-/Modul-Parität für Rail und Hub-Loader hergestellt; Hub-Basis-URLs springen auf den ersten tatsächlich erlaubten Tab, leere Hubs liefern 404. Tenant-Audit-Export liest Audit-Daten unter gebundenem RLS-Kontext.
  • UI-/Registry-Proof: sieben Rail-IDs in UI_NAV_IDS und docs/ui-inventory/surfaces.json; Interim-Visual-Baseline rendert alle sieben Hubs, Smoke-Spec deckt jeden Hub ab. Der Diff gegen die beiden ausdrücklich gesperrten Sidebar-Layoutpfade ist leer.
  • Verifikation: pnpm typecheck, pnpm lint, pnpm build, pnpm run verify:bundle-size (13/13 Gruppen und 653/653 Einzelrouten), pnpm run verify:i18n, pnpm run verify:sidebar-routes, pnpm test:hot-swap, pnpm run verify:test-coverage, verify:source-health, verify:ci-baseline und git diff --check grün. Gezielte Settings-Suite: 126/126 Tests. Voller Core-Lauf: 1.004 Testdateien und 7.240 Tests bestanden; 10 Dateien/55 Live-Integrationstests erwartungsgemäß ohne Infrastruktur übersprungen. Der nachgezogene Worker-Mailvertrag ist zusätzlich mit 21/21 Tests grün. 47 betroffene Playwright-Fälle kompilieren über --list; kein lokaler Live-E2E-/Deploy-Lauf durchgeführt.
  • Konsumenten-Sweep: Produktcode, Worker, Such-/Command-Ziele, visuelle Fixtures und E2E-Defaults zeigen direkt auf die neuen Hub-Routen. Verbleibende Treffer sind Komponenten-Importpfade oder die absichtlich unveränderten Resource-Endpunkte.

Technische Bausteine (Slices in Reihenfolge)

Slice 0 — Route-Manifest-Baseline. apps/web/app/routes.ts nutzt createRoutesFromFolders (v1-Konvention über ~/utils/compat/v1-route-convention), und der Bestand mischt Punkt-Notation (privacy.export.tsx) mit Ordner-Notation (members/new.tsx). Snapshot-Test über alle app.$tenant/settings/**-Pfade anlegen. Konvention für alles Neue: ausschließlich Ordner-Notation (billing.tsx + billing/usage.tsx), analog zum bewährten members.tsx + members/, roles-and-permissions.tsx + roles-and-permissions/, integrations.tsx + integrations/.

Slice 1 — SettingsHubShell + VM. VM: buildSettingsHubVM({ tabs, activeHref }) → { tabs: [{ id, labelKey, href, active }] }; die Permission-Entscheidung trifft der Loader und übergibt nur erlaubte Tabs. Screen komponiert PageShell + PageHeader (components/screens/shared/PageShell.tsx) + ~/ui/components/Tabs, Tabs als <Link className="contents no-underline"><Tabs.Item active={…}> — exakt das Muster aus components/screens/users/MembersPage.tsx:92-97.

Slice 2 — Redirect-Helper + Contract-Test. settings/legacy-redirects.server.ts mit legacySettingsRedirect(request, params, target) → 302 mit erhaltenem Query-String. Vorlage 1:1: routes/app.$tenant/api/legacy-settings-redirects.test.ts und die Loader in api/index.tsx, api/keys.tsx.

Slice 2b — Konsumenten-Sweep (neu, ergänzt 2026-07-21 nach Grep-Befund — im ursprünglichen Plan unterschätzt).

Der Grep hat ~25 Produktionsdateien außerhalb von routes/ gefunden, die Settings-URLs hartkodieren. Redirects halten die zwar am Leben, aber ein Suchindex-Eintrag oder ein Command-Palette-Ziel, das dauerhaft über einen 302 läuft, ist eine schleichende Regression. Diese Konsumenten ziehen mit um:

Kategorie Dateien Warum kritisch
App-Chrome-Menüs components/layouts/buttons/ProfileButton.tsx (6 Pfade!), layouts/sidebars/shadcn/nav-user.tsx, nav-actions.tsx, layouts/NavBar.tsx, buttons/CurrentSubscriptionButton.tsx direkt sichtbare Navigation
Command-Palette services/command-registry/commandRegistry.ts Z. 99, 109, 118, 127, 150, 159 6 Spotlight-Ziele
Suchindex services/search/globalSearch.server.ts, services/search/searchIndexProjection.server.ts persistierte URLs im Index → Re-Index nötig, sonst bleiben Alt-Ziele dauerhaft gespeichert
URL-Helfer utils/app/SubscriptionUrlUtils.ts (settings/subscription?subscription_required=1) Query-String muss den Redirect überleben — deckt Contract-Test ab
Fach-Services utils/services/.server/akP20OnboardingService.ts, modules/events/services/.server/EventsService.ts, services/billing/customer-invoices.server.ts, modules/chat/routes/chatRoutePaths.ts, utils/data/useMembersData.ts
Feature-Gates / Formulare components/ui/misc/ProFeature.tsx, core/settings/subscription/CheckPlanFeatureLimit.tsx, core/pricing/PricingPlanForm.tsx, core/settings/members/NewMember.tsx, screens/users/InviteMemberForm.tsx, modules/users/components/SubscriptionSettings.tsx
Error-Reporter packages/error-reporter/src/sentry.ts (settings/privacy)
Hot-Swap / Visual packages/ui-mock/src/index.ts, packages/ui-mock/visual-baseline/{ak-p20-interim,va-p24a-interim,ak-ui-05-plugins}.mock.ts sonst driften Hot-Swap-Drill und Baselines

Nicht betroffen: E-Mail-Templates. Der Grep über apps/web/app/modules/emails und packages/mail fand nur zwei Admin-Test-URLs (admin.example.com/settings/transactional-emails), keine Tenant-Settings-Links. Die per Mail versendete Lösch-Bestätigungs-URL wird in privacy.tsx gebaut und fällt unter die Endpoint-Regel.

Vorgehen: Der Sweep läuft pro Hub im jeweiligen Slice, nicht als Big-Bang — beim Umzug eines Hubs werden dessen Konsumenten mitgezogen. Abschluss-Kontrolle in Slice 10 per Grep.

Slice 3 — Hub D „Abrechnung" (Pilot). Kleinster Hub, drei Tabs, alle mit demselben BILLING_MODULE_KEY-Gate. Löst den subscription.tsx-Pass-through-Footgun und verankert ihn im Contract-Test. Danach STOP und Review, bevor die übrigen Hubs folgen.

Slice 4 — audit-export Interim-UI-Sanierung. Eigenständig wertvoll, auch ohne den Rest. Neuer Screen components/screens/audit/AuditExportPage.tsx; Loader/CSV-/PDF-Streaming (streamTenantAuditExport, streamTenantAuditPdfExport) bleiben unverändert. Filter-Optionen als VM (packages/view-models/src/audit/audit-export.vm.ts) statt hartkodierter <option>-Listen (Z. 130-155).

Slice 5-9 — Hubs F, A, B, C, E. Je Hub: Layout-Route anlegen → Kind-Routen per git mv verschieben (History bleibt) → Alt-Pfade auf Redirect-Loader reduzieren → doppelte Tab-Leisten entfernen (Hub B) → Tests umhängen.

Slice 10 — Rail-Inhalt + Registries + Doku. getTabs() in settings.tsx von 21 auf 7 Einträge kürzen. Kein Layout-Slice — die Komponente bleibt unangetastet (§Nicht im Scope).

Interim-UI-Standards (AD-28)

.planning/INTERIM-UI-DESIGN-STANDARDS.md vor dem Bau lesen. Verbindlich: §0 Component-Defaults statt Tailwind-Overrides · §2 Page-Padding 24 / Card 16 / Grid-Gap 16 / Field-Gap 16 · §5 Controls Medium (36) / Radius small (4) · §7 Empty/Loading/Permission als inline State-Komponenten, Permission-Denied = 404, nicht 403.

Stil-Referenzen (lesen, nicht kopieren): components/screens/users/MembersPage.tsx (Tab-Leiste), components/screens/billing/BillingUsagePage.tsx (Card/EmptyState/Loader/Alert-States), components/screens/billing/SubscriptionOverviewPage.tsx, sowie fertige Automations- und Form-Screens.

Registry-Gates (sonst lokal grün, CI rot)

Slice legt an Pflicht-Nachzug CI-Gate
Neue Nav-IDs (7 Hubs) UI_NAV_IDS in apps/web/app/application/ui/uiRegistry.ts + Fixtures in AppSidebar.test.tsx plus Surface-Einträge in docs/ui-inventory/surfaces.json verify:sidebar-routes, uiRegistry.test.ts, uiInventory.test.ts
Neue Hub-/Tab-Titel i18n-Keys in de/ und en/ translations.json — chirurgisch splicen, nie JSON round-trippen verify:i18n
Route-Umzüge apps/web/app/routes.test.ts + Manifest-Snapshot aus Slice 0 verify:sidebar-routes
Neue data-ui-id docs/ui-inventory/surfaces.json uiInventory.test.ts

Kein Prisma-Touch, keine Migration, kein neuer Permission-Key. Falls doch ein Permission-Key nötig würde: packages/db/src/permissions-seed.server.ts und application/dtos/shared/DefaultPermissions.ts und DEFAULT_PERMISSION_SCOPE_KEYS in roleDisplay.ts und de/en-Scope-Übersetzung — alle vier, sonst rot.

Verifikation (pro Commit)

pnpm --filter @hivegrid/web typecheck
pnpm --filter @hivegrid/view-models typecheck
pnpm run verify:i18n                 # Exit 0
pnpm run verify:sidebar-routes
node scripts/vitest-cli-compat.mjs run 'apps/web/app/routes/app.$tenant/settings'
node scripts/vitest-cli-compat.mjs run 'apps/web/app/application/sidebar'

Pre-Push zusätzlich — die bestehenden Suiten der angefassten geteilten Dateien mitlaufen lassen: settings.workspace-shell.test.tsx, settings/tenant-settings-i18n.test.ts, settings/tenant-settings-audit-log-copy.test.ts, settings/settings-validation-contract.test.ts, api/legacy-settings-redirects.test.ts sowie tests/e2e/tenant-governance-settings.{desktop,mobile}-a11y.spec.ts (kennen die aktuelle Settings-Navigation, brechen garantiert). Nicht verify:tenant-isolation-report regenerieren (Windows-False-Positive).

Abhängigkeiten

Blocker Status Auswirkung
AK-P21 offen — auf fix/ak-p21-audit-restwork liegen uncommittete Änderungen an privacy-tenant-deletion*.ts, privacy-gdpr.server.ts und eine neue Migration Hub F erst nach dem AK-P21-Merge bauen (User-Entscheidung 2026-07-21). Slices 0-3, 5 (A/B/C/E) sind unabhängig.

Risiken

  1. URL-Wechsel als Breaking Change — geprüft 2026-07-21, Ergebnis in Slice 2b. E-Mail-Templates sind nicht betroffen (Entwarnung). Dafür hardcoden ~25 Produktionsdateien Settings-URLs, darunter Command-Palette, Suchindex und die App-Chrome-Menüs. Der Suchindex ist der unangenehmste Fall, weil er URLs persistiert — dort reicht ein Code-Fix nicht, es braucht einen Re-Index. Behandelt als eigener Slice 2b, DoD 14.
  2. Gemischte Route-Konvention. Punkt- und Ordner-Notation nebeneinander; ohne den Manifest-Snapshot aus Slice 0 verschwindet beim Umzug still eine Route.
  3. Eltern-Loader läuft für Kinder. Betrifft subscription.tsx (dokumentiert) — beim Umzug jedes weiteren Hubs prüfen, ob unter dem Alt-Pfad Endpoint-Kinder hängen.
  4. Ticket-Deckung. Diese Doc ist repo-only getrackt (kein Plane-Ticket), analog zur inzwischen gelöschten AK-UI-Serie (AK-UI-ENTFALLEN.md). Der Plan wurde am 2026-07-21 mit dem User abgestimmt und freigegeben.

Quellen

  • AGENTS.md (Layer-Trennung Block A, Reachability B6-B12, DoD D18-D21, Ticket-Treue)
  • .planning/INTERIM-UI-PLAYBOOK.md, .planning/INTERIM-UI-DESIGN-STANDARDS.md (AD-28)
  • docs/AGENT-CHECKLIST.md (Pre-Push)
  • Live-Befund 2026-07-21 an app.localhost:3000, Tenant hivegrid-demo

Abhängigkeitsnachzug · CR-007 · 2026-07-27

Der Gruppen-Tab ist nicht mehr vom globalen row-groups-Flag abhängig. Rail, Hub und Direkt-Route verwenden ausschließlich app.settings.groups.full.