Add local development environment with Docker Compose for full stack

[Smartdevs17]

Context

New contributors spend hours setting up dependencies: PostgreSQL, Redis, Soroban CLI, Node.js, Rust, Python, and more. No single-command setup exists.

Current Limitation/Problem

Setup instructions rely on manual installation via brew, nvm, rustup, etc. Inconsistent environments cause 'works on my machine' bugs.

Expected Outcome

Single-command docker compose up that starts the full stack: API server, background workers, PostgreSQL, Redis, Soroban standalone node, ML service, webhook dispatcher.

Acceptance Criteria

• docker-compose.yml with all services: backend, workers, postgres, redis, soroban-standalone, ml-service, webhook-dispatcher
• Volume mounts: hot-reload for backend (ts-node-dev) and mobile (Expo)
• Health checks: each service waits for dependencies before starting (depends_on with condition)
• Seed script: docker compose run seed populates test data (5 plans, 10 users, 20 invoices)
• Documentation: README section with architecture diagram and setup steps
• Resource limits: total 8GB RAM, 4 CPU cores for all services
• Platform support: amd64 and arm64 (Apple Silicon) tested with Rosetta where needed
• Edge case: port conflicts (configurable via COMPOSE_PORT_* env vars)

Technical Scope

• docker-compose.yml - root composition with all services
• docker-compose.override.yml - local development overrides (hot-reload, debug ports)
• docker/backend.Dockerfile - Node.js backend service
• docker/ml.Dockerfile - Python ML service
• docker/seed/ - SQL seed data and contract deployment scripts
• .env.example - environment variable template with defaults
• scripts/setup.sh - initial setup script (checks Docker, pulls images)

[Yash-Karakoti]

@Yash-Karakoti has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

Allow me to work on this one

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Yash-Karakoti to this issue.

[drips-wave]

Congratulations, @Yash-Karakoti! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on June 30, 2026.

🧑‍💻 @Yash-Karakoti: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

Warning

When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are awarded when this issue is marked as completed by the maintainer.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊