application public active Verified 2026-04-10

Topolo Admin

Administrative interface for centralized auth, org management, user management, service controls, audit surfaces, and developer-platform review queues.

Documentation Map

What It Is

Administrative interface for centralized auth, org management, user management, service controls, audit surfaces, and developer-platform review queues.

Canonical documentation for Topolo Admin lives in `PlatformApplications/TopoloDocs`.

Use this repository for implementation only. Local product and operational docs have been retired in favor of the docs application.

The backend contract backlog for this app is tracked in:

Architecture

Owners: platform-admin

Source repos: PlatformApplications/TopoloAdmin

Dependencies: topolo-auth

Repo shape

  • PlatformApplications/TopoloAdmin/README.md
  • PlatformApplications/TopoloAdmin/REQUIRED_API_ENDPOINTS.md
  • PlatformApplications/TopoloAdmin/deploy.sh
  • PlatformApplications/TopoloAdmin/docs/
  • PlatformApplications/TopoloAdmin/index.html
  • PlatformApplications/TopoloAdmin/package-lock.json
  • PlatformApplications/TopoloAdmin/package.json
  • PlatformApplications/TopoloAdmin/pnpm-lock.yaml
  • PlatformApplications/TopoloAdmin/postcss.config.js
  • PlatformApplications/TopoloAdmin/public/
  • PlatformApplications/TopoloAdmin/scripts/
  • PlatformApplications/TopoloAdmin/src/
  • PlatformApplications/TopoloAdmin/tailwind.config.js
  • PlatformApplications/TopoloAdmin/test-api.js
  • PlatformApplications/TopoloAdmin/topolo.cloudcontrol.json
  • PlatformApplications/TopoloAdmin/tsconfig.json
  • PlatformApplications/TopoloAdmin/tsconfig.node.json
  • PlatformApplications/TopoloAdmin/vite.config.ts
  • PlatformApplications/TopoloAdmin/wrangler.toml

Runtime Surfaces

Hosts:

https://admin.topolo.app
topoloadmin

Config: PlatformApplications/TopoloAdmin/wrangler.toml

Main: not declared

Routes: workers.dev or asset-only surface

API Reference

Coverage: curated

Source: PlatformApplications/TopoloDocs/src/content/public/applications/admin.mdx

Source exists in repo: yes

Canonical admin coverage now lives in the docs application.

App API page: /reference/apps/topolo-admin

This system currently relies on a curated or README-derived contract surface instead of a source-controlled OpenAPI spec.

Auth and Permissions

Depends on Topolo Auth: yes

Service IDs:

srv_SySYzmlOH5H1

API key scopes

dashboard.read

View admin dashboard and analytics

Resource pattern: none

system.read

View system status and health

Resource pattern: none

system.write

Manage system configuration

Resource pattern: none

billing.read

View billing and subscription info

Resource pattern: none

billing.write

Manage billing and subscriptions

Resource pattern: none

support.read

View support tickets and issues

Resource pattern: none

support.write

Manage support tickets

Resource pattern: none

analytics.read

View operational analytics

Resource pattern: none

users.read

View users

Resource pattern: none

users.write

Create and update users

Resource pattern: none

organizations.read

View organizations

Resource pattern: none

organizations.write

Create and update organizations

Resource pattern: none

services.read

View services

Resource pattern: none

services.write

Create and update services

Resource pattern: none

security.read

View security settings and sessions

Resource pattern: none

security.write

Manage security settings and sessions

Resource pattern: none

branding.read

View login and landing experiences

Resource pattern: none

branding.write

Manage login and landing experiences

Resource pattern: none

developers.read

View developer tooling and submissions

Resource pattern: none

developers.write

Manage developer tooling and submissions

Resource pattern: none

Service permissions

dashboard:read, system:read, system:write, billing:read, billing:write, support:read, support:write, analytics:read, users:read, users:write, organizations:read, organizations:write, services:read, services:write, security:read, security:write, branding:read, branding:write, developers:read, developers:write

Data Ownership

No storage bindings were derived from wrangler configuration.

Queues / Cron / Workflows

Queue bindings:

No queue bindings were detected.

Cron triggers

No cron triggers were detected.

Workflow signals

No explicit queue/workflow script or cron signal was discovered.

Environment Variables and Bindings

Environment variables:

No environment variables were derived from wrangler configuration.

All wrangler bindings

No bindings were derived from wrangler configuration.

Deployments

Deployment environments: default only or not declared

Routes: workers.dev or Pages-only delivery

Observability enabled: no explicit setting found

Wrangler surfaces

  • PlatformApplications/TopoloAdmin/wrangler.toml -> topoloadmin

Build and deploy commands

  • build — PlatformApplications/TopoloAdmin/package.json :: tsc && vite build
  • build:clean — PlatformApplications/TopoloAdmin/package.json :: rm -rf dist && tsc && vite build
  • build:dev — PlatformApplications/TopoloAdmin/package.json :: vite build
  • preview — PlatformApplications/TopoloAdmin/package.json :: vite preview
  • deploy — PlatformApplications/TopoloAdmin/package.json :: echo 'Build output ready in ./dist directory'

Failure Modes

No default failure-mode heuristics are currently flagged for this system.

Debugging Runbooks

Start with these entrypoints:

  • PlatformApplications/TopoloAdmin/wrangler.toml
  • PlatformApplications/TopoloDocs/src/content/public/applications/admin.mdx
  • PlatformApplications/TopoloAdmin/README.md
  • PlatformApplications/TopoloAdmin/package.json

Change Log / Verification

Lifecycle: active

Last verified: 2026-04-10

Any code change to this system is expected to update the canonical docs in PlatformApplications/TopoloDocs and refresh the verification date.