Device Hub: instalar, parear e imprimir

A ponte local entre os apps do navegador e o hardware do armazém: instale no PC, pareie uma vez, conecte impressoras/balanças e acompanhe a fila no centro de impressão.

O que é o Device Hub#

O sandbox do navegador não abre TCP puro / USB / serial, então o WMS web não fala direto com impressoras ZPL nem balanças. O Device Hub é um app residente na bandeja, instalado em cada PC do armazém (Windows / Mac), que faz a ponte “navegador ↔ hardware”: inicia com a máquina e roda despercebido. Feito com Tauri v2: um código para Windows + macOS (Intel e Apple Silicon).

Baixar e instalar#

1. Baixe da página oficial (/zh/download ou /en/download): a página recomenda automaticamente DMG de Mac ou MSI de Windows (universal) conforme sua plataforma.
2. Baixar → instalar → avançar-avançar-concluir. Zero etapas manuais: sem drivers à mão, sem comandos, sem arquivos de configuração.
3. Assistente de primeira execução: ① mostra um código de pareamento → ② descobre impressoras automaticamente (mDNS + USB); marque os dispositivos e defina a impressora de etiquetas padrão → ③ pronto.
4. Inicia com a máquina e roda silenciosamente em segundo plano.

Pareamento#

1. O ícone da bandeja mostra um código de pareamento de 6 dígitos.
2. Digite uma vez no lado web: no diálogo de pareamento que aparece ao imprimir, ou em Admin → Print Devices (o gerenciamento do Hub fica lá).
3. Após parear, um token é emitido (salvo no localStorage); cada handshake WebSocket o carrega daí em diante. Por padrão só escuta 127.0.0.1; o modo LAN (para imprimir do celular) é opt-in e ainda exige o token.

Conectar impressoras#

• Impressoras ZPL (Zebra e similares): USB ou rede porta 9100; o Hub envia ZPL puro e consulta o status (sem papel/fita/tampa aberta).
• Todos os botões de impressão web vão pelo SDK ao Hub. Se não estiver instalado, o botão mostra um cartão “Device Hub não detectado” com o link de download; baixar o ZPL continua como alternativa.
• Impressora de etiquetas padrão: marque-a na página de dispositivos (is_default_label_printer).
• As balanças conectam por serial / USB-serial, com baud rate, prefixo/sufixo e unidade configuráveis; suportam protocolos comuns de saída contínua (ex.: Mettler Toledo, CAS, AND). Registre-a na página de dispositivos como tipo scale.

Canal de impressão na nuvem do celular#

1. Toque imprimir etiqueta no celular → POST /api/wms/print-jobs → tabela print_jobs (queued, com o conteúdo ZPL).
2. O Device Hub do PC assina o Supabase Realtime (com polling de 3 s de fallback) → assume o trabalho atomicamente (UPDATE … WHERE status=queued; zero linhas = cancelado, não imprime; evita erros).
3. Imprime localmente na Zebra → grava done/failed → o celular consulta o status.

Centro de impressão (app Admin)#

• Fila de impressão: toda a tabela print_jobs; filtre por status/armazém/impressora/tipo de etiqueta/tempo. Trabalhos sem atendimento >5 min são destacados; queued podem ser cancelados, failed reimpressos; atualização ao vivo; ao enviar de um botão do WMS você recebe um link para cá.
• Dispositivos de impressão: toda a tabela devices; online/offline pelo heartbeat last_seen_at (limite 2 min); tipo de conexão, marca de impressora padrão, Hub dono; o gerenciamento de pareamento do Hub também fica aqui.