FairQueue

FairQueue is a distributed systems prototype for a high-concurrency train-seat booking flow inspired by IRCTC Tatkal.

The active project lives in fairqueue-stack:

• FastAPI async backend
• Redis FIFO waiting room, TTL locks, and rate limiting
• PostgreSQL booking storage with atomic seat confirmation
• Next.js frontend
• WebSocket queue updates
• Locust load-test scenario
• Docker Compose orchestration

Run

cd fairqueue-stack
docker compose up --build

Open:

• Frontend: http://localhost:3000
• Backend docs: http://localhost:8000/docs
• Locust: http://localhost:8089

DEPLOY

https://fair-queue.vercel.app/

See fairqueue-stack/README.md for full setup, API notes, and verification steps.