Documentação do Sistema
Estrutura de dados e funcionalidades do sistema de gestão de fábrica
Visão Geral do Sistema
Este sistema de gestão de fábrica foi projetado para automatizar e otimizar os principais processos industriais, incluindo:
- Controle de produção
- Gerenciamento de estoque
- Registro de vendas
- Controle financeiro
- Monitoramento de KPIs
- Alertas de estoque baixo
Estrutura de Dados
Sistema baseado em 5 tabelas principais que cobrem todos os processos fabris
Telas Essenciais
Interface completa com 8 telas principais para controle de todas as operações
Dashboard Integrado
Visão consolidada de todos os indicadores importantes para tomada de decisão
Estrutura de Dados
O sistema é baseado em 5 tabelas principais que gerenciam todos os processos da fábrica, desde a produção até as vendas e finanças.
1. Produtos
Gerencia todos os itens (matérias-primas e produtos finais) da fábrica.
| Campo | Tipo | Descrição |
|---|---|---|
| produto_id | INT (PK) | Identificador único |
| nome | VARCHAR | Nome do produto |
| tipo | ENUM | 'materia_prima' ou 'produto_final' |
| estoque_minimo | INT | Quantidade mínima para alerta |
2. Ordens de Produção
Controla as ordens de produção de produtos finais.
| Campo | Tipo | Descrição |
|---|---|---|
| ordem_id | INT (PK) | Identificador único |
| produto_id | INT (FK) | Produto a ser fabricado |
| quantidade | INT | Quantidade a produzir |
| data_inicio | DATE | Data prevista de início |
| data_fim | DATE | Data prevista de término |
| status | ENUM | 'pendente', 'em_producao', 'finalizada' |
3. Movimento de Estoque
Registra todas as movimentações de estoque da fábrica.
| Campo | Tipo | Descrição |
|---|---|---|
| movimento_id | INT (PK) | Identificador único |
| produto_id | INT (FK) | Produto movimentado |
| tipo_movimento | ENUM | 'entrada' ou 'saida' |
| quantidade | INT | Quantidade movimentada |
| data_movimento | DATE | Data da movimentação |
| origem_destino | VARCHAR | Fonte ou destino (ex: fornecedor, cliente, produção) |
4. Vendas / Entregas
Controla as vendas realizadas e as entregas aos clientes.
| Campo | Tipo | Descrição |
|---|---|---|
| venda_id | INT (PK) | Identificador único |
| produto_id | INT (FK) | Produto vendido |
| quantidade | INT | Quantidade vendida |
| nome_cliente | VARCHAR | Nome do cliente |
| data_venda | DATE | Data da venda |
| valor_total | DECIMAL | Valor total da venda |
5. Controle Financeiro
Gerencia todas as transações financeiras da fábrica.
| Campo | Tipo | Descrição |
|---|---|---|
| financeiro_id | INT (PK) | Identificador único |
| tipo_transacao | ENUM | 'conta_pagar', 'conta_receber', 'despesa_fixa', 'receita' |
| descricao | VARCHAR | Descrição da transação |
| valor | DECIMAL | Valor da transação |
| data_vencimento | DATE | Data do vencimento |
| status | ENUM | 'pendente', 'pago' |
Telas do Sistema
O sistema possui uma interface completa com telas essenciais para operação diária da fábrica.
1. Tela de Login
- Controle de acesso dos usuários
- Recuperação de senha
- Proteção contra múltiplas tentativas
2. Cadastro de Produtos
- Formulário para adicionar/editar produtos
- Lista com busca e filtro de produtos
- Visualização de estoque atual e estoque mínimo
- Alertas visuais para estoque abaixo do mínimo
POST /products
PUT /products/{id}
3. Ordens de Produção
- Criar nova ordem de produção
- Listar ordens abertas, em produção e finalizadas
- Atualizar status da produção
- Cálculo automático de matérias-primas necessárias
POST /production-orders
PATCH /production-orders/{id}/status
4. Controle de Estoque
- Visualizar movimentações de estoque
- Registrar movimentação manual (entradas/saídas)
- Alertas de produtos com estoque abaixo do mínimo
- Exportação de relatórios
POST /inventory/movements
GET /inventory/alerts
5. Vendas / Entregas
- Registrar nova venda
- Listar vendas realizadas
- Filtros por data e cliente
- Visualizar histórico de vendas
POST /sales
GET /sales/history?client=CLIENTE
6. Controle Financeiro
- Registrar transações financeiras
- Visualizar fluxo de caixa
- Saldo financeiro atual
- Filtrar transações por tipo, status e data
POST /finance/transactions
GET /finance/balance
7. Dashboard
- Visão geral com indicadores-chave
- Produtos com estoque baixo
- Ordens de produção pendentes
- Vendas recentes
- Saldo financeiro atual
GET /dashboard/metrics
8. Gerenciamento de Usuários
- Cadastro e gestão de usuários
- Controle de permissões (admin, operador)
- Histórico de atividades
POST /users
PUT /users/{id}/permissions
Observações Importantes
Esta seção destaca os pontos críticos para compreensão do fluxo de dados e integração entre módulos.
Produtos
A tabela de produtos serve para ambos os tipos, matéria-prima e produto final, diferenciados pelo campo "tipo".
Movimento de Estoque
Controla toda entrada e saída, seja para matéria-prima, produto final, ou produção. Cada movimentação diminui ou aumenta o saldo atual do estoque.
Ordens de Produção
Quando uma ordem de produção é finalizada, o sistema deve gerar automaticamente movimentos de saída das matérias-primas utilizadas e entrada do produto final produzido.
Vendas
Cada nova venda gera automaticamente um movimento de saída de estoque do produto vendido e uma transação de receita no controle financeiro.
Controle Financeiro
Deve ser integrado com o módulo de vendas para registrar receitas e com o de compras para registrar despesas. Também lida com despesas fixas e contas a pagar/receber.
Fluxos de Integração
Como as diferentes partes do sistema interagem para automatizar os processos da fábrica.
Produção de Produto Final
- 1 Ordem de produção é criada
- 2 Sistema verifica disponibilidade de matéria-prima
- 3 Quando produção começa: reserva de matérias-primas no estoque
- 4 Quando produção é finalizada: saída de matérias-primas e entrada do produto final no estoque
Venda a Cliente
- 1 Venda é registrada no sistema
- 2 Sistema verifica disponibilidade do produto no estoque
- 3 Movimentação de saída do estoque é gerada
- 4 Transação de receita é registrada no controle financeiro
- 5 Se estoque fica abaixo do mínimo, alerta é disparado