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.tsxundapps/web/app/ui/components/SidebarInside/werden NICHT angefasst. Hover-Aufklappen,HOVER_OPEN_DELAY_MS/HOVER_CLOSE_DELAY_MS(300/350 ms), diew-[208px], der Content-Reflow beim Aufklappen und die Mobile-Tabs-Leiste bleiben exakt wie sie sind. Geändert wird ausschließlich der Inhalt desitems-Arrays, dassettings.tsxhineinreicht. 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 inAdminSidebar.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 |
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-75baut die URL). Ändern = tote Links in bereits versendeten Mails.settings/privacy.export.$jobId.download.tssettings/subscription/invoices.$invoiceId.download.tsxsettings/chat/audit.$id.attachments.$fileId.$variant.tsxsettings/logs/export.tsundsettings/logs/events-export.ts— CSV-Resource-Routes ohne Komponente (durch die Slice-0-Baseline gefunden, im ursprünglichen Plan übersehen; als.tstauchten sie in der*.tsx-Bestandsaufnahme nicht auf). Sie hängen untersettings/logs/, das nach Hub F zieht → beim Umzug von Hub F musslogs.tsxderselbe<Outlet/>-Pass-through-Trick wie beisubscription.tsxtreffen, 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.
buildSettingsHubVMinpackages/view-models/src/settings/settings-hub.vm.tsist pure Funktion (kein React, kein Prisma) mit Unit-Test. - 3.
SettingsHubShelluntercomponents/screens/settings/erhält VM als Prop, ist aus~/ui+PageShellkomponiert, kein handgeschriebenes Tailwind für Dinge, die~/uianbietet. - 4. Alle 6 Hubs + Kundenportal gebaut; die Rail zeigt 7 statt 21 Einträge; jeder Hub-Titel passt ohne
truncatein 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.
AuditExportPageneu untercomponents/screens/audit/:PageHeader,~/ui-Controls stattbg-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-Hacksettings.tsx:203-210entfä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 diffgegenSidebarIconsLayout.tsxundui/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 in628483111repariert; 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_IDSunddocs/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-baselineundgit diff --checkgrü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
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.- Gemischte Route-Konvention. Punkt- und Ordner-Notation nebeneinander; ohne den Manifest-Snapshot aus Slice 0 verschwindet beim Umzug still eine Route.
- 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. - 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, Tenanthivegrid-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.