Diseño de panel de analítica
Un panel para un producto responde a una pregunta de un vistazo: ¿está creciendo y dónde están abandonando los usuarios? Todo en la página existe para responder eso y luego permitir que el propietario profundice en el porqué.
Esta habilidad se destiló de construir y operar el panel de analítica de una aplicación Mac lanzada (sitio web → descarga → instalación → prueba → pago), y de cada error que su propietario detectó en una captura de pantalla. El ejemplo funcional está en examples/product-analytics.html con datos de muestra fijos.
Cómo trabajar
Sigue los pasos en orden. Cada uno termina con un listo cuando puedas marcar la casilla.
1. Escribe primero el contrato de datos
Antes de cualquier interfaz de usuario, enumera cada número que mostrará la página y, para cada uno: el evento que cuenta, la ventana de conteo, si es único o total, la zona horaria y con qué "período anterior" se compara. Colócalo en la forma de la respuesta de la API, no en el código de la interfaz de usuario. Consulta references/metrics.md.
Listo cuando cada mosaico, columna y gráfico tenga una línea en el contrato, y dos lugares que muestren "el mismo" número lo lean del mismo campo.
2. Diseña la página
Barra lateral con enlaces a las secciones, una barra superior fija con el estado de actualización y el selector de período, luego las secciones en orden del recorrido: resumen → países → embudo → compradores → aplicación → retención → sitio web → eventos. Una columna de contenido, máximo 1280 px. Consulta references/layout.md.
Listo cuando el resumen responda a la pregunta de un vistazo sin hacer scroll a 1440 × 900.
3. Construye los componentes a partir de la referencia
Usa los patrones en references/components.md y el código en references/snippets.md: fila de KPI con líneas finas, deltas con una línea base de "era", minigráficos en la ventana del gráfico, pestañas de métricas subrayadas sobre un único gráfico con un alternador de tabla, tabla de países ordenable con una barra de participación en la columna ordenada, barras de embudo con conversión por paso, filas expandibles de compradores con una línea de tiempo, donas con una rebanada explícita de "no reportado", mapa de calor de retención con niveles clasificados.
Los colores provienen únicamente de los tokens en references/tokens.md; se requieren tanto el modo claro como el oscuro.
Listo cuando ningún componente invente un color, radio o tamaño de fuente fuera de los tokens.
4. Revisión de honestidad
Repasa references/metrics.md sección por sección. Los infractores habituales: un "−100%" sobre una base de 1, ingresos que van por detrás del proveedor de pagos, pedidos de $0 contados como clientes, sumas de únicos diarios etiquetadas como únicos, porciones de dona que silenciosamente excluyen a las personas que no reportaron, una "fuente" que es una suposición mostrada como un hecho.
Listo cuando cada número indique su ventana y cada estimación diga que lo es.
5. Revisión de privacidad
La analítica de un producto en el que la gente confía no debe convertirse en aquello en lo que desconfían. Sigue references/privacy.md: sin cookies en el sitio web, sin direcciones IP almacenadas, sin contenido de usuario en los eventos, IDs aleatorios por instalación, una opción de exclusión en la aplicación y recorridos unidos por un hash salado diario, nunca por identidad.
Listo cuando puedas pegar el esquema de eventos en la política de privacidad del producto sin editarlo.
6. Revisión de capturas de pantalla
Ejecuta references/qa.md: capturas de pantalla reales a 1440, 1024 y 390 px, en modo claro y oscuro, cada período, con los totales verificados contra números calculados fuera de la página. Mira las imágenes, no el código.
Listo cuando todas las capturas de pantalla estén limpias y los totales conocidos coincidan.
Reglas que aplican en todas partes
- Orden del recorrido. Las secciones siguen el camino que recorre un cliente, por lo que una caída se lee de arriba a abajo.
- Una ventana por número, indicada. "período", "hoy", "últimos 30 días" aparece debajo de la columna o en la sugerencia del mosaico.
- Compara cosas similares. El período anterior tiene la misma duración y termina donde comienza el actual.
- Sin exageraciones con bases pequeñas. 0 → 3 es "nuevo", no "+∞%"; un delta sobre 1 → 2 se muestra pero en silencio.
- Desconocido es una fila, no un agujero. Los países desconocidos, los permisos no reportados y las fuentes no coincidentes se muestran, se ordenan al final y se cuentan en los totales.
- La actualización es visible. "Actualizado 09:00 UTC" y "pagos sincronizados 08:57" en el encabezado; un punto rojo y un error en lenguaje sencillo cuando la carga falla.
- La tabla está siempre a un clic de distancia. Cada gráfico tiene los valores diarios exactos detrás de un alternador "Tabla".
- Teclado y lectores de pantalla. Los gráficos reciben el foco y recorren los puntos con ← →; los encabezados ordenables son botones con
aria-sort; las filas expandibles sonrole="button"conaria-expanded. - Sin dependencias. SVG, gradientes cónicos CSS e
Intlcubren todos los gráficos aquí; el ejemplo es un solo archivo HTML.
Estilo de la casa
Grises neutros, un color de serie azul, verde y rojo solo para bueno y malo, naranja solo para la marca. Texto base de 13.5 px, valores de KPI de 24 px, peso 600 para números y encabezados, cifras tabulares en todas partes donde un número puede cambiar. Líneas finas, no sombras. Radio de tarjeta de 8 px, controles de 6 px, barras de 4 px. Consulta references/tokens.md.
Formato de crítica
Cuando se te pida revisar un panel (código, una URL o una captura de pantalla), responde en este orden:
- Veredicto en una oración: ¿responde a la pregunta de un vistazo?
- Números que no coinciden — la misma métrica mostrando dos valores, totales que no suman, ventanas que no coinciden. Estos van primero porque destruyen la confianza.
- Problemas de honestidad de references/metrics.md.
- Problemas de privacidad de references/privacy.md.
- Problemas de diseño y componentes, clasificados por cuánto ralentizan al propietario.
- Lo que funciona — sé breve, pero dilo, para que un rediseño no lo pierda.
Cada problema: lo que viste, por qué es engañoso o ralentiza, la solución.
Referencias
| Archivo | Qué cubre |
|---|---|
| metrics.md | contrato de datos, ventanas de conteo, deltas, ingresos, atribución, embudos, cohortes |
| layout.md | barra lateral, barra superior, orden de secciones, cuadrículas, puntos de quiebre, diseño para teléfono |
| components.md | cada componente de la página, sus estados y su accesibilidad |
| tokens.md | tokens de color claro y oscuro, escala tipográfica y de espaciado |
| snippets.md | delta, marcas de eje bonitas, cubos, minigráfico, dona, lista de barras, niveles de mapa de calor, plural |
| privacy.md | visitas sin cookies, redes con hash, IDs de instalación, opción de exclusión, qué no recopilar nunca |
| qa.md | protocolo de capturas de pantalla, totales conocidos, tabla de olores |
| case-study-typecorrect.md | el panel real del que proviene esto y los errores que cada regla solucionó |