🌲 Sistema de Romaneio de Madeiras

Sistema web em Django + PostgreSQL para gestão de vendas de madeiras, clientes, saldos, pagamentos e relatórios.

Django 4.xPostgreSQLPython 3.10+

📌 Sobre o Sistema

  • Controle de vendas de madeira em metros cúbicos (m³).
  • Gestão de clientes, motoristas, tipos de madeira e operadores.
  • Geração automática de romaneios e adiantamentos (pagamentos).
  • Cálculo automático do saldo de cada cliente (dívida ou crédito).
  • Painel com indicadores do mês e relatórios mensais detalhados.

📂 Estrutura Funcional

1️⃣ Dashboard

Resumo mensal: total vendido (m³), faturamento, saldo a receber e quantidade de romaneios/vendas no mês.

2️⃣ Cadastros

CRUD para Clientes, Tipos de Madeira, Motoristas e Operadores.

3️⃣ Romaneio (Vendas)

Registro detalhado de vendas: data, nº do romaneio, cliente, tipo de madeira, motorista, quantidade, tipo de venda, preço unitário e total calculado. Saldo do cliente atualizado automaticamente.

4️⃣ Adiantamentos (Pagamentos)

Registro de pagamentos: data, cliente, valor e descrição. Reduz saldo devedor ou gera crédito automaticamente.

5️⃣ Relatórios Mensais

  • Ficha de Romaneios
  • Ficha por Tipo de Madeira
  • Fluxo Financeiro (entradas e saídas)
  • Saldo de Clientes

📊 Lógica e Regras de Negócio

  • Saldo do cliente: vendas = saldo negativo, pagamentos = redução do saldo negativo.
  • Saldo sempre calculado automaticamente.
  • Relatórios garantem rastreabilidade total das operações.

🛠️ Stack e Boas Práticas

  • Backend: Python 3.10+, Django 4.x
  • Banco: PostgreSQL
  • Arquitetura por apps: cadastros, romaneio, financeiro, relatorios
  • Views baseadas em classes (CBV), templates responsivos (Bootstrap 5)
  • Uso opcional do Django Admin
  • Código limpo e documentado (PEP8)

📦 Recursos da Entrega

  • Modelos Django completos (Cliente, TipoMadeira, Motorista, Romaneio, ItemRomaneio, Pagamento)
  • Relacionamentos corretos (FKs)
  • Lógica de saldo e validação nas views e models
  • Estrutura organizada para fácil expansão futura
  • Exemplos de código nos diretórios dos apps

🚀 Instalação Rápida

git clone https://github.com/seu-usuario/seu-repo-romaneio.git
cd seu-repo-romaneio
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install -r requirements.txt
python manage.py migrate
python manage.py createsuperuser
python manage.py runserver

Acesse: http://localhost:8000