sagas/odisea-del-blog-maestro/033-telemetria-hibrida.md

2026-03-24 draft

033 — Telemetría híbrida

033 — Telemetría híbrida

Hoy quedó clara una tensión clásica: queremos un tablero vivo, pero no queremos regalar secretos al navegador.

La salida fue dividir la telemetría en dos planos:

  • Plano privado (build-time): Node.js consulta GitLab con GITLAB_TOKEN y deja un snapshot estático en src/content/system-stats.json.
  • Plano público (runtime): el cliente consulta solo el endpoint público del proyecto para estrellas, forks e ID.

La diferencia parece sutil, pero cambia todo:

  1. El frontend sigue siendo transparente y auditable.
  2. El token nunca cruza al HTML.
  3. El dashboard mantiene sensación de latido en vivo.

También hubo una decisión cultural: no confundir “tiempo real” con “todo desde cliente”. En un sistema con identidad técnica fuerte, seguridad y claridad pesan más que la ansiedad por actualizar cada segundo.

El resultado no es solo una tarjeta más bonita en /proyectos. Es una forma de trabajo: secreto en build, señal pública en runtime, contrato explícito en la spec.