Simulation of core backend infrastructure for a real-money fantasy sports app, developed and maintained between Jan 2024 and Jun 2025. This repo serves as internal documentation for the system’s architecture, service boundaries, and ops workflows. Code and configs are illustrative or redacted.
This repo simulates a backend infra system I designed while consulting on a real-money fantasy platform.
- Services: FastAPI microservices for Auth, Wallet, Scoring, Payments, KYC
- Infra: AWS ECS (Fargate), Terraform (stubs), GitHub Actions, Redis, S3
- Data: PostgreSQL (core), Redis (cache/pubsub), S3 (match snapshots)
- Async: Celery for scoring, payouts, webhook handling
- Payments: Razorpay (primary), Cashfree (fallback)
- KYC: PAN OCR, Aadhaar eSign, fallback to selfie + manual review
| Folder | Purpose |
|---|---|
docs/ |
Architecture diagrams, flows, system notes |
services/ |
Per-service readmes (auth, wallet, scoring, etc.) |
infra/terraform/ |
Infra planning stubs (networking, services, storage) |
cron/ |
Notes on cron jobs (e.g., match ingestion) |
adr/ |
Architecture Decision Records (bootstrap + tradeoffs) |
experiments/ |
Abandoned or in-progress ideas |
notes/ |
Raw notes from dev onboarding, edge cases, and flows |
postmortem.md |
War stories and incident reports (e.g., accidental refunds) |
- ❌ No code, no deployable infra
- ✅ Service boundaries, flows, edge case notes
- 🔒 Some sections anonymized or redacted (client context)
- 🧾 All infra and service files were written during/after active work
docs/architecture.md— System architecture sketch (mermaid)postmortem.md— Incident writeups from production bugsdocs/02_kyc_payments.md— KYC + Payments integration notes
I worked as an infra/backend consultant on a real-money fantasy sports product between Jan 2024 and Jun 2025. The actual code is proprietary, but this repo simulates the infra, notes, and service thinking behind that work — cleaned up just enough for open-source.
📝 Disclaimer: This repository is a self-authored simulation for demonstration purposes only. It does not contain proprietary client code or data.