EletroFlow — Sistema Interno de Orçamentos

📋 Sumário

1. Visão Geral
2. Funcionalidades
3. Fluxo de Uso (Exemplo)
4. Instalação & Execução
5. Estrutura do Projeto
6. Exemplos de Saída
7. Contribuição & Padrões
8. Backup & Migração de Dados
9. Contatos / Suporte Interno

---

Visão Geral

Aplicação interna desenvolvida em Python (Tkinter + SQLite) para gestão de orçamentos comerciais da Eletrofrio.
Centraliza cadastros de clientes e produtos, gera documentos padronizados e mantém histórico local de orçamentos.

Principais objetivos:

• Reduzir retrabalho e erros manuais;
• Padronizar a emissão de orçamentos;
• Facilitar consultas e controle de status;
• Permitir exportação em formatos oficiais (PDF/Excel).

---

Funcionalidades

• Cadastro, edição e exclusão de clientes e produtos;
• Emissão e controle de orçamentos comerciais;
• Status configuráveis: Aberto, Aprovado, Cancelado, Rejeitado;
• Filtros avançados por cliente, representante, status, período;
• Exportação para PDF padronizado e Excel (.xlsx);
• Banco de dados SQLite (pedidos.db) criado automaticamente.

---

Fluxo de Uso (Exemplo)

1. Abrir o sistema (python main.py);
2. Cadastrar ou importar clientes e produtos;
3. Criar um novo orçamento e adicionar itens;
4. Exportar o documento em PDF ou Excel;
5. Atualizar o status conforme aprovação ou cancelamento.

---

Instalação & Execução

Requisitos

• Python 3.10+
• Dependências listadas em requirements.txt:
  • openpyxl
  • reportlab
  • ttkbootstrap

Instalação

git clone https://github.com/eletrofrio/sistema-orcamentos.git
cd sistema-orcamentos
python -m venv venv
venv\Scripts\activate     # Windows
source venv/bin/activate   # Linux/Mac
pip install -r requirements.txt

Execução

python main.py

A interface gráfica será aberta com abas para Clientes, Produtos, Orçamentos e Consultas.

---

Estrutura do Projeto

sistema-orcamentos/
│
├── main.py               # Ponto de entrada da aplicação
├── requirements.txt      # Dependências do projeto
├── pedidos.db            # Banco SQLite (gerado automaticamente)
├── utils/                # Funções auxiliares
├── assets/               # Imagens e logotipos internos
├── arquivos_exportados/  # PDFs e planilhas .xlsx geradas
└── docs/
    └── images/           # Capturas de tela e documentação técnica

---

Exemplos de Saída

Tela de Clientes

Tela de Produtos

Tela de Orçamentos

---

Contribuição & Padrões

• Seguir convenção PEP8;
• Nomear commits conforme padrão: feat/, fix/, docs/, refactor/;
• Alterações relevantes devem ser registradas no changelog;
• Atualizar version.json antes de cada release interna.

---

Backup & Migração de Dados

• O banco local pedidos.db deve ser incluído nos backups periódicos da estação;
• Antes de atualizar versões, recomenda-se exportar os dados para Excel;
• As migrações de estrutura (schema) devem ser documentadas no diretório /docs/migrations/.

---

Contatos / Suporte Interno

Responsável técnico: Gabriel Araújo
Departamento: TI – Eletrofrio
Status do projeto: Em uso interno / manutenção contínua
Última atualização: Outubro de 2025