DOCUMENTAÇÃO DE MÓDULO

Assinaturas e Planos

Manter o catálogo de planos e itens, vincular serviços, contratar planos para clientes, controlar vencimento, status, aprovação, cancelamento, baixa e integração com contas a receber.

MóduloAssinaturas e Planos

Status Produção

ResponsávelJacy Cordeiro

Última revisão02/08/2026

OBJETIVO

Finalidade do módulo

Manter o catálogo de planos e itens, vincular serviços, contratar planos para clientes, controlar vencimento, status, aprovação, cancelamento, baixa e integração com contas a receber.

LOCALIZAÇÃO

Caminhos principais

sistema/painel/paginas/assinaturas.php

sistema/painel/paginas/assinaturas/

sistema/painel/paginas/planos.php

sistema/painel/paginas/planos/listar.php

sistema/painel/paginas/planos/salvar.php

sistema/painel/paginas/planos/baixar.php

sistema/painel/paginas/planos/cancelar.php

sistema/painel/paginas/planos/aprovar_plano.php

PERSISTÊNCIA

Tabelas relacionadas

grupo_assinaturas

itens_assinaturas

itens_assinaturas_servicos

assinaturas

clientes

servicos

receber

caixas

formas_pgto

frequencias

FLUXO

Sequência operacional observada

1Criar grupo/plano

2Cadastrar itens e serviços do plano

3Selecionar cliente e plano

4Definir valor, frequência e vencimento

5Salvar contratação

6Aprovar, baixar ou cancelar

7Refletir cobrança em receber/caixa

ENTRADAS

Dados recebidos

Catálogo: nome, item, valor, campos c1 a c12, serviços e quantidades.
Contratação: cliente, grupo, item, valor, frequência, vencimento e ativo.
Baixa: forma e data de pagamento.
Ações: aprovar, cancelar, excluir e alterar status.

SAÍDAS

Resultados produzidos

Catálogo em grupo_assinaturas e itens_assinaturas.
Relações entre itens e serviços.
Contratação em assinaturas.
Conta em receber e possível movimento de caixa.
Mensagens de aprovação, baixa, cancelamento e erro.

REGRAS DE NEGÓCIO

Comportamentos comprovados no código

O nome do plano é obrigatório.

Descrições e itens são verificados contra duplicidade nos endpoints correspondentes.

A contratação vincula cliente, plano, valor, frequência e vencimento.

Baixa e aprovação alteram o estado da assinatura e podem refletir no financeiro.

PONTOS DE ATENÇÃO

Cuidados antes de alterar

Não confundir a pasta assinaturas, usada no catálogo, com planos, usada nas contratações.

Alterações de itens podem afetar contratos já ativos.

Testar integração com receber e caixa em pago e pendente.

Preservar retornos esperados pelo JavaScript.

TESTE MÍNIMO

Validação após manutenção

Criar grupo de assinatura e item.
Vincular um serviço ao item.
Contratar o plano para cliente de teste.
Aprovar e conferir o status.
Baixar pagamento e verificar receber/caixa.
Cancelar uma contratação de teste e confirmar o comportamento.

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: assinaturas/salvar.php • assinaturas/salvar_itens.php • planos/salvar.php • planos/baixar.php • planos/cancelar.php

REFERÊNCIA COMPLETA

Documentação detalhada existente

Assinaturas e planos — documentação detalhadaCatálogo, contratação e financeiro.