Atualização remota do PDV

Você publica uma versão nova do PDV BMO aqui no painel e cada cliente recebe a atualização sozinho — sem visita, sem TeamViewer. O PDV baixa o pacote, confere se ele é legítimo, aplica de madrugada, reinicia e confirma. Se algo der errado, volta sozinho para a versão anterior.

1. Publicar uma versão

No seu PC, na pasta do projeto do PDV (hamburgueria-pdv), com o PowerShell:

1. Uma vez por sessão do PowerShell, informe o token de administração (o ADMIN_TOKEN do .env da VPS):

   $env:LICENCAS_ADMIN_TOKEN = "cole-o-token-aqui"

2. Gere e envie o pacote, informando a versão nova e uma nota do que mudou:

   .\build-cliente.ps1 -Versao 1.2.0 -Registrar -Notas "Correções no fechamento de conta"

   O script atualiza o package.json, monta dist\pdv-bmo-1.2.0.zip (sem node_modules, bancos, .env e chaves), calcula o hash de integridade e envia tudo ao servidor.
3. Confira aqui em Integrações → Versões: a versão aparece como RETIDA, com tamanho e nota.

Alternativa pelo painel

Se preferir, rode o build sem -Registrar e envie o ZIP em Integrações → Enviar pacote. A versão e o hash são lidos do versao.json que está dentro do ZIP.

2. Liberar a versão

Publicar não muda nada nos clientes. A atualização só é oferecida quando você libera:

1. Abra Integrações → Versões.
2. Na versão desejada, clique em Liberar e confirme. Para voltar atrás, Reter — os PDVs que ainda não baixaram deixam de receber a oferta.

Para liberar já no build, use -Liberar: .\build-cliente.ps1 -Versao 1.2.0 -Liberar.

3. O que acontece no PDV do cliente

1. Descoberta. A cada contato com o servidor (a cada 6 h; 30 min quando há atualização pendente; ou na hora, no botão "Verificar agora" da aba Licença) o PDV recebe a oferta da versão liberada.
2. Download e verificação. Baixa o ZIP autenticado com o token de licença, confere o SHA-256 do arquivo, extrai em atualizacoes\staging-<v>\, confere o hash de integridade dos arquivos principais e roda node --check nos .js do servidor. Se tudo bate: estado BAIXADA.
3. Aplicação. Entre 04:00 e 06:00 (hora do PC do cliente) o PDV faz backup dos arquivos que vão mudar em atualizacoes\backup-<v>\, copia os novos por cima (só o que mudou) e marca APLICADA.
4. Reinício. O servidor do PDV reinicia sozinho — pelo PM2, ou pelo relançador oculto (reiniciar-servidores.ps1) quando o PDV subiu pelo boot do Windows. Leva alguns segundos; as telas abertas reconectam.
5. Confirmação. Quando o servidor volta a responder na porta 3000, o estado vira ATUALIZADO e o painel recebe a confirmação no próximo contato.

4. Aplicar antes da janela

Duas formas de não esperar as 04:00 — ideais fora do horário de atendimento, porque o sistema fica alguns segundos fora do ar:

• Pelo painel: abra a ficha do cliente → na licença, clique Atualizar agora e escolha a versão (aparecem as versões com pacote maiores que a instalada, liberadas ou retidas — assim você faz um piloto num PDV antes de liberar para todos). No próximo contato (até 30 min) ele baixa, verifica e aplica em seguida. Para desfazer antes de acontecer: Cancelar agendamento.
• No PDV: Configurações → aba Licença → bloco Atualização do sistema → Atualizar o sistema agora: consulta o servidor, baixa, verifica e aplica em uma única ação (exige administrador do PDV). Se já houver uma versão baixada aguardando a janela, o botão Aplicar a versão baixada só a aplica.

5. Acompanhar

• Lista de licenças — a coluna Versão mostra a versão instalada e, ao lado, o andamento: 1.1.0 → 1.2.0 BAIXADA, APLICADA, FALHOU…
• Tile "Abaixo de vX" e filtro Versão desatualizada — quem ainda não está na versão liberada.
• Ficha do cliente — campo Atualização com estado, versão de origem/destino e o erro, quando houver.
• Histórico — eventos "PDV baixou a atualização", "PDV aplicou", "✅ PDV atualizado", "⚠ falhou", "⚠ reverteu", e quem liberou/agendou.
• Integridade — depois de atualizar, a instalação deve aparecer ÍNTEGRO (o hash da versão publicada é o esperado). Se aparecer ADULTERADO após uma atualização, alguém editou arquivos no cliente.

6. Verificações e rollback

O pacote é recusado — sem alterar nada no cliente — quando:

• o SHA-256 do ZIP baixado difere do registrado no servidor (download corrompido ou adulterado);
• o hash de integridade de auth.js, licenca.js e server.js difere do publicado;
• algum .js principal tem erro de sintaxe (node --check);
• as dependências do package.json mudaram, ou o binário vendor\node_sqlite3.node é diferente — nesses casos a atualização exige o instalador (instalar-novo-computador.bat).

Rollback automático

Depois de aplicar, o servidor do PDV conta cada tentativa de boot. Se a versão nova não chegar a responder em 3 tentativas, os arquivos do backup são restaurados, o estado vira REVERTIDA e o servidor reinicia com a versão anterior. O painel recebe o evento "⚠ PDV reverteu a atualização".

7. Problemas comuns

Outros guias rápidos

Resumo das demais operações do painel. Cada ação fica registrada no histórico com o usuário que a fez.

Novo cliente e ativação

1. + Novo cliente → nome, contato (WhatsApp) e CNPJ/CPF.
2. Na ficha, Gerar código de ativação → dias (30), carência (2), plano e valor (necessário para o PIX). Copie o código BMO-XXXX-XXXX.
3. No PC do cliente: descompactar o ZIP do build, instalar-novo-computador.bat (como Administrador), iniciar-manual.bat, login admin/admin123, Configurações → Licença → digitar o código → Ativar.
4. De volta ao painel, o cliente aparece ATIVA com vencimento em 30 dias. Trocou de computador? Desvincular PC libera o código para a máquina nova.

Renovar e cobrar

• Ciclo: 30 dias → 2 dias de carência (aviso amarelo no PDV) → bloqueio no dia 33. Ao renovar, os dias somam ao vencimento; se já bloqueada, o novo período começa hoje.
• Pagamento manual: ficha → Renovar → valor, origem e referência.
• PIX automático: com o Mercado Pago configurado e a licença com valor, o cliente vê Pagar com PIX no próprio PDV (tela de bloqueio, faixa de carência e aba Licença). Pagou → renova sozinho em segundos. Você também pode gerar o QR por aqui (Cobrar via PIX) e mandar pelo WhatsApp (botão na ficha, com texto pronto).
• Suspender bloqueia o PDV no próximo contato, ignorando a carência; Reativar desfaz. Cancelar é definitivo (exige novo código).

Integridade dos arquivos

Cada PDV envia um hash de auth.js, licenca.js e server.js. O servidor compara com o hash da versão que o PDV diz ter. ADULTERADO significa que alguém editou esses arquivos no cliente; VERSÃO ? significa que aquela versão não foi registrada (rode o build com -Registrar). A adulteração não bloqueia sozinha — você decide (ligar, suspender).

Usuários e 2FA

• admin faz tudo; operador renova, gera código, cobra e ajusta, mas não gerencia usuários, não cancela nem desvincula.
• Aba Usuários (só admin): criar, editar, redefinir senha, desativar, remover 2FA de quem perdeu o celular, e a lista de últimos acessos com IP.
• Perfil → Ativar 2FA: escaneie o QR no Google Authenticator/Authy e confirme o código. Recomendado para todo admin.
• Bloqueios automáticos: 5 senhas erradas no usuário ou 10 do mesmo IP → 15 minutos. Esqueceu tudo? Na VPS: node cli.js senha-painel "NovaSenha123" e node cli.js usuario-2fa-off admin.