Instruction file imported from chmulato/caracore-pdv-releases (.cursor/rules/project-memory.mdc). Copyright stays with the author.

Memória da Loja — caracore-pdv-releases

Name: project-memory
Author: chmulato

Repositório e papel

caracore-pdv-releases: loja (vitrine, download e feedback) do CaraCore PDV Desktop (Java).
URL: https://pdv.caracore.com.br/
Publicação: GitHub Pages a partir da pasta docs/.
Oficina: caracore-pdv (Java 25 · Quarkus). Canal Free publicado: v3.2.6-free (UI no navegador http://localhost:8080/login). Candidato v4 = Qute v4.0.0-rc2 (pré-release; T032 aberto).
Matriz: caracore-site — #caracore-pdv · #pdv-coexistencia.
Wiki: wiki.caracore.com.br — projeto-pdv.html, pdv/.

CTA Free: Baixar Free (3.2.6) → download.html. Premium: demonstração → consultoria.html. Sem misturar NF-e/Reforma no funil Free.
Qualidades: SQLite offline, venda no navegador, fechamento organizado. Copy Free não anuncia recibo nem emissão fiscal.
Menu do produto: O que resolvemos · Como funciona · Economia · Planos · Versões · Agendar demonstração.
Versões (versoes.html): mapa de canais + detalhe RC2 + histórico. Atual = 3.2.6-free. Prévia = 4.0.0-rc2. Sem misturar pasta nem data.
Download: página do Free (ZIPs + SHA + 5 passos); RC2/histórico em versoes.html ou <details>.
Sem depoimento inventado. Sem % de economia inventada.
PWA da loja (pwa.html) = vitrine/atalho, não é o caixa.

Free (R$ 0): 100 vendas/mês, 100 produtos, 1 operador, 4 vendedores, 1 loja; SQLite offline; pagamentos dinheiro, débito, crédito e outros (“outros” não é PIX integrado); sem PIX QR/gateway; sem NF-e/NFC-e.
Premium (R$ 79,90/mês): sem teto de 100 vendas, PIX integrado (QR/gateway), fiscal quando aplicável, suporte prioritário.
Fonte de tetos: oficina PlanoLicencaService.java. Copy pública não inventa recibo SMS.

1 operador: admin / admin em http://localhost:8080/login. Troca de senha obrigatória.
Copy canónica: docs/download.html#perfis (também em wiki-release-v3-2-6-free.html).
Não inventar elenco operador/gestor/auditoria neste ZIP. Não usar senhas do piloto Rust.
Banco: %APPDATA%\caracore\ (Win) / ~/.caracore/ — ≠ %APPDATA%\caracore-pdv\ do Rust.

PDV Desktop (Rust + Tauri 2): https://pdv-rust.caracore.com.br/ · v0.1.4 piloto Windows.
Download Rust = loja própria + artefatos em chmulato/caracore-rust-pdv-releases/releases (tag v0.1.4). Este repo é só o canal Java.
Teto Rust piloto = 100 vendas na vida, não por mês. Não misturar com o Free Java.

Versão atual do download: 3.2.6-free (ZIP Windows/Linux/macOS). Requisito: Java 25+.
Nomes reais dos ZIP: caracore-pdv-v3.2.6-free-free-{windows,linux,macos}-x64.zip.
SHA256 Windows 4b15a12dbe9b525bdb31be59aff5c226f32cbb40f766eca752744996fda634d9 · Linux 028e5987d35650fd0b2f5f4b2146033e92707b413c0cc8242d05df27e1a26e72 · macOS 7e617aebe895d87ffe0446643751886263f29cbab7422a9e2ac3bcdd0aa5deff.
Launcher Free: iniciar-pdv.bat (hífen). Banco: %APPDATA%\caracore\ (Win) / ~/.caracore/.
4.0.0-rc2 é prévia estacionada (iniciar_pdv.bat underscore; Java 25 + Python 3; Edge app mode; banco ./data/caracore-pdv.db; SHA256 5e5d55b6d376c7f1d6ce91a9fb9a73f6d606289af27b508adf2d9eb2cdcd955d). Não é o download da loja. Retomada: oficina CONTINUIDADE_DESENVOLVIMENTO.md / T032.
ZIP 3.2.6 não contém LEIA-ME; texto canônico = sidecar na release + docs/leia-me/LEIA-ME-v3.2.6-free.txt (se existir) / notas wiki-release-v3-2-6-free.html.
V3 (negócio): PME, PIX Split 2027 — posicionamento comercial; não confundir com a linha Rust (v0.1.x).
Evitar: Java descontinuado; “PDV v3” para a linha Rust; “nova geração”; “substitui”; PIX no Free; recibo no Free.