🏆 Gestão de Equipe e Comissões
A Pororoca conta com um motor financeiro inteligente feito para simplificar a remuneração do seu time de instrutores (professores) e equipe de atendimento (vendedores/balcão). O sistema calcula, provisiona e resguarda os valores comissionados de forma automatizada no momento em que as vendas entram no caixa.
📐 Como Configurar as Taxas de Comissão?
Cada profissional cadastrado no sistema pode possuir uma regra de comissão individualizada:
- Instrutores: No menu Instrutores, ao cadastrar ou editar o perfil de um professor, você define a sua Taxa de Comissão Padrão (%). Esta taxa será usada como base de cálculo sempre que ele for escalado para uma aula.
- Vendedores/Recepção: No menu Usuários, você pode definir taxas de comissão para os colaboradores do balcão que realizam vendas diretas de produtos de consumo ou pacotes na loja.
💸 Os Dois Modelos de Lançamento de Comissão
O sistema opera com duas dinâmicas de comissionamento para cobrir todas as necessidades da sua escola de praia:
1. Provisão Automática (Via Grade de Aulas)
Sempre que uma aula é criada na Agenda Geral e um instrutor é escalado, o sistema abre automaticamente uma provisão de comissão com o status PENDING (Pendente) associada ao valor da matrícula de cada aluno.
O motor de comissões gerencia o ciclo de vida dessas provisões de forma totalmente automatizada nas seguintes situações:
- No Agendamento (
create): O sistema consulta a taxa de comissão padrão do instrutor e lança a provisão proporcional ao preço cobrado por cada matrícula. - Na Edição da Aula (
update):- Inclusão de Alunos: Uma nova comissão
PENDINGé criada para o instrutor sobre a nova matrícula. - Remoção de Alunos: A comissão associada à matrícula removida é excluída permanentemente.
- Alteração de Preço: O valor da comissão é recalculado automaticamente de forma proporcional.
- Substituição de Instrutor: Se o professor da aula for trocado, todas as comissões anteriores ligadas à aula são excluídas e novas comissões são geradas para o instrutor substituto com base na sua própria taxa ativa.
- Inclusão de Alunos: Uma nova comissão
- Nos Cancelamentos e Estornos:
- Cancelamento com Reembolso/Crédito: Se o aluno cancelar a matrícula individual (
cancelEnrollment) ou a escola cancelar a aula inteira (cancelClass) e não for No-Show, a comissão correspondente é deletada fisicamente do banco de dados (em vez de apenas inativada). Isso impede comissões duplicadas quando o aluno reutilizar o crédito estornado em uma aula futura. - A Regra Anticalote (No-Show): Se o cancelamento for motivado por falta sem aviso prévio (STUDENT_NO_SHOW), o valor da aula é retido e a comissão do instrutor é mantida intacta na folha de pagamentos, recompensando o profissional pela sua disponibilidade na praia.
- Cancelamento com Reembolso/Crédito: Se o aluno cancelar a matrícula individual (
2. Lançamento Manual Direto no PDV (INSTRUCTOR ou SELLER)
Dentro de um pedido no PDV, a recepção ou o administrador pode usar o painel inferior de comissões para lançar valores manualmente:
- Selecione o tipo de profissional (
INSTRUCTORouSELLER). - Escolha o nome do colaborador na lista.
- O sistema exibe um botão "Calcular %" para sugerir o valor exato com base na taxa cadastrada no perfil dele.
- Clique em Lançar na Folha para anexar a comissão ao pedido com o status inicial de
PENDING(Pendente).


🔒 Regras de Acesso e Segurança (RBAC)
Para evitar vazamento de dados confidenciais e manter a harmonia da equipe, o módulo de comissões é rigorosamente protegido por travas de segurança:
- Visão do Administrador (
ADMIN/SUPER_ADMIN): Visualiza o relatório analítico global de todas as comissões geradas na escola, consegue auditar faturas, criar lançamentos manuais e realizar a baixa/liquidação financeira da folha dos funcionários. - Visão do Instrutor (
INSTRUCTOR): Possui acesso exclusivo e filtrado. O professor consegue visualizar apenas e estritamente as suas próprias comissões acumuladas. Os botões de "Pagar/Liquidar" e o acesso aos dados dos outros professores ficam completamente bloqueados e ocultos na interface. - Visão da Recepção (
RECEPTIONIST): Consegue lançar comissões associadas aos pedidos no balcão, mas não tem acesso à tela de fechamento de folha gerencial ou relatórios consolidados.
Fechamento de Mês Facilitado
Ao final do mês, o administrador não precisa somar recibos de papel. Basta filtrar o relatório pelo nome do instrutor e período desejado para ter o valor exato e transparente pronto para transferência!
