Skip to content

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.

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.

  • Fonte do idioma: user.language, que /api/auth/me já devolve a partir de preferred_language (employees ou clients). O Perfil já grava a preferência e chama updateUser({ 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.* em en.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 £.
  • src/i18n/en.ts — fonte: objeto de chaves agrupadas por área (nav.*, visit.*, profile.*…).
  • src/i18n/pt-BR.ts — tipado a partir de en.ts: o tsc falha se uma chave faltar. É o único arquivo de src onde texto em português pode morar (tests/shipped_copy_language.test.ts o libera e continua barrando português em qualquer outro lugar).
  • useT() — hook que lê user.language e devolve t(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 escolheu pt-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.
  1. 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.
  2. 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.
  3. Portal do cliente dentro do app.
  4. (Opcional, futura) e-mails, PDF, WhatsApp e páginas públicas no idioma do destinatário.
  • tsc: en e pt-BR com as mesmas chaves.
  • Vitest: variáveis, plural e fallback para inglês.
  • shipped_copy_language: src/i18n/pt-BR.ts como único lugar permitido para português.
  • Navegador (test:browsers): entrar com pt-BR e 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 do en.ts é lida por alguma tela, e um arquivo que já usa t() não ganha texto em inglês fora de STILL_ENGLISH (partes só de gestor da etapa 2, nomes de marca). A lista só diminui.
  1. Crie a chave em src/i18n/en.ts, na área certa, com o texto em inglês.
  2. O tsc passa a exigir a mesma chave em src/i18n/pt-BR.ts — escreva a tradução ali.
  3. No componente, use const { t } = useT() e t('area.chave'); variáveis como t('visit.assignedTo', { name }).
  4. Não escreva português fora de pt-BR.ts: o teste de cópia recusa.