Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/CR-ADMIN-IA.md
T

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?