O estoque só nasce de um contrato de licitação
Antes de qualquer item entrar, Compras cadastra o contrato com os itens, as quantidades contratadas e, a partir daí, o saldo a receber de cada um. Esse saldo é o limite para os recebimentos.
Processo licitatório 012/2026 · Fornecedor
Ata de Registro de Preços 018/2026 · Alfa Suprimentos Ltda.
| Item | Contratado | Recebido | A receber |
|---|---|---|---|
|
|
As colunas “Recebido” e “A receber” se atualizam sozinhas quando você registrar recebimentos na etapa 2.
Regras do sistema
- Controle por item: quantidade contratada e saldo a receber.
- Cada item vem do catálogo (núcleo) e já traz o tipo: consumo ou permanente.
- Empenho fica fora do sistema.
Por que contrato?
A entrada no estoque é baseada nos itens recebidos de contratos de licitação. A regra “entrada exige contrato” é uma configuração do município: a SEMTRAS a mantém ligada.
O material chega e é conferido contra o contrato
Cada entrega vem com uma nota fiscal. Compras confere o que chegou contra o saldo a receber. Só então o sistema publica o evento de item recebido, e cada módulo cuida do que é seu.
Primeira entrega
NF 4521 · papel A4 (200 resmas) + notebooks (4)
Contratos e Recebimento
Confere a NF e publica o evento
ItemRecebido
↓→
Estoque · consumo
Gera uma entrada e soma ao saldo.
Patrimônio · permanente
Cria uma unidade tombada por item.
Um módulo não lê as tabelas do outro: a comunicação é só por esse evento.
Registrar novo recebimento
Saldo a receber deste item no contrato:
Tente: 600 canetas em caixas (50 caixas × 12) ou mais que o saldo a receber, para ver o bloqueio.
Regras do sistema
- O recebimento é conferido contra o saldo a receber do contrato e traz a nota fiscal.
- Caixas são registradas em unidade padrão: 1 caixa de 12 → registra 12.
- Nunca há quantidade negativa ou zero.
- Tudo na mesma transação, e cada recebimento fica na auditoria.
Itens de consumo: cada movimento deixa um registro
O saldo de um produto é o resultado das movimentações: o que entrou menos o que saiu. Toda entrada e toda saída vira uma linha com tipo, origem, quantidade, responsável e referência.
Saldo
entradas acumuladas − saídas acumuladas
Movimentações de estoque
| Data e hora | Tipo | Origem | Item | Qtd. | Saldo após | Referência |
|---|---|---|---|---|---|---|
| Nenhuma movimentação ainda. Confira a NF 4521 na etapa 2. | ||||||
Simular uma saída
No fluxo completo, quem gera a saída é a entrega de um pedido, que não faz parte desta página. Aqui ela só serve para mostrar o efeito no saldo.
Regras do sistema
- O saldo nunca fica negativo: saída acima do saldo é bloqueada.
- Toda movimentação guarda o usuário responsável, a data e hora e uma referência (nota fiscal, pedido ou observação).
- As movimentações são a base dos relatórios e da auditoria.
Bem permanente: cada unidade tem nome e endereço
Itens permanentes não têm “saldo”. Cada notebook recebido vira uma unidade individual com número de tombamento, e o sistema sempre sabe onde ela está, com quem e por onde já passou.
Bens tombados
Clique em uma linha para escolher o bem.
| Tombo | Bem | Localização | Responsável |
|---|---|---|---|
| Nenhum bem tombado ainda. Confira a NF 4521 na etapa 2. | |||
Transferir ou devolver
Bem: . Escolher “Almoxarifado” é uma devolução.
Dar baixa
Histórico do bem
Sem bem selecionado.
Regras do sistema
- Cada bem é uma unidade individual: tombo, localização e responsável atuais.
- Transferência entre setores, devolução e baixa ficam no histórico do bem.
- Etiqueta com QR code não entra no MVP.
Inventário já existente
Os bens que o município já possui entram por importação do inventário, e a partir daí seguem o mesmo rastreio.
O sistema avisa antes de faltar
Cada produto de consumo tem um estoque mínimo. Quando o saldo chega nele ou abaixo, o item fica em vermelho e entra na lista de reposição.
Estoque atual por produto
| Produto | Saldo | Mínimo | Situação |
|---|---|---|---|
|
|
|||
| Notebook 14" 8 GB permanente | controlado por unidade, não por mínimo | ||
A marca no meio da barra indica o estoque mínimo. Registre uma saída de 110 resmas na etapa 3 para ver o alerta.
Relatório de reposição
Nenhum item abaixo do mínimo agora.
- : saldo , mínimo
Relatórios básicos do MVP
- Estoque atual por produto
- Reposição (saldo ≤ mínimo)
- Itens sem saldo
- Localização dos bens permanentes
Relatórios avançados ficam fora do MVP.
Fora do contrato só com justificativa, e tudo fica registrado
Doação, ajuste de inventário e saldo inicial não vêm de contrato. São permitidos como exceção, mas exigem permissão específica e uma justificativa obrigatória.
Entrada excepcional
A regra “entrada exige contrato” é configurável por município. Um município que aceite entrada manual como caminho normal só precisa desligá-la, e a justificativa continua obrigatória.
Trilha de auditoria desta simulação
| Data e hora | Quem | O que fez | Detalhe |
|---|---|---|---|
Como a trilha é protegida
- Só inclusão: o usuário do banco da aplicação não tem UPDATE nem DELETE na tabela de auditoria.
- Guarda autor, data, hora, IP e valores antes e depois. Está sempre ativa e não é configurável.
Fluxo de estocagem · dados fictícios · fonte: docs/analise-requisitos.md e docs/descricao basica/Projeto Controle de Pedidos.pdf. O fluxo completo, com pedido e entrega, está em docs/fluxos/01-fluxo-do-sistema.html.