Application API

TopoloCommerce

Clear API and contract surface for TopoloCommerce, grouped under the application instead of split across generic reference sections.

curated srv_topolo_commerce

Documentation Map

Authority

Service IDs:

srv_topolo_commerce

Repos: PlatformApplications/TopoloCommerce

Hosts:

https://commerce.topolo.app

Dependencies: topolo-auth, topolo-mdm, topolo-nexus, topolo-nodo, topolo-pay, topolo-venue-survey

Depends on Topolo Auth: yes

Contract Source

Type: curated

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

Source exists: yes

Canonical public and internal docs cover the Topolo org to venue hierarchy, authenticated org-scoped staff routing, canonical /venues/:venueId ops URLs, live guest venue discovery from active venue rows instead of a hidden demo org, module resolution contract, guest/runtime boundaries, editable venue catalog management, live queue streaming, team-management flows, cached-local resilience behavior, the module-aware resilience surface, replay-safe browser outbox recovery, cloud-side venue event journaling, the cloud-side Venue Edge enrollment plus bootstrap or journal-sync contract, and the shared platform integrations with Auth, MDM, Nexus, Nodo, Pay, and Venue Survey.

API key scopes in Auth catalog: 19

Auth Requirements

No global OpenAPI security scheme is declared.

  • dashboard.read
  • venues.read
  • venues.write
  • settings.read
  • settings.write
  • catalog.read
  • catalog.write
  • imports.read
  • imports.write
  • queues.read
  • queues.write
  • service_requests.read
  • service_requests.write
  • payments.create
  • devices.read
  • devices.write
  • publishing.read
  • publishing.write
  • reports.read

Runtime and Deployment

Wrangler surfaces: PlatformApplications/TopoloCommerce/apps/api/wrangler.toml, PlatformApplications/TopoloCommerce/apps/guest-web/wrangler.toml, PlatformApplications/TopoloCommerce/apps/ops-web/wrangler.toml

Environment variables: CORS_ORIGINS, ENVIRONMENT, TOPOLO_AUTH_URL

Routes: workers.dev or Pages-only delivery

Observability enabled: no explicit signal found

README-Derived Interface Surface

Source: PlatformApplications/TopoloCommerce/README.md

No route-level highlights were extracted from the current README.

Package Surfaces

@topolo/commerce-api

No package description recorded.

Source: PlatformApplications/TopoloCommerce/apps/api/package.json

Scripts: dev, build, deploy, test

@topolo/commerce-guest-web

No package description recorded.

Source: PlatformApplications/TopoloCommerce/apps/guest-web/package.json

Scripts: dev, build, preview, deploy

@topolo/commerce-ops-web

No package description recorded.

Source: PlatformApplications/TopoloCommerce/apps/ops-web/package.json

Scripts: dev, build, preview, deploy

topolo-commerce

TopoloCommerce multi-vertical commerce workspace

Source: PlatformApplications/TopoloCommerce/package.json

Scripts: dev:api, dev:ops, dev:guest, build:api, build:ops, build:guest, test

@topolo/commerce-shared

No package description recorded.

Source: PlatformApplications/TopoloCommerce/packages/shared/package.json

Scripts: test

Runtime Surface

Wrangler surfaces: PlatformApplications/TopoloCommerce/apps/api/wrangler.toml, PlatformApplications/TopoloCommerce/apps/guest-web/wrangler.toml, PlatformApplications/TopoloCommerce/apps/ops-web/wrangler.toml

This application does not yet have a source-controlled OpenAPI spec in the docs platform. The current API page is derived from the registered contract source and repository surface.