Fonte oficial: codigo e documentacao da garagem. Escopo desta pagina: produto, arquitetura, modulos, operacao, seguranca, testes e planos.
1. Visao de produto
- PDV Selo Verde para varejo brasileiro com foco em operacao antifragil
- Execucao local com SQLite para soberania de dados e continuidade de venda
- Fluxo preparado para Reforma Tributaria 2026-2033
- Distribuicao principal em Windows Desktop (EXE) com abertura em
localhost:8080
2. Stack tecnologica
| Camada |
Tecnologias |
Observacao |
| Backend |
Java 21, Spring Boot, Spring Data JPA, Spring Security, Hibernate |
Base de negocio e APIs REST do PDV |
| Frontend |
Thymeleaf, Bootstrap, HTMX, ApexCharts, jQuery |
Interface web responsiva para operacao e administracao |
| Banco |
SQLite |
Perfil padrao e armazenamento local |
| Desktop |
Electron + JRE embarcada |
Instalador Windows com bootstrap do servidor local |
| Relatorios |
JasperReports |
Geracao de PDF gerencial e fiscal |
3. Modulos funcionais
- PDV frente de caixa com atalhos, fluxo rapido e formas de pagamento
- Gestao de vendas com ciclo completo e rastreio de status
- Cadastro e pesquisa de produtos, clientes, vendedores, lojas e operadores
- Controle de estoque por loja e monitoramento administrativo
- Dashboard executivo com indicadores em tempo real
- Relatorios gerenciais e relatorio para contador (plano Premium)
- Suporte a operacao multi-loja
4. Operacao local e contingencia
- Banco local em SQLite para operar mesmo com internet instavel
- Modo de contingencia com fila local para eventos fiscais
- Fluxo antifragil para manter venda em condicao degradada
- Desktop com inicializacao assistida do backend local quando necessario
- Primeiro acesso de degustacao na loja:
admin / 123456
5. Seguranca e hardening
- Controles de autenticacao e autorizacao na aplicacao
- Empacotamento desktop com foco em integridade e protecao de codigo
- Ofuscacao no fluxo de distribuicao
- Diagnostico guiado no desktop com logs e coleta de evidencia
- Trilha de suporte com canais formais (e-mail, WhatsApp, Telegram)
6. Fiscal, compliance e sustentabilidade
- Motor fiscal com evolucao aderente ao cronograma 2026-2033
- Recibo digital para reduzir custo de papel e impressao
- Registro local e rastreabilidade de operacoes
- Posicionamento Selo Verde com foco em economia operacional
7. Planos e capacidades
| Plano |
Escopo |
Recursos destacados |
| Free (Degustacao) |
Validacao real da operacao |
100 vendas para teste, operacao local, fluxo base do PDV |
| Premium |
Continuidade operacional ampliada |
Recuperacao de senha por SMS, relatorio do contador, suporte prioritario e automacoes premium |
8. Testes e qualidade
- Testes Java (unitarios e integracao) com JUnit e Mockito
- Cobertura com JaCoCo
- Testes de interface com Selenium e Pytest
- Testes fiscais no desktop com Vitest e mocks da SEFAZ
- Validacoes de contingencia e sincronizacao em fila local
9. Navegacao recomendada da wiki