HitKeep i18n
Use esta habilidade ao alterar texto do painel visível ao usuário ou formatação localizada no HitKeep.
O painel do HitKeep utiliza arquivos JSON Transloco para o texto da interface e @jsverse/transloco-locale junto com APIs Intl do navegador para formatação sensível ao local. Os rótulos do PrimeNG são sincronizados a partir do idioma ativo do Transloco.
Superfície Pública
Os arquivos de tradução do painel estão em:
frontend/dashboard/public/i18n/en.jsonfrontend/dashboard/public/i18n/de.jsonfrontend/dashboard/public/i18n/es.jsonfrontend/dashboard/public/i18n/fr.jsonfrontend/dashboard/public/i18n/it.jsonfrontend/dashboard/public/i18n/nl.jsonfrontend/dashboard/public/i18n/pt.json
O painel atualmente expõe estes IDs de idioma:
en, de, es, fr, it, nl, pt
Os mapeamentos de formatação de localidade estão configurados em frontend/dashboard/src/app/app.config.ts:
en -> en-US
de -> de-DE
es -> es-ES
fr -> fr-FR
it -> it-IT
nl -> nl-NL
pt -> pt-BR
Não inferir um novo idioma suportado apenas a partir de um auxiliar de localidade Angular. Adicione ou altere um idioma suportado do painel somente quando o config Transloco, o arquivo JSON de localidade, o mapeamento de formatação e a documentação do produto estiverem todos de acordo.
Fluxo de Trabalho
- Pesquise pela chave de funcionalidade existente antes de criar uma nova chave.
- Coloque o texto do template Angular visível ao usuário atrás do
TranslocoPipe. - Use o
TranslocoServicepara rótulos computados em TypeScript. - Adicione o mesmo caminho de chave a todos os sete arquivos JSON de localidade.
- Mantenha os nomes das chaves semânticos e agrupados por funcionalidade.
- Preserve exatamente as variáveis de interpolação. Não traduza nomes de variáveis nem altere a sintaxe do placeholder.
- Para rótulos de opções computadas, dependa do idioma ativo para que os rótulos sejam recalculados após a troca de idioma.
- Para datas, números, porcentagens e durações, prefira os serviços ou auxiliares de localidade existentes em vez de formatação manual de strings.
- Deixe o texto de localidade do PrimeNG fluir através do serviço de sincronização existente, em vez de codificar rótulos de componentes.
- Mantenha os rótulos curtos o suficiente para botões, guias, chips, colunas de tabela e layouts móveis.
Locais úteis para inspecionar:
frontend/dashboard/src/app/app.config.tsfrontend/dashboard/src/app/transloco-loader.tsfrontend/dashboard/src/app/core/i18n/frontend/dashboard/scripts/check-i18n-locales.mjsfrontend/dashboard/scripts/sync-i18n-locales.mjs
Padrão de Qualidade de Tradução
Traduza o produto UI, não palavras individuais em inglês.
- Alemão: use alemão natural do produto e caracteres corretos como
Ä,Ö,Ü,ä,ö,ü, eß. - Espanhol: use acentos,
ñ, e pontuação de abertura quando necessário, por exemplo¿Seguro?. - Francês: use acentos e apóstrofos naturalmente, por exemplo
paramètres,sécurité, el'adresse e-mail. - Italiano: use acentos quando necessário, especialmente palavras com acento tônico final como
attività,città,perché,può, eè. - Holandês: mantenha a terminologia do painel natural e concisa. Reutilize termos existentes para site, equipe, meta, funil, link de compartilhamento e cliente de API.
- Português: use o contexto de formatação português brasileiro existente (
pt-BR), a menos que o produto mude explicitamente o alvo de localidade. Use português natural com acentos corretos.
Mantenha a terminologia analítica consistente em todos os idiomas. Se o repositório já usa um termo para "site", "equipe", "evento", "meta", "funil", "link de compartilhamento", "cliente de API", "campanha QR" ou "Oportunidade", reutilize-o.
Verificações
Execute a verificação de localidade após alterações de tradução:
cd frontend/dashboard && npm run i18n:check
Se houver suspeita de desvio na estrutura de chaves, execute o script de sincronização e revise as alterações resultantes antes de mantê-las:
cd frontend/dashboard && node scripts/sync-i18n-locales.mjs
Execute verificações de formatação para arquivos do painel:
cd frontend/dashboard && npm run fmt:check
Para comportamentos de UI que dependem da troca de idioma, adicione ou atualize testes focados perto do componente ou serviço que possui o comportamento.
Saída para Revisões
Ao relatar uma alteração de i18n, inclua:
Chaves alteradas:
- <caminho da chave>
Localidades atualizadas:
- en, de, es, fr, it, nl, pt
Verificações:
- <comando e resultado>
Ressalvas:
- <anotações de layout, redação ou revisão>
Não afirme que uma tradução foi revisada por um falante nativo, a menos que isso realmente tenha acontecido.