application public active Verified 2026-04-07

Topolo Quro

QR creation, redirect, and scan-tracking application with modern and legacy UI surfaces.

Documentation Map

What It Is

QR creation, redirect, and scan-tracking application with modern and legacy UI surfaces.

Canonical documentation for Topolo Quro 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: growth-platform

Source repos: PlatformApplications/TopoloQuro

Dependencies: topolo-auth

Repo shape

  • PlatformApplications/TopoloQuro/README.md
  • PlatformApplications/TopoloQuro/quro-system/
  • PlatformApplications/TopoloQuro/topolo.cloudcontrol.json

Runtime Surfaces

Hosts:

No primary host is registered.

quro-api

Config: PlatformApplications/TopoloQuro/quro-system/quro-api/wrangler.toml

Main: index.js

Routes: workers.dev or asset-only surface

quro-redirect-system

Config: PlatformApplications/TopoloQuro/quro-system/quro-redirect/wrangler.toml

Main: index.js

Routes: workers.dev or asset-only surface

quro-ui

Config: PlatformApplications/TopoloQuro/quro-system/quro-ui/wrangler.toml

Main: not declared

Routes: workers.dev or asset-only surface

quro-ui-legacy

Config: PlatformApplications/TopoloQuro/quro-system/quro-ui-legacy/wrangler.toml

Main: not declared

Routes: workers.dev or asset-only surface

API Reference

Coverage: curated

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

Source exists in repo: yes

Canonical Quro coverage now lives in the docs application.

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

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_quro_api

API key scopes

codes.read

View generated codes

Resource pattern: none

codes.write

Manage generated codes

Resource pattern: none

series.read

View QR series

Resource pattern: none

series.write

Manage QR series

Resource pattern: none

analytics.read

View QR analytics

Resource pattern: none

analytics.write

Manage QR analytics exports

Resource pattern: none

settings.read

View Quro settings

Resource pattern: none

settings.write

Manage Quro settings

Resource pattern: none

Service permissions

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

Data Ownership

d1

Binding: QURO_METADATA

Target: 64df2761-0e21-403d-a1c1-88abb09448f3

Environment: default

Source: PlatformApplications/TopoloQuro/quro-system/quro-api/wrangler.toml

d1

Binding: QURO_METADATA

Target: 64df2761-0e21-403d-a1c1-88abb09448f3

Environment: default

Source: PlatformApplications/TopoloQuro/quro-system/quro-redirect/wrangler.toml

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_URL AUTH_BASE_URL SERVICE_ID VITE_API_BASE_URL VITE_SERVICE_ID kv_namespaces routes

All wrangler bindings

  • QURO_METADATA (d1) -> 64df2761-0e21-403d-a1c1-88abb09448f3
  • QURO_METADATA (d1) -> 64df2761-0e21-403d-a1c1-88abb09448f3

Deployments

Deployment environments: preview, production

Routes: workers.dev or Pages-only delivery

Observability enabled: no explicit setting found

Wrangler surfaces

  • PlatformApplications/TopoloQuro/quro-system/quro-api/wrangler.toml -> quro-api
  • PlatformApplications/TopoloQuro/quro-system/quro-redirect/wrangler.toml -> quro-redirect-system
  • PlatformApplications/TopoloQuro/quro-system/quro-ui/wrangler.toml -> quro-ui
  • PlatformApplications/TopoloQuro/quro-system/quro-ui-legacy/wrangler.toml -> quro-ui-legacy

Build and deploy commands

  • deploy — PlatformApplications/TopoloQuro/quro-system/quro-api/package.json :: wrangler deploy
  • deploy:dry-run — PlatformApplications/TopoloQuro/quro-system/quro-api/package.json :: wrangler deploy --dry-run --config wrangler.toml
  • build — PlatformApplications/TopoloQuro/quro-system/quro-api/package.json :: node --check index.js
  • deploy — PlatformApplications/TopoloQuro/quro-system/quro-redirect/package.json :: wrangler deploy
  • deploy:dry-run — PlatformApplications/TopoloQuro/quro-system/quro-redirect/package.json :: wrangler deploy --dry-run --config wrangler.toml
  • build — PlatformApplications/TopoloQuro/quro-system/quro-redirect/package.json :: node --check index.js
  • build — PlatformApplications/TopoloQuro/quro-system/quro-ui/package.json :: tsc -b && vite build
  • preview — PlatformApplications/TopoloQuro/quro-system/quro-ui/package.json :: vite preview --host 0.0.0.0 --port 3001
  • deploy — PlatformApplications/TopoloQuro/quro-system/quro-ui/package.json :: npm run build && wrangler pages deploy ./dist --project-name quro-ui
  • deploy:preview — PlatformApplications/TopoloQuro/quro-system/quro-ui/package.json :: npm run build && wrangler pages deploy ./dist --project-name quro-ui --env preview
  • deploy:github — PlatformApplications/TopoloQuro/quro-system/quro-ui-legacy/package.json :: npm run build:production && gh-pages -d .
  • deploy:netlify — PlatformApplications/TopoloQuro/quro-system/quro-ui-legacy/package.json :: npm run build:production && netlify deploy --prod
  • deploy:cloudflare — PlatformApplications/TopoloQuro/quro-system/quro-ui-legacy/package.json :: npm run build:production && wrangler pages deploy --project-name=quro-ui-legacy .
  • deploy — PlatformApplications/TopoloQuro/quro-system/quro-ui-legacy/package.json :: npm run deploy:cloudflare
  • build:production — PlatformApplications/TopoloQuro/quro-system/quro-ui-legacy/package.json :: echo 'Preparing legacy reference files for deployment...'

Failure Modes

  • No primary host is registered in the system registry.

Debugging Runbooks

Start with these entrypoints:

  • PlatformApplications/TopoloQuro/quro-system/quro-api/wrangler.toml
  • PlatformApplications/TopoloQuro/quro-system/quro-redirect/wrangler.toml
  • PlatformApplications/TopoloQuro/quro-system/quro-ui/wrangler.toml
  • PlatformApplications/TopoloQuro/quro-system/quro-ui-legacy/wrangler.toml
  • PlatformApplications/TopoloDocs/src/content/public/applications/quro.mdx
  • PlatformApplications/TopoloQuro/README.md
  • PlatformApplications/TopoloQuro/quro-system/quro-api/package.json
  • PlatformApplications/TopoloQuro/quro-system/quro-redirect/package.json
  • PlatformApplications/TopoloQuro/quro-system/quro-ui/package.json
  • PlatformApplications/TopoloQuro/quro-system/quro-ui-legacy/package.json

Change Log / Verification

Lifecycle: active

Last verified: 2026-04-07

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