Sistema de Estoque Multi-Estoque

Objetivo

Construir um sistema de controle de estoque que opere com múltiplos estoques físicos dentro de uma mesma empresa. O sistema permite entrada, baixa e transferência de mercadoria entre estoques, entrada de mercadoria a partir de Nota Fiscal eletrônica e o controle de produtos compostos, em que uma unidade de venda agrupa várias unidades de um produto base.

Todo saldo é mantido por produto e por estoque. Toda alteração de saldo gera um registro rastreável de movimentação, o kardex.

Glossário

Atores

• Operador de estoque: registra entradas, baixas e transferências, importa NF-e e monta ou desmonta bundles.
• Gestor: consulta posição consolidada, relatórios e alertas, e mantém os cadastros, incluindo as composições de bundle.
• Sistema: valida regras, atualiza saldos e grava movimentações.

Papéis e permissões finais a alinhar. O escopo prevê controle de acesso por papel.

Entidades de dados

4.1Estoque físico warehouse

4.2Produto product

4.3Composição do bundle bundle_component

Define de quais produtos e em que quantidade um bundle é formado. Um bundle tem uma ou mais linhas de composição.

Exemplo: o pacote de bombom é um produto bundle com uma linha de composição: componente "Bombom", quantidade 12.

4.4Saldo stock_balance

O saldo é resultado calculável das movimentações. Manter o saldo materializado para leitura rápida e reconstruível a partir do kardex para auditoria.

4.5Movimentação stock_movement

Movimentações são imutáveis. Correção de erro acontece por movimentação de estorno, nunca por edição ou exclusão.

4.6Nota Fiscal invoice e item invoice_item

Funcionalidades

5.1Cadastro de estoques físicos

Criar, editar e inativar estoques. Listagem com unidades e ocupação por estoque.

5.2Cadastro de produtos

Criar, editar e inativar produtos simples e bundles. Visão de saldo do produto em cada estoque.

5.3Entrada de estoque

O operador escolhe o estoque de destino, o produto, a quantidade, o documento e o motivo. O sistema soma a quantidade ao saldo e grava uma movimentação Entrada.

5.4Baixa de estoque

O operador escolhe o estoque de origem, o produto, a quantidade, o documento e o motivo. O sistema subtrai do saldo e grava uma movimentação Baixa.

5.5Transferência entre estoques

O operador escolhe origem, destino, produto e quantidade. O sistema executa as duas pontas de forma atômica e grava uma movimentação Transferência que registra origem e destino.

5.6Entrada por Nota Fiscal

O operador informa o estoque de destino e os dados da nota, importa o XML da NF-e e confere os itens extraídos. Ao confirmar, o sistema dá entrada de cada item no estoque de destino, gerando uma movimentação Nota fiscal por item, vinculada à nota.

5.7Bundles e composição de produtos

O sistema entende que 1 bombom e 1 pacote de bombom são unidades diferentes do mesmo material. O pacote é um produto bundle cuja composição aponta para o bombom com um fator de conversão.

Cada bundle pode operar em um de dois modos, definidos pelo campo controla_estoque_proprio:

• Bundle virtual (sem estoque próprio): o sistema estoca apenas o componente. A baixa ou venda do pacote explode em baixa de 12 bombons. O saldo disponível de pacotes é calculado dividindo o saldo do componente pela composição.
• Bundle físico (com estoque próprio): o pacote é montado fisicamente e guardado pronto. A operação de montagem consome o componente e gera saldo do bundle; a desmontagem faz o caminho inverso. Componente e bundle têm saldos independentes.

A montagem gera uma movimentação Montagem que agrupa, sob o mesmo ref_movimentacao, a baixa do componente e a entrada do bundle. A desmontagem é o inverso.

5.8Consulta de saldo e posição consolidada

Painel com totais: SKUs ativos, unidades em estoque, valor em estoque a custo e quantidade de produtos abaixo do mínimo. Visão por estoque físico e por produto. Para bundles virtuais, exibir o saldo equivalente em pacotes calculado a partir do componente.

5.9Kardex e alertas

Histórico cronológico com filtro por tipo, produto, estoque e período. Produto cujo saldo total fica menor ou igual ao estoque mínimo entra em alerta.

Regras de negócio

1. Quantidade de movimentação é sempre maior que zero.
2. Baixa e transferência exigem saldo suficiente na origem. Comportamento com saldo insuficiente definido na seção 8.
3. Em transferência, origem e destino devem ser diferentes.
4. Transferência é atômica. Se uma ponta falhar, nenhuma ponta é aplicada.
5. Montagem exige saldo de componente suficiente no estoque. Quantidade de componente consumida é a quantidade do bundle multiplicada pela composição.
6. Montagem e desmontagem ocorrem dentro de um único estoque. Não movem saldo entre estoques.
7. Bundle virtual nunca tem saldo próprio. Seu disponível é sempre derivado do componente.
8. Movimentação não é editada nem excluída. Erro é corrigido por estorno que referencia a original.
9. Saldo nunca é alterado fora de uma movimentação registrada.
10. Estoque inativo e produto inativo não recebem novas movimentações.
11. Toda movimentação registra usuário e data e hora.
12. Valor em estoque usa o custo do produto vigente no momento da consulta. O custo de um bundle físico pode ser derivado da soma dos componentes.

Fluxos principais

7.1Transferência entre estoques

7.2Entrada por NF-e

7.3Montagem de bundle (pacote de bombom)

Pontos a decidir antes do desenvolvimento

Fora do escopo desta fase

• Integração contábil e fiscal além da leitura do XML da NF-e.
• Emissão de notas fiscais.
• Controle por lote, validade ou número de série.
• Inventário cíclico e contagem física assistida.
• Previsão de demanda e reposição automática.
• Composição de bundle com mais de um nível, caso a decisão 06 fique em nível único.

Itens podem entrar em fases seguintes mediante novo escopo.