Descripción general del Kiosk

El Kiosk es la cara pública de planta de tu Board. Es la pantalla amigable al tacto ejecutándose en una tablet junto a cada estación de trabajo, o en una TV montada sobre la línea de montaje, o en un teléfono guardado en un bolsillo de delantal. El Kiosk es donde los trabajadores — no los gerentes — interactúan con el sistema: ven qué hay en cola, registran progreso, registran tiempo, marcan bloqueos y toman el siguiente trabajo.

Esta página es un recorrido general por el Kiosk: qué es, cómo se lanza, en qué se diferencia del Panel de administración y el sistema de parámetros URL que hace que una pantalla Kiosk se vea completamente diferente a la siguiente.

Kiosk vs Panel de administración. El Panel de administración es para gerentes y planificadores — inicia sesión, obtén la imagen completa, configura todo. El Kiosk es para trabajadores — abre una URL, ve solo lo que es relevante, toca para registrar. Comparten los mismos datos subyacentes: cada acción en el Kiosk es visible en el Panel de administración en pocos segundos.

Tabla de contenido

Para qué sirve el Kiosk
Lanzar un Kiosk
Los dos modos de vista: Columnas y Tabla
Acciones protegidas con PIN
Registrar progreso
Seguimiento de tiempo desde el Kiosk
Bloquear y desbloquear una tarea
Login de supervisor y arrastrar y soltar
Detalles del trabajo, planos y registros
Búsqueda desde el Kiosk
Interruptores Ocultar completados y Mostrar borradores
Actualizaciones en vivo / auto-refresh
Referencia de parámetros URL
Cómo se comunica el Kiosk con el resto del sistema
Modelo de seguridad
Configurar una nueva pantalla Kiosk
Consejos y buenas prácticas

Para qué sirve el Kiosk

El Kiosk da a la planta todo lo que necesita y nada de lo que no necesita. Úsalo para:

Lista de trabajo diaria — cada trabajador en una estación puede ver de un vistazo qué hay en cola, qué está en curso y qué está bloqueado.
Registrar cantidades — toca una tarjeta → introduce PIN → introduce cuántas piezas se completaron.
Fichar entrada / salida — inicia un temporizador cuando empieza el trabajo, deténlo cuando termine. Las entradas de tiempo aparecen en la página de Seguimiento de tiempo del Panel de administración inmediatamente.
Añadir notas y fotos — captura desviaciones, defectos o simplemente un “FYI” adjunto al registro de trabajo.
Marcar bloqueos — marca una tarea como bloqueada cuando falta material, una herramienta está caída o cualquier otra cosa detiene el progreso.
Pantalla en pared — apunta una TV a ella y todo el taller ve la misma imagen, refrescada automáticamente.

El Kiosk es deliberadamente mayormente de lectura para gerentes y mayormente de escritura para trabajadores. No hay menú de ajustes, no hay diálogos de edición llenos de desplegables, no hay cambiador de módulos. Todo está a uno o dos toques de distancia.

Lanzar un Kiosk

Cada Kiosk está vinculado a una Vista Kanban personalizada que configuraste en Configuración de la aplicación → Vistas Kanban. Esa vista define:

Qué estaciones de trabajo se muestran como columnas (y en qué orden).
A qué departamento filtrar (o Todos los departamentos).
Qué columnas de metacampo mostrar en la vista de tabla.
La clave URL de la vista — un slug corto y opaco que la identifica.

Para abrir un Kiosk para una vista dada, la URL tiene este aspecto:

https://board.apslo.com/kiosk?url_key=abc123xyz&allow_edit=1&theme=dark

El url_key es el único parámetro obligatorio. Todo lo demás es un indicador de funcionalidad.

El lugar más fácil para generar una URL de Kiosk es el Configurador de URL del Kiosk en el Dashboard. Eliges una vista, alternas los indicadores, y la página produce una URL para copiar y pegar — sin edición manual requerida.

No se requiere login. Una URL de Kiosk es pública. Cualquiera con la URL puede abrir el Kiosk y ver qué hay en el tablero. Trata la URL como una contraseña — consulta Modelo de seguridad.

Los dos modos de vista: Columnas y Tabla

Dentro de un Kiosk, el usuario puede cambiar entre dos diseños en cualquier momento. La elección se guarda por navegador, por kiosko.

Columnas

El diseño kanban horizontal — una columna por estación de trabajo. Cada columna muestra:

El nombre de la estación de trabajo y una barra de progreso por columna (planificado vs fabricado).
Una pila de tarjetas, de arriba abajo por prioridad. Cada tarjeta muestra la referencia del trabajo, nombre, cantidad planificada/fabricada, estado de bloqueo y cualquier badge de trabajador activo.

Esta vista es la mejor en pantallas anchas — una TV de pared o una tablet horizontal — cuando el equipo quiere ver todo el flujo.

Tabla

Un listado denso de una fila por trabajo-estación con las columnas que configuraste en la Vista Kanban subyacente (más cualquier columna de metacampo). Cada fila tiene los mismos datos que una tarjeta, solo dispuestos horizontalmente.

Esta vista es la mejor en pantallas pequeñas — una tablet de 7 pulgadas montada en teléfono junto a una sola estación de trabajo — cuando el equipo solo se preocupa por su propia fila.

Un interruptor en la cabecera del Kiosk (icono de Columnas / icono de Tabla) alterna entre las dos.

Acciones protegidas con PIN

El Kiosk es accesible públicamente — cualquiera con la URL puede ver el tablero. Pero escribir en él (registrar cantidades, iniciar temporizadores, bloquear tareas) requiere un PIN.

Cada empleado tiene un PIN personal (4-8 dígitos) configurado en Configuración de la aplicación → Empleados. Cuando un trabajador toca una tarjeta e intenta hacer algo, el Kiosk muestra un modal de PIN. Introduce el PIN, y la acción procede en el contexto de ese empleado — lo que significa que la entrada de tiempo, nota de registro o motivo de bloqueo se registra con su nombre.

El modal de PIN solo permanece abierto el tiempo necesario para una acción. No hay concepto de “sesión” de Kiosk — cada acción se autentica de forma independiente. Esto es intencional: significa que el siguiente trabajador puede acercarse al mismo Kiosk y usarlo sin preocuparse por cerrar sesión.

Solo los empleados cuyas estaciones de trabajo incluyan la relevante pueden actuar sobre una tarjeta. Cada registro de empleado tiene una lista de estaciones de trabajo para las que está autorizado. El Kiosk filtra lo que ven y sobre lo que pueden actuar en consecuencia.

Registrar progreso

La acción más común del Kiosk. Flujo:

Toca una tarjeta.
Introduce el PIN.
Se abre el Editor de Estación de Trabajo. Muestra: nombre del trabajo, planificado/fabricado actual, y una fila de controles para cada estación de trabajo del trabajo para la que tú (el empleado verificado) estás autorizado.
Para cada estación de trabajo, introduce:
- Cantidad fabricada — cuántas piezas se terminaron en esta ronda.
- Nota (si está permitido en la estación de trabajo) — un comentario de texto libre.
- Imágenes (si está permitido en la estación de trabajo) — adjunta fotos (arrastrar-soltar, pegar o examinar).
Toca Enviar.

Se crea una nueva entrada de registro de trabajo (visible en el Panel de administración en la pestaña Registros del trabajo), la cantidad fabricada se incrementa, el sello de versión del kanban se aumenta (para que el Kiosk de todos los demás se auto-refresque), y cualquier webhook qty_changed se dispara.

Si la cantidad alcanza la cantidad planificada, la estación de trabajo se marca automáticamente como completada (un evento único que dispara el webhook task_completed).

Los interruptores por estación de trabajo en la pestaña Estaciones de trabajo del Trabajo controlan qué está disponible aquí: Permitir cantidad, Permitir notas, Permitir imágenes. Si Cantidad está deshabilitada, el editor solo registra que trabajaste en ella — la cantidad planificada se registra como la cantidad automáticamente cuando es necesario.

Seguimiento de tiempo desde el Kiosk

El Kiosk es el lugar más común donde se crean entradas de tiempo. Flujo:

Toca una tarjeta → introduce el PIN.
En el Editor de Estación de Trabajo, toca Iniciar trabajo (para la fila de estación de trabajo que quieres cronometrar).
El temporizador empieza. Un reloj en vivo de tiempo transcurrido aparece en el editor.
Camina — el temporizador sigue corriendo.
Vuelve más tarde. Toca Detener trabajo.
Aparece una confirmación con la duración, opcionalmente permitiéndote introducir cantidad + nota de una sola vez.

La entrada detenida aparece inmediatamente en la página de Seguimiento de tiempo del Panel de administración, en la pestaña de Seguimiento de tiempo del trabajo, y en el badge de avatar del trabajador en la cabecera de la página de Producción.

Un trabajador solo puede tener un temporizador activo a la vez — iniciar uno nuevo en una estación de trabajo diferente cerrará automáticamente el anterior. Esto previene el doble conteo accidental.

Si un trabajador olvida detener un temporizador, dos redes de seguridad entran en juego:

Un gerente puede detenerlo desde el Panel de administración (Panel de edición de Trabajo → pestaña Seguimiento de tiempo).
Un Cron Job configurado lo auto-cerrará al final del turno.

Bloquear y desbloquear una tarea

Los trabajadores pueden marcar una tarea como bloqueada cuando algo les impide continuar — material faltante, herramienta rota, se necesita aclaración del diseño, etc.

Toca una tarjeta → introduce el PIN.
En el Editor de Estación de Trabajo, toca Bloquear.
Introduce una nota explicando por qué (obligatoria).
Toca Confirmar bloqueo.

La tarjeta ahora está marcada Bloqueada en rojo. Sigue ocupando su columna, pero el indicador visual dice a los supervisores que algo necesita atención. Un webhook job_blocked se dispara para que las notificaciones puedan enviarse a Slack o a cualquier otro sitio.

Desbloquear sigue el mismo flujo con una nota opcional. La tarjeta vuelve a su estado normal.

Los trabajadores regulares solo pueden registrar progreso en tarjetas para las que están autorizados. Los Supervisores pueden hacer más — específicamente, pueden arrastrar tarjetas entre columnas para mover el trabajo hacia adelante cuando el flujo necesita un empujón.

Para habilitar el arrastre de supervisor en un Kiosk:

Añade &show_login=1 a la URL del Kiosk.
Aparece un botón Iniciar sesión en la cabecera del Kiosk.
Tócalo → introduce el PIN del supervisor → la sesión ahora está elevada para esa pestaña del navegador.
El supervisor ahora puede arrastrar tarjetas entre columnas. Los soltados se persisten en el servidor y el movimiento es visible para todos en pocos segundos.

El estado de Supervisor es un indicador por empleado definido en Configuración de la aplicación → Empleados. El PIN de un empleado regular no elevará la sesión incluso si tocan el botón Iniciar sesión.

El inicio de sesión persiste para la pestaña del navegador. Cerrar la pestaña cierra la sesión del supervisor automáticamente.

Detalles del trabajo, planos y registros

Tocar una tarjeta con allow_edit=0 (o cualquier tarjeta cuando no está en modo edición) abre una vista de detalle del trabajo con varias pestañas:

Estaciones de trabajo — cada estación de trabajo en este trabajo y su progreso (solo lectura).
Detalles — la descripción del trabajo, imagen, valores personalizados (metacampo) marcados como “Mostrar en etiqueta” e información del Pedido.
Planos — cada imagen, PDF o enlace externo subido que el planificador adjuntó en el Panel de administración.
Registros — historial cronológico de cantidad, tiempo, nota y entradas de adjuntos en este trabajo.
Seguimiento de tiempo — cada entrada de tiempo cerrada para este trabajo, más cualquier temporizador activo.

La pestaña Planos es particularmente importante en la planta — los trabajadores pueden hacer zoom en un plano CAD o especificación PDF sin salir del Kiosk.

Cuando allow_edit=1, tocar una tarjeta va directamente al Editor de Estación de Trabajo (donde el trabajador puede registrar progreso). Las pestañas todavía son alcanzables desde el menú de desbordamiento del editor.

Búsqueda desde el Kiosk

Si la URL del Kiosk contiene &allow_search=1, aparece una barra de búsqueda en la cabecera. Escribir en ella filtra las tarjetas a través de todas las columnas por:

Nombre del trabajo
Nº Ref del trabajo
Número de pedido / proyecto
Nombre del cliente

La búsqueda no distingue mayúsculas y minúsculas y usa coincidencia contiene. Cuando el campo de búsqueda tiene cualquier texto, los interruptores Ocultar completados / Ocultar borrador se ignoran temporalmente — para que incluso un trabajo terminado pueda encontrarse por Nº Ref. Limpiar la caja de búsqueda vuelve a poner en efecto los interruptores.

La búsqueda es local al navegador actual — filtra lo que ya está cargado más una consulta de backend que ignora los filtros de ocultación.

Interruptores Ocultar completados y Mostrar borradores

Dos interruptores en la cabecera del Kiosk controlan qué tarjetas son visibles:

Mostrar completados — por defecto, las tarjetas cuya cantidad fabricada ha cumplido (o superado) la cantidad planificada se ocultan para que el tablero permanezca enfocado en trabajo accionable. Activa el interruptor para verlas.
Mostrar borradores — por defecto, las estaciones de trabajo en borrador (las marcadas como borrador en el Panel de administración) también se ocultan. Activa el interruptor para verlas también.

Ambos interruptores persisten por navegador, por clave URL del Kiosk. Así que una tablet en la línea de montaje puede estar configurada en “Ocultar completados = activado” sin afectar a la tablet en el taller de pintura.

Los indicadores URL show_completed=1, show_archived=1, show_draft=1 y allow_draft_progress=1 solo siembran el estado inicial en la primera carga. Después de eso, el interruptor dentro del Kiosk es la fuente de verdad — incluso si la URL forzó algo a estar activado, el trabajador puede desactivarlo. Esto mantiene el Kiosk usable cuando las preferencias del equipo difieren de cómo se generó la URL.

Actualizaciones en vivo / auto-refresh

El Kiosk hace dos cosas para mantenerse actualizado:

Consulta silenciosa — una pequeña petición comprueba periódicamente un sello de versión del lado del servidor. Si algo ha cambiado (nueva cantidad registrada, tarjeta movida, temporizador iniciado/detenido) el Kiosk recupera el tablero. Si nada ha cambiado, la petición es un no-op.
Refresh completo periódico — el parámetro URL refresh controla con qué frecuencia ocurre una recuperación completa (por defecto: cada 5 minutos). Define &refresh=2 para refrescar cada 2 minutos, etc. El mínimo es 1 minuto.

Esta combinación significa que un Kiosk montado en pared está siempre actualizado sin que nadie tenga que interactuar con él, y la tablet de un trabajador recoge cambios de un colega en pocos segundos.

Referencia de parámetros URL

Una URL de Kiosk tiene un parámetro obligatorio (url_key) y un puñado de indicadores de funcionalidad opcionales. El Configurador de URL del Kiosk del Dashboard los construye automáticamente; también puedes editar a mano.

Parámetro	Tipo	Por defecto	Significado
`url_key`	string	obligatorio	La clave URL de la Vista Kanban. Identifica qué vista renderizar.
`allow_edit`	`0` / `1`	`0`	Muestra el Editor de Estación de Trabajo cuando se toca una tarjeta (después del PIN). Off = el Kiosk es de solo lectura.
`allow_draft_progress`	`0` / `1`	`0`	Permite a los trabajadores también registrar progreso en tareas en borrador. Implica mostrar borradores en la primera carga.
`allow_search`	`0` / `1`	`0`	Muestra una caja de búsqueda en la cabecera.
`show_login`	`0` / `1`	`0`	Muestra un botón Iniciar sesión para supervisores (habilita arrastrar y soltar).
`show_completed`	`0` / `1`	`0`	Siembra el interruptor “Mostrar completados” dentro del Kiosk.
`show_archived`	`0` / `1`	`0`	Incluye tarjetas de trabajos archivados.
`show_draft`	`0` / `1`	`0`	Siembra el interruptor “Mostrar borradores” dentro del Kiosk.
`refresh`	entero (minutos)	`5`	Intervalo de auto-refresh. Mínimo 1.
`theme`	`light` / `dark`	`light`	Tema visual.
`lang`	código de idioma (por ejemplo, `en`, `pl`, `de`)	predeterminado de la cuenta	Fuerza al Kiosk a renderizarse en un idioma específico.

Combina los indicadores según sea necesario. Por ejemplo:

Pantalla en pared (solo lectura, oscuro, refresh rápido): ?url_key=...&theme=dark&refresh=2
Tablet del trabajador (editar + buscar + login de supervisor): ?url_key=...&allow_edit=1&allow_search=1&show_login=1
Taller incluyendo borradores: ?url_key=...&allow_edit=1&allow_draft_progress=1

Cómo se comunica el Kiosk con el resto del sistema

Cada acción en el Kiosk tiene el mismo efecto que la acción equivalente del Panel de administración:

Acción del Kiosk	Qué ocurre en otros lugares
Registrar cantidad	Se actualiza `manufactured_qty` del trabajo, se añade entrada de registro de trabajo, se dispara el webhook `qty_changed`. Si la cantidad cumple la planificada, se dispara el webhook `task_completed` (solo la primera vez).
Iniciar trabajo	Se crea un registro de temporizador activo. El avatar del empleado aparece en la cabecera de la página de Producción y en la tarjeta relevante.
Detener trabajo	Entrada de tiempo cerrada y visible en la página de Seguimiento de tiempo, la pestaña de Seguimiento de tiempo del trabajo y la pestaña Registros del trabajo. Se dispara el webhook `time_log_saved` con `mode: work_stopped`.
Bloquear tarea	Tarjeta marcada como bloqueada; se dispara el webhook `job_blocked`.
Arrastre de supervisor	La tarjeta se mueve a la nueva estación de trabajo. Igual que arrastrar y soltar en el kanban de Producción.

El Kiosk está totalmente acotado al tenant — el url_key identifica al tenant (tu cuenta), y todas las consultas están restringidas a los datos de ese tenant. No hay filtración entre tenants.

Modelo de seguridad

Algunas cosas a tener en cuenta:

El url_key es la credencial. Cualquiera con la URL puede ver el tablero. Trata la URL como una contraseña wifi — está bien dársela a tu equipo, no está bien publicarla.
Escribir requiere un PIN. Incluso con la URL, nadie puede registrar progreso sin un PIN de empleado válido. Los PINs son de 4 a 8 dígitos y se establecen por empleado en el Panel de administración.
Un trabajador solo puede actuar sobre sus estaciones de trabajo autorizadas. Cada registro de Empleado lleva una lista de IDs de estaciones de trabajo en las que se les permite trabajar. El Kiosk filtra en consecuencia.
Los supervisores son explícitamente elevados. Solo los empleados marcados como supervisores pueden arrastrar tarjetas entre columnas, y solo cuando show_login=1 está definido en la URL y han tocado Iniciar sesión con su PIN.
Si una URL se filtra, regenera la url_key de la Vista Kanban desde Configuración de la aplicación → Vistas Kanban — la URL antigua deja de funcionar inmediatamente. (O elimina la vista por completo.)

Configurar una nueva pantalla Kiosk

Un recorrido práctico para hacer que una nueva tablet, teléfono o TV muestre un Kiosk:

Crear la Vista Kanban — ve a Configuración de la aplicación → Vistas Kanban → Añadir nueva vista. Elige el departamento, oculta las columnas de estaciones de trabajo irrelevantes, define el orden y guarda. La vista aparece con una url_key autogenerada.
Generar la URL — abre el Dashboard → en la tarjeta Configurador de URL del Kiosk, elige la vista del desplegable. Alterna los indicadores que quieras (permitir editar, permitir buscar, tema, idioma, …). Copia la URL.
Abrirla en el dispositivo — pega la URL en el navegador del dispositivo. Marca / fija a pantalla de inicio.
(Opcional) Bloquear el dispositivo — en tablets Android usa “Fijar pantalla” o un lanzador en modo kiosko; en iPad usa “Acceso guiado”; en kioskos Windows usa “Acceso asignado” — estos previenen que los usuarios salgan accidentalmente de la página del Kiosk.
Entregarlo al equipo — pueden registrar progreso enseguida. Sin login, sin formación, sin manual.

Consejos y buenas prácticas

Una Vista Kanban por ubicación física de Kiosk. No intentes hacer que una vista encaje en cada pantalla — crea vistas separadas para el taller de pintura, la bahía de montaje y el área de empaquetado. Cada una recibe su propia URL.
Mantén las tablets cerca de las estaciones de trabajo. Cuantos menos pasos dé un trabajador para registrar progreso, más fiables los datos.
Usa show_login=1 solo donde tengas un supervisor real. De lo contrario el botón Iniciar sesión es solo ruido visual.
Para pantallas en pared, deja allow_edit=0. Una pantalla de solo lectura es más fiable (nadie mueve algo por accidente) y usa menos energía por menos interacciones.
Por defecto refresh=5 está bien. Bájalo a refresh=2 si quieres actualizaciones de pantalla en pared casi en tiempo real. No vayas por debajo de 1 — solo quema ancho de banda.
Define los interruptores por estación de trabajo cuidadosamente. Permitir notas y Permitir imágenes son geniales para pasos con mucho QC pero innecesarios para cortes simples. Desactívalos en la pestaña Estaciones de trabajo del Trabajo para mantener el Kiosk más simple.
Combina con Cron Jobs para auto-cerrar temporizadores olvidados al final del turno. Los trabajadores a veces olvidarán — el cron es tu red de seguridad.
Combina con Webhooks para enviar eventos de planta en tiempo real (cantidad cambiada, tarea bloqueada) a Slack, Teams o cualquier otro canal en el que vivan tus supervisores.
Para talleres multilingües, usa lang= en cada URL de Kiosk para que se cargue en el idioma correcto independientemente del predeterminado de la cuenta.
Rota periódicamente las url_keys si te preocupan las URLs filtradas — generar una nueva vista reemplaza la URL pero solo lleva un minuto.