application public active Verified 2026-04-09

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.

Canonical documentation for TopoloMDM lives in `PlatformApplications/TopoloDocs`.

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

Architecture

Owners: device-platform

Source repos: PlatformApplications/TopoloMDM

Dependencies: topolo-auth

Repo shape

  • PlatformApplications/TopoloMDM/README.md
  • PlatformApplications/TopoloMDM/nodo-mdm-api/
  • PlatformApplications/TopoloMDM/nodo-mdm-console/
  • PlatformApplications/TopoloMDM/nodo-mdm-mobile/
  • PlatformApplications/TopoloMDM/topolo.cloudcontrol.json

Runtime Surfaces

Hosts:

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

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

Main: index.js

Routes: workers.dev or asset-only surface

nodo-mdm-console

Config: PlatformApplications/TopoloMDM/nodo-mdm-console/wrangler.toml

Main: not declared

Routes: workers.dev or asset-only surface

API Reference

Coverage: curated

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

Source exists in repo: yes

Canonical MDM coverage now lives in the docs application.

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

  • PlatformApplications/TopoloMDM/nodo-mdm-api/wrangler.toml -> nodo-mdm-api
  • PlatformApplications/TopoloMDM/nodo-mdm-console/wrangler.toml -> nodo-mdm-console

Build and deploy commands

  • deploy — PlatformApplications/TopoloMDM/nodo-mdm-api/package.json :: wrangler deploy
  • deploy:dry-run — PlatformApplications/TopoloMDM/nodo-mdm-api/package.json :: npx --yes wrangler@4 deploy --dry-run --config wrangler.toml
  • build — PlatformApplications/TopoloMDM/nodo-mdm-api/package.json :: node --check index.js
  • build — PlatformApplications/TopoloMDM/nodo-mdm-console/package.json :: astro build
  • deploy — PlatformApplications/TopoloMDM/nodo-mdm-console/package.json :: npm run build && npx wrangler pages deploy dist --project-name nodo-mdm-console
  • preview — PlatformApplications/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:

  • PlatformApplications/TopoloMDM/nodo-mdm-api/wrangler.toml
  • PlatformApplications/TopoloMDM/nodo-mdm-console/wrangler.toml
  • PlatformApplications/TopoloDocs/src/content/public/applications/mdm.mdx
  • PlatformApplications/TopoloMDM/README.md
  • PlatformApplications/TopoloMDM/nodo-mdm-api/package.json
  • PlatformApplications/TopoloMDM/nodo-mdm-console/package.json

Change Log / Verification

Lifecycle: active

Last verified: 2026-04-09

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