Manual de Implantação

DOSS Print Agent + Bridge 41731

Agent Bridge 41731 Não publique serviceAccountKey.json

Este manual padroniza a instalação de impressão automática em novas lojas. O pacote público pode ser baixado pela Central de Impressão. A chave privada do Firebase deve ser copiada manualmente e nunca publicada online.

1. Pré-requisitos

  • Windows com internet
  • Node.js instalado
  • Impressora instalada e testada no Windows
  • Acesso ao Firebase do projeto correto
  • UID real da loja
  • Arquivo serviceAccountKey.json do projeto correto

2. Estrutura da pasta

C:\doss-print-agent
agent.js
bridge.js
printer.js
config.json
serviceAccountKey.json
package.json
iniciar_doss_print_agent.cmd
iniciar_doss_print_bridge.cmd

3. Copiar os pacotes

  1. Crie a pasta C:\doss-print-agent.
  2. Baixe o pacote do Agent.
  3. Baixe o pacote do Bridge 41731.
  4. Extraia ambos dentro da mesma pasta.
  5. Rode npm.cmd install dentro da pasta.
cd C:\doss-print-agent
npm.cmd install

4. Colocar a chave do Firebase

  1. Copie o arquivo da service account do projeto correto.
  2. Renomeie para serviceAccountKey.json.
  3. Coloque em C:\doss-print-agent.
  4. Valide o projeto:
Select-String -Path .\serviceAccountKey.json -Pattern 'project_id'

No DOSS deve aparecer doss-lab quando essa for a credencial correta.

5. Descobrir a impressora

Get-Printer | Select-Object Name

Copie exatamente o nome da impressora e use o mesmo texto no config.json.

6. Configurar o config.json

Use sempre o UID real da loja. Não use slug ou nome amigável.

{
  "lojaUid": "UID_REAL_DA_LOJA",
  "deviceId": "PC-UNICO-01",
  "deviceName": "PC Unico",
  "deviceRole": "balcao",
  "allowedChannels": ["balcao"],
  "printerName": "Print iD2",
  "paperWidth": 80,
  "pollMs": 2000,
  "channels": {
    "balcao": {
      "printerName": "Print iD2",
      "paperWidth": 80,
      "copies": 1,
      "enabled": true
    },
    "cozinha": {
      "printerName": "Print iD2",
      "paperWidth": 80,
      "copies": 1,
      "enabled": false
    }
  }
}

7. Testar o Bridge

cd C:\doss-print-agent
node .\bridge.js

Depois abra no navegador:

http://127.0.0.1:41731/status
http://127.0.0.1:41731/printers

O status deve retornar ok: true e a lista de impressoras deve vir preenchida.

8. Testar o Agent

cd C:\doss-print-agent
node .\agent.js

O console deve mostrar o UID real da loja e o canal balcao ou cozinha conforme o caso.

9. Validar impressão automática

  1. Deixe Agent e Bridge abertos.
  2. Faça um pedido real no sistema.
  3. Verifique se a comanda sai sem teste manual.
  4. No Firestore, confirme que o print_job vai para printed.

10. Subir com o Windows

  1. Pressione Win + R.
  2. Digite shell:startup.
  3. Crie atalhos para:
C:\doss-print-agent\iniciar_doss_print_agent.cmd
C:\doss-print-agent\iniciar_doss_print_bridge.cmd

Diagnóstico rápido

Quando não imprime automático

  • lojaUid errado no config.json
  • serviceAccountKey.json de outro projeto
  • allowedChannels diferente do canal do job
  • Agent não está aberto
  • Job fica pending com claimedBy = null

Quando o Bridge aparece offline

  • bridge.js não está rodando
  • Atalho não foi colocado em shell:startup
  • Porta 127.0.0.1:41731 não subiu

Ficha de implantação

Nome da loja:
UID real da loja:
Projeto Firebase:
Device ID:
Impressora:
Largura do papel:
Canal permitido:
Bridge validado:
Agent validado:
Teste automático aprovado:
Atalhos no startup:
Data da implantação: