Communitygithub.com

PascaleBeier/hitkeep

HitKeep es una herramienta de analítica centrada en la privacidad para humanos y agentes de IA, alojada localmente o en regiones cloud gestionadas de la UE/EE. UU.

¿Qué es hitkeep?

HitKeep ofrece analíticas web respetando la privacidad, permitiendo a desarrolladores y agentes de IA configurar un seguimiento sin cookies ni identificadores personales. Es compatible con autohosting o despliegue en regiones cloud de la UE y EE. UU. para cumplir con normativas como el GDPR. La habilidad 'hitkeep' facilita la integración con el panel de control de HitKeep, gestionando la internacionalización (i18n) mediante archivos JSON de Transloco, formatos regionales con `@jsverse/transloco-locale` y las APIs `Intl` del navegador. Soporta siete idiomas (en, de, es, fr, it, nl, pt) y asegura que los cambios en el texto visible se realicen de forma coherente a través de la configuración de Transloco, los archivos de traducción y el mapeo de formatos regionales. Incluye scripts de verificación y sincronización para mantener la consistencia clave, y proporciona pautas detalladas para traducciones de alta calidad en cada idioma.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add PascaleBeier/hitkeep

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

HitKeep i18n

Usa esta habilidad cuando estés cambiando texto del panel de control visible para el usuario o formatos localizados en HitKeep.

El panel de control de HitKeep utiliza archivos JSON de Transloco para el texto de la interfaz de usuario y @jsverse/transloco-locale más las APIs Intl del navegador para formatos sensibles a la configuración regional. Las etiquetas de PrimeNG se sincronizan desde el idioma activo de Transloco.

Superficie Pública

Los archivos de traducción del panel están en:

  • 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

El panel actualmente expone estos identificadores de idioma:

en, de, es, fr, it, nl, pt

Las asignaciones de configuración regional para formateo están configuradas en 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

No inferir un nuevo idioma soportado únicamente a partir de un helper de configuración regional de Angular. Agregar o cambiar un idioma soportado del panel solo cuando la configuración de Transloco, el archivo JSON de configuración regional, la asignación de formato y la documentación del producto estén todos de acuerdo.

Flujo de trabajo

  1. Buscar la clave de funcionalidad existente antes de crear una nueva.
  2. Poner el texto de la plantilla Angular visible para el usuario detrás de TranslocoPipe.
  3. Usar TranslocoService para etiquetas calculadas en TypeScript.
  4. Agregar la misma ruta de clave a los siete archivos JSON de configuración regional.
  5. Mantener los nombres de clave semánticos y agrupados por funcionalidad.
  6. Preservar las variables de interpolación exactamente. No traducir nombres de variables ni cambiar la sintaxis de los marcadores de posición.
  7. Para etiquetas de opciones calculadas, depender del idioma activo para que las etiquetas se recalculen después de cambios de idioma.
  8. Para fechas, números, porcentajes y duraciones, preferir los servicios o helpers de configuración regional existentes en lugar de formatear cadenas manualmente.
  9. Dejar que el texto de configuración regional de PrimeNG fluya a través del servicio de sincronización existente en lugar de codificar etiquetas de componentes.
  10. Mantener las etiquetas lo suficientemente cortas para botones, pestañas, chips, columnas de tabla y diseños móviles.

Lugares útiles para inspeccionar:

  • 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

Nivel de calidad de traducción

Traducir el producto de la interfaz de usuario, no palabras individuales en inglés.

  • Alemán: usar alemán de producto natural y caracteres correctos como Ä, Ö, Ü, ä, ö, ü y ß.
  • Español: usar acentos, ñ y puntuación de apertura cuando sea necesario, por ejemplo ¿Seguro?.
  • Francés: usar acentos y apóstrofos de forma natural, por ejemplo paramètres, sécurité y l'adresse e-mail.
  • Italiano: usar acentos cuando sea necesario, especialmente palabras con acento final como attività, città, perché, può y è.
  • Neerlandés: mantener la terminología del panel natural y concisa. Reutilizar términos existentes para sitio, equipo, objetivo, embudo, enlace compartido y cliente de API.
  • Portugués: usar el contexto de formato de portugués brasileño existente (pt-BR) a menos que el producto cambie explícitamente el objetivo de configuración regional. Usar portugués natural con acentos correctos.

Mantener la terminología de analítica consistente en todos los idiomas. Si el repositorio ya usa un término para "sitio", "equipo", "evento", "objetivo", "embudo", "enlace compartido", "cliente de API", "campaña QR" u "Oportunidad", reutilizarlo.

Verificaciones

Ejecutar la verificación de configuración regional después de cambios de traducción:

cd frontend/dashboard && npm run i18n:check

Si se sospecha una desviación en la forma de las claves, ejecutar el script de sincronización y revisar los cambios resultantes antes de conservarlos:

cd frontend/dashboard && node scripts/sync-i18n-locales.mjs

Ejecutar verificaciones de formato para los archivos del panel:

cd frontend/dashboard && npm run fmt:check

Para el comportamiento de la interfaz de usuario que depende del cambio de idioma, agregar o actualizar pruebas específicas cerca del componente o servicio que posee el comportamiento.

Salida para revisiones

Al informar un cambio de i18n, incluir:

Claves cambiadas:
- <ruta de clave>

Configuraciones regionales actualizadas:
- en, de, es, fr, it, nl, pt

Verificaciones:
- <comando y resultado>

Advertencias:
- <notas de diseño, redacción o revisión>

No afirmar que una traducción fue revisada por un hablante nativo a menos que eso realmente haya ocurrido.

Skills relacionados