CaraCore PDV — duas linhas, mesma filosofia

O CaraCore PDV é o caixa da loja. Existem duas linhas do mesmo produto: a oferta madura Java Free (backend Quarkus, operada pelo launcher no Edge na v4.0.0 e pelo navegador na versão anterior 3.2.12) e a linha piloto Rust (app nativo Windows). Nenhuma substitui a outra. Manuais estão neste portal; download fica na loja de cada linha.

Coexistência e versões: o PDV v4.0.0 foi lançado em 08/11/2026 e é a versão indicada para operar; o pacote saiu com os gates medidos (T032 17/17 e matriz 11/11, com a medição de desempenho, M11, não feita). A release v4.0.0 foi publicada em 06/11/2026 (ZIP portátil Windows x64, SHA-256 9557e0b1…d81eac, 176.613.179 B, assinada com duas chaves Ed25519), com lançamento em 08/11/2026. A versão anterior é a v3.2.12-free, última da linha 3.2.x, multiplataforma, com manutenção encerrada em 08/11/2026 e os pacotes ainda disponíveis; a build candidata v4.0.0-candidato-20261031 fica no histórico. Rust usa a release v0.1.4. São faixas independentes.

Linha madura

Linha atual · v4.0.0 · lançada em 08/11/2026 para Windows 10/11 x64, com launcher no Edge

Versão anterior · última da linha 3.2.x · canal v3.2.12-free, multiplataforma, com manutenção encerrada em 08/11/2026

Frente de caixa Local-First para PME: cadastrar produto, registrar venda e manter o balcão operando na máquina da loja mesmo sem internet, com os dados em SQLite local. Na 3.2.12-free o requisito é Java 25+ (Temurin recomendado); a v4 leva o Java no pacote. Na v4.0.0, nem o Free nem o Premium emitem NF-e/NFC-e nem fazem PIX pelo sistema — o PIX é feito pela maquininha do banco, fora do PDV.

  • Oficina: caracore-pdv
  • Loja: caracore-pdv-releases — pdv.caracore.com.br
  • Stack: Java 25 · Quarkus · SQLite · launcher no Edge (v4) ou navegador em localhost:8080/login (3.2.12-free)
  • Windows 10/11 x64 (v4) · Windows · Linux · macOS (3.2.12-free)

Linha piloto

Piloto Windows · release v0.1.4

O mesmo caixa CaraCore, com Rust no núcleo e Tauri 2 no shell. Começa no PDV local (um PC) e pode evoluir para PDV na rede. Download oficial no GitHub Releases.

  • Oficina: caracore-pdv-rust
  • Loja + artefatos: caracore-rust-pdv-releases — pdv-rust.caracore.com.br · GitHub Releases
  • Stack: Rust · Tauri 2 · React · SQLite
  • Instaladores MSI/NSIS pt-BR + ZIP · SHA256

O que muda para você e o detalhe opcional

O que muda para você

Os dois programas fazem o trabalho do caixa: registrar venda, fechar o dia e guardar os dados no computador da loja. A diferença é a tecnologia por baixo e o estágio da oferta. No Java Free não há PIX integrado (QR/gateway). Premium: assinatura mensal de R$ 79,90 com suporte, vendas e cadastros sem os tetos do Free (que vai até 100 vendas por mês), cálculo de CBS/IBS. Na v4.0.0, nem o Free nem o Premium emitem NF-e/NFC-e nem fazem PIX pelo sistema — o PIX é feito pela maquininha do banco, fora do PDV. PIX integrado (Mercado Pago) e NFC-e sob demanda (TecnoSpeed PlugNotas, já desenhada para a transição IBS/CBS) são módulos em desenvolvimento para a v4.1.0, com meta em 24/03/2027. NF-e e NFS-e não estão no escopo planejado. Saiba mais. O piloto Rust documenta PIX com QR nas próprias regras da edição gratuita.

  • Java — o caminho maduro: v4.0.0 no Windows 10/11 x64; a 3.2.12-free segue em Windows, Linux e macOS
  • Rust — piloto Windows, instalador em português, para avaliar a nova stack
  • Os dois operam offline por padrão (SQLite no PC da loja)
  • V3 de negócio vale para os dois: foco em PME

Detalhe opcional

Há duas oficinas e duas lojas. Manuais Java (trilhas, Wiki Fiscal, suporte) estão neste portal em pdv/. Transparência, formatos de instalador e piloto ficam na loja Rust; a ficha Rust está em projeto-pdv-rust.html.

  • Não afirmar que Rust “substitui” ou é “migração forçada” do Java
  • Não misturar números de versão (v3.2.x ≠ v0.1.x)
  • Download Rust oficial = o mesmo repo da loja (caracore-rust-pdv-releases/releases), não caracore-pdv-releases
  • CTAs novos nunca apontam para /delivery/

O que a versão anterior 3.2.12 já entrega

Versão anterior: v3.2.12-free (15/10/2026), com manutenção de transição encerrada em 08/11/2026; a v4 é a indicada para operar. App web local no computador da loja, com caixa redesenhado, leitura e consolidação de itens, quantidade, desconto auditado, CPF opcional mascarado, pagamento em modal e recibo com subtotal/desconto. Pacotes ZIP para Windows, Linux e macOS. Primeiro acesso: Java 25+, pasta nova, iniciar-pdv.bat / iniciar-pdv.sh, depois http://localhost:8080/login com admin / admin. O programa escuta só neste computador, salvo configuração explícita. Roteiro: instalação com sucesso. Notas: 3.2.12-free. Manual e Wiki Fiscal: manual operacional Java.

ÁreaO que o lojista usa hoje
CaixaFree: venda no navegador (dinheiro, débito, crédito e outros — “outros” não é PIX integrado). Sem QR/gateway e sem NF-e/NFC-e. Leitor de código de barras e atalhos de teclado.
GestãoDashboard (vendas, estoque, performance), multi-loja com estoque por unidade
ContinuidadeSQLite local; a loja continua vendendo se a internet falhar
RelatóriosPDF via JasperReports; trilha do contador neste portal
PlanosFonte: PlanoLicencaService. Free (R$ 0): 100 vendas/mês, 100 produtos, 1 operador, 4 vendedores (medido em 06/11/2026), 1 loja; SQLite offline; recibo digital por link e PDF, sem valor fiscal; sem PIX integrado e sem NF-e/NFC-e. Premium: assinatura mensal de R$ 79,90 com suporte, vendas e cadastros sem os tetos do Free (que vai até 100 vendas por mês), cálculo de CBS/IBS. Na v4.0.0, nem o Free nem o Premium emitem NF-e/NFC-e nem fazem PIX pelo sistema — o PIX é feito pela maquininha do banco, fora do PDV. PIX integrado (Mercado Pago) e NFC-e sob demanda (TecnoSpeed PlugNotas, já desenhada para a transição IBS/CBS) são módulos em desenvolvimento para a v4.1.0, com meta em 24/03/2027. NF-e e NFS-e não estão no escopo planejado. Saiba mais. CTA da loja: Baixar Free.
Oficina Java: módulos pdv-core, pdv-fiscal-payment, pdv-platform-security e pdv-apps. A versão anterior v3.2.12-free é uma aplicação web local no navegador em http://localhost:8080/login, publicada em 15/10/2026 por autorização explícita para gates pendentes. Fonte: branch hotfix/3.2.12-free, commit 72ace488aed4ee91001c60cf40a3934ddfe8faf1. A 3.2.8 permanece no histórico. O v4 na oficina usa Quarkus + Qute; a release v4.0.0 foi publicada em 06/11/2026 e o lançamento foi em 08/11/2026; a build candidata de 31/10 fica no histórico. A wiki institucional não substitui o README da oficina.
Não homologado integralmente: 19/19 testes focados passaram com Java 25/H2; os três ZIPs passaram CRC/estrutura e os cinco assets remotos tiveram hashes conferidos. Pendentes: suíte completa, smoke portátil com SQLite/health/navegador, execução Linux/macOS e homologação operacional completa, incluindo Edge/leitor físico. Publicação autorizada em 15/10/2026 com essas ressalvas; os aceites da 3.2.8 não certificam a 3.2.12.

Downloads com integridade verificada — 3.2.12-free

Corretiva: preserva HTTP 405, distingue ESTORNADA de CANCELADA nos recibos/relatórios e grava a fila em transação independente. A migração V047 reconhece estornos antigos apenas com auditoria correspondente. Mantém backup pré-migração e pagamentos novos vinculados à abertura do turno; pagamentos antigos ficam como histórico não atribuído, fora do X/Z individual. O limite Free continua sendo um operador.

  • Windows x64 · SHA-256: 6d7a50b0acf2a05620a090eebdd48f049a1dd5599ccb6c40c419c38145f7c0e2
  • Linux x64 · SHA-256: 795a396318da61d1bd45dcfe816879d2184706f1c7849f1cd2ad98baa99fd9c1
  • macOS x64 (Intel) · SHA-256: 795a396318da61d1bd45dcfe816879d2184706f1c7849f1cd2ad98baa99fd9c1

Release e ressalvas completas · SHA256SUMS.txt · RELEASE_MANIFEST.json. Encerre o PDV antes de atualizar e preserve os dados existentes.

CaraCore PDV 4 (lançado em 08/11/2026)

Release v4.0.0, publicada em 06/11/2026: release no repositório de distribuição, ZIP portátil Windows x64 de 176.613.179 bytes, SHA-256 9557e0b16d77a85e0bb68971eb0e8710356977261337a8c1c05593e893d81eac, origem master be0f74b, imutável, com SHA256SUMS.txt assinado por duas chaves Ed25519. No próprio ZIP: T032 17/17, matriz de homologação com 11 itens medidos e 11 aprovados (a medição de desempenho, M11, não foi feita — PERF-001–007 seguem congeladas), banco 3.2.12 migrado 9/9 (migração 047 → 052) e sonda de promessas 20 aprovadas, 0 reprovadas, 1 não coberta, 0 bloqueadas. O canal pdv-v4 responde 200 com este hash e assinatura de dois kid; o aviso aparece no dashboard e a aplicação do pacote baixado é manual. O SCA do pacote é OSV datado de 06/11/2026 (275 pacotes consultados, 1 achado alto triado por byte); NVD não medido. O lançamento foi em 08/11/2026.

Histórico da prévia: a v4.0.0-candidato-20261031, build de 31/10/2026 (fonte master c343890), foi a prévia pública da edição Free para avaliação no Windows antes do lançamento — ZIP portátil unsigned de 178.317.680 bytes, SHA-256 0c2003b0f99a75328f7ebe632fc20b07cb5834a3f75b6f0e97ccfb7aef83434d, publicada em 31/10/2026, com limite de 100 vendas finalizadas por mês civil. Ela e as v4.0.0-rc6 (10/10/2026, SHA-256 0c00b24b33b3c365fd1f24ec173bfa4e35bedf1946b2df4151035250780d5325, 178.166.244 bytes) e v4.0.0-rc5 ficam no histórico e não são o que se baixa hoje. O roteiro de homologação está publicado. Vale para o pacote atual: Java 25 está em runtime\; o pacote não usa JDK nem Python do sistema; o Edge continua necessário; MSI não será distribuído. O aceite de um pacote não se transporta para outro — as medições da prévia (T032 e matriz feitas em ff400efd, sem SCA medido) não são as da v4.0.0, descritas acima. A versão anterior multiplataforma é v3.2.12-free, última da linha 3.2.x, em manutenção de transição encerrada em 08/11/2026; a v4 é a indicada para operar. Na v4.0.0, nem o Free nem o Premium emitem NF-e/NFC-e nem fazem PIX pelo sistema — o PIX é feito pela maquininha do banco, fora do PDV. PIX integrado (Mercado Pago) e NFC-e sob demanda (TecnoSpeed PlugNotas, já desenhada para a transição IBS/CBS) são módulos em desenvolvimento para a v4.1.0, com meta em 24/03/2027. NF-e e NFS-e não estão no escopo planejado.

O que a v4 acrescenta para a gestão: faturamento do dia identificado sem chamar faturamento de lucro; projeção de bruto, IBS, CBS, retenção prevista e líquido; painel diário com recebimentos por meio e saldo esperado em dinheiro; simulador de preço com alíquotas informadas (sem consulta à SEFAZ e sem executar PIX); custo de aquisição opcional e alertas gerenciais de custo acima do preço ou líquido previsto negativo. Essas projeções e alertas são restritos a GERENTE/ADMIN. Não são apuração fiscal, emissão de documento fiscal, integração SEFAZ ou PIX no PDV.

Migrar da 3.2 para a 4

Suportada a partir da v4.0.0. A v4 atualiza o banco da linha 3.2.x no primeiro acesso (migrações 047 → 052, caminho medido 9/9 no pacote de 06/11/2026), desde que o arquivo esteja na pasta de dados dela antes da primeira abertura. Faça backup antes e mantenha a 3.2.12 instalada até conferir a operação; os pacotes da v3.2.12-free continuam disponíveis como versão anterior.
  • Faça backup da pasta de dados antes de qualquer teste ou migração.
  • Para migrar, copie o banco da 3.2 (%APPDATA%\caracore\caracore-pdv.db) para data\caracore-pdv.db na pasta da v4 antes da primeira abertura; a v4 atualiza o esquema sozinha e mantém vendas e histórico.
  • A v4 não tem a ação de estornar uma venda já finalizada: cancelar uma venda em aberto descarta a venda e não mexe no estoque. Na 3.2.12, o estorno de venda paga devolvia o estoque.
  • Mantenha a 3.2.12 instalada e o backup à mão até conferir a operação na v4.

O que o PDV Rust entrega no piloto

Release v0.1.4, piloto Windows. Edição gratuita: até 100 vendas para testar — condições na transparência da loja.

No caixa

  • Checkout /vendas-v2 (carrinho, pagamento misto, scanner)
  • PIX com QR e confirmação no caixa
  • Abertura/fechamento de caixa e backup ao fechar turno
  • Estoque, clientes (LGPD), gestão e auditoria

Como instala e onde documenta

Qual linha escolher?

CenárioLinha recomendada
Loja em produção hoje, Linux ou macOSJava — pdv.caracore.com.br (versão anterior v3.2.12-free)
Windows, oferta madura, Wiki Fiscal e planos Free/PremiumJava (canal v4.0.0; a 3.2.12-free continua disponível)
Piloto Windows, MSI pt-BR ou avaliação Rust/TauriRust — pdv-rust.caracore.com.br
Trilhas comerciais, representantes, suporte L1 históricoJava — manual neste portal
TI avaliando Tauri, Rust e artefatos reprodutíveisRust (release v0.1.4)

Mapa rápido para quem vai mexer no código

Java · QuarkusRust + Tauri 2
Oficinacaracore-pdvcaracore-pdv-rust
Loja + artefatoscaracore-pdv-releasescaracore-rust-pdv-releases
Canal / releasev4.0.0 (atual) · v3.2.12-free (anterior)v0.1.4
PlataformaWindows 10/11 x64 (v4) · Windows, Linux e macOS (3.2.12-free)Piloto Windows
InterfaceLauncher no Edge (v4) · navegador em http://localhost:8080/login (3.2.12-free)React + Tauri 2
BancoSQLite localSQLite local (PostgreSQL opcional multi-caixa)
Wiki detalhadawiki.caracore.com.br/pdv/projeto-pdv-rust.html
Downloadloja Javacaracore-rust-pdv-releases/releases