Admin-Panel
Regeln
- Datentabellen: Serverseitige Paginierung, Sortierung und Filterung – niemals alle Zeilen clientseitig laden – verwende
?page=1&limit=25&sort=createdAt&order=desc - CRUD-Muster: Liste (Tabelle), Erstellen (Formular/Modal), Lesen (Detailansicht), Aktualisieren (Bearbeitungsformular), Löschen (Bestätigungsdialog) – einheitliches Layout für alle Ressourcen
- Rollenbasierte Zugriffskontrolle: Rollen definieren (admin, editor, viewer) mit Berechtigungsmatrix – Berechtigungen serverseitig auf jeder API-Route prüfen, nicht nur in der UI
- Bulk-Operationen: Mehrere Zeilen auswählen, Batch-Aktion (Löschen, Exportieren, Status ändern) – destruktive Aktionen bestätigen, bei großen Mengen im Hintergrund verarbeiten
- Suche: Entprellte Textsuche (300 ms) über Schlüsselfelder – mit Spaltenfiltern für präzise Abfragen kombinieren
- Benutzerverwaltung: Benutzer auflisten, Details anzeigen, Rollen ändern, Konten deaktivieren/aktivieren, Identität annehmen (nur Admin mit Audit-Log)
- Audit-Log: Aufzeichnung, wer was wann geändert hat –
{ userId, action, resource, resourceId, changes, timestamp } - Layout: Seitenleisten-Navigation (einklappbar), Breadcrumbs, Seitentitel mit Aktionsschaltflächen – responsiv, aber desktop-optimiert
Berechtigungsprüfungs-Muster
const PERMISSIONS = {
admin: ["users:read", "users:write", "users:delete", "data:read", "data:write", "data:delete"],
editor: ["data:read", "data:write"],
viewer: ["data:read"],
} as const;
function can(role: string, permission: string): boolean {
return PERMISSIONS[role]?.includes(permission) ?? false;
}
// Middleware
if (!can(user.role, "users:write")) return Response.json({ error: "Verboten" }, { status: 403 });
API-Muster für Datentabellen
GET /api/admin/users?page=1&limit=25&sort=createdAt&order=desc&search=john&role=admin
Rückgabe: { data: [...], total: 150, page: 1, limit: 25, totalPages: 6 }
Vermeiden
- Nur clientseitige Berechtigungsprüfungen – immer auf dem Server erzwingen
- Alle Daten laden und dann im Browser paginieren – serverseitige Paginierung verwenden
- Keine Bestätigung für destruktive Aktionen – Lösch- und Bulk-Operationen immer bestätigen
- Fehlender Audit-Trail – du musst wissen, wer was geändert hat