Bedrud implementiert ein 5-stufiges Rollensystem zur Zugriffskontrolle. Jede Rolle ist einem Satz von Zugriffszeichenfolgen zugeordnet, die im Benutzerdatensatz gespeichert und sowohl auf der API-Ebene (Backend-Middleware) als auch auf der UI-Ebene (Frontend-Guards und bedingte Darstellung) durchgesetzt werden.

Rollenhierarchie

Backend-Durchsetzung

Zugriffsebenen werden über die RequireAccess-Middleware auf jeder Admin-Route durchgesetzt. Die Middleware prüft das Zugriffsarray des Benutzers gegen die mindestens erforderliche Stufe:

• Routen, die superadmin-Zugriff erfordern, lehnen Admin, Moderator, Benutzer und Gast ab
• Routen, die admin-Zugriff erfordern, erlauben Superadmin und Admin
• Routen, die moderator-Zugriff erfordern, erlauben Superadmin, Admin und Moderator

Das Backend speichert Zugriffe als kommagetrennte Zeichenfolge in der Datenbank (Spalte accesses in der Tabelle users). Der GORM-Typ StringArray übernimmt die Serialisierung und Deserialisierung.

Frontend-Integration

Benutzertyp

Das User-Interface in user.store.ts enthält zwei boolesche Felder, die aus dem Zugriffsarray abgeleitet werden:

interface User {
  // ...
  isSuperAdmin: boolean  // accesses.includes('superadmin')
  isAdmin: boolean       // accesses.includes('admin') || accesses.includes('superadmin')
  accesses: string[]     // raw access list from backend
}

Admin-Guard

Das Admin-Layout (/dashboard/admin) lässt Superadmin, Admin und Moderator durch. Moderatoren erhalten eine Kontextvariable isReadOnly=true:

// routes/dashboard/admin.tsx
const canAccess = user?.isSuperAdmin || accesses.includes('admin') || accesses.includes('moderator')

Der useAdminContext()-Hook stellt das isReadOnly-Flag allen untergeordneten Routen zur Verfügung:

const { isReadOnly } = useAdminContext()

Was Moderatoren sehen vs. tun können

Rollenauswahl

Die Admin-Oberfläche bietet ein <Select>-Dropdown sowohl in der Benutzerlistentabelle als auch auf der Benutzerdetailseite, das den vorherigen binären Superadmin-Umschalter ersetzt. Verfügbare Optionen:

Das Dropdown sendet eine PUT /api/admin/users/:id/accesses-Anfrage mit dem vollständigen Zugriffsarray.

CLI-Verwaltung

Die Befehle bedrud user promote und bedrud user demote akzeptieren ein --role-Flag:

# Promote to superadmin (default)
bedrud user promote --email user@example.com
 
# Promote to admin
bedrud user promote --email user@example.com --role admin
 
# Promote to moderator
bedrud user promote --email user@example.com --role moderator
 
# Demote specific role
bedrud user demote --email user@example.com --role admin

Gültige --role-Werte: superadmin, admin, moderator, user, guest.

Code-Standorte