Skip to content

Prepare live event launch defaults #8

Description

@kingstarfly

What to build

Prepare the live event configuration for HackaDeck launch so the QR-to-card flow has the correct Event, public routes, and demo-ready setup for AI Engineers Singapore 2026.

Before starting, read docs/HackaDeck_Product_Spec.md, CONTEXT.md, and AGENTS.md.

Acceptance criteria

  • Confirm production Event details:
    • Name: "AI Engineers Singapore 2026"
    • Slug: ai-engineer-hack-2026
    • Edition label for cards: "AI Engineers Singapore 2026"
    • Start date/time for the event
  • Create seed script or Convex mutation to initialize the Event and event counter for deployment.
  • Confirm QR target URL format: should deep-link with event slug preselected (e.g., https://[domain]/?event=ai-engineer-hack-2026 or similar).
  • Verify event page at /events/ai-engineer-hack-2026 is suitable for big-screen gallery display during the event.
  • Document any environment variables needed:
    • OPENAI_API_KEY for GPT-5.5 and GPT Image 2
    • Any Convex deployment settings
  • Test the full flow end-to-end on staging/preview deployment before going live.

Blocked by

None — can start immediately (configuration and seed script).

Note: The seed script should be run before testing any other issues.

For human

This is a HITL (human-in-the-loop) issue. After completion:

  1. Run the seed script → Convex dashboard shows events row with correct name/slug, eventCounters row with nextCardNumber: 1
  2. Deploy to preview/staging environment
  3. Scan QR code on your phone → lands on quiz page with event preselected
  4. Complete full flow → card appears in gallery
  5. Open /events/ai-engineer-hack-2026 on a big screen → gallery looks good for live demo
  6. Confirm: QR URL, env vars documented, ready for participant testing

For agents

Before marking this issue complete:

  • Commit the implementation.
  • Run pnpm gate and make sure it passes. This includes pnpm convex:check (convex dev --once), which pushes Convex schema and functions to the configured dev deployment and regenerates TypeScript bindings.
  • Update this issue body so completed acceptance criteria are checked off (- [x]).
  • Close the issue after the implementation is committed and verified.

This is a HITL issue, but if an agent assists with the seed script or configuration:

Before handing back to the human, leave a comment documenting:

  • Exact seed script location and how to run it (e.g., npx convex run seed:createEvent)
  • Any environment variables that must be set before deployment
  • The QR URL format decided upon
  • Any deployment steps or Convex dashboard actions needed
  • What the human still needs to verify or decide

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or requestready-for-humanRequires human implementation or decision

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions