| name | brazilian-stack |
| description | Prefere stack brasileira/PT-BR — Postgres, FastAPI, Vue, datas dd/mm, R$ |
| roles | ["coordinator","builder"] |
| category | domain |
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.