hermes-skills/skills/devops/ops-portal-and-collector/references/ops-portal-recommendations.md

Generated Jul 9, 2026 by the Network Services Team. Full document at /root/.hermes/references/ops-portal-recommendations.md.

Architecture

Current: Static HTML served by Caddy, reads JSON data file. Read-only. Target: FastAPI backend with auth, action endpoints, audit logging, RBAC.

Strategy: Add action buttons to existing static pages immediately (via helper scripts), while planning the full rebuild.

Pages (13 total)

8 existing + 5 new:

• Dashboard, Servers, Backups, Network, Services, Cron Jobs, Logs, Config
• New: Customer Management, Billing/Finance, Users/RBAC, Audit Log, Settings

Actions per page

Each page should offer actions, not just views:

• Restart a service
• Trigger/restore backups
• Add DNS records
• Reboot routers
• Create customers
• Provision services
• Create tickets

RBAC

• Owner/Admin: everything
• Tech/Support: tickets, server status, service restarts
• Sales/Onboarding: customer activation, provisioning
• Viewer: read-only

Integrations Roadmap

• Connected: SyncroMSP, Cloudflare, Hetzner, netcup, Wasabi, admin-ai
• Pending: RingLogix (phone), Stripe (billing), Xero (accounting), UniFi (API key saved), Hudu, RunCloud

Implementation Phases

1. Action buttons on existing pages, VPN monitor widget
2. Backend development (FastAPI + SQLite for audit)
3. Customer management module
4. RBAC + multi-user support
5. Polish (Grafana dashboards, notifications, mobile)