application public active Verified 2026-03-29

TopoloMDM

MDM platform cluster spanning a device API, operator console, and mobile scaffold.

Documentation Map

What It Is

MDM platform cluster spanning a device API, operator console, and mobile scaffold.

TopoloMDM is not a single finished product in this repository yet. The current codebase is split across three surfaces with different levels of completeness:

This README is the truthful surface map for the current repo state.

Cloudflare Worker entrypoint: `nodo-mdm-api/index.js`

Architecture

Owners: device-platform

Source repos: Applications/TopoloMDM

Dependencies: topolo-auth

Repo shape

  • Applications/TopoloMDM/README.md
  • Applications/TopoloMDM/nodo-mdm-api/
  • Applications/TopoloMDM/nodo-mdm-console/
  • Applications/TopoloMDM/nodo-mdm-mobile/
  • Applications/TopoloMDM/packages/

Runtime Surfaces

Hosts:

https://nodo-mdm-api.topolo.workers.dev
nodo-mdm-api

Config: Applications/TopoloMDM/nodo-mdm-api/wrangler.toml

Main: index.js

Routes: workers.dev or asset-only surface

API Reference

Coverage: readme

Source: Applications/TopoloMDM/README.md

Source exists in repo: yes

README documents the current implemented route surface for nodo-mdm-api.

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

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:

svc_nodo_mdm_console svc_nodo_mdm_api svc_nodo_state_api

API key scopes

devices.read

View managed devices

Resource pattern: none

devices.write

Manage managed devices

Resource pattern: none

packages.read

View device packages

Resource pattern: none

packages.write

Manage device packages

Resource pattern: none

users.read

View MDM users

Resource pattern: none

users.write

Manage MDM users

Resource pattern: none

settings.read

View MDM settings

Resource pattern: none

settings.write

Manage MDM settings

Resource pattern: none

mdm.read

Read device information

Resource pattern: none

mdm.write

Send commands to managed devices

Resource pattern: none

mdm.admin

Full device management access

Resource pattern: none

state.read

Read device state and status data

Resource pattern: none

state.write

Update device state information

Resource pattern: none

commands.read

View device command history

Resource pattern: none

commands.write

Send commands to devices

Resource pattern: none

events.read

View device events and logs

Resource pattern: none

analytics.read

Access device analytics and metrics

Resource pattern: none

Service permissions

dashboard:read, devices:read, devices:write, devices:control, policies:read, policies:write, apps:read, apps:write, reports:read, state:read, state:write, commands:read, commands:write, events:read, analytics:read

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:

APP_CATALOG_URL AUTH_BASE_URL DEFAULT_TENANT FEED_API_URL SERVICE_ID STATE_API_URL

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

  • Applications/TopoloMDM/nodo-mdm-api/wrangler.toml -> nodo-mdm-api

Build and deploy commands

  • deploy — Applications/TopoloMDM/nodo-mdm-api/package.json :: wrangler deploy
  • build — Applications/TopoloMDM/nodo-mdm-console/package.json :: astro build
  • deploy — Applications/TopoloMDM/nodo-mdm-console/package.json :: npm run build && npx wrangler pages deploy dist --project-name nodo-mdm-console
  • preview — Applications/TopoloMDM/nodo-mdm-console/package.json :: astro preview

Failure Modes

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

Debugging Runbooks

Start with these entrypoints:

  • Applications/TopoloMDM/nodo-mdm-api/wrangler.toml
  • Applications/TopoloMDM/README.md
  • Applications/TopoloMDM/nodo-mdm-api/package.json
  • Applications/TopoloMDM/nodo-mdm-console/package.json

Linked runbooks

Change Log / Verification

Lifecycle: active

Last verified: 2026-03-29

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