Feature: Add comprehensive admin dashboard #87

Closed
opened 2026-08-17 10:24:06 +00:00 by nasandre · 1 comment
Owner

Feature Request

Status: LOW PRIORITY
Priority: Low
Component: UI/UX

Description

Implement a comprehensive admin dashboard for site administrators to monitor and manage the application.

Required Features

  1. User Management

    • View all users
    • Create/edit/delete users
    • View user roles and permissions
    • Reset user passwords
  2. Character Overview

    • Total character count
    • Characters by user
    • Recent character creations
    • Character activity trends
  3. Party Management

    • Total party count
    • Party composition
    • Recent party activity
    • Party conflicts or issues
  4. System Health

    • Database connection status
    • Storage mode (JSON vs PostgreSQL)
    • Memory usage
    • API uptime
  5. Homebrew Content

    • Total homebrew items
    • Content by type
    • Recent additions
    • Popular homebrew
  6. Audit Log

    • View recent system-wide actions
    • Search audit logs
    • Filter by user, action, date
  7. Settings

    • Site configuration
    • Feature toggles
    • Database settings
    • MCP configuration
## Feature Request **Status:** LOW PRIORITY **Priority:** Low **Component:** UI/UX ### Description Implement a comprehensive admin dashboard for site administrators to monitor and manage the application. ### Required Features 1. **User Management** - View all users - Create/edit/delete users - View user roles and permissions - Reset user passwords 2. **Character Overview** - Total character count - Characters by user - Recent character creations - Character activity trends 3. **Party Management** - Total party count - Party composition - Recent party activity - Party conflicts or issues 4. **System Health** - Database connection status - Storage mode (JSON vs PostgreSQL) - Memory usage - API uptime 5. **Homebrew Content** - Total homebrew items - Content by type - Recent additions - Popular homebrew 6. **Audit Log** - View recent system-wide actions - Search audit logs - Filter by user, action, date 7. **Settings** - Site configuration - Feature toggles - Database settings - MCP configuration
Owner

Automated triage (openclaw monitor):

Diagnosis

No admin dashboard exists. Existing endpoints support required features but lack UI:

  • User/role management via /api/users/* and /api/roles/* (backend/src/routes/users.ts, roles.ts)
  • Character/party data via /api/characters/* and /api/parties/* (backend/src/routes/characters.ts, parties.ts)
  • Homebrew CRUD via /api/homebrew/* (backend/src/routes/homebrew.ts)
  • Settings via /api/settings (backend/src/routes/settings.ts)
  • System health via /api/mcp/status and database config (backend/src/config/database.ts)
  • Missing: audit logging and consolidated overview endpoints

Possible fix

  1. Backend (backend/src/routes/admin.ts):

    • Aggregate endpoints for dashboard stats using existing services
    • Add audit log service (backend/src/services/auditService.ts)
    • Add system health aggregator using /api/mcp/status and database checks
  2. Frontend (frontend/src/pages/admin/):

    • Create admin layout with sidebar (reuse existing auth context)
    • Implement 7 feature sections as separate pages:
      • User management → reuse existing user/role UI patterns
      • Character overview → query /api/characters with filters
      • Party management → query /api/parties
      • System health → call /api/mcp/status and database checks
      • Homebrew content → query /api/homebrew
      • Audit log → new /api/admin/audit endpoint
      • Settings → extend /api/settings with admin fields
  3. Routing: Add /admin/* routes in frontend router

Notes / Questions

  • Is there an existing admin role/permission system, or should we add one?
  • Is audit logging already implemented, or should we add backend/src/services/auditService.ts?
  • Should the dashboard use existing UI components or new designs?
  • Confirm database type (JSON vs PostgreSQL from issue #87 context) for health checks
Automated triage (openclaw monitor): <!-- triage --> ## Diagnosis No admin dashboard exists. Existing endpoints support required features but lack UI: - User/role management via `/api/users/*` and `/api/roles/*` (backend/src/routes/users.ts, roles.ts) - Character/party data via `/api/characters/*` and `/api/parties/*` (backend/src/routes/characters.ts, parties.ts) - Homebrew CRUD via `/api/homebrew/*` (backend/src/routes/homebrew.ts) - Settings via `/api/settings` (backend/src/routes/settings.ts) - System health via `/api/mcp/status` and database config (backend/src/config/database.ts) - Missing: audit logging and consolidated overview endpoints ## Possible fix 1. **Backend** (`backend/src/routes/admin.ts`): - Aggregate endpoints for dashboard stats using existing services - Add audit log service (`backend/src/services/auditService.ts`) - Add system health aggregator using `/api/mcp/status` and database checks 2. **Frontend** (`frontend/src/pages/admin/`): - Create admin layout with sidebar (reuse existing auth context) - Implement 7 feature sections as separate pages: - User management → reuse existing user/role UI patterns - Character overview → query `/api/characters` with filters - Party management → query `/api/parties` - System health → call `/api/mcp/status` and database checks - Homebrew content → query `/api/homebrew` - Audit log → new `/api/admin/audit` endpoint - Settings → extend `/api/settings` with admin fields 3. **Routing**: Add `/admin/*` routes in frontend router ## Notes / Questions - Is there an existing admin role/permission system, or should we add one? - Is audit logging already implemented, or should we add `backend/src/services/auditService.ts`? - Should the dashboard use existing UI components or new designs? - Confirm database type (JSON vs PostgreSQL from issue #87 context) for health checks
Sign in to join this conversation.
No labels
No milestone
No project
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
nasandre/dnd-character-generator#87
No description provided.