Idioma do app (en-GB / pt-BR)
Idioma do app (en-GB / pt-BR)
Section titled “Idioma do app (en-GB / pt-BR)”Estado actual — tradução do navegador. As entradas React (index.html e chatwoot-panel.html) recusam tradução de página desde o HTML inicial (translate="no", classe notranslate e meta Google). Todas as rotas que usam essas entradas — acesso, instalação, telas internas e páginas públicas React — e os modais, menus e avisos inseridos no body herdam a proteção. Isso evita a substituição de nós de texto que causava removeChild ao atualizar a interface. O idioma do app continua sendo escolhido no Perfil e aplicado pelo dicionário interno; textos ainda não convertidos e páginas públicas continuam em inglês. HTML estático fora do React conserva a tradução do navegador. Extensões que ignoram esses marcadores e alteram o DOM não têm garantia de compatibilidade.
Estado actual — avisos do sistema. Um push gerado pelo sistema segue preferred_language de quem recebe: visita nova, atraso de check-in, holerite, decisão dos dados bancários, o nome da conversa da tarefa e os botões do aviso. O texto que alguém escreveu fica como foi escrito. E-mail, PDF, WhatsApp e páginas públicas continuam em inglês. Um aviso já gravado não muda se a pessoa trocar o idioma depois.
Objetivo
Section titled “Objetivo”Qualquer usuário — admin, gestor, funcionário ou cliente — escolhe o idioma em Perfil → Preferences → System Language. A mesma escolha governa a interface do app e a tradução do chat. Não há regra por papel.
Decisões
Section titled “Decisões”- Fonte do idioma:
user.language, que/api/auth/mejá devolve a partir depreferred_language(employeesouclients). O Perfil já grava a preferência e chamaupdateUser({ language }), então a interface troca sem recarregar. - Abordagem: dicionário próprio e tipado, sem dependência nova. Inglês é a fonte.
- Fora do escopo desta leva (continuam em inglês): e-mails, PDF de fatura, mensagens de WhatsApp para cliente e as páginas públicas por link (orçamento, pagamento, extrato, proposta, avaliação) — não há usuário logado nem interface do seletor ali; fatura é documento fiscal UK e templates de WhatsApp são aprovados pela Meta num idioma. Podem virar uma etapa própria.
- Avisos do sistema: o push segue o idioma do perfil de quem recebe (
notice.*emen.ts/pt-BR.ts). O texto que alguém escreveu não entra nessa tradução. - Nunca traduzido: logs, códigos de erro e conteúdo digitado por pessoas.
- Relógio: o fuso continua sempre
Europe/London; só os nomes de dia/mês seguem o idioma. Moeda continua £.
Arquitetura
Section titled “Arquitetura”src/i18n/en.ts— fonte: objeto de chaves agrupadas por área (nav.*,visit.*,profile.*…).src/i18n/pt-BR.ts— tipado a partir deen.ts: otscfalha se uma chave faltar. É o único arquivo desrconde texto em português pode morar (tests/shipped_copy_language.test.tso libera e continua barrando português em qualquer outro lugar).useT()— hook que lêuser.languagee devolvet(chave, variáveis?). Variáveis simples ({name}) e plural básico (one/other). Chave sem tradução carregada cai no inglês.- Carregamento: o inglês vai no bundle; o português é um
import()dinâmico, baixado só por quem escolheupt-BR. O bundle inicial de quem usa inglês não cresce. - Datas:
londonLocale(valor, opções, idioma)— o terceiro parâmetro já existe. <html lang>acompanha o idioma (leitor de tela, hifenização).- Texto ainda não convertido continua em inglês: a conversão pode ir tela a tela sem quebrar nada.
Etapas
Section titled “Etapas”- Base + telas da equipe — concluída (2026-09-13): navegação (sidebar, barra inferior), cabeçalhos; Dashboard do funcionário, Agenda, Financeiro/holerite, Notificações, Perfil, moldura do Chat (início, avisos, composer), detalhe da visita (check-in, checklist, evidências, incidentes, avaliação) e os toasts dessas telas. O holerite em PDF e a prévia da mensagem de WhatsApp continuam em inglês.
- Admin, por área — concluída nas superfícies listadas (2026-09-15): Dashboard administrativo, Operações, Quotes, Leads, Billing, Folha (incluindo reserva e calendário), ChatOps do gestor, Settings (menu, General, Fiscal, Serviços e área de cobertura, WhatsApp e respostas, cancelamento, lucro, alocação, avisos, feed, eliminação de contas) e Equipe & Clientes. Relatórios: cabeçalho, tabs, KPIs e gráficos da aba Stats. Ainda em inglês: Meta/Chatwoot aninhados, manutenção/DataSanity, portal do cliente e o resto das vistas de Relatórios.
- Portal do cliente dentro do app.
- (Opcional, futura) e-mails, PDF, WhatsApp e páginas públicas no idioma do destinatário.
Testes e verificação
Section titled “Testes e verificação”tsc:enept-BRcom as mesmas chaves.- Vitest: variáveis, plural e fallback para inglês.
shipped_copy_language:src/i18n/pt-BR.tscomo único lugar permitido para português.- Navegador (
test:browsers): entrar compt-BRe ver uma tela da etapa em português; o chat continua traduzindo. - Orçamento de bundle: bundle inicial sem crescimento.
- Verificação visual das telas da etapa nos dois idiomas — português é mais longo e costuma quebrar botões e cards.
i18n_copy_contract: toda chave doen.tsé lida por alguma tela, e um arquivo que já usat()não ganha texto em inglês fora deSTILL_ENGLISH(partes só de gestor da etapa 2, nomes de marca). A lista só diminui.
Como acrescentar texto
Section titled “Como acrescentar texto”- Crie a chave em
src/i18n/en.ts, na área certa, com o texto em inglês. - O
tscpassa a exigir a mesma chave emsrc/i18n/pt-BR.ts— escreva a tradução ali. - No componente, use
const { t } = useT()et('area.chave'); variáveis comot('visit.assignedTo', { name }). - Não escreva português fora de
pt-BR.ts: o teste de cópia recusa.