Visão geral do Kiosk

O Kiosk é a face pública do chão de fábrica do seu Board. É a tela amigável ao toque rodando em um tablet ao lado de cada estação de trabalho, ou em uma TV montada acima da linha de montagem, ou em um telefone enfiado no bolso de um avental. O Kiosk é onde os trabalhadores — não os gerentes — interagem com o sistema: eles veem o que está na fila, registram progresso, registram tempo, sinalizam bloqueios e pegam o próximo trabalho.

Esta página é um tour de alto nível pelo Kiosk: o que é, como é iniciado, como difere do Painel de administração e o sistema de parâmetros de URL que faz uma exibição de Kiosk parecer completamente diferente da próxima.

Kiosk vs Painel de administração. O Painel de administração é para gerentes e planejadores — faça login, obtenha a imagem completa, configure tudo. O Kiosk é para trabalhadores — abra uma URL, veja apenas o que é relevante, toque para registrar. Eles compartilham os mesmos dados subjacentes: cada ação no Kiosk é visível no Painel de administração em poucos segundos.

Sumário

Para que serve o Kiosk
Iniciando um Kiosk
Os dois modos de visualização — Colunas e Tabela
Ações protegidas por PIN
Registrando progresso
Controle de tempo a partir do Kiosk
Bloqueando e desbloqueando uma tarefa
Login de supervisor e arrastar e soltar
Detalhes do trabalho, desenhos e registros
Buscando a partir do Kiosk
Alternâncias Ocultar Concluídos e Mostrar Rascunhos
Atualizações ao vivo / auto-atualização
Referência de parâmetros de URL
Como o Kiosk conversa com o resto do sistema
Modelo de segurança
Configurando uma nova exibição de Kiosk
Dicas e melhores práticas

Para que serve o Kiosk

O Kiosk dá ao chão de fábrica tudo o que precisa e nada do que não precisa. Use-o para:

Lista de trabalho diária — cada trabalhador em uma estação pode ver em um relance o que está na fila, o que está em andamento e o que está bloqueado.
Registrando quantidades — toque em um cartão → insira o PIN → insira quantas peças foram concluídas.
Registrando entrada / saída — inicie um temporizador quando o trabalho começar, pare quando terminar. Entradas de tempo aparecem na página Controle de tempo do Painel de administração imediatamente.
Adicionando notas e fotos — capture desvios, defeitos ou apenas um “FYI” anexado ao registro de trabalho.
Sinalizando bloqueios — marque uma tarefa como bloqueada quando material está faltando, uma ferramenta está parada ou qualquer outra coisa para o progresso.
Exibição em parede — aponte uma TV para ele e toda a fábrica vê a mesma imagem, atualizada automaticamente.

O Kiosk é deliberadamente majoritariamente de leitura para gerentes e majoritariamente de escrita para trabalhadores. Não há menu de configurações, não há diálogos de edição cheios de menus suspensos, não há alternador de módulos. Tudo está a um ou dois toques de distância.

Iniciando um Kiosk

Cada Kiosk está amarrado a uma visualização Kanban personalizada que você configurou em Configurações do aplicativo → Visualizações Kanban. Essa visualização define:

Quais estações de trabalho são mostradas como colunas (e em que ordem).
Para qual departamento filtrar (ou Todos os Departamentos).
Quais colunas de metafield mostrar na visualização de tabela.
A chave de URL da visualização — um slug curto e opaco que a identifica.

Para abrir um Kiosk para uma determinada visualização, a URL se parece com:

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

A url_key é o único parâmetro obrigatório. Todo o resto é uma flag de recurso.

O lugar mais fácil para gerar uma URL de Kiosk é o Configurador de URL do Kiosk no Dashboard. Você escolhe uma visualização, alterna as flags e a página produz uma URL para copiar e colar — sem edição manual necessária.

Sem login necessário. Uma URL de Kiosk é pública. Qualquer um com a URL pode abrir o Kiosk e ver o que está no quadro. Trate a URL como uma senha — veja Modelo de segurança.

Os dois modos de visualização — Colunas e Tabela

Dentro de um Kiosk, o usuário pode alternar entre dois layouts a qualquer momento. A escolha é salva por navegador, por kiosk.

Colunas

O layout kanban horizontal — uma coluna por estação de trabalho. Cada coluna mostra:

O nome da estação de trabalho e uma barra de progresso por coluna (planejado vs fabricado).
Uma pilha de cartões, de cima para baixo por prioridade. Cada cartão mostra ref do trabalho, nome, qtd planejada/fabricada, status bloqueado e quaisquer badges de trabalhadores ativos.

Esta visualização é melhor em telas largas — uma TV de parede ou um tablet em paisagem — quando a equipe quer ver todo o fluxo.

Tabela

Uma listagem densa de uma linha por trabalho-estação com as colunas que você configurou na visualização Kanban subjacente (mais quaisquer colunas de metafield). Cada linha tem os mesmos dados de um cartão, apenas disposto horizontalmente.

Esta visualização é melhor em telas pequenas — um tablet montado em telefone de 7 polegadas ao lado de uma única estação de trabalho — quando a equipe só se importa com sua própria linha.

Uma alternância no cabeçalho do Kiosk (ícone de Colunas / ícone de Tabela) muda entre as duas.

Ações protegidas por PIN

O Kiosk é publicamente acessível — qualquer um com a URL pode visualizar o quadro. Mas escrever nele (registrando quantidades, iniciando temporizadores, bloqueando tarefas) requer um PIN.

Cada funcionário tem um PIN pessoal (4–8 dígitos) configurado em Configurações do aplicativo → Funcionários. Quando um trabalhador toca um cartão e tenta fazer algo, o Kiosk mostra um modal de PIN. Insira o PIN, e a ação prossegue no contexto desse funcionário — significando que a entrada de tempo, nota de registro ou motivo de bloqueio é registrada com o nome dele.

O modal de PIN permanece aberto apenas pelo tempo necessário para uma ação. Não há conceito de uma “sessão” de Kiosk — cada ação é autenticada independentemente. Isso é intencional: significa que o próximo trabalhador pode se aproximar do mesmo Kiosk e usá-lo sem se preocupar em fazer logout.

Apenas funcionários cujas estações de trabalho incluem a relevante podem agir em um cartão. Cada registro de funcionário tem uma lista de estações de trabalho às quais está autorizado. O Kiosk filtra o que eles veem e podem agir de acordo.

Registrando progresso

A ação mais comum do Kiosk. Fluxo:

Toque em um cartão.
Insira o PIN.
O Editor de Estação de trabalho abre. Ele mostra: nome do trabalho, planejado/fabricado atual e uma linha de controles para cada estação de trabalho no trabalho às quais você (o funcionário verificado) está autorizado.
Para cada estação de trabalho, insira:
- Qtd Fabricada — quantas peças foram concluídas nesta rodada.
- Nota (se permitido na estação de trabalho) — um comentário de texto livre.
- Imagens (se permitido na estação de trabalho) — anexe fotos (arraste e solte, cole ou navegue).
Toque em Enviar.

Uma nova entrada de registro de trabalho é criada (visível no Painel de administração na aba Registros do trabalho), a qtd fabricada é incrementada, o carimbo de versão do kanban é avançado (para que o Kiosk de todos os outros se auto-atualize), e quaisquer webhooks qty_changed disparam.

Se a qtd atinge a qtd planejada, a estação de trabalho é automaticamente marcada como concluída (um evento de uma vez que dispara o webhook task_completed).

Alternâncias por estação de trabalho na aba Estações de trabalho do Trabalho controlam o que está disponível aqui: Permitir Qtd, Permitir Notas, Permitir Imagens. Se Qtd está desabilitado, o editor apenas registra que você trabalhou nela — a qtd planejada é registrada como a qtd automaticamente quando necessário.

Controle de tempo a partir do Kiosk

O Kiosk é o lugar mais comum onde entradas de tempo são criadas. Fluxo:

Toque em um cartão → insira o PIN.
No Editor de Estação de trabalho, toque em Iniciar Trabalho (para a linha de estação de trabalho que você quer cronometrar).
O temporizador começa. Um relógio decorrido ao vivo aparece no editor.
Vá embora — o temporizador continua rodando.
Volte depois. Toque em Parar Trabalho.
Uma confirmação aparece com a duração, opcionalmente permite que você insira qtd + nota de uma vez.

A entrada parada aparece imediatamente na página Controle de tempo no Painel de administração, na aba Controle de tempo do trabalho e na badge de avatar do trabalhador no cabeçalho da página de Produção.

Um trabalhador pode ter apenas um temporizador ativo por vez — iniciar um novo em uma estação de trabalho diferente automaticamente fechará o anterior. Isso previne dupla contagem acidental.

Se um trabalhador esquecer de parar um temporizador, duas redes de segurança entram em ação:

Um gerente pode pará-lo do Painel de administração (Painel de Edição de Trabalho → aba Controle de tempo).
Um Cron Job configurado o fechará automaticamente no fim do turno.

Bloqueando e desbloqueando uma tarefa

Trabalhadores podem sinalizar uma tarefa como bloqueada quando algo os impede de continuar — material faltando, ferramenta quebrada, esclarecimento de design necessário etc.

Toque em um cartão → insira o PIN.
No Editor de Estação de trabalho, toque em Bloquear.
Insira uma nota explicando por que (obrigatório).
Toque em Confirmar Bloqueio.

O cartão agora é marcado Bloqueado em vermelho. Ele ainda ocupa sua coluna, mas a sinalização visual diz aos supervisores que algo precisa de atenção. Um webhook job_blocked dispara para que notificações possam ser enviadas para o Slack ou qualquer outro lugar.

Desbloquear segue o mesmo fluxo com uma nota opcional. O cartão retorna ao seu estado normal.

Trabalhadores regulares só podem registrar progresso em cartões aos quais estão autorizados. Supervisores podem fazer mais — especificamente, eles podem arrastar cartões entre colunas para mover o trabalho para frente quando o fluxo de trabalho precisa de um empurrão.

Para habilitar arrastar de supervisor em um Kiosk:

Adicione &show_login=1 à URL do Kiosk.
Um botão Entrar aparece no cabeçalho do Kiosk.
Toque nele → insira o PIN do supervisor → a sessão agora é elevada para essa aba do navegador.
O supervisor agora pode arrastar cartões entre colunas. Solturas são persistidas do lado do servidor e o movimento é visível a todos em poucos segundos.

O status de supervisor é uma flag por funcionário definida em Configurações do aplicativo → Funcionários. O PIN de um funcionário regular não elevará a sessão mesmo se ele tocar no botão de Entrar.

O login persiste para a aba do navegador. Fechar a aba desconecta o supervisor automaticamente.

Detalhes do trabalho, desenhos e registros

Tocar em um cartão com allow_edit=0 (ou qualquer cartão quando não está em modo de edição) abre uma visualização de detalhes do trabalho com várias abas:

Estações de trabalho — cada estação de trabalho neste trabalho e seu progresso (somente leitura).
Detalhes — a descrição, imagem do trabalho, valores personalizados (metafield) marcados como “Mostrar na Etiqueta” e info do Pedido.
Desenhos — cada imagem carregada, PDF ou link externo que o planejador anexou no Painel de administração.
Registros — histórico cronológico de qtd, tempo, nota e entradas de anexo neste trabalho.
Controle de tempo — cada entrada de tempo fechada para este trabalho, mais quaisquer temporizadores ativos.

A aba Desenhos é particularmente importante no chão de fábrica — os trabalhadores podem dar zoom em um desenho CAD ou especificação PDF sem sair do Kiosk.

Quando allow_edit=1, tocar em um cartão vai direto para o Editor de Estação de trabalho (onde o trabalhador pode registrar progresso). As abas ainda são acessíveis a partir do menu de overflow do editor.

Buscando a partir do Kiosk

Se a URL do Kiosk contém &allow_search=1, uma barra de busca aparece no cabeçalho. Digitar nela filtra os cartões em todas as colunas por:

Nome do trabalho
Núm ref do trabalho
Número de pedido / projeto
Nome do cliente

A busca não diferencia maiúsculas/minúsculas e usa correspondência de contém. Quando o campo de busca tem qualquer texto, as alternâncias Ocultar Concluídos / Ocultar Rascunhos são temporariamente ignoradas — para que mesmo um trabalho concluído possa ser encontrado por núm ref. Limpar a caixa de busca traz as alternâncias de volta em vigor.

A busca é local ao navegador atual — filtra o que já está carregado mais uma consulta backend que ignora os filtros de ocultar.

Alternâncias Ocultar Concluídos e Mostrar Rascunhos

Duas alternâncias no cabeçalho do Kiosk controlam quais cartões são visíveis:

Mostrar Concluídos — por padrão, cartões cuja qtd fabricada atendeu (ou excedeu) a qtd planejada são ocultos para que o quadro permaneça focado em trabalho acionável. Ative a alternância para vê-los.
Mostrar Rascunhos — por padrão, estações de trabalho rascunho (aquelas marcadas como rascunho no Painel de administração) também são ocultas. Ative a alternância para vê-las também.

Ambas as alternâncias persistem por navegador, por chave de URL do Kiosk. Então um tablet na linha de montagem pode ser definido para “Ocultar Concluídos = ligado” sem afetar o tablet na pintura.

As flags de URL show_completed=1, show_archived=1, show_draft=1 e allow_draft_progress=1 apenas semeiam o estado inicial na primeira carga. Depois disso, a alternância no Kiosk é a fonte de verdade — mesmo se a URL forçou algo ligado, o trabalhador pode desligá-lo. Isso mantém o Kiosk utilizável quando as preferências da equipe diferem de como a URL foi gerada.

Atualizações ao vivo / auto-atualização

O Kiosk faz duas coisas para permanecer atual:

Consulta silenciosa — uma pequena requisição periodicamente verifica um carimbo de versão do lado do servidor. Se algo mudou (nova qtd registrada, cartão movido, temporizador iniciado/parado) o Kiosk busca novamente o quadro. Se nada mudou, a requisição é um no-op.
Atualização completa periódica — o parâmetro de URL refresh controla com que frequência uma re-busca completa acontece (padrão: a cada 5 minutos). Defina &refresh=2 para atualizar a cada 2 minutos etc. O mínimo é 1 minuto.

Esta combinação significa que um Kiosk montado em parede está sempre atual sem que ninguém precise interagir com ele, e o tablet de um trabalhador pega mudanças de um colega em poucos segundos.

Referência de parâmetros de URL

Uma URL de Kiosk tem um parâmetro obrigatório (url_key) e um punhado de flags de recurso opcionais. O Configurador de URL do Kiosk do Dashboard constrói esses automaticamente; você também pode editar à mão.

Parâmetro	Tipo	Padrão	Significado
`url_key`	string	obrigatório	A chave de URL da Visualização Kanban. Identifica qual visualização renderizar.
`allow_edit`	`0` / `1`	`0`	Mostra o Editor de Estação de trabalho quando um cartão é tocado (após PIN). Desligado = o Kiosk é somente leitura.
`allow_draft_progress`	`0` / `1`	`0`	Permite que trabalhadores também registrem progresso em tarefas Rascunho. Implica mostrar rascunhos na primeira carga.
`allow_search`	`0` / `1`	`0`	Mostra uma caixa de busca no cabeçalho.
`show_login`	`0` / `1`	`0`	Mostra um botão Entrar para supervisores (habilita arrastar e soltar).
`show_completed`	`0` / `1`	`0`	Semeia a alternância “Mostrar Concluídos” no Kiosk.
`show_archived`	`0` / `1`	`0`	Inclui cartões de trabalhos arquivados.
`show_draft`	`0` / `1`	`0`	Semeia a alternância “Mostrar Rascunhos” no Kiosk.
`refresh`	inteiro (minutos)	`5`	Intervalo de auto-atualização. Mínimo 1.
`theme`	`light` / `dark`	`light`	Tema visual.
`lang`	código de localidade (por exemplo, `en`, `pl`, `de`)	padrão da conta	Forçar o Kiosk a renderizar em uma linguagem específica.

Combine flags conforme necessário. Por exemplo:

Exibição em parede (somente leitura, escuro, atualização rápida): ?url_key=...&theme=dark&refresh=2
Tablet de trabalhador (edição + busca + login de supervisor): ?url_key=...&allow_edit=1&allow_search=1&show_login=1
Workshop incluindo rascunhos: ?url_key=...&allow_edit=1&allow_draft_progress=1

Como o Kiosk conversa com o resto do sistema

Cada ação no Kiosk tem o mesmo efeito que a ação equivalente do Painel de administração:

Ação do Kiosk	O que acontece em outro lugar
Registrar qtd	`manufactured_qty` do trabalho atualizada, entrada de registro de trabalho adicionada, webhook `qty_changed` dispara. Se a qtd atende ao planejado, o webhook `task_completed` dispara (apenas primeira vez).
Iniciar trabalho	Registro de temporizador ativo criado. O avatar do funcionário aparece no cabeçalho da página de Produção e no cartão relevante.
Parar trabalho	Entrada de tempo fechada e visível na página Controle de tempo, na aba Controle de tempo do trabalho e na aba Registros do trabalho. Webhook `time_log_saved` dispara com `mode: work_stopped`.
Bloquear tarefa	Cartão sinalizado como bloqueado; webhook `job_blocked` dispara.
Arrastar do supervisor	Cartão move para a nova estação de trabalho. Igual a arrastar e soltar no kanban de Produção.

O Kiosk é totalmente com escopo de inquilino — a url_key identifica o inquilino (sua conta), e todas as consultas são restritas aos dados desse inquilino. Não há vazamento cross-tenant.

Modelo de segurança

Algumas coisas para manter em mente:

A url_key é a credencial. Qualquer um com a URL pode ver o quadro. Trate a URL como uma senha de wifi — ok dar à sua equipe, não ok postar publicamente.
Escrever requer um PIN. Mesmo com a URL, ninguém pode registrar progresso sem um PIN de funcionário válido. PINs são de 4–8 dígitos e definidos por funcionário no Painel de administração.
Um trabalhador só pode agir em suas estações de trabalho autorizadas. Cada registro de Funcionário carrega uma lista de IDs de estação de trabalho aos quais está permitido trabalhar. O Kiosk filtra de acordo.
Supervisores são explicitamente elevados. Apenas funcionários sinalizados como supervisores podem arrastar cartões entre colunas, e apenas quando show_login=1 está definido na URL e tocaram em Entrar com seu PIN.
Se uma URL vazar, regenere a url_key da Visualização Kanban em Configurações do aplicativo → Visualizações Kanban — a URL antiga para de funcionar imediatamente. (Ou exclua a visualização inteiramente.)

Configurando uma nova exibição de Kiosk

Um passo a passo prático para fazer um novo tablet, telefone ou TV mostrar um Kiosk:

Crie a Visualização Kanban — vá para Configurações do aplicativo → Visualizações Kanban → Adicionar Nova Visualização. Escolha o departamento, oculte colunas de estação de trabalho irrelevantes, defina a ordem e salve. A visualização aparece com uma url_key auto-gerada.
Gere a URL — abra o Dashboard → no cartão Configurador de URL do Kiosk, escolha a visualização do menu suspenso. Alterne as flags que você quer (permitir edição, permitir busca, tema, linguagem, …). Copie a URL.
Abra-a no dispositivo — cole a URL no navegador do dispositivo. Favorite / fixe na tela inicial.
(Opcional) Bloqueie o dispositivo — em tablets Android use “Fixação de Tela” ou um launcher em modo kiosk; em iPad use “Acesso Guiado”; em kiosks Windows use “Acesso Atribuído” — esses previnem que usuários acidentalmente saiam da página do Kiosk.
Entregue à equipe — eles podem registrar progresso imediatamente. Sem login, sem treinamento, sem manual.

Dicas e melhores práticas

Uma Visualização Kanban por localização física do Kiosk. Não tente fazer uma visualização caber em cada tela — crie visualizações separadas para a pintura, a baia de montagem e a área de embalagem. Cada uma recebe sua própria URL.
Mantenha tablets próximos às estações de trabalho. Quanto menos passos um trabalhador dá para registrar progresso, mais confiáveis são os dados.
Use show_login=1 apenas onde você tem um supervisor real. Caso contrário, o botão de Entrar é apenas ruído visual.
Para exibições em parede, deixe allow_edit=0. Uma exibição somente leitura é mais confiável (ninguém acidentalmente move algo) e usa menos energia por causa de menos interações.
refresh=5 padrão está bom. Caia para refresh=2 se quiser atualizações de exibição em parede quase em tempo real. Não vá abaixo de 1 — apenas queima largura de banda.
Defina alternâncias por estação de trabalho com cuidado. Permitir Notas e Permitir Imagens são ótimas para etapas com muito QC, mas desnecessárias para cortes simples. Desligue-as na aba Estações de trabalho do Trabalho para manter o Kiosk mais simples.
Combine com Cron Jobs para fechar automaticamente temporizadores esquecidos no fim do turno. Trabalhadores às vezes esquecerão — o cron é sua rede de segurança.
Combine com Webhooks para enviar eventos do chão de fábrica em tempo real (qtd alterada, tarefa bloqueada) para Slack, Teams ou qualquer outro canal em que seus supervisores vivem.
Para fábricas multi-língua, use lang= em cada URL de Kiosk para que carregue na linguagem certa, independentemente do padrão da conta.
Periodicamente rotacione url_keys se você está preocupado com URLs vazadas — gerar uma nova visualização substitui a URL, mas leva apenas um minuto.