# Dashboards

## Para qué sirve

Un dashboard es un tablero con "tiles" (mosaicos): cada tile muestra un dato, un gráfico, una tabla, un texto, un link o una imagen. Sirve para juntar en una sola pantalla lo que necesita mirar cada área: por ejemplo, reservas e ingresos para gestión, o errores y tiempos de respuesta para sistemas.

Una organización nueva arranca sin dashboards: cada equipo arma los suyos con **Crear dashboard**.

## Cuándo usarlo

- Querés una vista fija que todos miren (por ejemplo, en la pantalla del área de sistemas).
- Querés mostrarle a dirección solo los números de negocio.
- Encontraste algo útil en [Explorar](https://lymen.app/docs/datos/explorar/) y lo querés dejar guardado.

## Quién puede qué

| Rol | Ver | Crear y editar |
|---|---|---|
| Administración | Todos los dashboards | Sí |
| Sistemas (IT) | Todos los dashboards | Sí |
| Negocio y Dirección | Solo los dashboards marcados "Todos" | No |

Cuando creás un dashboard elegís quién lo ve (campo **Lo ven**, más abajo).

## Ver un dashboard

1. Entrá a **Dashboards** y elegí uno de la lista. Podés buscarlo por nombre.
2. Arriba a la derecha elegís el **Período** de la vista: *Como se armó* (cada tile usa su propio período), *24 h*, *7 días* o *30 días*. Cambiarlo no modifica el dashboard guardado.
3. Los tiles se **actualizan solos cada 60 segundos** mientras lo mirás.
4. Con "Cambiar de dashboard…" saltás a otro sin volver a la lista.
5. Si tenés permiso, el botón **Editar** abre el modo de edición.

## Crear o editar un dashboard

1. Creá uno nuevo desde la lista, o abrí uno existente y tocá **Editar**.
2. Completá el nombre, quién lo ve y la descripción.
3. Tocá **Agregar tile** y elegí el tipo: Datos, Texto, Link o Imagen.
4. Tocá un tile para configurarlo en el panel de la derecha.
5. Arrastrá un tile para cambiarlo de lugar y tirá de su esquina inferior derecha para cambiar el tamaño. Con el teclado, usá las flechas sobre esa esquina.
6. Tocá **Guardar dashboard**. El estado de arriba dice "Editando · sin guardar" o "Editando · todo guardado".

Si salís con cambios sin guardar, Lymen te pregunta "¿Descartar los cambios sin guardar?". Si descartás, lo que cambiaste desde el último guardado se pierde.

### Campos del dashboard

| Campo | Para qué sirve | Por defecto | Valores válidos | Impacto |
|---|---|---|---|---|
| Nombre del dashboard | Cómo aparece en la lista y en las migas de pan. | "Nuevo dashboard" | 1 a 80 caracteres. Obligatorio. | Sin nombre no se puede guardar. |
| Lo ven | Quién puede abrirlo. | Todos | *Todos (Dirección, IT, admin)* o *Solo IT y admin* | Pasarlo a "Solo IT y admin" lo oculta de inmediato para Negocio y Dirección. Usalo para tableros con detalle técnico. |
| Descripción | Texto corto bajo el título. | Vacío | Hasta 240 caracteres | Solo informativo. |
| Tiles | Los mosaicos del tablero. | Ninguno | Hasta 24 por dashboard | Al llegar a 24 se deshabilita "Agregar tile". Cada tile de datos hace una consulta cada 60 segundos mientras alguien mira el dashboard. |
| Eliminar | Borra el dashboard. | | | Se pierde el dashboard entero, con todos sus tiles. Los datos de origen no se tocan. |

## Tipos de tile

Al tocar **Agregar tile** aparece "¿Qué querés agregar?" con cuatro opciones:

| Tipo | Qué es |
|---|---|
| Datos | Un número, gráfico o tabla. |
| Texto | Un título de sección, una nota o un aviso. |
| Link | Un acceso a otra página o pantalla. |
| Imagen | Un logo, un plano o una foto. |

### Tile de datos

Muestra datos vivos. Se puede armar de tres maneras:

- **Del catálogo**: elegís una métrica ya preparada (lista más abajo). Es lo más simple.
- **Armado con ayuda** (modo guiado): un asistente de cinco pasos te pregunta qué datos, qué medir, filtros, período y agrupamiento, y cómo se ve. Lo puede usar cualquiera que edite el dashboard.
- **Consulta escrita**: escribís una consulta en [LQL](https://lymen.app/docs/datos/lql/). Solo para Sistemas y Administración.

#### Campos de un tile de datos

| Campo | Para qué sirve | Por defecto | Valores válidos | Impacto |
|---|---|---|---|---|
| Título | Nombre que se ve en el tile. | El de la métrica | Hasta 80 caracteres | Solo informativo. |
| Datos | De dónde sale el dato (en tiles del catálogo). | Según la métrica | Métricas, Logs, Trazas, Eventos | Las opciones sin métricas disponibles aparecen deshabilitadas. |
| Métrica | Qué se mide. | La elegida al crear | Ver catálogo más abajo | Al cambiarla se actualiza el título (si no lo editaste) y se ajustan el tipo de gráfico y la agrupación a lo que esa métrica admite. |
| Tipo de gráfico | Cómo se dibuja. | Línea si la métrica la admite | Número, Línea, Barras, Tabla, Ranking, Reparto y los especiales | Número no agrupa. Tabla, Ranking y Reparto necesitan una agrupación. Si una combinación no es válida, se corrige sola. |
| Agrupar | Divide el dato en partes. | Sin agrupar (total) | Por servicio, Por tipo de evento, Por canal y los atributos de tu negocio (por ejemplo "Por especialidad" o "Por medio de pago", según tu perfil) | Agrupar por algo con muchos valores distintos da un gráfico ilegible y una consulta más pesada. |
| Período | Cuánto tiempo hacia atrás mira. | Últimas 24 horas | 15 min, 1 h, 6 h, 24 h, 7 d, 30 d y 90 d (en consultas propias, hasta 30 d) | Un período largo tarda más en cargar. Si la consulta escrita trae su propio período, el del tile queda deshabilitado y se ve "Período de la consulta". |
| Unidad | Texto que acompaña al número (solo en consultas propias). | Vacía | Hasta 16 caracteres: letras, números, espacio y `% $ / . · _ -` | Solo cambia cómo se lee el número. |
| Mejor si | Hacia dónde es mejor el número, para pintar el semáforo (solo en consultas propias). | Sube | Sube / Baja | Si lo elegís al revés, un valor bueno se pinta como malo. |
| Línea de referencia | Dibuja una línea horizontal en el gráfico. | Sin línea | Cualquier número | Solo visual. Sirve para marcar una meta. |
| Avisar en el semáforo si baja de / pasa de | Umbral que pinta el número de amarillo. | Sin aviso | Un número. Solo para el tipo Número | Solo cambia el color del tile. **No manda avisos ni alertas.** |
| Tamaño: ancho | Columnas que ocupa. | 3 para un número, 6 para el resto | 1 a 12 columnas | Solo diseño. |
| Tamaño: alto | Filas que ocupa. | Según el tipo | 1 a 8 filas (mínimo 1 para Número, Texto y Link; 2 para Imagen; 3 para el resto) | Solo diseño. |
| Antes / Después | Cambia el orden del tile. | | | Solo diseño. |
| Quitar tile | Elimina el tile del dashboard. | | | Se pierde la configuración del tile. Se aplica recién al tocar "Guardar dashboard". |

#### Tipos de gráfico

| Tipo | Para qué sirve |
|---|---|
| Número | Un valor grande, con su variación y semáforo. |
| Línea | Cómo cambia el dato en el tiempo. |
| Barras | Comparar valores. |
| Tabla | Filas con varios valores. |
| Ranking | Los mayores primero. |
| Reparto | Cuánto aporta cada parte. |
| Recorrido (embudo) | Cuántas personas llegan a cada paso de un proceso y dónde se van. |
| Por día (disponibilidad) | Cuánto funcionó bien el sistema cada día. |
| Eventos | Lista de lo que va pasando, lo más nuevo arriba (hasta 200), con enlace "Ver qué pasó" hacia la traza. |
| Pagos | Los últimos 10 pagos rechazados y los 10 cobros más grandes del período. |
| Incidentes | Incidentes abiertos y los últimos resueltos. |

Los últimos cinco son tiles especiales: se arman con su propia métrica, no con una consulta.

#### Métricas del catálogo

| Métrica | Qué muestra | Unidad |
|---|---|---|
| Pedidos por segundo | Pedidos que reciben tus servicios. | pedidos/s |
| Errores | Porcentaje de pedidos que terminaron con error. | % |
| Tiempo de respuesta (p95) | El 95 % de los pedidos responde en este tiempo o menos. | ms |
| Tiempo de respuesta | Promedio de lo que tardan las páginas en responder. | ms |
| Tiempo de respuesta contra lo habitual | Promedio, con lo habitual de los últimos 7 días y los incidentes marcados. | ms |
| Disponibilidad | Del tiempo funcionando: porcentaje de intervalos de 5 minutos en los que falló menos del 5 % de los pedidos. | % |
| Disponibilidad por día | Operaciones que funcionaron bien, día por día. | % |
| Errores en los logs | Líneas de log con nivel error o más grave. | líneas |
| Incidentes | Abiertos y últimos resueltos. | incidentes |
| Eventos de negocio (contados) | Todos los eventos de negocio, por tipo. | eventos |
| Eventos de negocio | Eventos guardados, en total, por tipo o por canal. | eventos |
| Eventos recientes | Lo que va pasando, con enlace a la traza. | eventos |

Además hay métricas de negocio que dependen de tu perfil: reservas confirmadas, reservas por canal, cancelaciones, pagos, pagos aprobados y rechazados, porcentaje de rechazos, ingresos, ticket promedio, plata perdida por rechazos y el embudo de reserva. Solo aparecen si tu aplicación manda esos eventos y tu cuenta los tiene configurados (ver [Reglas de captura](https://lymen.app/docs/datos/captura/)).

Un **log** es una línea de texto que un sistema escribe cuando pasa algo. Un **evento de negocio** es un hecho que le importa a tu organización, como "pago aprobado". Una **traza** es el recorrido completo de un pedido entre servicios.

### Tile de texto

| Campo | Para qué sirve | Por defecto | Valores válidos | Impacto |
|---|---|---|---|---|
| Cómo se ve | Variante del texto. | Nota | *Título de sección* (grande, sin tarjeta, para separar partes), *Nota* (en una tarjeta), *Aviso* (fondo amarillo, para algo importante) | "Título de sección" ocupa todo el ancho y 1 fila. |
| Título | Encabezado del tile. | Vacío | Hasta 120 caracteres | Un tile sin título no muestra encabezado. |
| Texto | Cuerpo del mensaje. En un título de sección es opcional. | Vacío | Hasta 2.000 caracteres. Barra con Negrita, Cursiva, Link y Lista | Hace falta al menos un título o un texto para guardar. |
| Tamaño | Ancho y alto. | Ancho 4 (12 si es título de sección) | 1 a 12 columnas, alto 1 a 8 | Solo diseño. |

### Tile de link

| Campo | Para qué sirve | Por defecto | Valores válidos | Impacto |
|---|---|---|---|---|
| Estilo | Cómo se ve el acceso. | Tarjeta | Tarjeta o Botón | Solo diseño. |
| Título | Lo que dice el link. | Vacío (obligatorio) | Hasta 120 caracteres | Sin título no se puede guardar. |
| Descripción | Texto de apoyo. | Vacío | Hasta 160 caracteres | Solo informativo. |
| Dirección | A dónde lleva. | Vacía (obligatoria) | Una dirección que empiece con `https://` o `http://`, o una pantalla del portal que empiece con `/` | Por seguridad no se aceptan otros tipos de dirección ni direcciones con usuario y clave. Los links externos muestran el dominio. |
| Emoji | Ícono opcional. | Vacío | Un emoji | Solo diseño. |
| Tamaño | Ancho y alto. | Ancho 3 | 1 a 12, alto 1 a 8 | Solo diseño. |

### Tile de imagen

| Campo | Para qué sirve | Por defecto | Valores válidos | Impacto |
|---|---|---|---|---|
| Imagen | El archivo a mostrar. | Ninguna (obligatoria) | PNG, JPEG, WebP o GIF de hasta 2 MB | La imagen queda guardada en Lymen y la ve cualquiera que vea el dashboard. No subas imágenes con datos personales. |
| Descripción de la imagen | Texto alternativo para quien no puede verla. | Se propone a partir del nombre del archivo | Hasta 200 caracteres. Obligatorio | Sin descripción no se puede guardar. |
| Ajuste | Cómo ocupa el espacio. | Mostrar entera | Mostrar entera / Llenar el espacio | "Llenar el espacio" puede recortar los bordes. |
| Link | Convierte la imagen en un acceso. | Vacío | Igual que en el tile Link | Ver Link. |
| Pie | Texto debajo de la imagen. | Vacío | Hasta 200 caracteres | Solo informativo. |
| Tamaño | Ancho y alto. | Ancho 4 | 1 a 12, alto 2 a 8 | Solo diseño. |

Si un tile de texto, link o imagen está incompleto, el botón **Guardar dashboard** se deshabilita y arriba aparece "Falta completar el tile «nombre»".

## Ejemplos

- **Tablero de recepción**: un título de sección "Hoy", un número de reservas confirmadas con semáforo, una línea de reservas por canal y un tile de link al sitio de turnos.
- **Tablero de sistemas**: errores (%) con línea de referencia en 1, tiempo de respuesta p95, ranking de servicios por pedidos y el tile de Incidentes.
- **Desde Explorar**: armás una consulta en [Explorar](https://lymen.app/docs/datos/explorar/), tocás "Agregar a un dashboard" y elegís un dashboard existente o uno nuevo.

## Problemas comunes

- **No encuentro el botón Editar**: tu rol es Negocio o Dirección. Pedile a Administración o Sistemas que lo edite.
- **No puedo guardar**: falta el nombre o hay un tile de contenido incompleto. Mirá el mensaje de estado arriba.
- **El tile dice "Consulta avanzada anterior"**: es un tile viejo, escrito en un formato anterior. Sigue funcionando, pero para editarlo tocá "Pasar al nuevo formato".
- **Un tile no muestra datos**: probá con un período más largo y revisá que la fuente esté mandando datos.
- **El semáforo de un tile no me avisa**: el umbral solo pinta el tile. Para recibir avisos hace falta una regla de alerta.
- **Agregar tile está deshabilitado**: llegaste al máximo de 24 tiles. Quitá alguno o armá otro dashboard.