Troubleshooting

Quick Outcome

Use this page when control-plane provisioning/deploy, attendee, admin, or integration workflows fail.

Do This

1. Isolate failing subsystem: control-plane orchestration, event runtime, auth, payment, or storage.
2. Reproduce with explicit route/action and capture logs.
3. Verify control-plane env and GitHub workflow wiring.
4. Verify DB bindings/migrations and runtime secrets.
5. Re-run end-to-end flow after fix.

Important inputs:

• Legacy migration reference (Atkins only): events/atkins-reunion-2026.json
• Atkins migration runbook: ops/runbooks/atkins-control-plane-adoption.md
• Event config fallback: apps/event-site/src/lib/config.ts
• Runtime bindings: apps/event-site/wrangler.toml, apps/control-plane/wrangler.toml
• Workflow run logs: event-deploy-from-manifest

Check + Fix

• Workflow dispatch failures: verify control-plane GITHUB_* env values and token scope.
• Event worker serves placeholder response: verify provider deploy path uses workflow dispatch, not stub worker path.
• Wrong event branding/content: verify manifest inputs and generated apps/event-site/src/lib/config.ts in workflow.
• Payment issues: validate Stripe webhook secret and endpoint delivery.
• Mail issues: validate Mailgun key/domain pair.

Next Move

Continue to Community.