BarberBot Software BarberBotDocumentação Técnica Visão geral
DOCUMENTAÇÃO DE MÓDULO

Produtos e Estoque

Cadastrar produtos, categorias, valores, nível de estoque e comissão; registrar entradas e saídas; disponibilizar os itens para vendas, compras e uso em atendimentos.

MóduloProdutos e Estoque
Status Produção
ResponsávelJacy Cordeiro
Última revisão02/08/2026
01
OBJETIVO

Finalidade do módulo

Cadastrar produtos, categorias, valores, nível de estoque e comissão; registrar entradas e saídas; disponibilizar os itens para vendas, compras e uso em atendimentos.

02
LOCALIZAÇÃO

Caminhos principais

sistema/painel/paginas/produtos.php
sistema/painel/paginas/produtos/listar.php
sistema/painel/paginas/produtos/salvar.php
sistema/painel/paginas/produtos/entrada.php
sistema/painel/paginas/produtos/saida.php
sistema/painel/paginas/produtos/excluir.php
sistema/painel/paginas/estoque.php
sistema/painel/paginas/estoque/listar.php
03
PERSISTÊNCIA

Tabelas relacionadas

produtos
cat_produtos
pagar
comissoes
usuarios
04
FLUXO

Sequência operacional observada

1Cadastrar categoria e produto
2Definir valores e estoque mínimo
3Registrar entrada
4Registrar saída e responsável
5Atualizar saldo
6Consultar estoque e usar em vendas/manutenções
05
ENTRADAS

Dados recebidos

  • POST: id, nome, categoria, descricao, valor_compra, valor_venda, estoque e nivel_estoque.
  • Comissão: comissao_tipo e comissao_valor.
  • Movimentos: quantidade_entrada/saida, motivo e funcionario_saida.
  • Upload de imagem do produto.
06
SAÍDAS

Resultados produzidos

  • Registro em produtos.
  • Atualização do saldo de estoque.
  • Lançamentos relacionados quando previstos pelo endpoint.
  • Listagens de produtos e estoque.
  • Mensagens de validação e sucesso.
07
REGRAS DE NEGÓCIO

Comportamentos comprovados no código

O nome do produto é verificado para evitar duplicidade.

A categoria deve existir antes do cadastro quando exigida pelo fluxo.

Entrada e saída exigem quantidade válida.

A imagem deve usar extensão permitida.

O saldo atualizado é usado para limitar vendas.

08
PONTOS DE ATENÇÃO

Cuidados antes de alterar

Alterações de saldo afetam vendas e compras.

Confirmar se o endpoint gera conta a pagar ou comissão antes de mudar o movimento.

Não permitir saída maior que o saldo sem uma regra explícita.

Validar permissões de upload e impedir execução de arquivos enviados.

09
TESTE MÍNIMO

Validação após manutenção

  1. Cadastrar produto e categoria válidos.
  2. Registrar entrada e conferir o saldo.
  3. Registrar saída e conferir redução.
  4. Testar quantidade inválida.
  5. Realizar uma venda do produto e confirmar controle do estoque.
  6. Consultar a página de estoque e conferir nível mínimo.
Fonte da documentação

Conteúdo conferido no snapshot agenda.barberbot(1).zip e no esquema barberbotcom_agenda(1).sql. Quando o código não comprova um comportamento, ele não é apresentado como regra.

Evidências principais: produtos/salvar.php • produtos/entrada.php • produtos/saida.php • estoque/listar.php

10
REFERÊNCIA COMPLETA

Documentação detalhada existente

Produtos — documentação completaCadastro, movimentos e estoque. Produtos — arquivo por arquivoLeitura dos endpoints operacionais.