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

265 lines
26 KiB
Markdown

# 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
- [x] **1.** Route-Manifest-Baseline existiert (`routes.settings-manifest.test.ts`) und ist nach jedem Hub-Umzug grün — keine Route verschwindet still.
- [x] **2.** `buildSettingsHubVM` in `packages/view-models/src/settings/settings-hub.vm.ts` ist pure Funktion (kein React, kein Prisma) mit Unit-Test.
- [x] **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.
- [x] **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).
- [x] **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).
- [x] **6.** Die vier Endpoint-Routen (Endpoint-Regel) haben unveränderte URLs; der Rechnungs-Download unter `settings/subscription/` funktioniert nachweislich weiter.
- [x] **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.
- [x] **8.** Doppelte Tab-Leisten entfernt (`MembersPage.tsx:92-97`, `RolesPage.tsx`); Fallback-Tab-Hack `settings.tsx:203-210` entfällt.
- [x] **9.** `POLICY_SECTIONS`-Pfade auf die neuen URLs gezogen (Tabelle in §C), inkl. Fix der `"api"`-Kette.
- [x] **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).
- [x] **11.** Registry-Gates nachgezogen: `UI_NAV_IDS`, `docs/ui-inventory/surfaces.json`, `AppSidebar.test.tsx`-Fixtures, i18n de **und** en.
- [x] **12.** **`git diff` gegen `SidebarIconsLayout.tsx` und `ui/components/SidebarInside/` ist leer.**
- [x] **13.** Tests grün: VM-Unit, Redirect-Contract, Smoke je Hub, Visual-Baselines (interim markiert), plus die bestehenden Suiten aus §Verifikation.
- [x] **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`.