O Sistema Bestcell é uma aplicação local desenvolvida para gestão de vendas e controle financeiro, com foco em vendas à vista e parceladas, amplamente aplicável a pequenos comércios, especialmente no segmento de aparelhos eletrônicos.
O sistema permite:
- Cadastro e acompanhamento de vendas
- Controle detalhado de parcelas e pagamentos
- Registro de acréscimos e descontos
- Identificação de inadimplência
- Geração de relatórios financeiros consolidados
- Encerramento administrativo de vendas críticas
O Bestcell foi projetado para uso diário, operando de forma simples, segura e consistente, priorizando a integridade financeira dos dados.
Todo o processamento ocorre localmente, sem dependência de internet ou serviços externos.
A interface é acessada via navegador, utilizando o Streamlit, e o sistema pode ser iniciado com duplo clique por meio de um arquivo .bat.
- Python 3
- Streamlit
- Pandas
- SQLite
- python-dateutil
Todas as dependências necessárias estão listadas no arquivo requirements.txt.
O Bestcell adota uma arquitetura em camadas, com separação clara de responsabilidades.
Interface (Streamlit)
│
▼
Camada de View
│
▼
Camada de Negócio
│
▼
Camada de Persistência (SQLite)
- bestsystem.py — Interface e orquestração
- view.py — Apresentação e formatação
- utils.py — Regras de negócio e cálculos
- database.py — Persistência de dados
O fluxo de negócio representa o ciclo completo de uma venda.
- Cadastro da venda
- Criação automática da parcela 0
- Pagamento integral
- Arquivamento automático
- Cadastro da venda
- Registro da entrada (parcela 0)
- Geração de parcelas futuras
- Gestão contínua até quitação ou encerramento
- Quitação total → venda arquivada
- Exceção administrativa → venda encerrada
- Cadastro de vendas à vista e parceladas
- Arquivamento automático
- Exclusão de vendas
- Controle individual por parcela
- Status automático (Pago, Em dia, Atrasado)
- Cálculo dinâmico de saldo
- Pagamentos
- Acréscimos
- Descontos
- Histórico financeiro imutável
- Identificação automática
- Consolidação de inadimplência
- Encerramento administrativo
O sistema oferece relatórios financeiros consolidados por período.
- Valor total vendido
- Valor total recebido
- Saldo em aberto
- Valor em atraso
- Vendas do mês
- Parcelas em aberto
- Parcelas em atraso
- Clientes críticos
- Python 3.10+
- Windows
- Navegador web
bestcell-system/
│
├── local/ # versão atual (local)
│ ├── bestsystem.py
│ ├── database.py
│ ├── utils.py
│ ├── view.py
│ └── assets/
│
├── vps/ # reservado para versão VPS (ainda não adicionada)
│ ├── bestsystem.py
│ ├── auth.py
│ ├── database.py
│ ├── utils.py
│ ├── view.py
│ └── assets/
│
├── runtime/ # não versionado
├── run.sh # execução na VPS
└── requirements.txt
Para desenvolvimento local: streamlit run local/bestsystem.py
Para execução na VPS (quando os arquivos estiverem adicionados): ./run.sh
O sistema será acessado em: http://localhost:8501
- sales — vendas
- parcels — parcelas
- adjustments — ajustes financeiros
- archived_sales — vendas quitadas
- closed_sales — vendas encerradas
O banco utiliza SQLite com integridade referencial ativa.
O Sistema Bestcell é um projeto completo, funcional e pronto para uso diário, desenvolvido com boas práticas de engenharia de software.
Atende tanto a um cenário real de negócio quanto a avaliações acadêmicas, servindo como um excelente item de portfólio.
- Acesso remoto via VPS
- Banco PostgreSQL
- Login de usuário
- Backup automático
- API e frontend web
📌 Projeto desenvolvido para fins práticos e uso cotidiano.