# 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)

```bash
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](../decisoes/index.md) 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