Hardware suportado
Impressora térmica Zebra ZD220 + leitores 1D / 2D HID.
Impressora Zebra ZD220
Impressora térmica direta de etiquetas adesivas, 203 dpi (8 dots/mm), USB / Ethernet opcional. Padrão de etiqueta do ICTUS: 50 × 30 mm (400 × 240 dots).
Setup no Windows
- Conectar via USB e instalar driver "Generic / Text Only" (não o driver Zebra Designer).
- Compartilhar a impressora com nome simples (ex.:
ZEBRA01) — sem espaços. - Em propriedades → Preferências de impressão: papel Custom 50 × 30 mm, sem margens.
- Calibrar mídia: pressionar FEED por 3 s; a impressora detecta o gap entre etiquetas.
- Configurar tipo de mídia Contínua 400 dots se usar rolo contínuo, ou Gap se usar etiqueta die-cut.
- No ICTUS, ir em Admin → Configurações e clicar em "Imprimir etiqueta de teste".
Templates ZPL
Três templates padrão são entregues em worker/src/lib/zpl.ts; cada org pode customizá-los em ict_label_templates.
- KIT: código do kit, alias, validade de esterilização, lote, QR Code (2D) + Code128 (1D).
- ITEM: barcode do item, modelo, contagem de ciclos, QR + Code128.
- BATCH: lote de esterilização, equipamento, programa, data, QR + Code128.
- TEST_PRINT: usado pelo botão de teste em Admin → Configurações.
Exemplo de ZPL (KIT 50×30mm)
^XA
^PW400
^LL240
^CI28
^FO20,15^A0N,28,28^FDICTUS CME^FS
^FO20,50^A0N,20,20^FDKit: {{kit_code}}^FS
^FO20,75^A0N,18,18^FD{{alias}}^FS
^FO20,100^A0N,16,16^FDLote: {{lote}}^FS
^FO20,120^A0N,16,16^FDValidade: {{sterile_expires_at}}^FS
^FO260,40^BQN,2,4^FDLA,{{kit_barcode}}^FS
^FO20,160^BY2,2,40^BCN,50,Y,N,N^FD{{kit_barcode}}^FS
^XZ
Leitores de código de barras / QR
Qualquer leitor que opere em modo HID Keyboard Emulation é compatível. Recomenda-se leitores 2D (lêem 1D + QR + DataMatrix + PDF417).
Modelos recomendados
| Modelo | Tipo | Notas |
|---|---|---|
| Honeywell Voyager 1450g | 2D corded | Excelente custo-benefício; leitura rápida; ergonômico. |
| Zebra DS2208 | 2D corded | Robusto, IP42, ideal para área limpa/expurgo. |
| Datalogic QuickScan QD2430 | 2D corded | Boa leitura em etiquetas térmicas pequenas (kit 50×30 mm). |
Configuração obrigatória
- Modo: HID Keyboard (não USB COM emulator).
- Sufixo: CR (Enter) — alguns 2D usam Tab, ambos funcionam.
- Layout: US English (default) — evite ABNT2 no leitor, mesmo se o teclado físico for ABNT2.
- Prefixo: vazio. Se necessário (AIM ID / FNC1), configure no ICTUS via
useBarcodeScanner({ prefix, suffix }). - Velocidade: padrão do fabricante (60 ms entre teclas funciona).
RFID (opcional)
Leitor RFID USB emulando HID com prefixo configurável; integra-se ao mesmo listener com strategy de roteamento (auth vs. operação). Cada cartão tem um rfid_hex registrado em ict_user_credentials.
Tablet / desktop
- Recomendado: tablet Windows 10/11 de 10–12", ou notebook compacto, na bancada do expurgo / preparo.
- Resolução mínima: 1280×800 (PWA "Thick Finger" mantém botões ≥ 48 px).
- Conectividade: Wi-Fi corporativo; offline parcial via service worker para consulta de receita do kit.
- Câmera traseira: fallback ZXing (próxima fase) se não houver leitor físico.
Infraestrutura de rede
- Estação de trabalho da CME → Zebra ZD220 via USB (ou rede TCP 9100 RAW).
- Estação → Internet → Cloudflare Workers (HTTPS).
- Sem servidor on-premise: nenhuma instalação local de banco, agente ou serviço.