Cómo construir una app web para la propiedad centralizada de métricas
Aprende un plan práctico para construir una app web que centralice definiciones de métricas, propietarios, aprobaciones y su reutilización entre equipos.

Qué significan las “métricas centralizadas” (y por qué importan)
Métricas centralizadas significa que tu empresa tiene un único lugar compartido donde se definen, poseen y explican las métricas de negocio —para que todos trabajen con el mismo manual. En la práctica, es un catálogo de métricas (un diccionario de KPI) donde cada métrica tiene una definición aprobada única, un propietario responsable y orientación clara sobre su uso.
El problema: “la misma métrica, respuestas distintas”
Sin una definición centralizada, los equipos crean naturalmente sus propias versiones del mismo KPI. “Usuarios activos” puede significar “inició sesión” en Producto, “tuvo cualquier evento” en Analytics, y “suscriptores de pago que usaron una función” en Finanzas.
Cada versión puede ser razonable en aislamiento—pero cuando un dashboard, una revisión trimestral y un reporte de facturación no coinciden, la confianza se erosiona rápido.
También aparecen costes ocultos: trabajo duplicado, hilos largos en Slack para conciliar números, cambios de última hora antes de revisiones ejecutivas y una pila creciente de conocimiento tribal que se rompe cuando la gente cambia de rol.
El objetivo: una sola fuente de verdad para definiciones y propiedad
Una app de métricas centralizada crea una única fuente de verdad para:
- Definiciones de métricas (fórmula, reglas de inclusión/exclusión, ventanas temporales)
- Propiedad de la métrica (quién la mantiene y quién aprueba cambios)
- Contexto de uso (dónde debe usarse y dónde no)
No se trata de imponer un único número para cada pregunta: se trata de hacer las diferencias explícitas, intencionales y fácilmente descubribles.
Quién se beneficia (y cómo)
- Equipos de Analytics dejan de reinventar métricas y pueden aplicar definiciones coherentes de KPI.
- Product lanza más rápido con menos debates en la lectura de experimentos.
- Finanzas y Operaciones obtienen reporting estable para previsiones y planificación.
- Liderazgo consigue KPI fiables y comparables entre equipos.
Criterios de éxito a los que aspirar
Sabrás que la gobernanza de métricas centralizada funciona cuando hay menos disputas sobre métricas, ciclos de reporting más rápidos, menos preguntas “¿qué definición usaste?” y KPI consistentes entre dashboards y reuniones, incluso a medida que la compañía escala.
Alcance y modelo de datos: qué debe almacenar tu app
Antes de diseñar pantallas o flujos, decide de qué se debe responsabilizar la app. Una app de métricas centralizada falla cuando las definiciones viven en comentarios, hojas de cálculo o en la cabeza de las personas. Tu modelo de datos debe hacer que cada métrica sea explicable, buscable y modificable de forma segura.
Objetos principales (el catálogo mínimo)
La mayoría de equipos puede cubrir la mayoría de casos con estos objetos:
- Métrica: el KPI en sí (p. ej., “Usuarios Activos Mensuales”).
- Dimensión: cómo se segmenta la métrica (p. ej., país, plan, dispositivo).
- Fuente: de dónde provienen los datos (tabla del warehouse, stream de eventos, CRM).
- Propietario: persona o equipo responsable (a menudo enlazado a un directorio de usuarios/grupos).
- Dashboard/Reporte: donde se consume la métrica (activo de BI, notebook, presentación).
- Etiqueta: clasificación ligera (p. ej., Crecimiento, Finanzas, North Star, OKR 2026).
Estos objetos hacen que el catálogo se sienta completo: los usuarios pueden saltar de una métrica a sus cortes, origen, responsable y dónde aparece.
Campos obligatorios para un registro de Métrica
Una página de métrica debe responder: ¿Qué es? ¿Cómo se calcula? ¿Cuándo debería usarla?
Incluye campos como:
- Nombre (amigable) y descripción corta.
- Definición de negocio (en lenguaje claro).
- Fórmula / lógica (fragmento SQL, pseudocódigo o pasos de cálculo).
- Grano (qué representa una fila/valor: user-day, orden, account-month).
- Filtros por defecto y filtros permitidos (qué se incluye/excluye, salvedades conocidas).
- Unidad (conteo, %, $, minutos) y agregación (sum, avg, distinct count).
- Ejemplos (interpretaciones reales y preguntas comunes que responde).
Campos de gobernanza (para controlar cambios)
Incluso a nivel de modelo de datos, planifica la gobernanza:
- Estado: draft / approved / deprecated.
- Fechas efectivas: cuándo empieza/termina a ser válida una definición.
- Aprobadores: usuario(s) o grupo(s) requeridos para la aprobación.
- Razón de deprecación y métrica de reemplazo (si procede).
Relaciones que deberías modelar explícitamente
Los buenos catálogos son navegables:
- Una Métrica depende de Fuentes (tablas, eventos, pipelines) y puede apoyarse en Dimensiones específicas.
- Un Dashboard/Reporte usa Métricas (relación muchos-a-muchos), opcionalmente con un indicador de “métrica primaria”.
- Propietarios se relacionan tanto con Métricas como con Fuentes (quién arregla el pipeline vs. quién posee el significado del KPI).
Si aciertas con estos objetos y relaciones, la UX posterior (explorar el catálogo, páginas de métricas, plantillas) será sencilla —y las definiciones permanecerán coherentes conforme la compañía crece.
Roles, responsabilidades y propiedad de métricas
Una app de métricas centralizada solo funciona cuando cada métrica tiene un “adulto en la sala”. La propiedad responde a preguntas básicas rápidamente: ¿Quién garantiza que esta definición es correcta? ¿Quién aprueba cambios? ¿Quién comunica qué cambió?
Roles principales en la app
Propietario de la métrica
La persona responsable del significado y uso de la métrica. Los propietarios no necesitan escribir SQL, pero sí autoridad y contexto.
Steward / revisor
Un guardián de calidad que verifica que las definiciones sigan estándares (nombres, unidades, reglas de segmentación, filtros permitidos), y que la métrica esté alineada con las métricas existentes.
Contribuidor
Cualquiera que pueda proponer una nueva métrica o sugerir ediciones (Product Ops, Analytics, Finanzas, Growth, etc.). Los contribuidores mueven ideas, pero no publican cambios por su cuenta.
Consumidor
La mayoría de usuarios: personas que leen, buscan y consultan métricas en dashboards, documentos y planificación.
Admin
Gestiona el sistema: permisos, asignación de roles, plantillas y acciones de alto riesgo como reasignación forzada de propiedad.
Responsabilidades de la propiedad (qué significa “poseer” realmente)
Los propietarios son responsables de:
- Precisión de la definición: significado de negocio, reglas de inclusión/exclusión, unidades y grano (p. ej., user-day vs. account-month).
- Aprobaciones de cambios: revisar solicitudes, confirmar impacto y aprobar o rechazar actualizaciones.
- Comunicación: asegurar que los equipos afectados conozcan las actualizaciones (nota de lanzamiento, hilo de comentarios o notificación).
- Higiene del ciclo de vida: marcar métricas como deprecadas cuando sean sustituidas y apuntar al reemplazo.
Expectativas de flujo estilo RACI
Define expectativas directamente en la UI para que la gente no adivine:
- Proponer (Contributor): redacta una métrica o solicitud de cambio con la razón y ejemplos.
- Revisar (Steward/Reviewer): comprueba estándares, duplicados, nomenclatura y claridad.
- Aprobar (Owner): decisión final; responsable del impacto downstream.
- Archivar/Deprecate (Owner + Admin para forzar): el propietario inicia; el admin puede ejecutar si es necesario.
Escalado cuando falta o se disputa la propiedad
Haz de “métrica sin propietario” un estado de primera clase. Un camino pragmático:
- Sugerir propietarios automáticamente (basado en etiquetas de dominio/equipo o quien creó la métrica).
- Asignación con límite de tiempo: si no se asigna en X días, notificar al líder del equipo relevante.
- Resolución de disputas: el steward medía; si no se resuelve, escalar a un responsable de gobernanza de datos o jefe de departamento.
Esta estructura previene métricas fantasma y mantiene las definiciones estables cuando los equipos cambian.
Flujo de gobernanza: Draft, Review, Approve, Deprecate
Una app de métricas centralizada funciona cuando está claro quién puede cambiar una métrica, cómo se evaluan los cambios y qué garantiza que algo esté “aprobado”. Un modelo simple y fiable es un flujo impulsado por estados con permisos explícitos y un rastro visible.
Estados: qué permite cada uno
Draft → Review → Approved → Deprecated debe ser más que etiquetas: cada estado debe controlar el comportamiento:
- Draft: cualquiera con derechos de autor puede crear o editar. Las métricas en draft pueden estar incompletas, pero la app debe validar lo básico (nombre, propietario, fuente de datos).
- Review: las ediciones están restringidas (o requieren una nueva solicitud de cambio). Los revisores pueden comentar, pedir actualizaciones y ejecutar comprobaciones. La métrica es visible para stakeholders, pero marcada claramente como no autoritativa.
- Approved: la definición y la lógica de consulta están bloqueadas (o las ediciones requieren una solicitud formal). Las métricas aprobadas son elegibles para integraciones downstream (sincronización BI, acceso por API) y pueden referenciarse como fuente de verdad.
- Deprecated: solo lectura, claramente señalizada y excluida de plantillas y resultados “recomendados”. Proporciona un enlace de reemplazo y la razón de la deprecación.
Flujo de propuesta: crear/solicitar cambio con justificación
Trata nuevas métricas y cambios como propuestas. Una propuesta debe capturar:
- Qué cambia (texto de definición, filtros, grano, SQL/lógica, propietario, umbrales)
- Por qué (razón)
- Quién se ve afectado (equipos, dashboards, alertas)
- Cuándo debe entrar en vigor (opcionalmente con fecha efectiva)
Lista de comprobación de revisión para evitar KPI “casi iguales”
Una checklist consistente mantiene las revisiones rápidas y justas:
- Claridad de la definición e intención de negocio
- Filtros e inclusiones/exclusiones (incluyendo ventanas temporales)
- Grano (por usuario, por orden, por día) y cómo se agrega
- Casos límite (reembolsos, cancelaciones, IDs faltantes, datos que llegan tarde)
- Estándares de nombres y consistencia con métricas existentes
Auditabilidad: quién aprobó qué y cuándo
Cada transición debe quedar registrada: proponente, revisores, aprobador, marcas temporales y un diff de lo que cambió. Este historial permite responder con confianza: “¿Cuándo cambió este KPI y por qué?” También facilita revertir cuando una definición causa sorpresas.
UX de la app: Catálogo, páginas de métrica y plantillas
Tu app tendrá éxito o fracasará según si alguien puede responder, en menos de un minuto: “¿Esta métrica es real, está vigente y quién la posee?” La UX debe sentirse más como un catálogo de producto bien organizado que como una herramienta de datos.
Catálogo: explorar, buscar, filtrar
Empieza con una página principal del catálogo que facilite escaneo rápido y selección confiable.
Haz la navegación principal con criterio:
- Explorar por dominio/equipo (p. ej., Crecimiento, Finanzas, Soporte)
- Búsqueda con coincidencias tolerantes (alias, abreviaturas comunes)
- Filtros que reflejen la gobernanza: etiqueta, estado (Draft/Approved/Deprecated), propietario y fuente de datos
Cada tarjeta/fila de métrica debe mostrar el conjunto mínimo de decisión: nombre de la métrica, definición corta, insignia de estado, propietario y fecha de última actualización. Esto evita que los usuarios tengan que entrar a múltiples páginas solo para saber si una métrica es utilizable.
Página de detalle de la métrica: todo lo que necesitas, nada que no
Una página de métrica debe leerse de arriba abajo como una ficha técnica:
- Definición en lenguaje claro (un párrafo) más por qué importa
- Propietario y propietario de respaldo, con una acción clara de “Hacer una pregunta”
- Reglas de negocio (qué se incluye/excluye), granularidad y cadencia de actualización
- Consulta de ejemplo (opcional) y enlace al dataset canónico
- Uso: dashboards, reportes y equipos que dependen de ella
- Historial de cambios: qué cambió, cuándo y por qué
Mantén el contenido técnico colapsable (“Mostrar SQL / detalles de cálculo”) para que los usuarios no técnicos no tengan que procesarlo obligatoriamente.
Plantillas que guían buenas definiciones
Las plantillas reducen la inconsistencia. Usa campos obligatorios (nombre, definición, propietario, estado, dominio, numerador/denominador o fórmula) y ofrece redacciones sugeridas como “Count of…” o “Percentage of…”. Pre-llena ejemplos para evitar entradas vacías y vagas.
UX para usuarios no técnicos
Escribe para la claridad: evita siglas en títulos, soporta sinónimos (“Usuarios Activos” vs. “DAU”) y muestra tooltips para jerga inevitable. Empareja siempre una métrica con un propietario humano: la gente confía más en personas que en tablas.
Control de acceso: auth, permisos y controles de admin
Si una app de métricas es donde las definiciones se vuelven oficiales, el control de acceso no puede ser una ocurrencia tardía. No solo proteges datos: proteges decisiones: qué cuenta como Ingresos, quién puede cambiarlo y cuándo.
Autenticación: elige lo que encaje con tu organización
Empieza con un enfoque claro de login y mantenlo consistente:
- SSO/OAuth (recomendado para equipos grandes): funciona bien con Google/Microsoft/Okta para que los empleados usen cuentas existentes y el offboarding sea automático.
- Email + contraseña: válido para empresas más pequeñas o usuarios externos mixtos, pero añade verificación de email y flujos de reset.
Sea lo que sea, haz que la identidad sea estable: los usuarios deben tener un ID único aunque su email cambie.
Autorización: RBAC más propiedad
Usa control de acceso basado en roles (RBAC) para permisos amplios y añade propiedad a nivel de recurso para precisión.
Un modelo simple:
- Viewer: acceso solo lectura al catálogo
- Editor: crea borradores, propone cambios
- Approver (Steward): aprueba definiciones dentro de dominios asignados
- Admin: gestiona configuración org, roles, dominios y políticas
Luego superpone reglas de propiedad como “Solo el propietario de la métrica (o el aprobador de dominio) puede editar la definición aprobada.” Esto evita ediciones oportunistas y permite colaboración.
Protege acciones clave con fricción extra
Algunas acciones requieren cheques más fuertes porque alteran la confianza:
- Aprobaciones y publicación (quién puede hacer oficial una métrica)
- Deprecaciones y eliminaciones (evitar romper dashboards)
- Cambios de permisos y propiedad (impedir escalado de privilegios)
Salvaguardas prácticas: diálogos de confirmación con texto de impacto claro, razones obligatorias para cambios y (para acciones sensibles) reautenticación o aprobación admin.
Controles de admin: donde la gobernanza es manejable
Añade un área de admin que soporte operaciones reales:
- Equipos y dominios (p. ej., Ventas, Finanzas, Producto)
- Asignación de roles y transferencia de propiedad
- Ajustes de políticas (reglas de nombres, campos obligatorios, requisitos de aprobación)
Incluso si tu primera versión es pequeña, diseñar estos controles temprano evita excepciones desordenadas y hace que la gobernanza se sienta predecible en lugar de política.
Versionado, historial y cambios seguros
Cuando una métrica cambia, la confusión se propaga más rápido que la actualización. Una app de métricas centralizada debe tratar cada definición como un lanzamiento de producto: versionada, revisable y fácil de revertir (al menos conceptualmente) si algo sale mal.
Versiona cada cambio significativo
Crea una nueva versión siempre que algo pueda afectar la interpretación: texto de definición, lógica de cálculo, inclusión/exclusión de datos, propiedad, umbrales o incluso el nombre. “Edición menor” y “edición mayor” pueden existir, pero ambas deben capturarse como versiones para que la gente pueda responder: ¿Qué definición usamos cuando tomamos esa decisión?
Una regla práctica: si un interesado podría preguntar “¿cambió esta métrica?”, merece una nueva versión.
Un changelog que la gente pueda leer
Cada página de métrica debe incluir una línea temporal clara que muestre:
- Qué cambió (resumen antes/después, no solo texto crudo)
- Por qué cambió (la razón de negocio)
- Quién lo aprobó (nombre + rol)
- Cuándo sucedió (marca temporal, y si está fechada para el futuro)
Las aprobaciones deben vincularse a la versión exacta que autorizaron.
Fechado efectivo para transiciones reales
Muchas métricas necesitan definiciones que cambien en un punto específico en el tiempo (nuevo precio, nuevo empaquetado, política revisada). Soporta fechas efectivas para que la app pueda mostrar:
- Definición actual
- Definición próxima (efectiva el 1 de enero)
- Definiciones pasadas
Esto evita reescribir la historia y ayuda a los analistas a alinear correctamente los periodos de reporting.
Deprecación sin romper la confianza
La deprecación debe ser explícita, no silenciosa. Cuando una métrica se depreca:
- Márcala como Deprecated con una razón corta
- Redirígela a una métrica de reemplazo (o lista alternativas)
- Muestra una advertencia persistente en la página de la métrica y en resultados de búsqueda
Bien hecha, la deprecación reduce KPI duplicados preservando contexto para dashboards antiguos y decisiones pasadas.
Integraciones: BI, warehouse, notificaciones y APIs
Una app de métricas centralizada solo se vuelve fuente de verdad cuando encaja en cómo la gente ya trabaja: dashboards en BI, consultas en el warehouse y aprobaciones en chat. Las integraciones convierten definiciones en algo que los equipos pueden confiar y reutilizar.
Trazabilidad BI (dashboards → métricas)
La página de una métrica debe responder: “¿Dónde se usa este número?” Añade una integración BI que permita enlazar una métrica con dashboards, reportes o tiles específicos.
Esto crea trazabilidad bidireccional:
- Desde la página de la métrica: ver todos los dashboards que dependen de ella (con enlaces relativos como
/bi/dashboards/123si haces proxy o almacenas referencias internas). - Desde un dashboard: mostrar la definición de la métrica que usa (propietario, fórmula, filtros, grano y estado actual).
La ganancia práctica es auditorías más rápidas y menos debates: cuando un dashboard se ve extraño, la gente puede verificar la definición en vez de re-litigarla.
Integración con el warehouse (SQL de ejemplo + referencias a tablas/modelos)
La mayoría de desacuerdos de métricas empieza en la consulta. Haz explícita la conexión con el warehouse:
- Almacena SQL de ejemplo para la métrica (la consulta de referencia que la gente puede comparar).
- Guarda referencias a las tablas/modelos subyacentes (p. ej., tablas del warehouse, modelos dbt o entidades de la capa semántica).
- Opcionalmente almacena salvedades conocidas como datos que llegan tarde o reglas de zona horaria.
No necesitas ejecutar consultas en la app al principio. Incluso SQL estático más lineage da a los revisores algo concreto que validar.
Notificaciones en Slack/Teams para eventos de gobernanza
Enviar gobernanza por email ralentiza todo. Publica notificaciones en Slack/Teams para:
- Solicitud de revisión
- Aprobado / rechazado
- Deprecación programada
- Cambio rompedor detectado (p. ej., definición que afecta dashboards vinculados)
Incluye un enlace profundo a la página de la métrica y a la acción específica (revisar, aprobar, comentar).
API + webhooks para automatización
Una API permite que otros sistemas traten métricas como un producto, no como un documento. Prioriza endpoints para búsqueda, lectura y estado:
- Listar/buscar métricas, propietarios y etiquetas
- Obtener la definición aprobada actual y su versión
- Crear solicitudes de revisión y añadir comentarios
Añade webhooks para que las herramientas puedan reaccionar en tiempo real (p. ej., anotar un BI cuando una métrica se depreca). Documenta esto en /docs/api y mantén payloads estables para que las automatizaciones no fallen.
En conjunto, estas integraciones reducen el conocimiento tribal y mantienen la propiedad de métricas visible dondequiera que se tomen decisiones.
Estándares de definición y comprobaciones de calidad
Una app de métricas solo funciona cuando las definiciones son lo bastante consistentes para que dos personas leyendo la misma métrica lleguen a la misma interpretación. Los estándares y comprobaciones de calidad convierten “una página con una fórmula” en algo que los equipos pueden confiar y reutilizar.
Estándares de definición para aplicar
Empieza estandarizando los campos que toda métrica debe tener:
- Nombre y descripción corta: usa un patrón de nombres consistente (por ejemplo, “Revenue (Net)” vs. “Revenue”).
- Unidad y formato: moneda, porcentaje, conteo o duración. Incluye reglas de redondeo (p. ej., 2 decimales) y convenciones de visualización.
- Ventana temporal: indica claramente el grano por defecto y el lookback (diario/semanal/mensual, trailing 7 days, MTD, etc.).
- Filtros por defecto: qué se incluye/excluye por defecto (región, línea de producto, canal). Los valores por defecto deben ser explícitos para que los dashboards no derivan silenciosamente.
Haz que estos campos sean obligatorios en la plantilla de la métrica, no “recomendados”. Si una métrica no cumple el estándar, no está lista para publicar.
Casos límite que deberías documentar
La mayoría de desacuerdos ocurre en los bordes. Añade una sección dedicada a “Casos límite” con indicaciones para:
- Nulos y registros faltantes: ¿se tratan los nulos como cero, se excluyen o se marcan?
- Datos que llegan tarde: ¿qué cambia después y durante cuánto tiempo la métrica se considera provisional?
- Reembolsos/cancelaciones/chargebacks: ¿ajustan periodos históricos o solo el periodo actual?
- Desduplicación y reglas de identidad: ¿qué cuenta como usuario/orden único?
Campos de validación y límites conocidos
Añade campos estructurados de validación para que los usuarios sepan cuando una métrica está sana:
- Expectativa de frescura de datos (p. ej., actualizada cada hora, diariamente antes de las 9am)
- Tablas/fuentes de registro
- Limitaciones conocidas (brechas de cobertura, backfills, muestreo)
Una checklist de “Calidad de Definición”
Antes de aprobar, exige una checklist como:
- Nombre, unidad, ventana temporal y filtros por defecto completados
- Fórmula o lógica documentada (y revisada)
- Casos límite rellenados
- Expectativa de frescura establecida
- Propietario asignado y ruta de contacto clara
La app debe bloquear el envío o la aprobación hasta que los items requeridos pasen, convirtiendo la calidad de directriz en un flujo de trabajo.
Adopción: hacer del catálogo el lugar por defecto para buscar
Un catálogo de métricas solo funciona cuando se convierte en la primera parada para “¿Qué significa este número?” La adopción es un problema de producto, no solo de gobernanza: necesitas valor claro para usuarios diarios, caminos de contribución de baja fricción y respuesta visible de los propietarios.
Mide la adopción como producto
Instrumenta señales simples que indiquen si la gente realmente usa el catálogo:
- Búsquedas realizadas (y tasa de “sin resultados”)
- Vistas de páginas de métricas y puntos de entrada principales (búsqueda vs. enlaces)
- Aprobaciones completadas y tiempo medio de aprobación
- Reutilización: qué métricas se enlazan en dashboards, docs y tickets
Usa estas señales para priorizar mejoras. Por ejemplo, una alta tasa de “sin resultados” suele significar nombres inconsistentes o sinónimos faltantes —arreglable con mejores plantillas y curación.
Construye bucles de feedback en cada página de métrica
La gente confía más en definiciones cuando puede hacer preguntas en contexto. Añade feedback ligero donde aparezca la confusión:
- Hilos de comentarios/preguntas por métrica
- Flujo de “Sugerir una edición” que cree una solicitud de cambio (en lugar de editar en sitio)
- Reacciones rápidas como “Esto respondió mi pregunta” para medir utilidad
Encamina el feedback al propietario y steward, y muestra el estado (“triageado”, “en revisión”, “aprobado”) para que los usuarios vean progreso en lugar de silencio.
Onboarding con dos rutas breves
La adopción se frena cuando los usuarios no saben cómo contribuir con seguridad. Proporciona dos guías prominentes y enlázalas desde estados vacíos y la navegación:
- Cómo agregar una métrica: cuándo crear una nueva, campos obligatorios, ejemplos
- Cómo solicitar cambios: cuándo abrir una solicitud de cambio, qué evidencia incluir
Mantén estas páginas vivas (p. ej., /docs/adding-a-metric y /docs/requesting-changes).
Crea una cadencia semanal predecible
Establece una reunión semanal de revisión (30 minutos basta) con propietarios y stewards para:
- Limpiar aprobaciones pendientes
- Triagear preguntas nuevas y ediciones sugeridas
- Identificar duplicados y candidatos a fusión
La consistencia es la rueda de adopción: respuestas rápidas generan confianza y la confianza impulsa el uso repetido.
Básicos de seguridad, cumplimiento y plan de despliegue
La seguridad para una app de propiedad de métricas no solo trata de prevenir brechas: también de mantener el catálogo confiable y seguro para compartir. La clave es ser claro sobre qué pertenece en el sistema, qué no y cómo se registran los cambios.
Clasificación de datos: almacenar definiciones, no datos sensibles
Trata la app como fuente de verdad para el significado, no como repositorio de hechos brutos.
Almacena de forma segura:
- Nombres de métricas, descripciones, fórmulas y reglas de inclusión/exclusión
- Propiedad, cadencia de revisión y enlaces a dashboards (p. ej.,
/dashboards/revenue) - Fuentes de datos a alto nivel (p. ej., “tabla orders”) sin copiar datos
Evita almacenar:
- Datos a nivel de fila de clientes, emails, device IDs o tickets de soporte
- Exportes de resultados de consultas, capturas con datos personales o datasets de ejemplo
- Secrets (claves API), credenciales del warehouse o tokens privados
Cuando los equipos quieran ejemplos, usa ejemplos sintéticos (“Pedido A, Pedido B”) o agregados (“total de la semana pasada”) con etiquetas claras.
Logging y retención: auditar sin sobrecompartir
Querrás un historial de auditoría para cumplimiento y responsabilidad, pero los logs pueden convertirse accidentalmente en una fuga de datos.
Registra:
- Quién cambió qué y cuándo (diffs de definiciones, cambios de estado, aprobaciones)
- Cambios de permisos y acciones administrativas
No registres:
- Payloads completos de solicitud que puedan incluir datos pegados
- Tokens de acceso o credenciales
Define retenciones por política (por ejemplo, 90–180 días para logs estándar; más largo para eventos de auditoría) y separa eventos de auditoría de logs de depuración.
Backups y confiabilidad básicas
Expectativas mínimas:
- Backups automáticos diarios de la base de datos (más recuperación punto-en-tiempo si es posible)
- Pruebas regulares de restauración (un backup que no has restaurado es una esperanza, no un plan)
- Objetivos claros de RPO/RTO (cuánto puedes perder, qué tan rápido debes recuperarte)
Plan de despliegue: empezar pequeño y escalar
Comienza con un piloto en un dominio (p. ej., Revenue o Adquisición) y 1–2 equipos. Define métricas de éxito como “% de dashboards vinculados a métricas aprobadas” o “tiempo para aprobar un KPI nuevo”. Itera sobre fricciones y luego expande dominio por dominio con formación ligera y una expectativa clara: si no está en el catálogo, no es una métrica oficial.
Construir la app más rápido (nota práctica)
Si vas a convertir esto en una herramienta interna real, la vía más rápida suele ser lanzar una versión delgada pero completa: exploración del catálogo, páginas de métricas, RBAC y un flujo de aprobación —luego iterar.
Los equipos suelen usar Koder.ai para poner en vivo esa primera versión rápidamente: puedes describir la app en chat, usar el modo Planning para fijar el alcance y generar un stack funcional (React en frontend; Go + PostgreSQL en backend). A partir de ahí, snapshots y rollback te ayudan a iterar con seguridad, y la exportación de código mantiene libertad si quieres integrar el código en tu pipeline. Despliegue/hosting y dominios personalizados son útiles para rollouts internos, y los planes free/pro/business/enterprise facilitan empezar pequeño y escalar la gobernanza a medida que crece la adopción.
Preguntas frecuentes
¿Qué significa “métricas centralizadas” en la práctica?
Las métricas centralizadas significan que existe un lugar compartido y aprobado para definir los KPI —normalmente un catálogo de métricas/diccionario de KPI— para que los equipos no mantengan versiones en conflicto.
En la práctica, cada métrica tiene:
- Una única definición (significado de negocio + reglas de cálculo)
- Un propietario y aprobador nombrado
- Orientación clara sobre cuándo usar (y cuándo no usar) la métrica
¿Cómo sé si tenemos el problema de “la misma métrica, respuestas diferentes”?
Empieza inventariando los KPI que aparecen en revisiones ejecutivas, reportes de finanzas y los dashboards principales, y luego compara las definiciones lado a lado.
Señales comunes de alarma:
- Mismo nombre, pero filtros/ventanas temporales/grano diferentes
- La gente pregunta “¿qué definición usaste?” tras compartir un número
- Dashboards que discrepan con reportes de finanzas o facturación
- Métricas que viven en hojas de cálculo, hilos de Slack o conocimiento tribal
¿Cuál es el modelo de datos mínimo que debería almacenar una app de propiedad de métricas?
La mayoría de los equipos cubren bien los casos con estos objetos:
- Métrica (el KPI)
- Dimensión (cómo se segmenta)
- Fuente (tablas/eventos/sistemas de registro)
- Propietario (persona/equipo responsable)
- Dashboard/Reporte (donde se usa)
- Etiqueta (dominio/clasificación)
Modela las relaciones explícitamente (por ejemplo, dashboards usan muchas métricas; métricas dependen de múltiples fuentes).
¿Qué debería incluir cada página de detalle de métrica para ser útil?
Busca campos que respondan: ¿Qué es? ¿Cómo se calcula? ¿Cuándo debo usarla?
Un conjunto “requerido” práctico:
- Nombre + descripción corta
- Definición de negocio (lenguaje claro)
- Fórmula/lógica (SQL o pseudocódigo)
- Grano (p. ej., user-day, account-month)
- Unidad + regla de agregación
- Filtros por defecto y permitidos (inclusiones/exclusiones)
- Ejemplos + preguntas comunes que responde la métrica
¿Qué flujo de gobernanza funciona mejor para la creación y cambios de métricas?
Usa un flujo basado en estados que controle qué se puede editar y qué es “oficial”:
- Draft: edición flexible; validar básicos (nombre/propietario/fuente)
- Review: feedback y comprobaciones; restringir ediciones directas
- Approved: la definición está bloqueada; los cambios requieren una solicitud formal
- Deprecated: solo lectura; mostrar razón y reemplazo
Además, guarda un registro de propuesta que capture qué cambió, por qué, quién se ve afectado y cuándo entra en vigor.
¿Quién debería ser el propietario de una métrica y cuáles son sus responsabilidades?
Define roles claros y enlázalos con permisos:
- Propietario: responsable del significado/uso; aprueba cambios; comunica actualizaciones
- Steward/Reviewer: hace cumplir estándares; detecta duplicados e inconsistencias
- Contributor: propone nuevas métricas/ediciones mediante solicitudes de cambio
- Consumer: consulta y referencia definiciones
- Admin: gestiona roles, políticas y acciones de alto riesgo
Haz de “métrica sin propietario” un estado de primera clase con reglas de escalado (sugerir automáticamente → asignación con límite de tiempo → escalar al responsable de gobernanza).
¿Cómo debe manejar la app de métricas el versionado y las fechas efectivas?
Versiona cada vez que un cambio pueda alterar la interpretación (definición, lógica, filtros, grano, umbrales o incluso renombrados).
Incluye un changelog legible:
- Resumen antes/después
- Razonamiento de negocio
- Aprobador + marca temporal
Soporta fechas efectivas para mostrar definiciones actuales, próximas y pasadas sin reescribir la historia.
¿Qué modelo de permisos evita ediciones accidentales sin dejar de ser colaborativo?
Usa RBAC + propiedad a nivel de recurso:
- Viewer: solo lectura
- Editor: crea borradores, propone cambios
- Approver/Steward: aprueba dentro de dominios
- Admin: gestiona configuraciones y políticas
Añade fricción extra para acciones sensibles (publicar/aprobar, deprecar/eliminar, cambiar propiedad/permisos) con avisos de confirmación y razones obligatorias.
¿Qué integraciones hacen que un catálogo de métricas se use de verdad?
Prioriza integraciones que reduzcan fricción diaria:
- Trazabilidad BI: enlaza métricas ↔ dashboards/tiles para ver dónde se usa un número
- Referencias al warehouse: guarda SQL de ejemplo y enlaces a tablas/modelos (no hace falta ejecutar consultas al principio)
- Notificaciones: alertas en Slack/Teams para solicitudes de revisión, aprobaciones y deprecaciones
- API + webhooks: buscar/leer métricas, obtener definiciones/aprobaciones/versiones; documenta en /docs/api
¿Cómo hacemos el despliegue seguro y fomentamos la adopción en la compañía?
Trátalo como un despliegue de producto:
- Piloto en un dominio (p. ej., Revenue) con un par de equipos
- Mide uso (búsquedas, tasa de “sin resultados”, vistas de página, tiempo de aprobación)
- Añade bucles de feedback (comentarios, “sugerir edición” → solicitud de cambio)
Para seguridad, almacena definiciones y metadatos, no datos raw de clientes ni secretos. Mantén logs de auditoría para cambios/aprobaciones, políticas de retención y copias de seguridad con pruebas de restauración.