aquilia-admin-dashboard-ops - SKILL.md Agent Skill

name: aquilia-admin-dashboard-ops description: "Build and operate Aquilia admin dashboard features. Use for AdminIntegration, AdminModules, admin templates/controllers/security/audit/users/permissions/monitoring/storage/tasks/provider pages, and aq admin commands."

Aquilia Admin Dashboard Ops

Purpose

Configure and extend the built-in Aquilia admin dashboard and admin CLI operations.

Trigger Conditions

Use for admin dashboard setup, admin pages, users/staff/superuser management, audit logs, permissions, monitoring, storage/tasks/mail admin modules, and aq admin commands.

Inputs

Admin site title, enabled modules, security settings, database URL, user credentials, and page/module requirements.
Whether operation is interactive or non-interactive.

Execution Flow

Add AdminIntegration(...) to workspace and configure AdminModules for enabled areas.
Use admin CLI: aq admin check, createsuperuser, createstaff, listusers, changepassword, setup, status, and audit.
Extend templates/controllers using existing admin registry, permissions, hooks, widgets, and audit models.
Keep admin pages backed by implemented services and templates under aquilia/admin/.
Test admin behavior with admin tests and example admin app.

Constraints

Admin authentication/authorization must use existing admin security and permissions paths.
Do not store plaintext passwords; use Aquilia password hashing paths.
Interactive commands have prompt validation; non-interactive mode must provide required values.

Implementation Anchors

aquilia/admin/, aquilia/integrations/admin.py, aquilia/cli/__main__.py admin section, tests/test_admin*.py, examples/admin_dashboard_app/.

Examples

.integrate(AdminIntegration(site_title="Commerce Admin", modules=AdminModules(audit=True, monitoring=True))).
Run aq admin setup -y --database-url sqlite:///db.sqlite3.
Add a custom admin view by following admin/controller.py and templates conventions.

Failure Handling

If admin pages are forbidden, inspect permissions and session/auth state. If setup fails, verify DB connectivity and migrations. If audit output is empty, confirm audit integration and table creation.