application internal active Verified 2026-04-09

TopoloLearn

Multi-tenant learning platform for branded learning businesses, cohort delivery, assessment, evidence packs, certification, and enterprise seat management.

Documentation Map

What It Is

Multi-tenant learning platform for branded learning businesses, cohort delivery, assessment, evidence packs, certification, and enterprise seat management.

TopoloLearn is the Topolo-native multi-tenant learning platform for branded training businesses, cohort delivery, assessment workflows, evidence packs, certification, and enterprise seat management.

The canonical architecture and operating docs live in `PlatformApplications/TopoloDocs`. This repo-local README is a codebase entrypoint only.

Architecture

Owners: product-platform

Source repos: PlatformApplications/TopoloLearn, PlatformApplications/TopoloDocs

Dependencies: topolo-platform, topolo-auth, topolo-one, applications-packages, cloud-control

Repo shape

  • PlatformApplications/TopoloLearn/README.md
  • PlatformApplications/TopoloLearn/apps/
  • PlatformApplications/TopoloLearn/package.json
  • PlatformApplications/TopoloLearn/packages/
  • PlatformApplications/TopoloLearn/pnpm-lock.yaml
  • PlatformApplications/TopoloLearn/pnpm-workspace.yaml
  • PlatformApplications/TopoloLearn/topolo.cloudcontrol.json
  • PlatformApplications/TopoloLearn/tsconfig.base.json
  • PlatformApplications/TopoloDocs/astro.config.mjs
  • PlatformApplications/TopoloDocs/package-lock.json
  • PlatformApplications/TopoloDocs/package.json
  • PlatformApplications/TopoloDocs/public/
  • PlatformApplications/TopoloDocs/scripts/
  • PlatformApplications/TopoloDocs/src/
  • PlatformApplications/TopoloDocs/templates/
  • PlatformApplications/TopoloDocs/topolo.cloudcontrol.json
  • PlatformApplications/TopoloDocs/tsconfig.json

Runtime Surfaces

Hosts:

https://learn.topolo.app
topololearn-api

Config: PlatformApplications/TopoloLearn/apps/api/wrangler.toml

Main: src/index.ts

Routes: workers.dev or asset-only surface

topololearn

Config: PlatformApplications/TopoloLearn/apps/web/wrangler.toml

Main: not declared

Routes: workers.dev or asset-only surface

API Reference

Coverage: curated

Source: PlatformApplications/TopoloLearn/apps/api/src/index.ts

Source exists in repo: yes

Curated handbook and schema docs define the route-scoped operator, studio, member, runtime, assessment, certificate, activity, learner submission, and studio mutation contract owned by the Worker.

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

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_topolo_learn

API key scopes

runtime.read

View branded runtime state and published brand snapshots

Resource pattern: none

studio.read

View TopoloLearn studio state

Resource pattern: none

studio.write

Manage TopoloLearn studio configuration

Resource pattern: none

assessments.write

Review submissions and manage assessment outcomes

Resource pattern: none

certificates.write

Issue and manage certificates

Resource pattern: none

settings.read

View TopoloLearn settings

Resource pattern: none

settings.write

Manage TopoloLearn settings

Resource pattern: none

Service permissions

No role/permission catalog rows were found in the checked-in Auth permissions seed.

Data Ownership

d1

Binding: LEARN_DB

Target: c6ccccaa-fc17-40c0-a985-8602a794dc07

Environment: default

Source: PlatformApplications/TopoloLearn/apps/api/wrangler.toml

kv

Binding: LEARN_PUBLISHED_KV

Target: 75f7fe4c581040c19518e9db5cc0ce26

Environment: default

Source: PlatformApplications/TopoloLearn/apps/api/wrangler.toml

r2

Binding: LEARN_UPLOADS_BUCKET

Target: topololearn-prod-r2-uploads

Environment: default

Source: PlatformApplications/TopoloLearn/apps/api/wrangler.toml

r2

Binding: LEARN_CERTIFICATES_BUCKET

Target: topololearn-prod-r2-certificates

Environment: default

Source: PlatformApplications/TopoloLearn/apps/api/wrangler.toml

d1

Binding: LEARN_DB

Target: TODO_TOPLOLEARN_DEV_DB

Environment: dev

Source: PlatformApplications/TopoloLearn/apps/api/wrangler.toml

kv

Binding: LEARN_PUBLISHED_KV

Target: TODO_TOPLOLEARN_DEV_KV

Environment: dev

Source: PlatformApplications/TopoloLearn/apps/api/wrangler.toml

r2

Binding: LEARN_UPLOADS_BUCKET

Target: topololearn-dev-r2-uploads

Environment: dev

Source: PlatformApplications/TopoloLearn/apps/api/wrangler.toml

r2

Binding: LEARN_CERTIFICATES_BUCKET

Target: topololearn-dev-r2-certificates

Environment: dev

Source: PlatformApplications/TopoloLearn/apps/api/wrangler.toml

d1

Binding: LEARN_DB

Target: TODO_TOPLOLEARN_STAGING_DB

Environment: staging

Source: PlatformApplications/TopoloLearn/apps/api/wrangler.toml

kv

Binding: LEARN_PUBLISHED_KV

Target: TODO_TOPLOLEARN_STAGING_KV

Environment: staging

Source: PlatformApplications/TopoloLearn/apps/api/wrangler.toml

r2

Binding: LEARN_UPLOADS_BUCKET

Target: topololearn-staging-r2-uploads

Environment: staging

Source: PlatformApplications/TopoloLearn/apps/api/wrangler.toml

r2

Binding: LEARN_CERTIFICATES_BUCKET

Target: topololearn-staging-r2-certificates

Environment: staging

Source: PlatformApplications/TopoloLearn/apps/api/wrangler.toml

Queues / Cron / Workflows

Queue bindings:

  • LEARN_ANALYTICS_QUEUE -> topololearn-prod-queue-analytics
  • LEARN_WORKFLOW_QUEUE -> topololearn-prod-queue-workflows
  • LEARN_ANALYTICS_QUEUE -> topololearn-dev-queue-analytics (dev)
  • LEARN_WORKFLOW_QUEUE -> topololearn-dev-queue-workflows (dev)
  • LEARN_ANALYTICS_QUEUE -> topololearn-staging-queue-analytics (staging)
  • LEARN_WORKFLOW_QUEUE -> topololearn-staging-queue-workflows (staging)

Cron triggers

No cron triggers were detected.

Workflow signals

  • LEARN_ANALYTICS_QUEUE -> topololearn-prod-queue-analytics
  • LEARN_WORKFLOW_QUEUE -> topololearn-prod-queue-workflows
  • LEARN_ANALYTICS_QUEUE -> topololearn-dev-queue-analytics
  • LEARN_WORKFLOW_QUEUE -> topololearn-dev-queue-workflows
  • LEARN_ANALYTICS_QUEUE -> topololearn-staging-queue-analytics
  • LEARN_WORKFLOW_QUEUE -> topololearn-staging-queue-workflows

Environment Variables and Bindings

Environment variables:

ENVIRONMENT FRONTEND_URL PLATFORM_HOST SERVICE_ID SKIP_AUTH TOPOLO_AUTH_API_URL

All wrangler bindings

  • LEARN_DB (d1) -> c6ccccaa-fc17-40c0-a985-8602a794dc07
  • LEARN_PUBLISHED_KV (kv) -> 75f7fe4c581040c19518e9db5cc0ce26
  • LEARN_UPLOADS_BUCKET (r2) -> topololearn-prod-r2-uploads
  • LEARN_CERTIFICATES_BUCKET (r2) -> topololearn-prod-r2-certificates
  • LEARN_ANALYTICS_QUEUE (queue) -> topololearn-prod-queue-analytics
  • LEARN_WORKFLOW_QUEUE (queue) -> topololearn-prod-queue-workflows
  • LEARN_DB (d1) -> TODO_TOPLOLEARN_DEV_DB [dev]
  • LEARN_PUBLISHED_KV (kv) -> TODO_TOPLOLEARN_DEV_KV [dev]
  • LEARN_UPLOADS_BUCKET (r2) -> topololearn-dev-r2-uploads [dev]
  • LEARN_CERTIFICATES_BUCKET (r2) -> topololearn-dev-r2-certificates [dev]
  • LEARN_ANALYTICS_QUEUE (queue) -> topololearn-dev-queue-analytics [dev]
  • LEARN_WORKFLOW_QUEUE (queue) -> topololearn-dev-queue-workflows [dev]
  • LEARN_DB (d1) -> TODO_TOPLOLEARN_STAGING_DB [staging]
  • LEARN_PUBLISHED_KV (kv) -> TODO_TOPLOLEARN_STAGING_KV [staging]
  • LEARN_UPLOADS_BUCKET (r2) -> topololearn-staging-r2-uploads [staging]
  • LEARN_CERTIFICATES_BUCKET (r2) -> topololearn-staging-r2-certificates [staging]
  • LEARN_ANALYTICS_QUEUE (queue) -> topololearn-staging-queue-analytics [staging]
  • LEARN_WORKFLOW_QUEUE (queue) -> topololearn-staging-queue-workflows [staging]

Deployments

Deployment environments: dev, staging

Routes: workers.dev or Pages-only delivery

Observability enabled: no explicit setting found

Wrangler surfaces

  • PlatformApplications/TopoloLearn/apps/api/wrangler.toml -> topololearn-api
  • PlatformApplications/TopoloLearn/apps/web/wrangler.toml -> topololearn

Build and deploy commands

  • build — PlatformApplications/TopoloLearn/apps/api/package.json :: tsc --noEmit
  • deploy — PlatformApplications/TopoloLearn/apps/api/package.json :: wrangler deploy
  • build — PlatformApplications/TopoloLearn/apps/web/package.json :: vite build
  • preview — PlatformApplications/TopoloLearn/apps/web/package.json :: vite preview
  • build — PlatformApplications/TopoloLearn/package.json :: pnpm -r run build
  • build — PlatformApplications/TopoloLearn/packages/config/package.json :: tsc --noEmit
  • build — PlatformApplications/TopoloLearn/packages/database/package.json :: tsc --noEmit

Failure Modes

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

Debugging Runbooks

Start with these entrypoints:

  • PlatformApplications/TopoloLearn/apps/api/wrangler.toml
  • PlatformApplications/TopoloLearn/apps/web/wrangler.toml
  • PlatformApplications/TopoloLearn/apps/api/src/index.ts
  • PlatformApplications/TopoloLearn/README.md
  • PlatformApplications/TopoloLearn/apps/api/package.json
  • PlatformApplications/TopoloLearn/apps/web/package.json
  • PlatformApplications/TopoloLearn/package.json
  • PlatformApplications/TopoloLearn/packages/config/package.json
  • PlatformApplications/TopoloLearn/packages/database/package.json

Linked runbooks

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.