OpenWager

OpenWager is a reference implementation of a distributed, event-driven social sportsbook platform built with Python, Django, Kafka, and PostgreSQL. It demonstrates scalable service boundaries, contract-first integrations, and operational readiness patterns for high-frequency betting workloads.

Services

• PulseFeed: canonical fixtures, markets, odds snapshots, and results
• BetCore: betting transactions, wallet ledgering, and settlement orchestration
• PromoGuard: promotion eligibility, redemption decisions, and fraud signals
• RankForge: loyalty points, badges, and leaderboard materialization
• OpsArena: SLO metadata, alert catalog governance, and incident/fault drill APIs

Documentation map

• Quickstart: QUICKSTART.md
• Docker guide: INSTRUCTION-MANUAL.md
• Architecture: ARCHITECTURE.md
• Deployment: DEPLOYMENT.md
• Roadmap: ROADMAP.md
• Changelog: CHANGELOG.md
• Contribution guide: CONTRIBUTING.md
• Documentation index: docs/INDEX.md

Quick start (Docker — full stack)

cp .env.example .env
make up-all
make seed-docker
make start-pipeline-docker
make e2e-flow-docker

Quick start (local — infra only)

cp .env.example .env
make verify-env
make bootstrap
make infra-up
make topics-create
make test

Engineering quality gates

• Repository checks: make lint, make test, make smoke
• Service-local checks: make -C services/<service> test
• Deterministic API flow check (with stack running): make e2e-flow-docker
• Load test (with stack running): make loadtest-headless
• Live reliability drill (with stack running): make live-drill-docker
• CI workflows:
  • .github/workflows/openwager-monorepo-ci.yml
  • .github/workflows/opsarena-observability-smoke.yml