application public active Verified 2026-03-29

Topolo Roadmapper

Roadmap and project management application in the Topolo portfolio.

Documentation Map

What It Is

Roadmap and project management application in the Topolo portfolio.

Architecture

Owners: product-platform

Source repos: Applications/TopoloRoadmapper

Dependencies: topolo-auth

Repo shape

  • Applications/TopoloRoadmapper/apps/
  • Applications/TopoloRoadmapper/docs/
  • Applications/TopoloRoadmapper/package.json
  • Applications/TopoloRoadmapper/packages/
  • Applications/TopoloRoadmapper/pnpm-lock.yaml
  • Applications/TopoloRoadmapper/pnpm-workspace.yaml
  • Applications/TopoloRoadmapper/scripts/

Runtime Surfaces

Hosts:

No primary host is registered.

topolo-production-roadmapper

Config: Applications/TopoloRoadmapper/apps/api/wrangler.toml

Main: src/index.ts

Routes: workers.dev or asset-only surface

API Reference

Coverage: curated

Source: Applications/TopoloRoadmapper/package.json

Source exists in repo: yes

Current contract coverage is curated rather than OpenAPI-backed.

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

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_I0z_mOMxdFVa

API key scopes

projects.read

View product initiatives and projects

Resource pattern: none

projects.write

Create and manage projects

Resource pattern: none

roadmaps.read

View roadmaps

Resource pattern: none

roadmaps.write

Create and manage roadmaps

Resource pattern: none

reports.read

View roadmap reports

Resource pattern: none

reports.write

Manage roadmap reports

Resource pattern: none

settings.read

View Roadmapper settings

Resource pattern: none

settings.write

Manage Roadmapper settings

Resource pattern: none

Service permissions

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

Data Ownership

d1

Binding: DB

Target: e241800d-ea5b-463e-9b87-9fe8b4890f35

Environment: default

Source: Applications/TopoloRoadmapper/apps/api/wrangler.toml

r2

Binding: ATTACHMENTS_BUCKET

Target: roadmapper-prod-attachments

Environment: default

Source: Applications/TopoloRoadmapper/apps/api/wrangler.toml

d1

Binding: DB

Target: 85cce97a-5af2-47d6-aeb8-f8ed7f6169e1

Environment: staging

Source: Applications/TopoloRoadmapper/apps/api/wrangler.toml

d1

Binding: DB

Target: 85cce97a-5af2-47d6-aeb8-f8ed7f6169e1

Environment: dev

Source: Applications/TopoloRoadmapper/apps/api/wrangler.toml

r2

Binding: ATTACHMENTS_BUCKET

Target: roadmapper-dev-attachments

Environment: dev

Source: Applications/TopoloRoadmapper/apps/api/wrangler.toml

r2

Binding: ATTACHMENTS_BUCKET

Target: roadmapper-staging-attachments

Environment: staging

Source: Applications/TopoloRoadmapper/apps/api/wrangler.toml

Queues / Cron / Workflows

Queue bindings:

  • NOTIFICATION_QUEUE -> topolo-prod-queue-notifications
  • NOTIFICATION_QUEUE -> topolo-dev-queue-notifications (dev)
  • NOTIFICATION_QUEUE -> topolo-staging-queue-notifications (staging)

Cron triggers

No cron triggers were detected.

Workflow signals

  • NOTIFICATION_QUEUE -> topolo-prod-queue-notifications
  • NOTIFICATION_QUEUE -> topolo-dev-queue-notifications
  • NOTIFICATION_QUEUE -> topolo-staging-queue-notifications

Environment Variables and Bindings

Environment variables:

ENVIRONMENT FRONTEND_URL SERVICE_ID SKIP_AUTH TOPOLO_AUTH_API_URL route

All wrangler bindings

  • DB (d1) -> e241800d-ea5b-463e-9b87-9fe8b4890f35
  • NOTIFICATION_QUEUE (queue) -> topolo-prod-queue-notifications
  • ATTACHMENTS_BUCKET (r2) -> roadmapper-prod-attachments
  • DB (d1) -> 85cce97a-5af2-47d6-aeb8-f8ed7f6169e1 [staging]
  • DB (d1) -> 85cce97a-5af2-47d6-aeb8-f8ed7f6169e1 [dev]
  • NOTIFICATION_QUEUE (queue) -> topolo-dev-queue-notifications [dev]
  • ATTACHMENTS_BUCKET (r2) -> roadmapper-dev-attachments [dev]
  • NOTIFICATION_QUEUE (queue) -> topolo-staging-queue-notifications [staging]
  • ATTACHMENTS_BUCKET (r2) -> roadmapper-staging-attachments [staging]

Deployments

Deployment environments: dev, staging

Routes: workers.dev or Pages-only delivery

Observability enabled: no explicit setting found

Wrangler surfaces

  • Applications/TopoloRoadmapper/apps/api/wrangler.toml -> topolo-production-roadmapper

Build and deploy commands

  • build — Applications/TopoloRoadmapper/package.json :: pnpm -r run build
  • deploy:api — Applications/TopoloRoadmapper/package.json :: pnpm -C apps/api run deploy
  • deploy:web — Applications/TopoloRoadmapper/package.json :: pnpm -C apps/web run build && pnpm -C apps/web run deploy
  • deploy — Applications/TopoloRoadmapper/apps/api/package.json :: wrangler deploy
  • prebuild — Applications/TopoloRoadmapper/apps/web/package.json :: pnpm -C ../../packages/ui install --frozen-lockfile=false && pnpm -C ../../packages/ui run build
  • build — Applications/TopoloRoadmapper/apps/web/package.json :: vite build
  • deploy — Applications/TopoloRoadmapper/apps/web/package.json :: pnpm run build && npx wrangler pages deploy dist --project-name roadmapper
  • preview — Applications/TopoloRoadmapper/apps/web/package.json :: vite preview
  • build — Applications/TopoloRoadmapper/packages/domain/package.json :: pnpm exec tsc --project tsconfig.json
  • build — Applications/TopoloRoadmapper/packages/infra/package.json :: npx tsc --project tsconfig.json

Failure Modes

  • No primary host is registered in the system registry.
  • Neither OpenAPI nor README-derived interface detail was found.

Debugging Runbooks

Start with these entrypoints:

  • Applications/TopoloRoadmapper/apps/api/wrangler.toml
  • Applications/TopoloRoadmapper/package.json
  • Applications/TopoloRoadmapper/apps/api/package.json
  • Applications/TopoloRoadmapper/apps/web/package.json
  • Applications/TopoloRoadmapper/packages/domain/package.json
  • Applications/TopoloRoadmapper/packages/infra/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.