Manage App
App:
apps/manage· Port: :3003 · Audience: Super admins (platform operators)
The Manage app is the super-admin control panel for the platform itself. It gives the Leadmetrics operations team full visibility and control over all tenants, agent configurations, LLM providers, global skills, billing, and system health.
Status
| Layer | Status |
|---|---|
| Tenant & user management (M1–M6) | [Live] |
| Agent configs, skills, providers, system monitoring (M7–M15) | [To Build] |
Contents
| Doc | What it covers |
|---|---|
| Screens | All Manage screens (M1–M15) |
| Screen Flows | Navigation flows — tenant drill-down, agent config, impersonation |
| Knowledge Base — Screens | KB dataset management screens (KB1–KB6) — full spec for the admin layer |
| Knowledge Base — Flows | KB navigation flows — dataset management, upload, crawl, sandbox |
Key Screens
| ID | Screen | Status |
|---|---|---|
| M1 | All Tenants | [Live] |
| M2 | Tenant Detail | [Live] |
| M3 | All Users | [Live] |
| M4 | All Invoices | [Live] |
| M5 | Email Templates | [Live] |
| M6 | Activity Templates | [Live] |
| M7 | Master Agent Configs | [To Build] |
| M8 | Global Skills Library | [To Build] |
| M9 | LLM Providers | [To Build] |
| M10 | Tenant Agent Overrides | [To Build] |
| M11 | Agent Monitor (live queue view) | [To Build] |
| M12 | Request Queue (all tenants) | [Live] |
| M13 | All Blogs (all tenants) | [Live] |
| M14 | Platform Health | [To Build] |
| M15 | Audit Log | [To Build] |
Knowledge Base Management (Admin Layer)
The Manage app owns the Knowledge Base system configuration. Super admins:
- Create and configure datasets per tenant (embedding model, chunking strategy, parser engine)
- Set website crawler schedules
- Trigger re-index or clear datasets on behalf of a tenant (all actions logged to
audit_logs) - View dataset stats per tenant from the Tenant Detail → Knowledge Base tab
Tenants (via Dashboard) and DM reviewers (via DM Portal) can then upload/remove docs and use the sandbox — but they cannot create or configure new datasets.
See Knowledge Base — Screens for full screen specs (KB1–KB6).
Key Behaviours
- Impersonation — Super admin can impersonate any tenant admin to debug issues (token-scoped, logged)
- Agent config push — Changes to a Master Agent Config can be pushed to all tenants or a subset
- Global skills — Skills defined here are the defaults; tenants can override at their level
- LLM provider management — Set which providers are available per plan tier; manage API key rotation
- Billing — View all invoices, trigger manual billing events, adjust plan limits
Tech
- Framework: Next.js 15 (App Router)
- Auth: JWT (HS256) via
requireSuperAdmin()—super_adminrole required - API prefix:
/admin/v1 - Related API doc: api/admin.md