Tudo começa em um contrato de licitação
O estoque não recebe item “solto”. Compras cadastra o contrato com seus itens e quantidades, e cada recebimento é conferido contra o saldo a receber, com a nota fiscal.
Contrato
Ata de Registro de Preços 018/2026 · Alfa Suprimentos Ltda.
| Item | Contratado | Recebido | A receber |
|---|---|---|---|
|
|
Consumo → Estoque
Papel A4 entra no saldo: 0 → 200 resmas
Permanente → Patrimônio
Cada notebook vira uma unidade com nº de tombamento:
Regras do sistema
- Quantidade nunca negativa.
- Caixa entra em unidade padrão: 1 caixa de 12 → registra 12.
- Bem permanente é sempre individual, com localização e responsável.
- Saldo ≤ estoque mínimo marca o item em vermelho (veja o painel na etapa 5).
Entrada fora de contrato (exceção)
Doação, ajuste de inventário e saldo inicial são permitidos, mas exigem justificativa obrigatória e permissão específica, e ficam auditados.
A regra “entrada exige contrato” é configurável por tenant. A SEMTRAS a mantém ligada.
Evento de domínio: ItemRecebido → consumido por Estoque (consumo) ou Patrimônio (permanente). Um módulo não lê a tabela do outro.
O setor monta o pedido, consumo e permanente juntos
O solicitante cria um rascunho, inclui os itens com a quantidade solicitada e confere antes de enviar. Depois do envio, ele não altera mais.
Pedido 2026/000087
CRAS Centro · João Silva
Reposição de material de expediente e equipamentos para a sala de atendimento.
| Item | Solicitada | Saldo atual |
|---|---|---|
| módulo inativo |
Enviado: o solicitante não altera mais o pedido.
Só o solicitante (ou seu setor) altera o próprio rascunho.
Desative para ver como a tela degrada: o pedido deixa de mostrar o saldo, e nada mais quebra.
Regras do sistema
- Só o perfil Solicitante cria pedidos.
- Se o município tiver só Estoque ou só Patrimônio, o catálogo e o pedido filtram o tipo correspondente.
- Validação opcional da quantidade contra o consumo histórico.
Evento de domínio: PedidoEnviado → inicia o fluxo de autorização do tenant.
Um veredito basta, com quantidade aprovada por item
O pedido cai numa caixa de entrada vista pelos dois setores avaliadores, a NSUAS 1 e a NSUAS 2, e basta que um servidor de qualquer um deles decida. A decisão grava o usuário, o setor dele, a data e a hora. O fluxo é configurável por município (veja 00-configurador-autorizacao.html). O autorizador vê o saldo e define, item a item, quanto aprova (igual, menor ou zero).
Pedido 2026/000087 · CRAS Centro
| Item | Solicitada | Saldo | Aprovada |
|---|---|---|---|
| — |
Observação do gestor (gerada):
Bloqueado: João Silva é o solicitante deste pedido e não pode autorizá-lo (segregação de funções).
Regras do sistema
- Basta um veredito: o primeiro servidor da NSUAS 1 ou da NSUAS 2 que decidir encerra a análise.
- Solicitante não aprova o próprio pedido.
- Todos os itens aprovados ou parte deles → Aprovado (parcial fica na observação). Nenhum → Reprovado.
- Cada decisão grava usuário, setor, data e hora. O autorizador não altera a quantidade distribuída.
Em aberto com a SEMTRAS
O que acontece quando dois servidores abrem o mesmo pedido ao mesmo tempo, e se uma decisão já registrada pode ser revista. Itens de consumo e permanentes seguem o mesmo caminho nesta demonstração.
Compras levanta o que foi autorizado
Só pedidos aprovados aparecem para a separação. Para cada item, Compras confere o saldo e define a quantidade que vai sair. No caso do bem permanente, escolhe as unidades pelos nºs de tombamento.
Pedido reprovado: ele não chega à separação. O fluxo termina na etapa 3.
Volte à etapa 3 e use “Recomeçar demo”.
Separação · Pedido 2026/000087
| Item | Aprovada | Disponível | Distribuir |
|---|---|---|---|
|
|
Deixe menos que o aprovado para ver o pedido ficar Parcialmente atendido; o restante continua pendente para uma próxima entrega.
Regras do sistema
- A quantidade distribuída não passa da aprovada nem do saldo. Saída acima do saldo é bloqueada.
- Itens totalmente distribuídos → Atendido. Caso contrário → Parcialmente atendido.
- O saldo só baixa na entrega, não na separação.
O termo é emitido e o sistema atualiza o resto
Ao entregar, o sistema gera o termo de recebimento com a relação completa dos itens e quem recebeu. Na mesma transação, baixa o saldo e muda a localização dos bens.
Pedido reprovado: nenhum termo é emitido.
Cabeçalho e logo configuráveis por município
TERMO DE RECEBIMENTO Nº 2026/000045
- Pedido
- 2026/000087
- Data
- 28/10/2026
- Solicitante · setor
- João Silva · CRAS Centro
- Autorizado por
| Item | Qtd. | Identificação |
|---|---|---|
Para bens permanentes, o termo inclui o termo de responsabilidade do recebedor.
Recebido por (nome e assinatura) · data e hora
Entregue por (Compras)
PDF gerado com DomPDF a partir de uma view Blade própria, separada das telas.
Efeitos na mesma transação
- Saldo do papel A4: 200 → , e o saldo nunca fica negativo.
- Bens entregues passam a ter o setor e a pessoa como localização e responsável.
- Pedido vira .
- Saldo ≤ mínimo (): papel A4 aparece em vermelho e entra no relatório de reposição.
Em aberto com a SEMTRAS
Como o recebedor assina: termo impresso com upload do escaneado, assinatura eletrônica ou ambos. Falta confirmar se quem recebe é sempre um servidor com login. O MVP começa com o PDF impresso.
Evento de domínio: EntregaConfirmada → Estoque baixa o saldo, Patrimônio atualiza a localização.
Cada passo deixou um registro, e ninguém apaga
A auditoria faz parte do núcleo: está sempre ativa e não é configurável. Esta é a trilha completa do pedido que você acabou de acompanhar.
| Data e hora | Quem | O que fez | Antes → depois |
|---|---|---|---|
| → |
Como a trilha é protegida
- Só inclusão: o usuário do banco da aplicação não tem UPDATE nem DELETE na tabela.
- Registra autor, data, hora, IP e valores antes e depois (
owen-it/laravel-auditing). - Desativar um módulo esconde os dados, mas não apaga nada e a auditoria continua valendo.
Status do pedido
O destaque mostra o status atual da demonstração.