Topolo Venue Survey

Documentation Map

• Application hub
• Application API surface
• Machine system JSON
• Machine application JSON
• internal/apps/venue-survey
• API Key Scope Mismatches
• Auth Session and Role Drift
• CORS and Cross-Origin Failures
• Stale Deploy and Cache Issues
• Resource Binding Sync Failures

What It Is

Internal venue-survey application with a worker API, asset storage, and a Cloudflare Pages web shell.

Legacy aliases: venue-survey

Cloudflare-native intake app for on-site venue meetings.

Auth/session helpers added for app usability:

1. D1 DB created: `topolo-venue-survey` (`35a75c2d-8931-4b2c-be54-a022dee6f679`). 2. R2 bucket created: `topolo-venue-survey-assets`. 3. Migrations applied remotely: `0001_init.sql`, `0002_seed_sample.sql`. 4. Worker runtime config: - Vars: `APP_ORIGIN`, `MAGIC_LINK_BASE_URL`, `R2_ACCOUNT_ID`, `R2_BUCKET_NAME` - Required secret: `JWT_SECRET` - Optional secrets (for direct R2 signed URLs): `R2_ACCESS_KEY_ID`, `R2_SECRET_ACCESS_KEY` - Optional secret: `TURNSTILE_SECRET` - Note: if optional R2 secrets are missing, the API uses Worker-signed upload/download URLs as a fallback. 5. Set web env using `apps/web/.env.example` (`VITE_API_BASE`).

API Reference

Coverage: curated

Source: PlatformApplications/TopoloDocs/src/content/internal/apps/venue-survey.mdx

Source exists in repo: yes

App API page: /reference/apps/topolo-venue-survey

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:

No Auth service ID mapped in docs yet.

API key scopes

No API key scopes were found in the checked-in Auth catalog for this system.

Service permissions

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

Data Ownership

Deployments

Deployment environments: default only or not declared

Routes: workers.dev or Pages-only delivery

Observability enabled: no explicit setting found

Wrangler surfaces

• InternalApplications/topolo-venue-survey/apps/api/wrangler.toml -> topolo-venue-survey-api
• InternalApplications/topolo-venue-survey/apps/web/wrangler.toml -> topolo-venue-survey-web

Build and deploy commands

• build — InternalApplications/topolo-venue-survey/apps/api/package.json :: tsc -p tsconfig.json
• deploy — InternalApplications/topolo-venue-survey/apps/api/package.json :: wrangler deploy
• deploy:dry-run — InternalApplications/topolo-venue-survey/apps/api/package.json :: wrangler deploy --dry-run --outdir .wrangler/build
• build — InternalApplications/topolo-venue-survey/apps/web/package.json :: tsc -p tsconfig.json && vite build
• preview — InternalApplications/topolo-venue-survey/apps/web/package.json :: vite preview
• build — InternalApplications/topolo-venue-survey/package.json :: npm run build -w @topolo/shared && npm run build -w @topolo/api && npm run build -w @topolo/web
• build — InternalApplications/topolo-venue-survey/packages/shared/package.json :: tsc -p tsconfig.json

Failure Modes

• No Auth service ID is registered for this system.

Debugging Runbooks

Start with these entrypoints:

• InternalApplications/topolo-venue-survey/apps/api/wrangler.toml
• InternalApplications/topolo-venue-survey/apps/web/wrangler.toml
• PlatformApplications/TopoloDocs/src/content/internal/apps/venue-survey.mdx
• InternalApplications/topolo-venue-survey/README.md
• InternalApplications/topolo-venue-survey/apps/api/package.json
• InternalApplications/topolo-venue-survey/apps/web/package.json
• InternalApplications/topolo-venue-survey/package.json
• InternalApplications/topolo-venue-survey/packages/shared/package.json

Linked runbooks

• API Key Scope Mismatches
• Auth Session and Role Drift
• CORS and Cross-Origin Failures
• Stale Deploy and Cache Issues
• Resource Binding Sync Failures

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.