O que foi adicionado e alterado nesta versão

• Java 25: runtime, compilação e JavaFX atualizados para Java 25 (Temurin 25). Requisito mínimo do usuário final passa a ser Java 25+.
• Zonas de navegação por domínio: bottom nav e centro de configurações renomeados por domínio — "Gestão da loja", "Operação", "Caixa e turno", "Financeiro", "Fiscal e auditoria", "Suporte".
• InactivityLock: bloqueio automático de tela por inatividade configurável — segurança operacional no balcão.
• PdvStatusBar: barra de status operacional sempre visível com conexão, loja, operador, turno e modo offline/online.
• Supervisor elevation: botões de desconto e cancelamento sempre visíveis na Nova Venda — habilitados por perfil ou via autorização inline de supervisor.
• SetupGate: tela de configuração inicial bloqueante — o sistema não avança até loja e operador estarem configurados corretamente.
• Scripts Python: health-check e validação migrados para Python (pasta scripts/) — padronização com o ecossistema.
• Pipeline CI: workflow release-free.yml atualizado para java-version: '25' (Temurin 25).

Limitações da edição FREE

Para que perfil de loja esta versão faz sentido

• Alta aderência: pequena operação com 1 a poucos caixas, foco em venda rápida e necessidade de trabalhar mesmo com internet instável.
• Aderência média: loja em fase de transição de processo, que precisa provar fluxo e rotina antes de ampliar estrutura.
• Linux/macOS: equipes técnicas ou pequenas operações que preferem sistemas não-Windows podem testar o PDV na plataforma de sua escolha.
• Baixa aderência: operação que já exige integração fiscal completa, múltiplas integrações legadas e automações além do escopo Free.

Regra comercial: primeiro validar o básico com a Free; depois avançar para o Premium quando houver necessidade real de expansão.

Roteiro de validação em 15 minutos (demonstração rápida)

1. Abertura (2 min): confirmar cenário da loja e principal dor do balcão (fila, fechamento, internet, treinamento).
2. Operação de venda (5 min): cadastrar item simples, registrar venda e concluir recibo digital.
3. Prova de continuidade (3 min): destacar operação local e explicar como o fluxo se mantém previsível com oscilação de internet.
4. Leitura de gestão (3 min): mostrar visão rápida do dia para dono/gerente.
5. Fechamento comercial (2 min): alinhar limites da Free e próximos passos para evolução Premium.

Documentação de produto: wiki.caracore.com.br/projeto-pdv.html.

Objeções comuns e resposta comercial curta

FAQ comercial da versão atual

Preciso pagar para testar?
Não. A edição Free foi criada para validação real com limites explícitos.

Consigo usar em produção?
Sim, para operação pequena dentro dos limites da edição Free.

Preciso instalar Java?
Sim. O requisito é Java 25+ no sistema (Temurin 25 é a recomendação). Verifique com java -version antes de executar.

A Free já inclui tudo?
Não. Ela valida o fluxo principal; recursos de expansão ficam no Premium.

Qual o próximo passo após validar?
Agendar demonstração comercial para plano de implantação e evolução de operação.

Pacotes publicados no canal público

Valide a integridade com SHA256SUMS.txt e RELEASE_MANIFEST.json incluídos na release.

Instalação rápida

1. Certifique-se de ter Java 25+ instalado: java -version
2. Baixe o pacote da sua plataforma na página de download.
3. Extraia o ZIP para uma pasta local (ex.: C:\Programas\CaraCore-PDV-FREE no Windows).
4. Windows: execute iniciar-pdv.bat. Linux/macOS: execute ./iniciar-pdv.sh.
5. Aguarde ~10 segundos para o backend Quarkus iniciar.
6. Acesse o sistema no navegador em http://localhost:8765 ou pela janela principal do aplicativo.

Primeiro login: usuário admin · senha admin · troca obrigatória no primeiro acesso.

Dados: banco SQLite local criado automaticamente em %APPDATA%\caracore\ (Windows) ou ~/.config/CaraCore PDV/ (Linux/macOS).

Integridade do pacote

Cada release inclui SHA256SUMS.txt e RELEASE_MANIFEST.json. Para validar:

# Windows (PowerShell)
Get-FileHash caracore-pdv-v3.2.2-free-free-windows-x64.zip -Algorithm SHA256

# Linux
sha256sum caracore-pdv-v3.2.2-free-free-linux-x64.zip

# macOS
shasum -a 256 caracore-pdv-v3.2.2-free-free-macos-x64.zip

Compare com o hash correspondente em SHA256SUMS.txt da mesma release.

O que permanece igual às versões anteriores

• Cadastro de produtos, clientes, vendedores e configurações de loja.
• Fluxo de venda, carrinho e fechamento de caixa.
• Trilha de auditoria e perfis de operador.
• Banco SQLite local preservado — migrações Flyway automáticas.
• Limites da edição FREE: 100 vendas/mês, 1 operador, 4 vendedores, 1 loja, 100 produtos, 10 SMS recibo/mês; sem NF-e e sem PIX.

Evolução planejada

• Pacote instalador nativo NSIS (Windows) — próxima release.
• Assinatura digital no macOS (requer certificado Apple Developer).
• Upgrade in-place para edição PREMIUM sem reinstalação.
• Dashboard simplificado otimizado para o plano FREE.