4.6 KiB
CR-ADMIN-IA · Vorschlag: Admin-Navigation auf 8 Bereiche mit Inner Sidebars
| Typ | Change-Request (nicht beauftragt) |
| Owner | offen — Entscheidung Raffael |
| Phase | Querschnitt · Plattform-Admin |
| Status | Vorschlag, wartet auf Entscheidung |
| Herkunft | Kapitel 9 des Admin-Audits vom 26.07.2026 |
| Verwandt | R-ADMIN1 (Fix-Serie), UI-01 dort |
Warum das ein CR ist und kein Fix
R-ADMIN1 behebt Defekte: falsche Texte, kaputte Zahlen, tote Links. Kapitel 9
des Berichts ist etwas anderes — es entwirft eine neue
Informationsarchitektur für den Admin-Bereich: 8 statt rund 28
Navigationspunkte, umbenannte und zusammengelegte Routen, eine Redirect-Map über
etwa 30 URLs. Das ist eine Produktentscheidung mit Migrationsaufwand, kein
Fehlerbehebung. Nach AGENTS.md läuft so etwas über den
Change-Request-Workflow, nicht über ein Fix-Ticket.
Die Analyse dahinter (Kapitel 8, IA-01 bis IA-13) ist als Befundliste in
R-ADMIN1 erfasst und dort einzeln behebbar. Dieses Dokument hält nur den
Gesamtentwurf fest.
Der Entwurf in Kurzform
Acht Top-Level-Bereiche, jeder mit permanent sichtbarer Inner Sidebar (Textlabels, kein Hover, keine Icon-Rail, keine Tabs im Content):
| # | Bereich | Route | fasst zusammen |
|---|---|---|---|
| 1 | Übersicht | / |
heute /dashboard |
| 2 | Kunden | /tenants |
/accounts*, /kwp-contracts |
| 3 | Betrieb | /ops |
/health + /system (Merge), /jobs, /deploys |
| 4 | Plattform | /platform |
/api*, /feature-flags*, /notifications*, /marketing-integrations |
| 5 | Support | /support |
/support*, /select-tenant |
| 6 | Sales | /sales |
eigener Produktbereich, 11 Routen |
| 7 | Sicherheit & Audit | /security |
/audit, /admin-users*, Sessions |
| 8 | Einstellungen | /settings |
Profil, Sicherheit, Plattform, Benachrichtigungen, Sales-Settings |
Dazu zwei Detailvorschläge:
- Mandanten-Detailseite in Tabs statt einer Mega-Seite (Überblick, Abo, Nutzer, Billing, Notizen, Erweitert). Der Abo-Baukasten erhält einen Sticky-Save mit Diff-Anzeige statt 34 einzelner Speichern-Buttons.
- Redirect-Map alt → neu als permanente Weiterleitungen für Bookmarks.
Der vollständige Wortlaut inklusive aller Inner-Sidebar-Listen liegt im
Auditbericht. Die Redirect-Map ist dort abgebrochen (endet in der Zeile für
/sales/...) und müsste vor einer Umsetzung vervollständigt werden.
Konflikte mit dem Bestand — vor einer Entscheidung zu klären
- Mandanten-Identifier in Routen. Der Entwurf schreibt
/tenants/:slug. Heute laufen Routen über IDs;DATA-08zählt drei parallele Schemata (CUID, UUID, Slug). Ein Wechsel auf Slug ist eine eigene Migration mit Eindeutigkeits- und Umbenennungsfragen, nicht ein Routing-Rename. /dashboard→/. Der Admin-Host hat bereits eine Wurzel-Logik (isAdminRootPath, Redirect auf/dashboard). Die Umkehrung berührt Host-Routing und die.__host-Alias-Erzeugung.- Sales als eigener Produktbereich.
IA-11ist berechtigt, aber der Admin-Sales-Workspace ist frisch gebaut (feat/admin-sales-workspace, gemergt am 26.07.). Ein Umbau direkt nach dem Merge sollte bewusst entschieden werden. - Merge
/health+/system. Beide haben eigene Loader, Services und Tests. Der Merge ist sinnvoll (IA-07), aber kein Nebenprodukt. - Bestehende Design-Nachzüge.
D-ADMINist noch offen; eine neue IA würde Davids Screen-Grundlage verschieben.
Empfehlung
Nicht als Ganzes umsetzen, sondern in zwei Stufen trennen:
- Stufe 1 — jetzt sinnvoll, ohne IA-Umbau: die Einzelbefunde
IA-01,IA-02,IA-05,IA-06,IA-09,IA-12ausR-ADMIN1. Kern ist eine Route-Registry als einzige Quelle für Nav-Label, H1,document.titleund Breadcrumb. Damit werden tote Links strukturell unmöglich (IA-03), die Titel-Widersprüche verschwinden, und die Command-Palette speist sich aus derselben Quelle. Das ist ein abgrenzbares Dev-Ticket ohne URL-Änderung. - Stufe 2 — echter CR: die Umbenennung und Zusammenlegung der Routen samt
Redirect-Map. Braucht eine Produktentscheidung, eine vollständige Redirect-Map
und eine Abstimmung mit
D-ADMIN.
UI-01 (fünf Sub-Navigations-Patterns auf eines) lässt sich unabhängig von
Stufe 2 lösen: ein Pattern für alle bestehenden Routen, ohne eine URL zu ändern.
Offene Fragen an Raffael
- Stufe 1 (Route-Registry) als eigenes Dev-Ticket freigeben?
- Soll
UI-01das bestehende Routing behalten oder auf Stufe 2 warten? - Ist der Sales-Bereich als eigenes Produkt gewollt (
IA-11) — und wenn ja, vor oder nach dem v2-Gate?