Backend local (produção-like)

Stack Docker unificada para validar o runtime próximo de produção no laptop:

gunicorn (não runserver)
sem bind mount do código-fonte
Celery worker + beat (market, oracle, indexer)
config.settings.production (DEBUG=False)

Isto não substitui o deploy em Kubernetes/Helm (blockchain-infra-common).

Pré-requisitos

Clones lado a lado (ou monorepo):

Blockchain/
  blockchain-docs/                 ← este repo (compose aqui)
  blockchain-auth-service/
  blockchain-gateway-service/
  blockchain-meters-service/
  blockchain-market-service/
  blockchain-transactions-service/
  blockchain-oracle-service/
  blockchain-indexer-service/

Docker Desktop
Token GitHub com acesso ao repo privado blockchain-grpc-protos:

export REPO_GITHUB_PAT="$(gh auth token)"

.env em cada serviço (a partir de .env.example se ainda não existir)

Subir

A partir de blockchain-docs:

docker network create blockchain-local 2>/dev/null || true
export REPO_GITHUB_PAT="$(gh auth token)"
docker compose -f docker-compose.prod.yml up --build -d

Portas

Serviço	URL
Gateway	http://localhost:8000
Auth	http://localhost:8001
Meters	http://localhost:8002
Market	http://localhost:8003
Transactions	http://localhost:8004
Oracle	http://localhost:8005
Indexer	http://localhost:8006

Health check rápido:

curl -s http://localhost:8000/health
curl -s http://localhost:8003/health

Parar

docker compose -f docker-compose.prod.yml down

Dev vs produção-like

	Dev (`docker-compose.yml` em cada repo)	Prod-like (`docker-compose.prod.yml` aqui)
App server	`runserver` (pode mostrar “compiling”)	`gunicorn`
Código	bind mount `.:/app`	imagem baked
Settings	`local` / `DEBUG=True`	`production` / `DEBUG=False`
Orquestração	um compose por microserviço	um compose unificado