Admin Dashboard — Migration Plan
Status: populated Owner: Platform Engineering (Frontend) Last updated: 2026-04-18
1. Overview
The admin-dashboard is a new service replacing any ad-hoc internal tooling (direct database queries, Postman collections, one-off scripts) used by the operations team.
2. Phases
Phase 1 — Internal Alpha (Sprint 1–2)
- Deploy to
admin-alpha.internal.ghasi.iobehind Cloudflare Access. - Dashboard + operator management pages complete.
- Connects to staging Kong + staging backend services.
- Used by platform engineering team only.
Phase 2 — Operations Handoff (Sprint 3–4)
- Routing rules and message log inspection pages added.
- Ops team onboarded with read-only and read-write admin roles.
- User management page delivered.
- Runbook updated to reference admin dashboard instead of direct API calls.
Phase 3 — Full Operations Coverage
- Billing oversight page.
- System health page replacing direct Grafana links for first-level ops triage.
- Settings page for configuration management.
- All E2E tests green.
3. Parallel Run Period
During Phase 2, ops may still use direct API calls (via Postman/scripts) alongside the dashboard. A sunset date for direct API access from non-service accounts is set for 30 days after Phase 3 GA.
4. Rollback Plan
- Blue/green Kubernetes deployment.
- Ingress annotation switch to previous deployment: < 5 minutes.
- Cookie format changes bump the session schema version; old cookies cleared on first request (force re-login only — acceptable for internal users).
5. Feature Flags
| Flag | Default | Purpose |
|---|---|---|
billing_admin_enabled | false in alpha | Gate billing page until billing-service admin APIs are production-ready |
settings_page_enabled | false | Gate settings page behind flag during ops review |
routing_dnd_enabled | true | Can be disabled if drag-and-drop causes issues in staging |