i18n Backend

O contrato da API é estável em códigos. Texto humano segue o locale da request ou do usuário. UI: i18n-frontend / i18n-mobile. Contratos: api-design.

Regras inegociáveis

• code machine-readable (ORDER_NOT_FOUND). message opcional já localizada ou omitida — o client traduz o code. Não mude o code por idioma.
• Locale: perfil do usuário autenticado > query/header explícito (lang, X-Locale) > Accept-Language > default. Nunca geo-IP como única fonte.
• Parse Accept-Language com q-values e fallback (pt-BR → pt → en).
• Datas na API: ISO-8601 / epoch. Formatação de calendário fica no client, salvo PDF/e-mail gerado no servidor.
• Catálogos versionados no repo (locales/en.json, .ftl, .resx). Sem SQL de tradução ad hoc numa feature.
• Logs e métricas em inglês/técnico estável. Não localize slog/ILogger de ops.
• Plurals/ICU no servidor só quando o servidor gera texto (e-mail, PDF, push).

HTTP