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

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

  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?