Features

This chapter covers the core features and capabilities of Admin Panel.

Features

• CRUD generator — Register any data model and get full create/read/update/delete endpoints and HTML forms
• User management — List, create, disable, reset passwords, assign roles
• Role-based access — Admin, editor, viewer roles with per-resource permission checks
• System settings — Key-value settings store with typed values and change tracking
• Audit log — Every admin action recorded with actor, action, resource, and timestamp
• Search & pagination — Built-in search across any registered model with paginated results
• HTML dashboard — Server-rendered admin interface with navigation, tables, forms, and flash messages
• JSON API — Every operation also available via JSON API for programmatic access
• Data export — Export any model's data as JSON

Requirements

• Python 3.10+
• No external dependencies (stdlib only)

Quick Start

Follow this guide to get Admin Panel up and running in your environment.

Quick Start

python src/main.py --init-demo

# List all users
curl http://localhost:8007/api/users

# Create a user
curl -X POST http://localhost:8007/api/users \
  -H "Content-Type: application/json" \
  -d '{"username": "newuser", "email": "newuser@example.com", "role": "editor"}'

# Get system settings
curl http://localhost:8007/api/settings

# Update a setting
curl -X PUT http://localhost:8007/api/settings/site_name \
  -H "Content-Type: application/json" \
  -d '{"value": "My SaaS App"}'

# View audit log
curl http://localhost:8007/api/audit-log

# CRUD: list registered models
curl http://localhost:8007/api/models

# CRUD: list records for a model
curl http://localhost:8007/api/crud/projects

# CRUD: create a record
curl -X POST http://localhost:8007/api/crud/projects \
  -H "Content-Type: application/json" \
  -d '{"name": "New Project", "status": "active"}'

# Open the HTML admin panel in your browser
open http://localhost:8007/admin

API Endpoints