[EPIC] ÁGORA: internacionalizar o framework (des-portuguesar API e código) #56

New issue

Open

opened 2026-07-27 13:24:29 -03:00 by navigator · 0 comments

navigator commented

2026-07-27 13:24:29 -03:00

Owner

Diretriz (Marcos, 2026-07-27)

ÁGORA é o FRAMEWORK — internacionalista. Pindorama é a instalação brasileira do ÁGORA.

Regra: toda a API e todo identificador de código em INGLÊS. Cópia de UI visível ao
usuário é localizada por instalação (Pindorama = pt-BR) — mas rotas, campos, nomes de
módulo, tabelas novas e slugs de permissão são inglês.

Exemplo: /admin/papeis -> /admin/roles.

Escopo (varredura — renomear com compat/redirect onde houver front acoplado)

Rotas admin pt -> en: /admin/papeis -> /admin/roles, revisar /admin/*
GET /api/v1/municipios -> /api/v1/municipalities (endpoint novo desta semana)
Auditar todos os paths /api/v1/* em pt (/consultas, /propostas, /campanha, /convites, ...) — alias EN canônico + pt como alias temporário na transição
Campos de DTO/JSON em pt (nome_completo, nascimento, sexo, municipio_ibge, residencia_*, titulo_eleitor, sigla, esfera) -> política: expor EN no contrato (tradução no DTO) OU renomear com migration — decidir por tabela
Nomes de módulo/arquivo em pt (campanha.rs, politico_contacts.rs, titulo_eleitor.rs) -> en
TODA feature NOVA (camada de campanha) já nasce em inglês

Não-escopo

Cópia de UI visível (pt-BR é a localização do Pindorama). i18n de UI é outro épico.

## Diretriz (Marcos, 2026-07-27) **ÁGORA é o FRAMEWORK** — internacionalista. **Pindorama é a instalação brasileira do ÁGORA.** Regra: **toda a API e todo identificador de código em INGLÊS.** Cópia de UI visível ao usuário é localizada por instalação (Pindorama = pt-BR) — mas rotas, campos, nomes de módulo, tabelas novas e slugs de permissão são inglês. > Exemplo: `/admin/papeis` -> `/admin/roles`. ## Escopo (varredura — renomear com compat/redirect onde houver front acoplado) - [ ] Rotas admin pt -> en: `/admin/papeis` -> `/admin/roles`, revisar `/admin/*` - [ ] `GET /api/v1/municipios` -> `/api/v1/municipalities` (endpoint novo desta semana) - [ ] Auditar todos os paths `/api/v1/*` em pt (`/consultas`, `/propostas`, `/campanha`, `/convites`, ...) — alias EN canônico + pt como alias temporário na transição - [ ] Campos de DTO/JSON em pt (`nome_completo`, `nascimento`, `sexo`, `municipio_ibge`, `residencia_*`, `titulo_eleitor`, `sigla`, `esfera`) -> política: expor EN no contrato (tradução no DTO) OU renomear com migration — decidir por tabela - [ ] Nomes de módulo/arquivo em pt (`campanha.rs`, `politico_contacts.rs`, `titulo_eleitor.rs`) -> en - [ ] TODA feature NOVA (camada de campanha) já nasce em inglês ## Não-escopo - Cópia de UI visível (pt-BR é a localização do Pindorama). i18n de UI é outro épico.