Especialista em I18n
Visão Geral
Entregue uma configuração completa de i18n + auditoria: configure o framework i18n, substitua strings voltadas ao usuário por chaves, garanta paridade entre locales e valide pluralização/formatação para en-US e zh-CN.
Capacidades Principais
- Seleção e configuração de bibliotecas (React, Next.js, Vue).
- Arquitetura de chaves e organização de arquivos de locale.
- Geração de traduções e estratégia de qualidade (IA, profissional, manual).
- Roteamento e detecção/alternância de idioma.
- Localização de SEO e metadados (quando aplicável).
- Suporte a RTL (apenas se locales RTL estiverem no escopo).
Entradas de Escopo (pergunte se não estiver claro)
- Framework e estilo de roteamento.
- Estado atual do i18n (nenhum, parcial, legado).
- Locais alvo (padrão: en-US + zh-CN).
- Necessidades de qualidade de tradução (IA vs profissional vs manual).
- Formatos de locale em uso (JSON, YAML, PO, XLIFF).
- Requisitos de formalidade/cultura (se houver).
Fluxo de Trabalho (Auditar -> Corrigir -> Validar)
- Confirmar escopo e locais alvo
- Identifique o framework i18n e as localizações dos locales.
- Confirme os locales; o padrão é en-US + zh-CN quando especificado.
- Configurar baseline i18n (se ausente)
- Escolha uma biblioteca adequada ao framework (ex.: React: react-i18next; Next.js: next-intl; Vue: vue-i18n).
- Instale os pacotes e crie o arquivo de entrada/configuração i18n.
- Conecte o provider na raiz da aplicação e carregue os recursos de locale.
- Adicione um seletor de idioma e persistência (rota/parâmetro/localStorage) conforme apropriado.
- Estabeleça a estrutura de arquivos de locale e namespaces de chaves.
- Se o roteamento for sensível a locale, defina a estratégia de segmento de locale cedo (subcaminho, subdomínio, parâmetro de consulta).
- Se metadados forem voltados ao usuário, inclua tradução para títulos/descrições.
- Auditar uso de chaves e paridade de locale
- Execute:
python scripts/i18n_audit.py --src <raiz-src> --locale <caminho/en-US.json> --locale <caminho/zh-CN.json> - Trate chaves ausentes/lacunas de paridade como bloqueadores.
- Verifique manualmente chaves dinâmicas (
t(var)).
- Encontrar strings brutas voltadas ao usuário
- Pesquise:
rg -n --glob '<src>/**/*.{ts,tsx,js,jsx}' "<[^>]+>[^<{]*[A-Za-z][^<{]*<" rg -n --glob '<src>/**/*.{ts,tsx,js,jsx}' "aria-label=\\