Skip to main content

Event Live Documentation

This documentation covers the event ticketing platform:

  • Frontend: Next.js hosted on Vercel
  • Backend: AWS ECS + Fargate (NestJS API + worker)
  • Data: Aurora PostgreSQL (system of record) + ElastiCache Redis (cache/locks)
  • Async: SQS (jobs) + DLQ, optional SNS/EventBridge for fanout
  • Payments: Stripe Checkout + webhooks (idempotent processing)

Start here​

  • Architecture → Overview (big picture)
  • Flows → Ticket Purchase (High Contention) (correctness under load)
  • Architecture → Data Model & Invariants (constraints that prevent oversell)

Documentation principles​

  • Diagrams are written in Mermaid so they can be reviewed in Git diffs.
  • Architectural changes should include an ADR and updates to relevant flows.