feat: docker-compose local dev environment (#510)

[Julianemeka]

Closes #510

Changes

docker-compose.dev.yml

Complete local dev stack (separate from CI docker-compose.yml):

• postgres (15-alpine): health check via pg_isready, named volume
• redis (7-alpine): health check via redis-cli ping, named volume
• api: builds from ./api, port 3000, waits for postgres+redis healthy
• frontend: Vite dev server, port 5173, hot-reload volume mount
• indexer: waits for postgres+redis
• notification: waits for redis

All services use volume mounts (/app/node_modules excluded) for live code reload.

Dev Dockerfiles

• api/Dockerfile.dev
• demo/Dockerfile.dev (Vite with --host 0.0.0.0)
• services/indexer/Dockerfile.dev
• services/notification/Dockerfile.dev

.env.dev.example

Safe local defaults — copy to .env before starting.

Usage

cp .env.dev.example .env
docker compose -f docker-compose.dev.yml up

Acceptance Criteria

• ✅ PostgreSQL service with health check
• ✅ Redis service with health check
• ✅ API service with environment variables
• ✅ Frontend service (Vite dev server)
• ✅ Proper networking (shared paystream_dev network)
• ✅ Volume mounts for hot reload
• ✅ Environment variables via .env.dev.example
• ✅ Health checks on all stateful services

[drips-wave]

@Julianemeka Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits