# CaraCore PDV 4.0.0 — 08/11/2026

Primeira versão de linha (GA) da v4. Release `v4.0.0` publicada no repositório de distribuição em
06/11/2026; este texto é a nota oficial do lançamento.

- Windows x64; abre no Edge em modo aplicativo; Java 25 já embutido no pacote.
- `CaraCore-PDV-4.0.0-qute-portable-windows-x64.zip` · **176.613.179 bytes**
- SHA-256 `9557e0b16d77a85e0bb68971eb0e8710356977261337a8c1c05593e893d81eac`
- Origem: `master` `be0f74b` (pacote de 06/11/2026)
- Assinatura: duas chaves Ed25519 do projeto (`pdv-release-2026-a` e `pdv-release-2026-b`) sobre a lista
  `SHA256SUMS.txt`

## Como instalar

1. Baixe o ZIP e confira o SHA-256 (passo em "Conferir o que você baixou").
2. Extraia em uma pasta com espaço para o banco e os logs — por exemplo `C:\CaraCore\PDV-4.0.0`.
3. Abra `iniciar_pdv.bat`. O Edge abre em modo aplicativo, apontando para o caixa local.
4. No primeiro acesso, entre com `admin` / `admin` e crie a sua senha na tela de primeiro acesso.
5. Depois do login, o caixa abre em "Nova venda". Os dados ficam em `.\data\` (banco `caracore-pdv.db` e
   `logs`), dentro da pasta extraída.

Não precisa instalar Java, Python nem banco de dados. Não é um instalador MSI: é pasta portátil, e o Edge
faz parte do Windows.

## O que esta versão faz

- Venda no balcão por código digitado ou lido no leitor; quantidade, desconto e foco no campo de valor.
- Pagamento em dinheiro (com troco), débito, crédito e outros, na tela de pagamento da venda.
- Estoque dá baixa quando a venda é finalizada; venda em aberto cancelada não movimenta estoque.
- Venda paga não é alterada: cancelar, descontar ou editar itens de uma venda finalizada é recusado.
- Turno de caixa com sangria, suprimento e fechamento X/Z, com a diferença apontada na conferência.
- Recibo da venda em tela e em PDF (sem valor fiscal).
- Dashboard com o movimento do dia, produtos com custo acima do preço e, no plano Pro, o resumo financeiro
  previsto (bruto, impostos estimados, retenção prevista e líquido previsto).
- Backup local pelo Centro de backup, com a política de criptografia de campos explicada na tela.
- Auditoria de login, venda finalizada, cancelamento e troca de senha, com eventos encadeados e verificados
  no teste.
- Funciona sem o canal de atualização: a venda conclui com os destinos externos inalcançáveis e nenhuma
  conexão externa é aberta pelo aplicativo durante o fluxo (medido em 05/11/2026).

## Atualização

- A partir desta versão, o PDV consulta o canal oficial (`api.caracore.com.br/releases/pdv-v4`) e, quando
  houver versão nova, mostra o aviso no dashboard com "Ver novidades", "Baixar" e "Lembrar depois".
- O download é feito pelo próprio app e conferido por SHA-256; o canal só é aceito com a lista de hashes
  assinada por duas chaves Ed25519.
- **A aplicação do pacote é manual:** feche o PDV, extraia o ZIP e copie o conteúdo sobre a instalação,
  mantendo a pasta `data`. A oferta é adiada enquanto houver venda aberta.

## Plano Free e plano Pro

- **Free:** até **100 vendas finalizadas por mês**, **100 produtos**, **1 operador de caixa**,
  **4 vendedores** e **1 loja**. Ao chegar no limite, o sistema avisa e orienta o upgrade; a venda que
  excede o limite não é finalizada.
- **Pro:** licença assinada para a máquina, sem esses limites e com o resumo financeiro do dia. A licença é
  um arquivo local; não depende de internet para o caixa abrir.

## Quem vem da 3.2.12

- Faça backup do banco antes. Copie o banco da 3.2 (`%APPDATA%\caracore\caracore-pdv.db`) para
  `data\caracore-pdv.db` na pasta da v4 **antes da primeira abertura**; o esquema é atualizado sozinho, uma
  vez, e não volta atrás.
- A primeira abertura passa pelo fluxo de primeiro acesso: você define uma senha nova; a senha antiga da
  3.2.12 não é reaproveitada (medido no cenário de banco migrado).
- Vendas, produtos e operadores da 3.2.12 continuam legíveis depois da migração. Na medição, o banco saiu da
  migração `047` para `052` e as vendas antigas ficaram intactas.
- **Diferença importante:** esta versão não tem estorno de venda já paga. Na 3.2.12, estornar uma venda paga
  devolvia o estoque e gravava o status `ESTORNADA`; aqui esse caminho não existe. Confira itens e pagamento
  antes de finalizar.
- Instalações novas e migradas usam o mesmo pacote; não é preciso instalar a 3.2.12 antes.

## Conferir o que você baixou

1. No PowerShell, na pasta do arquivo:
   `Get-FileHash .\CaraCore-PDV-4.0.0-qute-portable-windows-x64.zip -Algorithm SHA256`.
   O resultado tem de ser `9557e0b16d77a85e0bb68971eb0e8710356977261337a8c1c05593e893d81eac`.
2. Na mesma release estão `SHA256SUMS.txt` e duas assinaturas (`SHA256SUMS.txt.sig` e
   `SHA256SUMS.txt.sig.pdv-release-2026-b`). Elas provam que a lista de hashes saiu do projeto.
3. Não existe assinatura Authenticode. O Windows pode exibir "editor desconhecido" ao abrir o launcher.
   Isso é esperado: não desative o SmartScreen, o Defender nem o antivírus para rodar o programa.

A assinatura prova a origem do pacote, não a ausência de falhas no software.

## SBOM e varredura de dependências (OSV)

- SBOM CycloneDX: 261 componentes, publicado junto desta versão (`bom.json`).
- Varredura OSV (`api.osv.dev`) sobre o SBOM do próprio artefato, medida em 06/11/2026: 275 pacotes
  consultados, 1 achado de severidade alta, triado.
- O achado é o `CVE-2024-47554`, no `commons-io 2.8.0` aninhado dentro do `velocity-engine-core 2.3`. O
  programa embutido no pacote usa `commons-io 2.21.0`: as 182 classes do runner foram conferidas por byte e
  nenhuma é da versão afetada. O achado não alcança o que roda.
- NVD não foi consultado nesta data. O resultado acima é OSV, com fonte e data — não é um atestado de
  ausência de vulnerabilidades.

## Limites conhecidos

- Sem Authenticode; sem MSI e sem instalador: é ZIP portátil.
- Sem PIX integrado, sem emissão fiscal (NF-e/NFC-e) e sem TEF. O recibo não tem valor fiscal.
- Criptografia por campo, não do arquivo: a senha de envio de e-mail e, quando existirem, a senha do
  certificado fiscal e a chave de licença são cifradas. O arquivo do banco não é cifrado (recomenda-se
  BitLocker na pasta) e o CPF do cliente fica em claro, igual à 3.2.12.
- Recuperação de senha: quem esquecer a senha depende do administrador redefinir; não há autoatendimento.
- Desempenho não foi medido nesta versão — não há promessa de tempo de abertura.
- O resumo financeiro é estimativa local com UF/regime padrão e alíquotas cadastradas. Sem alíquota, IBS/CBS
  aparecem zerados; a retenção é apenas prevista e nenhum PIX Split é executado.

## Evidências da versão

- T032 no próprio ZIP: 17/17.
- Matriz de homologação: 11 itens medidos, 11 aprovados, 0 reprovados, incluindo a recusa `409` de alterar
  venda paga. A medição de desempenho (M11) **não foi feita**: `PERF-001`–`007` seguem congeladas por decisão
  do dono, e bloqueado não é aprovado.
- Banco 3.2.12 migrado: 9/9, origem `047` → `052`.
- Venda com destinos externos inalcançáveis e quarteto na tela: aprovado (0 conexões externas em 70
  amostras).
- Sonda de promessas no pacote: 20 aprovadas, 0 reprovadas, 1 não coberta, 0 bloqueadas. O item não coberto
  é a aplicação automática do pacote: o aviso e o download são medidos (canal oficial respondeu `200` com
  este hash, o cliente aceitou a assinatura e o download público confere) e a aplicação é manual, como
  descrito em «Atualização».
- SBOM no asset `bom.json`; varredura OSV no asset `OSV_2026-11-06.json`.

[Release no GitHub](https://github.com/chmulato/caracore-pdv4-releases/releases/tag/v4.0.0) ·
[Downloads](../download.html) · [Versões](../versoes.html)
