Frente de caixa open source

PDV web para vender, gerenciar estoque e evoluir em comunidade.

Hórus PDV reúne balcão, caixa, clientes, fornecedores, produtos, relatórios e gestão avançada em uma base React + .NET aberta para estudo, uso e contribuição.

Ver no GitHub Assistir demonstração
MIT License React 19 + Vite ASP.NET Core .NET 8 SQL Server Smoke test E2E
docs/images/dashboard.png
Dashboard operacional Visão geral, atalhos de operação e módulos do PDV.
MIT Licença aberta
.NET 8 API ASP.NET Core
React Frontend Vite
SQL SQL Server local
E2E Playwright smoke
Quick start

Clone, suba o SQL Server e rode a aplicação local.

O projeto foi organizado para ser auditável e simples de iniciar: banco via Docker, API .NET e frontend Vite com variáveis de ambiente por endpoint.

Clonar projeto Como contribuir
terminal 
git clone https://github.com/flaviooliveira-code/horus_pdv.git
cd horus_pdv

docker start sqlserver2025

cd API/NETCORE
dotnet run --urls http://localhost:5260

cd ../../FRONTEND
npm install
npm run dev
Open source

Construído para ser lido, testado e melhorado.

Transparente

Código, estrutura, scripts e smoke test ficam no repositório.

Auditável

Fluxos críticos de caixa, venda e estoque podem ser verificados ponta a ponta.

Documentado

README, screenshots, vídeo demo e comandos reduzem atrito para novos usuários.

Extensível

Base preparada para módulos fiscais, pagamentos integrados e instaladores.

Demonstração

Veja o sistema operando com API real.

A gravação percorre cadastro, login, CRUDs, gestão avançada, abertura de caixa, venda, cupom, histórico e relatórios.

Abrir vídeo
Módulos

Fluxos essenciais para operação de balcão.

Clique nos cards para abrir a galeria em slides sem sair da página.

Contribuir

Um fluxo simples para colaborar com o projeto.

Antes de abrir PR, rode o smoke test para validar cadastro, login, navegação, CRUDs, caixa e venda.

1

Fork

Crie um fork do repositório e uma branch focada na mudança.

2

Instale

Suba SQL Server, API .NET e frontend React localmente.

3

Teste

Execute `npm run smoke` no frontend antes de enviar.

4

PR

Abra pull request com resumo, prints e escopo bem definido.

Roadmap

Próximos passos do MVP open source.

Em desenvolvimento

Fiscal NFC-e / NF-e

Camada fiscal, emissão, contingência e integração com certificados.

Em desenvolvimento

Pagamentos integrados

TEF, adquirentes, conciliação e retorno de transação.

Planejado

Instalador

Pacote de setup local para simplificar uso em pequenas lojas.

Planejado

Docs técnicas

Guias de arquitetura, endpoints, banco e contribuição.

Conheça o desenvolvedor por trás do Hórus PDV.

O Hórus PDV faz parte do meu portfólio de projetos open source, estudos técnicos e produtos em evolução. No meu site pessoal você encontra outros sistemas, artigos sobre arquitetura, automação, React, APIs e bastidores da construção desses projetos.

Abrir portfólio Ver outros projetos Código-fonte
Hórus PDV Portfólio Projetos e artigos