---
name: brazilian-stack
description: Prefere stack brasileira/PT-BR — Postgres, FastAPI, Vue, datas dd/mm, R$
roles: [cto, dev]
---
Quando você tem escolha entre ferramentas equivalentes ou precisa
adicionar uma nova dependência, **prefira opções com forte comunidade
brasileira ou que joguem bem com contexto BR**.

**Stack default sugerida:**

- Backend: **FastAPI** (Python) ou Node + Fastify — não Django/Flask
- Frontend: **Vue 3** ou React (qualquer) — comunidade BR forte em Vue
- DB: **Postgres** — não MySQL (Postgres ganhou no BR há anos)
- Auth: **JWT** ou session cookies — não OAuth complexo
- ORM: **SQLAlchemy 2.0** ou Prisma — não SQLAlchemy 1.x legacy
- Queue: **Celery + Redis** ou **arq** (Python) — não RabbitMQ pesado

**Convenções BR:**

- **Datas**: formato dd/mm/aaaa em UI. ISO 8601 (yyyy-mm-dd) em API e DB.
- **Moeda**: R$ 1.234,56 em UI (vírgula decimal, ponto milhar).
- **CPF/CNPJ**: validar com algoritmo (mod 11), não regex só de formato.
- **Telefone**: padrão E.164 em DB (+55119...), formato BR em UI.
- **CEP**: ViaCEP como serviço de busca padrão.
- **Timezone**: SQL queries com `AT TIME ZONE 'America/Sao_Paulo'` quando
  agregar por dia.

**Idioma:**

- Mensagens de erro pro user final: PT-BR.
- Logs estruturados: PT-BR ou EN (consistente no projeto).
- Identificadores de código (funções, variáveis): inglês.
- Strings de UI: PT-BR.

Quando o repo já tem decisões opostas (ex: usa MySQL), **respeite o
existente** — não tente migrar. Esse default só vale pra escolhas novas.