{
  "generated_at": "2026-04-10T10:31:25.550Z",
  "system": {
    "id": "topolo-admin",
    "name": "Topolo Admin",
    "slug": "topolo-admin",
    "kind": "application",
    "summary": "Administrative interface for centralized auth, org management, user management, service controls, audit surfaces, and developer-platform review queues.",
    "aliases": [],
    "lifecycle": "active",
    "last_verified": "2026-04-10",
    "owners": [
      "platform-admin"
    ],
    "repo_paths": [
      "PlatformApplications/TopoloAdmin"
    ],
    "service_ids": [
      "srv_SySYzmlOH5H1"
    ],
    "visibility": "public",
    "api_contract": {
      "type": "curated",
      "source": "PlatformApplications/TopoloDocs/src/content/public/applications/admin.mdx",
      "notes": "Canonical admin coverage now lives in the docs application."
    },
    "primary_hosts": [
      "https://admin.topolo.app"
    ],
    "doc_paths": [
      "applications/admin",
      "internal/apps/admin"
    ],
    "dependencies": [
      "topolo-auth"
    ],
    "public_hub_url": "/systems/topolo-admin",
    "internal_hub_url": null,
    "application_api_url": "/reference/apps/topolo-admin",
    "generated_openapi_url": null,
    "machine_urls": {
      "system": "/machine/systems/topolo-admin.json",
      "application": "/machine/applications/topolo-admin.json"
    }
  },
  "docs": {
    "public": [
      {
        "id": "applications/admin.mdx",
        "title": "Topolo Admin",
        "summary": "Public overview of the administrative interface used for org, user, service, and audit management across the Topolo platform.",
        "audience": "public",
        "tags": [
          "admin",
          "auth",
          "organizations"
        ],
        "url": "/applications/admin.mdx",
        "last_verified": "2026-04-07"
      }
    ],
    "internal": [],
    "runbooks": []
  },
  "authority": {
    "owners": [
      "platform-admin"
    ],
    "repo_paths": [
      "PlatformApplications/TopoloAdmin"
    ],
    "service_ids": [
      "srv_SySYzmlOH5H1"
    ],
    "dependencies": [
      "topolo-auth"
    ],
    "aliases": []
  },
  "interfaces": {
    "contract_type": "curated",
    "contract_source": "PlatformApplications/TopoloDocs/src/content/public/applications/admin.mdx",
    "contract_source_exists": true,
    "openapi": null,
    "readme": {
      "path": "PlatformApplications/TopoloAdmin/README.md",
      "intro": [
        "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:"
      ],
      "headings": [
        "Topolo Admin",
        "Backend dependency freeze",
        "Pre-demo verification"
      ],
      "routeHighlights": [],
      "commandHighlights": []
    }
  },
  "auth": {
    "depends_on_topolo_auth": true,
    "api_key_scopes": [
      {
        "name": "dashboard.read",
        "description": "View admin dashboard and analytics",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "system.read",
        "description": "View system status and health",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "system.write",
        "description": "Manage system configuration",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "billing.read",
        "description": "View billing and subscription info",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "billing.write",
        "description": "Manage billing and subscriptions",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "support.read",
        "description": "View support tickets and issues",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "support.write",
        "description": "Manage support tickets",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "analytics.read",
        "description": "View operational analytics",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "users.read",
        "description": "View users",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "users.write",
        "description": "Create and update users",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "organizations.read",
        "description": "View organizations",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "organizations.write",
        "description": "Create and update organizations",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "services.read",
        "description": "View services",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "services.write",
        "description": "Create and update services",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "security.read",
        "description": "View security settings and sessions",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "security.write",
        "description": "Manage security settings and sessions",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "branding.read",
        "description": "View login and landing experiences",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "branding.write",
        "description": "Manage login and landing experiences",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "developers.read",
        "description": "View developer tooling and submissions",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "developers.write",
        "description": "Manage developer tooling and submissions",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "settings.read",
        "description": "View admin settings",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "settings.write",
        "description": "Manage admin settings",
        "resourcePattern": null,
        "kind": "api_key_scope"
      }
    ],
    "service_permissions": [
      {
        "name": "dashboard:read",
        "description": "View admin dashboard and analytics",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "name": "system:read",
        "description": "View system status and health",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "name": "system:write",
        "description": "Manage system configuration",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "name": "billing:read",
        "description": "View billing and subscription info",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "name": "billing:write",
        "description": "Manage billing and subscriptions",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "name": "support:read",
        "description": "View support tickets and issues",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "name": "support:write",
        "description": "Manage support tickets",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "name": "analytics:read",
        "description": "View operational analytics",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "name": "users:read",
        "description": "View users",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "name": "users:write",
        "description": "Create and update users",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "name": "organizations:read",
        "description": "View organizations",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "name": "organizations:write",
        "description": "Create and update organizations",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "name": "services:read",
        "description": "View services",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "name": "services:write",
        "description": "Create and update services",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "name": "security:read",
        "description": "View security settings and sessions",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "name": "security:write",
        "description": "Manage security settings and sessions",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "name": "branding:read",
        "description": "View login and landing experiences",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "name": "branding:write",
        "description": "Manage login and landing experiences",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "name": "developers:read",
        "description": "View developer tooling and submissions",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "name": "developers:write",
        "description": "Manage developer tooling and submissions",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "name": "settings:read",
        "description": "View admin settings",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "name": "settings:write",
        "description": "Manage admin settings",
        "resourcePattern": null,
        "kind": "permission"
      }
    ]
  },
  "runtime": {
    "primary_hosts": [
      "https://admin.topolo.app"
    ],
    "repo_entries": [
      "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"
    ],
    "wrangler_surfaces": [
      {
        "path": "PlatformApplications/TopoloAdmin/wrangler.toml",
        "observabilityEnabled": false,
        "environments": [],
        "routes": [],
        "vars": [],
        "bindings": [],
        "cronTriggers": [],
        "workerName": "topoloadmin",
        "compatibilityDate": "2025-08-08"
      }
    ],
    "packages": [
      {
        "path": "PlatformApplications/TopoloAdmin/package.json",
        "name": "topoloadmin",
        "scripts": [
          "dev",
          "build",
          "build:clean",
          "build:dev",
          "preview",
          "lint",
          "lint:full",
          "verify:pre-demo",
          "deploy"
        ],
        "scriptCommands": [
          {
            "name": "dev",
            "command": "vite"
          },
          {
            "name": "build",
            "command": "tsc && vite build"
          },
          {
            "name": "build:clean",
            "command": "rm -rf dist && tsc && vite build"
          },
          {
            "name": "build:dev",
            "command": "vite build"
          },
          {
            "name": "preview",
            "command": "vite preview"
          },
          {
            "name": "lint",
            "command": "eslint src/App.tsx src/components/layout/sidebar.tsx src/pages/DashboardLayout.tsx src/pages/DevelopersPage.tsx src/pages/AppSubmissionsPage.tsx src/pages/DeveloperRequestsPage.tsx --ext ts,tsx --report-unused-disable-directives --max-warnings 0"
          },
          {
            "name": "lint:full",
            "command": "eslint . --ext ts,tsx --report-unused-disable-directives"
          },
          {
            "name": "verify:pre-demo",
            "command": "npm run build"
          },
          {
            "name": "deploy",
            "command": "echo 'Build output ready in ./dist directory'"
          }
        ]
      }
    ]
  },
  "data": {
    "env_vars": [],
    "bindings": [],
    "queue_bindings": [],
    "storage_kinds": [],
    "workflow_signals": []
  },
  "deployment": {
    "commands": [
      {
        "name": "build",
        "command": "PlatformApplications/TopoloAdmin/package.json :: tsc && vite build"
      },
      {
        "name": "build:clean",
        "command": "PlatformApplications/TopoloAdmin/package.json :: rm -rf dist && tsc && vite build"
      },
      {
        "name": "build:dev",
        "command": "PlatformApplications/TopoloAdmin/package.json :: vite build"
      },
      {
        "name": "preview",
        "command": "PlatformApplications/TopoloAdmin/package.json :: vite preview"
      },
      {
        "name": "deploy",
        "command": "PlatformApplications/TopoloAdmin/package.json :: echo 'Build output ready in ./dist directory'"
      }
    ],
    "routes": [],
    "environments": [],
    "assets_directories": [],
    "observability_enabled": false
  },
  "debugging": {
    "failure_modes": [],
    "entrypoints": [
      "PlatformApplications/TopoloAdmin/wrangler.toml",
      "PlatformApplications/TopoloDocs/src/content/public/applications/admin.mdx",
      "PlatformApplications/TopoloAdmin/README.md",
      "PlatformApplications/TopoloAdmin/package.json"
    ]
  }
}