Cómo operar DataMetrixx

1. Primeros pasos

Después de crear tu cuenta desde datametrixx.com, recibirás un correo de confirmación. Una vez verificada tu cuenta, podrás acceder al panel de administración.

Al iniciar sesión por primera vez llegas al Dashboard, que resume el estado de tu cuenta: clientes activos, datasets cargados, publicaciones activas y uso de almacenamiento.

2. Roles y permisos

DataMetrixx maneja 5 roles con permisos jerárquicos:

3. Cómo fluyen los datos

Esta es la jerarquía mental que vas a usar todo el tiempo. Léela una vez y el resto de la plataforma tendrá sentido.

• Tu cuenta puede tener uno o varios clientes, según tu plan.
• Cada cliente puede tener muchos datasets independientes (por ejemplo: “Ventas”, “Inventario”, “Producción”).
• Cada dataset acumula versiones. Cada vez que subes un CSV al mismo dataset se crea una nueva versión y la anterior queda guardada.
• Los componentes (gráficas, tablas, KPIs) se construyen apuntando a un dataset — no a una versión concreta.
• La versión activa del dataset es la que ven los componentes. Cuando una nueva importación termina bien, se vuelve la activa automáticamente.

4. Gestión de clientes

Cada cliente representa una empresa, marca o proyecto al que le vas a entregar datos y visualizaciones.

Crear un cliente

1. Entra a Clientes desde el menú lateral.
2. Haz clic en Nuevo cliente.
3. Completa nombre, slug (URL amigable) y correo de contacto.
4. Opcional: crea un administrador del cliente con email y contraseña.
5. Elige el tipo de dominio: ninguno, subdominio o dominio propio.
6. Guarda. El cliente queda listo para cargar datos y publicar.

5. Gestión de usuarios

Los usuarios se crean simultáneamente en DataMetrixx y en AWS Cognito. Solo Platform Admin y Tenant Owner pueden crear, editar o resetear contraseñas.

Crear un usuario

1. Ve a Usuarios → Nuevo usuario.
2. Completa nombre completo, email y contraseña inicial.
3. Asigna rol (Tenant Admin, Client Admin o Viewer).
4. Si es rol de cliente, selecciona el cliente asignado.
5. Guarda. El usuario recibe sus credenciales.

Resetear contraseña

Usa el botón Resetear clave. La nueva contraseña debe cumplir:

• Mínimo 8 caracteres
• Al menos una mayúscula
• Al menos un número
• Al menos un carácter especial

El formulario valida los requisitos en tiempo real con una lista de chequeo visual.

6. Catálogos

Los catálogos definen los valores permitidos para las dimensiones de tus datos: continentes, regiones, países, clasificaciones, elementos y sub-elementos. Funcionan como listas maestras que mantienen la consistencia de nombres al importar.

Entra a Catálogos para ver, editar o importar nuevos valores. Los catálogos se comparten entre todos los datasets del cliente.

7. Datasets

Un dataset es el contenedor que agrupa todas las versiones de un mismo conjunto de datos. Piénsalo como “el tema”: las filas específicas van y vienen con cada importación, pero el dataset es el ancla estable al que tus componentes se conectan.

Crear un dataset

1. Entra a Datasets y haz clic en Nuevo dataset.
2. Asigna nombre y descripción claros (ej: “Ventas 2026”).
3. Guarda. El dataset queda vacío, esperando su primera importación.

Estructura de una fila

Todas las filas que cargues al dataset siguen un esquema dimensional común. No tienes que usar todos los campos — llena los que apliquen a tu negocio:

La combinación continent + region + country + classification + element + sub_element + year actúa como llave única dentro de cada importación. Es lo que usa el sistema para detectar duplicados.

8. Importación y versionado

La forma principal de cargar datos es subiendo archivos CSV. Cada importación que hagas a un mismo dataset se convierte en una nueva versión — no sobrescribe la anterior.

Proceso paso a paso

1. Entra a Importaciones → Nueva importación.
2. Selecciona el dataset destino (o crea uno nuevo).
3. Sube el archivo CSV (delimitador coma, encoding UTF-8).
4. Mapea cada columna de tu CSV al campo correspondiente del sistema:continent,region,country,classification,element,sub_element,year,value. Si tu CSV usa otros nombres (ej: “Pais”, “Año”), el mapeo los traduce.
5. Elige política de duplicados:
   • Rechazar: si una fila duplica una llave existente, se omite.
   • Upsert: actualiza el valor de la fila duplicada con el nuevo.
6. Inicia la importación. El sistema procesa en background y muestra el progreso.

Estados de una importación

Versionado y versión activa

Cada dataset tiene una versión activa: la importación cuyas filas se muestran hoy en los componentes. Las versiones anteriores permanecen almacenadas — puedes volver a cualquiera en cualquier momento.

• Cuando una importación termina en estado completed, se vuelve la versión activa automáticamente.
• Puedes activar una versión anterior desde la lista de importaciones del dataset.
• Puedes hacer rollback de una importación problemática: borra sus filas y, si era la activa, el dataset vuelve a la anterior.

9. Archivos

La sección Archivos gestiona activos binarios (imágenes, documentos, logos) almacenados en S3 por cliente. Al subir un archivo obtienes una URL pública que puedes usar en componentes de imagen, páginas del site builder o branding.

Los avatares de usuario se almacenan en el prefijo público avatars/y son accesibles sin firma.

10. Componentes

Un componente es una visualización reutilizable (tabla, gráfica, KPI, mapa…) que se conecta a un dataset. Lo importante es entender esto:

Tipos disponibles

Cómo se conecta un componente a los datos

Cuando creas un componente tienes que responder estas preguntas:

1. ¿De qué dataset viene la información? Seleccionas el dataset del cliente. El componente queda amarrado a él por id — no a una versión específica, sino al dataset en general.
2. ¿Qué filtros aplico? Por ejemplo: solo el país “México”, solo años entre 2020 y 2026, solo el elemento “Ventas”. Los filtros descartan filas antes de agrupar.
3. ¿Cómo agrupo? Las dimensiones son las columnas por las que sumas o promedias. Para una gráfica de barras de ventas por país, la dimensión es country. Para una línea de tiempo es year.
4. ¿Qué agregación uso? sum, avg, count, max o min sobre la columna value.
5. ¿Cómo ordeno y cuánto muestro? Ordenas por dimensión o por valor agregado, ascendente o descendente, y limitas a los primeros N resultados.

Ejemplo 1 — Gráfica de barras: ventas por país

Quiero ver cuánto vendió cada país en 2026, ordenado del que más vendió al que menos:

{
  "dataset_id": "uuid-del-dataset-ventas",
  "dimensions": ["country"],
  "aggregation": "sum",
  "filters": {
    "element": "Ventas",
    "year": 2026
  },
  "sort_by": "value",
  "sort_order": "desc",
  "limit": 10
}

Esto traduce a: “sumame value agrupado por country, solo filas donde element = "Ventas" y year = 2026, ordenado por el total de mayor a menor, top 10.”

Ejemplo 2 — Línea de tiempo: ventas mensuales de un producto

{
  "dataset_id": "uuid-del-dataset-ventas",
  "dimensions": ["year"],
  "aggregation": "sum",
  "filters": {
    "element": "Ventas",
    "sub_element": "Online"
  },
  "year_range": [2020, 2026],
  "sort_by": "year",
  "sort_order": "asc"
}

Ejemplo 3 — KPI: total de ventas del mes

{
  "dataset_id": "uuid-del-dataset-ventas",
  "dimensions": [],
  "aggregation": "sum",
  "filters": {
    "element": "Ventas",
    "year": 2026
  }
}

Sin dimensions el resultado es un solo número — perfecto para un KPI.

Flujo de creación en el panel

1. Entra a Componentes → Nuevo componente.
2. Asigna nombre y descripción.
3. Elige el tipo (tabla, barras, línea, KPI, etc.).
4. Selecciona el dataset fuente.
5. Configura filtros, dimensiones, agregación y ordenamiento.
6. Configura estilo: colores, etiquetas, leyenda, formato numérico.
7. Usa Vista previa para ver el resultado con datos reales.
8. Guarda. El componente queda listo para usarse en templates.

Componentes que no vienen de un dataset

Los tipos Texto, Imagen, PDF y Archivo no necesitan dataset. Sirven para agregar contenido estático a un dashboard: un título, un logo, un manual en PDF, un video. Se suben directo al componente desde el panel.

11. ¿Cómo se actualizan los componentes cuando subo datos nuevos?

Esta es probablemente la pregunta más importante del sistema. La respuesta corta es: se actualizan solos, sin tocar los componentes.

El flujo paso a paso, por dentro

1. Tienes un dataset con versión activa = Importación #1.
2. Tu gráfica de barras lee filas solo de Importación #1.
3. Subes un CSV nuevo al mismo dataset.
4. El sistema procesa y crea Importación #2.
5. Al terminar, Importación #2 se marca como versión activa — automáticamente.
6. La próxima vez que alguien abra el dashboard, la gráfica lee de Importación #2.

Qué cosas sí tienes que revisar

• Estructura de columnas: si el componente filtra por element = "Ventas" y en el nuevo CSV renombraste la columna a “Venta”, el filtro dejará de encontrar coincidencias. Mantén los nombres consistentes o re-mapea las columnas al importar.
• Política de duplicados: si eliges rechazar, las filas que ya existen no se actualizan — podrías tener la versión activa incompleta. Si eliges upsert, los registros se actualizan con los nuevos valores.
• Errores en la importación: si queda en estado failed, la versión anterior sigue activa. Revisa el resumen de errores, corrige el CSV y vuelve a subir.
• Rollback: si el CSV nuevo trajo un problema, ve a la importación y haz rollback. El dataset vuelve a la versión anterior y los componentes también.

Cuándo NO se actualiza solo

Si en lugar de subir al mismo dataset creas un dataset nuevo, los componentes existentes siguen mirando al dataset viejo. En ese caso hay que editar cada componente y apuntarlo al dataset nuevo — o, mejor, subir los datos al dataset original.

12. Templates

Un template es una composición de varios componentes en un layout en grid. Funciona como el dashboard que luego vas a publicar.

1. Entra a Templates → Nuevo template.
2. Define nombre, descripción y cliente propietario.
3. Arrastra componentes al grid y ajusta su tamaño.
4. Guarda en estado draft.
5. Cuando esté listo cámbialo a published.

13. Publicaciones y embeds

Publicar un template genera un token público que permite mostrar el dashboard en cualquier sitio sin necesidad de autenticación.

1. Selecciona un template en estado published.
2. Crea una publicación. Se genera automáticamente public_token.
3. Configura visibilidad: public o controlled.
4. Define la lista de dominios permitidos (CORS).
5. Copia el snippet de embed y pégalo en tu sitio.

Snippet de embed

<div id="datametrixx-container"></div>
<script src="https://api.datametrixx.com/datametrixx.js"
        data-token="TU_TOKEN_PUBLICO"
        data-container="datametrixx-container">
</script>

14. Site Builder

Cada cliente puede tener un sitio público con su propio branding, páginas y publicaciones embebidas, sin escribir una línea de código.

1. Entra a Site Builder.
2. Configura header, footer y menú de navegación.
3. Crea páginas con slug, título y descripción SEO.
4. Arrastra publicaciones (dashboards) al contenido.
5. Publica la página. Queda accesible en el dominio del cliente.

15. Branding

En Branding cada cliente configura su identidad visual:

• Logotipo (se sube como archivo).
• Favicon para la pestaña del navegador.
• Colores primario y secundario.
• Tipografía (cuando está disponible).

Los cambios se aplican instantáneamente al sitio público y a los embeds.

16. Dominios

Cada cliente puede publicar bajo uno de estos esquemas:

17. Facturación

La sección Facturación muestra tu plan actual, consumo, fecha de próximo cargo y historial de pagos.

• El trial dura 7 días sin tarjeta.
• Al finalizar el trial puedes seleccionar un plan mensual.
• Los precios están en MXN.
• Algunos planes incluyen un setup fee único.

18. Auditoría

El sistema registra automáticamente todas las acciones importantes: creaciones, ediciones, eliminaciones, importaciones, cambios de permisos y reseteo de contraseñas.

En Auditoría puedes filtrar por usuario, tipo de acción, entidad, fecha y rango. Cada registro incluye el diff de los cambios realizados y la IP de origen.

19. Preguntas frecuentes