Communitygithub.com

PascaleBeier/hitkeep

HitKeep é uma ferramenta de análise focada em privacidade para humanos e agentes de IA, auto-hospedada ou em regiões gerenciadas de nuvem UE/EUA.

O que é hitkeep?

HitKeep é uma plataforma de análise web que prioriza a privacidade, permitindo que desenvolvedores e agentes de IA coletem métricas de site sem comprometer dados dos visitantes. Pode ser auto-hospedada ou executada em regiões de nuvem gerenciadas na UE ou EUA. A skill de internacionalização (i18n) gerencia a tradução do texto do painel, usando arquivos JSON Transloco para a interface do usuário e APIs `Intl` do navegador para formatação localizada. Suporta os idiomas en, de, es, fr, it, nl e pt (com formatação pt-BR). A skill define um fluxo de trabalho para adicionar ou modificar traduções, garantindo consistência entre arquivos de idioma e mapeamentos de formatação, além de incluir verificações de qualidade e scripts de sincronização.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add PascaleBeier/hitkeep

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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.json
  • frontend/dashboard/public/i18n/de.json
  • frontend/dashboard/public/i18n/es.json
  • frontend/dashboard/public/i18n/fr.json
  • frontend/dashboard/public/i18n/it.json
  • frontend/dashboard/public/i18n/nl.json
  • frontend/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

  1. Pesquise pela chave de funcionalidade existente antes de criar uma nova chave.
  2. Coloque o texto do template Angular visível ao usuário atrás do TranslocoPipe.
  3. Use o TranslocoService para rótulos computados em TypeScript.
  4. Adicione o mesmo caminho de chave a todos os sete arquivos JSON de localidade.
  5. Mantenha os nomes das chaves semânticos e agrupados por funcionalidade.
  6. Preserve exatamente as variáveis de interpolação. Não traduza nomes de variáveis nem altere a sintaxe do placeholder.
  7. Para rótulos de opções computadas, dependa do idioma ativo para que os rótulos sejam recalculados após a troca de idioma.
  8. 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.
  9. 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.
  10. 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.ts
  • frontend/dashboard/src/app/transloco-loader.ts
  • frontend/dashboard/src/app/core/i18n/
  • frontend/dashboard/scripts/check-i18n-locales.mjs
  • frontend/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é, e l'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.

Habilidades Relacionadas