application · active
Topolo Admin

Administrative interface for centralized auth, org management, org-scoped role and user-access management, app-centric service assignment, support-facing personal and service-local identity visibility, household-connection context, org billing preview, service controls, audit surfaces, and cross-app handoff into other internal operator tools.
Documentation map

Topolo Admin — Public overview of the administrative interface used for org, user, service, and audit management across the Topolo platform.
Authority and runtime

System ID: topolo-admin
App IDs: app_topolo_admin
Owners: platform-admin
Repositories: apps/TopoloAdmin
Hosts: https://admin.topolo.app, https://admin.topolo.dev, https://admin.stg.topolo.us
Dependencies: topolo-auth, applications-packages
Security and data ownership

Risk tier: critical
Tenant isolation: platform_admin
Privacy classification: confidential
Storage: none
Export and deletion: not_applicable
Enterprise ready: yes
Source-derived capability inventory

Source revisions: apps/TopoloAdmin@78b98e22ab49d3ed3bbb72420eeb68d4a4264134
Declared actions: 1 · API routes: 3 · UI routes: 35
{
  "id": "topolo-admin",
  "name": "Topolo Admin",
  "slug": "topolo-admin",
  "kind": "application",
  "visibility": "public",
  "repo_paths": [
    "apps/TopoloAdmin"
  ],
  "source_revisions": [
    {
      "source_path": "apps/TopoloAdmin",
      "repository": "apps/TopoloAdmin",
      "revision": "78b98e22ab49d3ed3bbb72420eeb68d4a4264134",
      "ref": "origin/staging"
    }
  ],
  "source_counts": {
    "source_files": 154,
    "test_files": 57,
    "test_cases": 0,
    "migration_files": 0,
    "database_tables": 0,
    "manifests": 1,
    "deploy_targets": 2,
    "actions": 1,
    "mobile_contracts": 1,
    "notifications": 0,
    "package_manifests": 3,
    "deployment_configs": 0
  },
  "manifests": [
    {
      "source_path": "apps/TopoloAdmin/topolo.app.json",
      "service_slug": "topolo-admin",
      "name": "topolo-admin",
      "app_id": "app_topolo_admin",
      "compatibility_date": "2026-04-10",
      "primary_target": "web",
      "environments": [
        "development",
        "production",
        "staging"
      ],
      "targets": [
        {
          "name": "api",
          "kind": "worker",
          "directory": "apps/api",
          "main": "src/worker.ts",
          "worker_name": "topolo-admin-api",
          "subdomain": null,
          "healthcheck_path": "/api/health",
          "variable_names": [
            "AUTH_API_URL"
          ],
          "secret_names": [],
          "bindings": []
        },
        {
          "name": "web",
          "kind": "worker",
          "directory": "apps/web",
          "main": "src/worker.ts",
          "worker_name": "topolo-admin",
          "subdomain": "admin",
          "healthcheck_path": "/api/health",
          "variable_names": [
            "AUTH_API_URL",
            "INSIGHTS_SITE_KEY"
          ],
          "secret_names": [],
          "bindings": [
            {
              "kind": "services",
              "binding": "API",
              "target": null
            }
          ]
        }
      ],
      "notifications": [],
      "notification_contract": {
        "source_path": null,
        "role": "consumer_only",
        "schema_version": null,
        "owner_app_id": null,
        "events": []
      },
      "actions": [
        {
          "name": "widget.get",
          "title": "Get Admin widget",
          "description": "Get the TopoloOne widget summary for Admin.",
          "method": "GET",
          "path": "/api/widget",
          "permission": "dashboard:read",
          "authorizationMode": "runtime",
          "readOnly": true,
          "inputSchema": {
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "type": "object",
            "properties": {},
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "additionalProperties": true
          },
          "target": "api",
          "destructive": false,
          "requiresConfirmation": false,
          "agentAccess": "auto",
          "documentation": {
            "example_input": {},
            "cli_example": [
              "topolo actions --service topolo-admin --json",
              "topolo actions get <action-id> --json",
              "topolo actions validate <action-id> --data @payload.json --json",
              "topolo actions plan <action-id> --data @payload.json --json",
              "topolo actions call <action-id> --data @payload.json --json"
            ],
            "http_example": {
              "method": "GET",
              "path": "/api/widget",
              "body": null
            },
            "effects": "Reads state through GET /api/widget without a declared mutation.",
            "verification": [
              "Check the structured action result and pagination or resource identifiers before using it downstream."
            ],
            "recovery": [
              "Correct identity, resource context, permission, or input validation failures, then retry the read."
            ],
            "docs_url": null,
            "resource": null,
            "next_action_ids": [],
            "rollback_action_id": null
          },
          "implementation": {
            "status": "implemented",
            "route_key": "GET /api/widget",
            "evidence": "Matched to a served route extracted from canonical staging source."
          }
        }
      ],
      "action_coverage": {
        "status": "ok",
        "served_routes": 2,
        "matched_actions": 1,
        "declared_unserved_actions": [],
        "coverage_excluded_actions": [],
        "uncatalogued_routes": [],
        "ignored_routes": 1,
        "configured_exclusions": 0,
        "configuration_findings": [],
        "notes": []
      },
      "runtime_contract_audit": {
        "status": "verified",
        "actions": 1,
        "contracts": 1,
        "contract_module": "topolo.action-contracts.mjs",
        "validator_sources": [
          "apps/api/src/worker.ts"
        ],
        "authorization_sources": [
          "apps/api/src/worker.ts"
        ],
        "findings": []
      }
    }
  ],
  "mobile_contracts": [
    {
      "source_path": "apps/TopoloAdmin/topolo.mobile-experience.json",
      "contract": {
        "version": "2026-07-03",
        "status": "approved",
        "mode": "web",
        "webOnly": true,
        "appId": "app_topolo_admin",
        "localizationNamespace": "admin",
        "fallbackPath": "/dashboard",
        "notes": "TopoloAdmin is the platform-operator admin console (users, organizations, services, pricing, audit logs, security, bugfix queue). It is a dense, desktop-only management surface with no first-class mobile use case; it deliberately does not ship a native dynamic-app experience. webOnly opts it out of the TopoloOne native shell while keeping it web-accessible."
      }
    }
  ],
  "package_manifests": [],
  "deployment_configs": [],
  "source_signals": {
    "api_routes": [
      {
        "method": "LITERAL",
        "path": "/api/widget",
        "source_path": "apps/TopoloAdmin/apps/api/src/widget.ts"
      },
      {
        "method": "GET",
        "path": "/api/health",
        "source_path": "apps/TopoloAdmin/apps/api/src/worker.ts"
      },
      {
        "method": "GET",
        "path": "/api/widget",
        "source_path": "apps/TopoloAdmin/apps/api/src/worker.ts"
      }
    ],
    "ui_routes": [
      {
        "path": "/dashboard",
        "source_path": "apps/TopoloAdmin/apps/web/src/App.tsx"
      },
      {
        "path": "/users",
        "source_path": "apps/TopoloAdmin/apps/web/src/App.tsx"
      },
      {
        "path": "/users/add",
        "source_path": "apps/TopoloAdmin/apps/web/src/App.tsx"
      },
      {
        "path": "/users/:id",
        "source_path": "apps/TopoloAdmin/apps/web/src/App.tsx"
      },
      {
        "path": "/users/:id/edit",
        "source_path": "apps/TopoloAdmin/apps/web/src/App.tsx"
      },
      {
        "path": "/organizations",
        "source_path": "apps/TopoloAdmin/apps/web/src/App.tsx"
      },
      {
        "path": "/organizations/add",
        "source_path": "apps/TopoloAdmin/apps/web/src/App.tsx"
      },
      {
        "path": "/organizations/:id",
        "source_path": "apps/TopoloAdmin/apps/web/src/App.tsx"
      },
      {
        "path": "/organizations/:id/edit",
        "source_path": "apps/TopoloAdmin/apps/web/src/App.tsx"
      },
      {
        "path": "/organizations/:organizationId/services/add",
        "source_path": "apps/TopoloAdmin/apps/web/src/App.tsx"
      },
      {
        "path": "/organizations/:organizationId/services/:relationshipId",
        "source_path": "apps/TopoloAdmin/apps/web/src/App.tsx"
      },
      {
        "path": "/organizations/:organizationId/services/:relationshipId/edit",
        "source_path": "apps/TopoloAdmin/apps/web/src/App.tsx"
      },
      {
        "path": "/services",
        "source_path": "apps/TopoloAdmin/apps/web/src/App.tsx"
      },
      {
        "path": "/services/add",
        "source_path": "apps/TopoloAdmin/apps/web/src/App.tsx"
      },
      {
        "path": "/services/:id",
        "source_path": "apps/TopoloAdmin/apps/web/src/App.tsx"
      },
      {
        "path": "/services/:id/edit",
        "source_path": "apps/TopoloAdmin/apps/web/src/App.tsx"
      },
      {
        "path": "/developers",
        "source_path": "apps/TopoloAdmin/apps/web/src/App.tsx"
      },
      {
        "path": "/app-submissions",
        "source_path": "apps/TopoloAdmin/apps/web/src/App.tsx"
      },
      {
        "path": "/developer-requests",
        "source_path": "apps/TopoloAdmin/apps/web/src/App.tsx"
      },
      {
        "path": "/support",
        "source_path": "apps/TopoloAdmin/apps/web/src/App.tsx"
      },
      {
        "path": "/analytics",
        "source_path": "apps/TopoloAdmin/apps/web/src/App.tsx"
      },
      {
        "path": "/capacity",
        "source_path": "apps/TopoloAdmin/apps/web/src/App.tsx"
      },
      {
        "path": "/audit-logs",
        "source_path": "apps/TopoloAdmin/apps/web/src/App.tsx"
      },
      {
        "path": "/audit-logs/:id",
        "source_path": "apps/TopoloAdmin/apps/web/src/App.tsx"
      },
      {
        "path": "/security",
        "source_path": "apps/TopoloAdmin/apps/web/src/App.tsx"
      },
      {
        "path": "/security/user",
        "source_path": "apps/TopoloAdmin/apps/web/src/App.tsx"
      },
      {
        "path": "/settings",
        "source_path": "apps/TopoloAdmin/apps/web/src/App.tsx"
      },
      {
        "path": "/settings/:section",
        "source_path": "apps/TopoloAdmin/apps/web/src/App.tsx"
      },
      {
        "path": "/login-experience",
        "source_path": "apps/TopoloAdmin/apps/web/src/App.tsx"
      },
      {
        "path": "/landing-experience",
        "source_path": "apps/TopoloAdmin/apps/web/src/App.tsx"
      },
      {
        "path": "/platform-pricing",
        "source_path": "apps/TopoloAdmin/apps/web/src/App.tsx"
      },
      {
        "path": "/app-pricing",
        "source_path": "apps/TopoloAdmin/apps/web/src/App.tsx"
      },
      {
        "path": "/bugfix-settings",
        "source_path": "apps/TopoloAdmin/apps/web/src/App.tsx"
      },
      {
        "path": "/bugfix-queue",
        "source_path": "apps/TopoloAdmin/apps/web/src/App.tsx"
      },
      {
        "path": "/getting-started",
        "source_path": "apps/TopoloAdmin/apps/web/src/App.tsx"
      }
    ],
    "test_cases": [],
    "database_tables": []
  },
  "documentation": {
    "declared_paths": [
      "applications/admin",
      "internal/apps/admin"
    ],
    "present_paths": [
      "applications/admin",
      "internal/apps/admin"
    ],
    "missing_paths": [],
    "human_reference": "/systems/topolo-admin",
    "machine_reference": "/machine/systems/topolo-admin.json",
    "action_examples": 1,
    "action_schemas": 1
  },
  "source_findings": []
}