# R-ADMIN1 · Admin-Bereich: Befunde aus dem Staging-Audit vom 26.07.2026 | | | |---|---| | **Typ** | Dev (Fix-Serie) | | **Owner** | Raffael | | **Phase** | Querschnitt · Plattform-Admin | | **Cycle/Fenster** | 26.07.2026 | | **Status** | in Arbeit — 21 von 67 eigenständigen Befunden erledigt (~31 %) | | **Plane** | noch nicht angelegt | | **Branch** | `fix/admin-audit-20260726` (Worktree `HiveGrid-Cloud-fix-admin-audit-20260726`) | ## Was wir bauen Behebung der Befunde eines vollständigen Klick-Audits des Admin-Bereichs auf `staging-admin.hivegrid.de` (erhoben 26.07.2026, Release `b05b69964`, Viewport 1018–1400 px, DE, Super-Admin-Sitzung). Der Auditbericht ist kein Roadmap-Ticket, sondern eine Fehlerliste mit Route, Element und Textstring je Befund. **Quelle:** Auditbericht im Auftrag vom 26.07.2026. Er bricht in Kapitel 5 bei `LAY-09` ab; die Kapitel 6 bis 8 fehlen (`UI-01` verweist auf ein „Kapitel 8"). Was dort steht, ist in diesem Ticket **nicht** abgedeckt. ## Definition of Done ### P0 — Blocker (12/12 erledigt) - [x] **P0-01** Toter Sidebar-Link „Lead-Regeln" (`/sales/settings/leads` → 404) - [x] **P0-02** `NaN €` in der Tarif-Spalte auf `/accounts/subscriptions` - [x] **P0-03** `1/NAN` in der Pagination der drei `/notifications`-Listen - [x] **P0-04** Rohe HTML-Entities (`Europe/Berlin`, `https://`) - [x] **P0-05** Job-IDs in der Wire-Form `…%3A…` auf `/jobs` - [x] **P0-06** Stat-Karten ohne Zahl bei Wert 0 (7 Routen) - [x] **P0-07** Commit-Hash läuft aus der Release-Karte auf `/deploys` - [x] **P0-08** Falscher Seitentitel und Breadcrumb im ganzen `/sales/settings/*`-Zweig - [x] **P0-09** Falscher aktiver Sidebar-Eintrag — **Teil 1 ist kein Defekt** (`/settings/security` ist ein Unterpunkt von „Plattform-Admins", die Hervorhebung ist korrekt). Teil 2 („auf `/settings` kurzzeitig Feature-Flags aktiv") ist im Code nicht reproduzierbar: das Matching ist exakt und segmentweise, ohne Fallback auf die erste Route. Vermutlich ein Übergangszustand während der Navigation, verwandt mit P0-10. - [x] **P0-10** „Details" auf `/jobs` brauchte zwei Klicks - [x] **P0-11** Migrationsstatus las nicht aus der DB; `/system` zeigte leeren Release - [x] **P0-12** Zwei verschiedene 404-Seiten auf demselben Host ### i18n und Copy (5/6 erledigt) - [x] **I18N-01** ASCII-Transliteration in 26 deutschen Strings + CI-Gate - [x] **I18N-02** Rohe Enum-Werte (Support-Status/Priorität/Quelle, Plan-Code, Trial-Badge, Provider-Auswahl) - [x] **I18N-03** Rohe Event-Keys als Checkbox-Label in `/marketing-integrations` - [x] **I18N-04** Deutsch/Englisch-Mix (`Sales Workspace`, `Clients`, `Inbound`, `API Clients`, `Inbound Registrations`, `Failed`) - [ ] **I18N-05** Ansprache uneinheitlich (du/neutral/wir), drei Varianten desselben Begründungstexts — **offen** - [x] **I18N-06** Verwaiste Copy: `/settings`-Subline, „Profil"-Karte, Roadmap-Satz im Feature-Flag-Editor. **Zwei Teile offen** (siehe unten) ### Design-System (0/9 erledigt — offen) - [ ] **UI-01** Fünf Sub-Navigations-Patterns → eines. **Bewusst als eigenes Ticket abgetrennt** (Nutzer-Entscheidung 26.07.): betrifft ~15 Screens und Davids finale Optik, braucht eine Design-Entscheidung statt eines Fixes. - [ ] **UI-02** Zwei PageHeader-Varianten - [ ] **UI-03** Doppelte Breadcrumbs mit unterschiedlichen Wurzeln - [ ] **UI-04** Button-Hierarchie zerfasert, Fremd-Blau neben Marke Gelb/Schwarz - [ ] **UI-05** Zwei EmptyState-Komponenten, sechs Textmuster - [ ] **UI-06** Trend-Semantik falsch (grüner Aufwärtspfeil auf „Kritisch") - [ ] **UI-07** Versalien-Labels nur punktuell - [ ] **UI-08** Icon-Vergabe (Dollar-Icon auf Mail-Kacheln, Doppelbelegungen) - [ ] **UI-09** Pagination: doppelte 10-Option, Accessible Name `11`, zweite Implementierung auf `/audit` ### Layout und Responsive (0/9 erledigt — offen) - [ ] **LAY-01** Badge überlagert Kachel-Überschrift (`/dashboard`, `/accounts/billing`) - [ ] **LAY-02** identisch mit P0-07 — bereits erledigt - [ ] **LAY-03** `Tag anlegen` / `Feld anlegen` abgeschnitten - [ ] **LAY-04** Vor- und Nachname überlappen in `/accounts/new` - [ ] **LAY-05** `Override speichern` rechts abgeschnitten - [ ] **LAY-06** Tabellenköpfe überlappen in `/sales/settings/pipelines` - [ ] **LAY-07** `break-all` zerlegt Wörter auf `/jobs` unter 1130 px - [ ] **LAY-08** Spalten ohne Ellipse, `/audit`-Filterblock 450 px hoch - [ ] **LAY-09** Ungruppierte Abo-Historie in einer Zelle bei „RheinMain Gebäudetechnik" (neun Zeilen Plan/Beendet-am ohne Gruppierung). Der Bericht bricht mitten in diesem Befund ab; die Beschreibung ist unvollständig. - [ ] **LAY-09b** Spaltenbreiten auf `/accounts`: die ID-Spalte (25-stellige CUID) frisst die Breite, die Plan-Spalte wird gequetscht. Trägt in Teil 2 dieselbe Nummer wie LAY-09, ist aber ein anderer Befund. - [ ] **LAY-10** Horizontaler Scroll auf Seiten- statt Tabellenebene, dadurch scrollen Seitenkopf und Filterleiste mit weg (`/audit`, `/accounts`, `/api/logs`, `/accounts/subscriptions`, `/jobs`) - [ ] **LAY-11** Icon-Rail als Sub-Navigation auf `/feature-flags` — steckt in UI-01 - [ ] **LAY-12** `/accounts/:id` ist eine Mega-Seite: 34 Feature-Zeilen mit **je eigenem Speichern-Button**, kein Dirty-State, Gefahrenbereich erst nach langem Scroll erreichbar - [ ] **LAY-13** `/select-tenant` bricht die Admin-Shell (H1 doppelt, Versalien-Label) ### Barrierefreiheit — Kapitel 6 des Berichts (0/10 erledigt) - [ ] **A11Y-01** Glocken-Icon im Header ist ein toter Link. **Verifiziert:** `SubframeAppShell` setzt `href={params.tenant ? … : "#"}`; im Admin gibt es keinen Tenant-Parameter, also zeigt der Link immer auf `#`. Ziel: `/notifications`. - [ ] **A11Y-02** Karten-Links ohne Accessible Name (`/dashboard`, `/support`, `/accounts/billing`) - [ ] **A11Y-03** Verschachtelte interaktive Elemente (`a > button`) — dieselbe Ursache wie P0-10, dort für `/jobs` behoben, an sechs weiteren Stellen offen - [ ] **A11Y-04** Formularfelder auf `/admin-users` ohne `for`/`id`-Verknüpfung - [ ] **A11Y-05** Icon-only Submit-Buttons ohne `aria-label` (`/audit`, `/api/logs`, `/admin-users`) - [ ] **A11Y-06** Modal-Close ohne Namen, Focus-Trap und `Esc` ungeprüft (Job-Detail) - [ ] **A11Y-07** Pagination-Accessible-Name `11` — identisch mit UI-09 - [ ] **A11Y-08** Status nur über Farbe (`/notifications/channels`, `/health`, `/deploys`, Trendpfeile) - [ ] **A11Y-09** Hover-only Navigation (Feature-Flags-Icon-Rail) — steckt in UI-01 - [ ] **A11Y-10** Sidebar ohne Gruppen-Semantik (~30 Einträge ohne `role="group"`/`aria-labelledby`) ### Daten und Konsistenz — Kapitel 7 des Berichts (0/14 erledigt) - [ ] **DATA-01** Derselbe Mandant zeigt drei Tarif-Wahrheiten: `/accounts` „Business", `/accounts/billing` `business` + Badge `Trial`, `/accounts/:id` „Plan: Keine" + `Aktiv` + `trial`. **Wichtigster Befund aus Teil 2.** - [ ] **DATA-02** Plan ist ein Freitextfeld (Placeholder `z. B. starter`) — Ursache von DATA-01 - [ ] **DATA-03** Feature-Flag-Zähler widersprechen sich (Übersicht „2/2" vs. Liste „Alle (1)") - [ ] **DATA-04** Flag-Name identisch mit Flag-Key - [ ] **DATA-05** `NaN` und flächendeckend „Nicht verfügbar" auf `/accounts/subscriptions` — `NaN`-Teil mit P0-02 behoben, die leeren Zeitraum-Spalten sind offen - [ ] **DATA-06** Audit-Akteur mischt Typen (Text `Admin` vs. rohe CUID) - [ ] **DATA-07** Rohe technische IDs im UI (Rechnungs-Objekt-ID, Admin-ID, roher User-Agent) - [ ] **DATA-08** Drei ID-Schemata für Mandanten in Routen (CUID, UUID, Slug) - [ ] **DATA-09** Identische Initialen-Avatare auf `/select-tenant` - [ ] **DATA-10** Identische Zeitstempel für Erstellt/Verarbeitet/Beendet im Job-Modal - [ ] **DATA-11** Interne Pfade und Stacktraces ungefiltert im Job-Modal (`file:///myapp/…`) - [ ] **DATA-12** `/health` zeigt „Branch: unknown", leere Kritisch-/Unklar-Kacheln — Kachel-Teil mit P0-06 behoben, Build-Metadaten offen - [ ] **DATA-13** Seed-/Provider-Namen leaken („Hallo authentik", „authentik Default Admin", Zeile ohne Rollen-Badge, dauerhaft deaktivierter Button „Admin vorbereiten") - [ ] **DATA-14** Rollen-Terminologie dreifach („Superadmin", „Superbenutzer", „Super Admin") ### Informationsarchitektur — Kapitel 8 des Berichts (0/13 erledigt) - [ ] **IA-01** Label ≠ Route ≠ H1 ≠ `document.title` ≠ Breadcrumb (Tabelle mit 7 Beispielen) - [ ] **IA-02** `document.title` uneinheitlich — für `/sales/settings/*` mit P0-08 behoben, die übrigen Zweige offen - [ ] **IA-03** Tote Route in der Sidebar — identisch mit P0-01, behoben - [ ] **IA-04** ~30 Top-Level-Einträge, Sidebar-Scrollposition resettet bei jeder Navigation - [ ] **IA-05** 17 Routen nur über Karten oder Command-Palette erreichbar - [ ] **IA-06** Command-Palette kennt eine Hierarchie, die die Sidebar nicht hat; 8 Einträge, nicht scrollbar, keine Volltextsuche - [ ] **IA-07** Doppelte Wahrheiten: `/health` + `/system`, zwei Audit-Views, Telefonie-Settings zweimal, `/sales/contacts` vs. `/sales/companies`, drei Links auf `/accounts/billing` (einer als „Events öffnen") - [ ] **IA-08** Geschwister-Seiten mit unterschiedlichem Funktionsumfang - [ ] **IA-09** Falsche Gruppenzuordnung („Import und Export" unter Sales-Einstellungen) - [ ] **IA-10** `/kwp-contracts` auf Top-Level, unverständlicher Beschreibungstext - [ ] **IA-11** Zwei Produkte in einer Navigation (11 Sales-Routen im Plattform-Admin) - [ ] **IA-12** Breadcrumb-Wurzel „Helpdesk" ohne Gegenstück in der Admin-Navigation. *Präzisierung:* der Begriff existiert als Sidebar-Label der Mandanten-App; im Admin heißt der Eintrag „Support". Der Kern des Befunds bleibt gültig. - [ ] **IA-13** Einstellungen über fünf Orte verstreut ## Herkunft und Grenzen der Befundliste Der Bericht kam in zwei Teilen und ist **in beiden Teilen abgebrochen**; der erhebende Agent steht nicht mehr zur Verfügung, es kommt nichts nach. **Was fehlt:** - Das Ende von `LAY-09` in der Fassung aus Teil 1 (ungruppierte Abo-Historie bei „RheinMain Gebäudetechnik"). Teil 2 führt unter derselben Nummer einen **anderen** Befund (Spaltenbreiten und horizontaler Scroll) — beide sind hier als `LAY-09` und `LAY-09b` geführt. - **Kapitel 10 bis 13.** Die Überschrift von Teil 2 kündigt sie an, geliefert ist bis Kapitel 9.4; die Redirect-Map bricht mitten in einer Zeile ab. Der Inhalt ist unbekannt und wird **nicht rekonstruiert**. - Die Kapitelnummerierung ist zwischen den Teilen verrutscht: Teil 1 verweist für das Navigations-Pattern auf „Kapitel 8", dort steht in Teil 2 die IA-Kritik. **Was der Audit methodisch nicht abgedeckt hat** (unabhängig vom Abbruch, aus dem Kopf des Berichts selbst ableitbar): 1. **Kein Mobile.** Erhoben nur bei 1018–1400 px. HiveGrid ist PWA-only (AD-17) mit mobile-first Monteur-Sichten; unter 768 px existiert kein einziger Befund. 2. **Nur eine Rolle.** Alles als Super-Admin. Ob berechtigungsabhängige Einträge für schwächere Rollen ins 404 führen — der Fehlertyp aus P0-01 — ist ungeprüft. 3. **Keine Messung.** Ladezeit, Bundle-Größe und echte Screenreader-Ausgabe sind nicht Teil des Berichts. Diese drei Lücken werden nicht durch einen neuen Fließtext-Audit geschlossen, sondern über die vorhandenen wiederholbaren Gates (`verify:a11y-coverage`, Playwright + axe, Lighthouse, `docs/route-inventory.md`). ## Umsetzungs-Notiz **2026-07-26 — 21 von 36 Befunden erledigt (~58 %), davon P0 vollständig.** Drei Commits auf `fix/admin-audit-20260726`: | Commit | Inhalt | |---|---| | `178c28961` | P0-01, P0-02, P0-03, P0-04, P0-05, P0-06, P0-08, P0-12 | | `9398d1826` | P0-07, P0-10, P0-11 | | `ea88bc139` | I18N-01, I18N-02, I18N-03, I18N-04, I18N-06 (teilweise) | Jeder Befund ist an der Ursache behoben, nicht pro Route: - **P0-04** lag nicht an den zwei gemeldeten Strings, sondern an `i18nConfig`: i18next escapte Interpolationswerte, obwohl React jeden Textknoten selbst escaped. Jeder Wert mit Slash war betroffen. Fix in `packages/i18n/src/index.ts`. - **P0-02** entsteht, weil `SubscriptionPrice.price` ein Prisma-`Decimal` ist und die Loader-Serialisierung es als Objekt überträgt; `Number(...)` ergibt `NaN`. `/accounts` war unauffällig, weil dort ein Service serverseitig konvertiert. Fix: Normalisierung im Loader plus `—`-Fallback in den Formattern. - **P0-06** lag an den generierten Subframe-Guards `{value ? … : null}`, die die Zahl 0 verwerfen. Ein Fix in `app/ui/components/StatsCard` deckt alle sieben gemeldeten Routen ab (sync-disable + Eintrag in `docs/subframe/COMPONENT-MAPPING.md`). - **P0-01** war ein fehlender globaler Rollout-Datensatz. Mit CR-007 sind die fertigen Admin-Sales-Routen standardmäßig aktiv; AdminUser, Permissions und Own-/All-RLS bleiben die einzigen Zugriffsgates. - **P0-11** war ein Rechteproblem: `_prisma_migrations` hat seit dem RLS-Cutover keinen GRANT für `hivegrid_app`. Neue Migration `20260726190000_grant_app_migration_history_read` mit spaltenweisem SELECT und Inverse-SQL als Kommentar, plus ein Log, das die Ursache künftig sichtbar macht. - **P0-05** ist bewusst nur zur Hälfte umgesetzt: die Anzeige zeigt die ID dekodiert, der Detail-Link behält die Wire-ID. Eine Rückabbildung im Link wäre für Keys mit `%` mehrdeutig. Der Bericht sah `%253A` im Link als Fehler; das ist korrektes einmaliges URL-Encoding einer ID, die selbst `%3A` enthält. **Nebenbefund außerhalb des Berichts:** `toBullMqJobId` ist nicht bijektiv — die Keys `42` und `job-42` erzeugen beide die Job-ID `job-42`. Zwei verschiedene Idempotenzkeys könnten damit als Duplikat gelten. Praktisch unwahrscheinlich, aber dokumentiert und per Test festgehalten (`packages/queue/src/job-id.test.ts`). **Test-Proof (lokal grün):** `pnpm typecheck`, `pnpm lint`, `pnpm run verify:ui-visual` (130 passed, 14 observed, 0 failed), `pnpm run test:hot-swap`, `pnpm run verify:i18n` (Parität 14.549 Keys über 9 Namespaces + neuer Diakritika-Check), Admin-Suite `apps/web/app/components/screens/admin` + `apps/web/app/routes/admin` (315 Tests). Neue Tests: 8 Dateien mit 46 Fällen. **Interim-Baselines:** `ak-p19-interim.visual.test.tsx` und `platform-leads-interim.visual.test.tsx` wurden nachgezogen (AD-28). Beide Diffs wurden vor dem Update Zeichen für Zeichen geprüft: ausschließlich die neu sichtbaren Nullen und die neuen Label-Werte, keine Layout-Änderung. ## Dev-Nachzug - **UI-01** (fünf Nav-Patterns → eines) ist auf Nutzerwunsch ein eigenes Ticket. Empfehlung des Berichts: permanent sichtbare Inner-Sidebar mit Textlabels. Betrifft `/api`, `/notifications`, `/support`, `/feature-flags`, `/sales/calls`, `/sales/bookings`, `/sales/email` und zieht neue Visual-Baselines nach. - **I18N-06, zwei Reste:** `settings.tenant.generalDescription` („Aktualisiere deine Kontoeinstellungen" über einem fremden Mandanten) und `search.command.placeholder` (bietet im Admin Projekte und Dateien an) sind mit der Tenant-App geteilt. Beide brauchen eine kontextabhängige Komponente, keine Textänderung, sonst bricht die Tenant-Seite. - **P0-09 Teil 2 und P0-10 (weitere Stellen):** Das Muster `