93 lines
4.6 KiB
Markdown
93 lines
4.6 KiB
Markdown
# 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`](R-ADMIN1.md) (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
|
|
|
|
1. **Mandanten-Identifier in Routen.** Der Entwurf schreibt `/tenants/:slug`.
|
|
Heute laufen Routen über IDs; `DATA-08` zählt drei parallele Schemata (CUID,
|
|
UUID, Slug). Ein Wechsel auf Slug ist eine eigene Migration mit
|
|
Eindeutigkeits- und Umbenennungsfragen, nicht ein Routing-Rename.
|
|
2. **`/dashboard` → `/`.** Der Admin-Host hat bereits eine Wurzel-Logik
|
|
(`isAdminRootPath`, Redirect auf `/dashboard`). Die Umkehrung berührt
|
|
Host-Routing und die `.__host`-Alias-Erzeugung.
|
|
3. **Sales als eigener Produktbereich.** `IA-11` ist 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.
|
|
4. **Merge `/health` + `/system`.** Beide haben eigene Loader, Services und
|
|
Tests. Der Merge ist sinnvoll (`IA-07`), aber kein Nebenprodukt.
|
|
5. **Bestehende Design-Nachzüge.** `D-ADMIN` ist 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-12` aus `R-ADMIN1`. Kern ist eine
|
|
**Route-Registry** als einzige Quelle für Nav-Label, H1, `document.title` und
|
|
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
|
|
|
|
1. Stufe 1 (Route-Registry) als eigenes Dev-Ticket freigeben?
|
|
2. Soll `UI-01` das bestehende Routing behalten oder auf Stufe 2 warten?
|
|
3. Ist der Sales-Bereich als eigenes Produkt gewollt (`IA-11`) — und wenn ja,
|
|
vor oder nach dem v2-Gate?
|