Versão 3.1.2 FREE: primeira release multi-plataforma

O que foi adicionado nesta versão

• Multi-plataforma: primeira release com pacote portátil para Windows, Linux e macOS — a promessa de "trilha de evolução para Linux e macOS" da v3.1.1 foi entregue.
• Workflow CI/CD corrigido: pipeline de release reescrito com empacotamento direto do Quarkus fast-jar, eliminando dependência do Electron (não rastreado no repositório).
• Script de inicialização multiplataforma: iniciar-pdv.bat (Windows) e iniciar-pdv.sh (Linux/macOS) incluídos em cada ZIP.
• SHA256 por plataforma: cada ZIP tem hash individual em SHA256SUMS.txt e RELEASE_MANIFEST.json.
• Integridade de entrega: script delivery_free_multiplatform_to_releases.py na oficina para publicação controlada e rastreável.

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 agora 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.

Abrir plano de validação detalhado para visitas em campo.

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 21+ no sistema (Temurin 21 é 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 21+ instalado: java -version
2. Baixe o pacote da sua plataforma na página de download ou no canal interno de instaladores.
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.1.2-free-windows-x64.zip -Algorithm SHA256

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

# macOS
shasum -a 256 caracore-pdv-v3.1.2-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: 1 operador, 100 produtos, 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.