🛡️ Máquina Anticalote: Regras de Cancelamento
O maior vilão do faturamento de uma escola de praia é o cancelamento de última hora. O instrutor se desloca, a recepção separa o material, e o aluno cancela 30 minutos antes por preguiça ou atraso.
A Pororoca possui uma Máquina de Estados de Cancelamento parametrizável que protege as duas pontas: a receita da escola e o salário do instrutor.
⏱️ O Prazo Limite
Quando um aluno solicita o cancelamento:
Cenário A: Cancelamento Dentro do Prazo (Permitido)
- Ação: O agendamento é desfeito.
- Impacto Operacional: O aluno recebe 1 crédito de volta imediatamente na sua carteira digital.
- Impacto Financeiro: O horário do instrutor é liberado, ou a vaga na turma fica disponível para novos agendamentos.
Cenário B: Cancelamento Fora do Prazo / No-Show (Retido)
- Ação: A matrícula é marcada como cancelada por falta ou atrasada.
- Impacto Operacional: O aluno perde o crédito da aula (o crédito é consumido e não retorna para o saldo).
- Impacto Financeiro: O valor da aula continua integrado ao faturamento da escola e a comissão do instrutor é mantida ativa e protegida na folha de pagamento, garantindo que o profissional receba pelo tempo que ficou esperando na praia.
🔄 Cancelamento de Pedido Master (Estorno Geral)
Se um administrador (ADMIN) precisar realizar o cancelamento total de uma venda direto na listagem master de faturamento, o sistema realiza um rollback completo de segurança:
- Modifica o status de todas as aulas e aluguéis vinculados para
REFUNDED(Reembolsado). - Devolução ao Estoque: O robô lê as quantidades de produtos físicos vendidos e faz um incremento automático de volta no inventário (
stock), corrigindo o saldo da loja. - Derrubada de Comissões: Remove ou cancela todas as provisões de comissão que haviam sido lançadas na folha de pagamento dos funcionários associados a este pedido, evitando saídas de caixa indevidas.
