IDR COMANDAS — COMO USAR A CENTRAL

A central entregue precisa ser instalada em uma VPS e receber um endereço HTTPS.
O código e os exemplos de instalação estão na pasta Central. Nenhum serviço foi
publicado nem nenhuma conta de hospedagem foi alterada automaticamente.
Para a instalação técnica, consulte central/LEIA_PRIMEIRO.txt.

CADASTRAR UM CLIENTE
1. Abra o endereço da central e escolha Administração IDR.
2. Entre com o usuário e a senha criados durante a instalação.
3. Em Cadastrar estabelecimento, informe nome, usuário e senha do proprietário,
   plano, mensalidade, observação da cobrança, data paga, tolerância após
   vencimento e limite offline de até 72 horas.
4. Clique em Criar e gerar ativação. Guarde o token, que aparece apenas uma vez.
5. No PDV, abra Configurações e os dados da Central IDR. Informe o endereço HTTPS,
   identificador da loja, token e chave pública. Valide a conexão.
6. A primeira validação vincula a licença à instalação do computador da loja.

SUSPENDER E LIBERAR
No cartão do cliente, altere Situação para Suspensa e salve a licença.
O PDV recebe a suspensão na próxima validação online. Se estiver desconectado,
vale a autorização já recebida até o prazo de expiração. Não há bloqueio remoto
instantâneo de um computador offline.
Para liberar, coloque Ativa, atualize Pago até e salve. No PDV, use a verificação
da central. O registro do pagamento é administrativo: não há cobrança bancária
automática ou confirmação de recebimento integrada nesta versão.

TROCAR COMPUTADOR OU TOKEN
Use Credenciais e troca de computador no cliente da central. Remova o vínculo
somente quando a instalação anterior não será mais utilizada. Gere novo token
se o anterior foi perdido ou exposto. Uma licença antiga, já recebida offline,
continua até expirar. Não remova o banco local do cliente para trocar a licença.

CONSULTAR RESULTADOS
O proprietário acessa o mesmo endereço e escolhe Proprietário da loja.
O painel mostra somente sua loja e informa quando o PDV gerou e enviou os dados.
Quando a internet da loja cai, os números do painel podem ficar desatualizados.
A sincronização envia operações confirmadas sem duplicar reenvios; ela não é um
backup completo e não substitui as cópias de segurança do computador.

CATÁLOGO DE PRODUTOS
O cadastro do PDV consulta o código exato, preservando zeros à esquerda. A central
mantém a descrição; o preço e o estoque pertencem ao cadastro de cada loja.
A importação da base grande é executada no servidor por arquivo e em partes.
Códigos com descrições conflitantes ficam sinalizados e não preenchem produtos
automaticamente. Consulte Catálogo na central para pesquisar e conferir conflitos.

LIMITES IMPORTANTES DA ENTREGA
Uma instalação/terminal por loja. Equipamentos físicos, conexão da padaria,
capacidade da VPS e publicação HTTPS precisam de validação no ambiente real.
Não copie a chave privada da central para o PDV. Só a chave pública é usada
no computador para conferir se a autorização foi emitida pela IDR.

PUBLICAR ATUALIZAÇÕES DO PDV — 0.6.0

O PDV 0.6.0 tem atualizador incorporado. A primeira instalação vem do ZIP completo.
1. Compile e teste a versão nova, incrementando src/idr_comandas/__init__.py.
2. Gere o pacote somente do aplicativo:
   python scripts/create_update.py --app Aplicativo --output IDR-Flow-X.Y.Z-Atualizacao.zip
3. Na Administração IDR, abra Atualizações, informe a mesma versão do pacote,
   descreva as novidades e envie o ZIP Atualizacao. Não envie o ZIP completo.
4. A central verifica o pacote e assina o manifesto com sua chave privada.
   A publicação exige versão superior à última; o arquivo publicado é imutável.
5. PDVs autenticados consultam a central a cada minuto. O cliente escolhe Atualizar
   com o caixa fechado. O catálogo e dados comerciais não são baixados novamente.
6. Confira a atualização em uma instalação de homologação antes de disponibilizar
   aos demais clientes. Esta versão não oferece grupos de implantação ou rollback
   remoto; para uma correção posterior, publique uma versão superior.

APIs autenticadas por token da loja e vínculo da instalação:
POST /api/v1/update, com store_id e installation_id.
GET /api/v1/update/package?store_id=...&installation_id=...&file=...
O manifesto usa assinatura Ed25519, SHA-256, tamanho e versão; o cliente recusa
pacotes alterados e caminhos inválidos. A chave privada permanece na central.
O administrador usa sessão/CSRF/origem verificada para publicar.

Configure o proxy para upload de até 250.000.000 bytes em /admin/releases/upload,
com limite de tempo suficiente. O nginx.conf.example inclui a rota específica.
Mantenha espaço para os pacotes anteriores e backup da pasta releases e da chave.
Não apague pacotes ainda em download. O diretório privado não pode ser servido
diretamente por URL: os downloads passam pela autenticação do serviço.

O instalador preserva programa anterior e backup, valida a nova inicialização e
tenta recuperar ambos em falha. Os registros result.json ficam nas pastas
.idr-flow-update-* ao lado do Aplicativo. A recuperação não substitui backups
externos nem a homologação de migrações em cada nova versão.

Sem domínio e serviço configurados, o PDV mostra Central não configurada.
O indicador verde é contato recente confirmado; falhas mostram Central offline.
Os testes desta entrega são locais; a implantação HostGator ainda está pendente.
