application public active Verified 2026-04-09

Topolo Roadmapper

Roadmap and project management application in the Topolo portfolio with AI planning sessions, hierarchy-wide guest sharing and guest edit auditability, and narrative presentation delivery.

Documentation Map

What It Is

Roadmap and project management application in the Topolo portfolio with AI planning sessions, hierarchy-wide guest sharing and guest edit auditability, and narrative presentation delivery.

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

Use this repository for implementation only. Product flows, AI onboarding behavior, notification delivery boundaries, deployment guidance, and operational details are canonical in the docs application rather than in repo-local markdown.

Architecture

Owners: product-platform

Source repos: PlatformApplications/TopoloRoadmapper

Dependencies: topolo-auth, topolo-nexus

Repo shape

  • PlatformApplications/TopoloRoadmapper/README.md
  • PlatformApplications/TopoloRoadmapper/apps/
  • PlatformApplications/TopoloRoadmapper/docs/
  • PlatformApplications/TopoloRoadmapper/package.json
  • PlatformApplications/TopoloRoadmapper/packages/
  • PlatformApplications/TopoloRoadmapper/pnpm-lock.yaml
  • PlatformApplications/TopoloRoadmapper/pnpm-workspace.yaml
  • PlatformApplications/TopoloRoadmapper/scripts/
  • PlatformApplications/TopoloRoadmapper/topolo.cloudcontrol.json

Runtime Surfaces

Hosts:

No primary host is registered.

topolo-production-roadmapper

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

Main: src/index.ts

Routes: workers.dev or asset-only surface

roadmapper

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

Main: not declared

Routes: workers.dev or asset-only surface

API Reference

Coverage: curated

Source: PlatformApplications/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: PlatformApplications/TopoloRoadmapper/apps/api/wrangler.toml

r2

Binding: ATTACHMENTS_BUCKET

Target: roadmapper-prod-attachments

Environment: default

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

d1

Binding: DB

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

Environment: staging

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

d1

Binding: DB

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

Environment: dev

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

r2

Binding: ATTACHMENTS_BUCKET

Target: roadmapper-dev-attachments

Environment: dev

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

r2

Binding: ATTACHMENTS_BUCKET

Target: roadmapper-staging-attachments

Environment: staging

Source: PlatformApplications/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

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

Build and deploy commands

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

Failure Modes

  • No primary host is registered in the system registry.

Debugging Runbooks

Start with these entrypoints:

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