Build & testes por serviço

Fonte: AGENTS.md. Comandos completos por serviço nas respectivas páginas da seção Arquitetura (menu lateral).

Full stack (raiz)

docker-compose -f docker-compose.yml up -d
docker-compose -f docker-compose.yml logs -f
docker-compose -f docker-compose.yml down

Armadilhas comuns

  1. Submodules não clonados — git submodule update --init --recursive.

  2. Migrations desatualizadas — Rails migra automaticamente no boot; Python (Alembic) precisa de uv run alembic upgrade head manual.

  3. Portas em conflito — lsof -i :<porta>; ajustar no docker-compose.yml.

  4. Redis/Postgres não prontos — containers levam ~30s para ficar ready; usar docker-compose exec postgres pg_isready.

  5. TypeScript strict mode — sem any implícito; rodar pnpm run lint antes de commit.

  6. Alteração em submodule — não propaga sozinha para o superprojeto; git add <submodule> + commit na raiz.

Workflow de contribuição

  1. git checkout -b feat/my-feature

  2. Implementar no serviço relevante

  3. Rodar os testes do serviço (comando específico — ver página de Arquitetura do serviço; não existe make test/make lint na raiz, apesar de versões antigas do AGENTS.md os citarem — ver ADR e docs/bugs/2026-08-13-grill-with-docs-arquitetura.md, Divergência 2)

  4. Lint do serviço alterado

  5. Commit em Conventional Commits

  6. git push origin feat/my-feature

  7. Abrir PR com descrição clara