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

Serviços

Cadastrar os serviços oferecidos, seus valores, duração, comissão, categoria, prazo de retorno, imagem, status e configurações de pacote ou combo.

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

Finalidade do módulo

Cadastrar os serviços oferecidos, seus valores, duração, comissão, categoria, prazo de retorno, imagem, status e configurações de pacote ou combo.

02
LOCALIZAÇÃO

Caminhos principais

sistema/painel/paginas/servicos.php
sistema/painel/paginas/servicos/listar.php
sistema/painel/paginas/servicos/salvar.php
sistema/painel/paginas/servicos/mudar-status.php
sistema/painel/paginas/servicos/excluir.php
03
PERSISTÊNCIA

Tabelas relacionadas

servicos
cat_servicos
04
FLUXO

Sequência operacional observada

1Selecionar categoria
2Informar nome, valor e duração
3Definir comissão e retorno
4Configurar combo quando aplicável
5Salvar imagem e registro
6Disponibilizar para profissionais, agenda e financeiro
05
ENTRADAS

Dados recebidos

  • POST: id, nome, categoria, valor, tempo, comissao e dias_retorno.
  • Combo: combo_ativo, combo_qtd_sessoes e combo_validade_dias.
  • Upload de imagem quando enviado.
  • Ação de mudança de status.
06
SAÍDAS

Resultados produzidos

  • Registro em servicos.
  • Imagem do serviço na pasta usada pelo sistema.
  • Listagem HTML e mensagens de sucesso/erro.
  • Disponibilidade do serviço na agenda, nos profissionais e nos lançamentos.
07
REGRAS DE NEGÓCIO

Comportamentos comprovados no código

O nome do serviço é obrigatório.

A categoria precisa existir para o serviço ser organizado no painel.

A imagem deve passar pelas extensões aceitas e a pasta precisa permitir gravação.

Campos de combo são persistidos somente quando existentes na estrutura atual.

08
PONTOS DE ATENÇÃO

Cuidados antes de alterar

Tempo e dias de retorno influenciam agenda e comunicação com cliente.

Comissão afeta lançamentos financeiros na conclusão do atendimento.

Não alterar mensagens de retorno sem verificar o JavaScript.

Validar a compatibilidade dos campos do combo com a tabela antes de publicar.

09
TESTE MÍNIMO

Validação após manutenção

  1. Cadastrar serviço simples com categoria, valor e tempo.
  2. Editar comissão e dias de retorno.
  3. Enviar imagem válida e testar formato inválido.
  4. Vincular o serviço a um profissional.
  5. Criar um agendamento e confirmar duração e valor usados pelo sistema.
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: servicos/salvar.php • servicos/listar.php • servicos/mudar-status.php • servicos.php

10
REFERÊNCIA COMPLETA

Documentação detalhada existente

Serviços — arquivo por arquivoCampos, endpoints e integração com a agenda.