sfp_api_laravel_ginastica_cerebro/docs/proposta_comercial_v2_ajustes.md

Proposta Comercial — Ajustes v2

• Data Criação do Documento: 18 de Agosto de 2026
• Autor: Gabriel Alves (Desenvolvedor)
• Complementa: proposta_comercial_v1.md

---

Motivo

Na v1, a tab "Dados" (Dados Básicos da proposta) ainda carregava campos de valor (Matrícula, Total do Contrato, Desconto, Materiais), herdados do antigo módulo de Pacotes. Ficou definido que valor não deve existir em Dados — valor só existe dentro de Pavão e Irrecusável, que são as duas modalidades de precificação de uma proposta.

O que muda em Dados Básicos

Dados Básicos passa a ter apenas:

• Nome
• Quantidade de Aulas
• Duração da Aula

Saem de Dados: Valor da Matrícula, Valor Total do Contrato, Desconto (%), Materiais. Esses campos e a tabela de materiais da proposta base (class_package_products/class_package_unit_products) foram removidos — valor e material só existem dentro de Pavão/Irrecusável (pavao_proposals/irrecusable_proposals e as tabelas _unit correspondentes, que já cobrem isso desde a v1).

Pavão e Irrecusável passam a ser opcionais

Antes, toda proposta era obrigada a ter Pavão e Irrecusável. Agora uma proposta pode ter:

• só Pavão,
• só Irrecusável,
• os dois,
• ou nenhum ainda (proposta em rascunho, sem precificação definida).

Cada tab tem um toggle "esta proposta possui Pavão/Irrecusável" — só quando ligado é que os campos daquela modalidade existem e são obrigatórios/validados.

Regra de negócio para o futuro módulo de Contrato com Aluno

O módulo de Contrato ainda está "Aguardando Definições" (ver v1) e não foi implementado nesta rodada — o texto abaixo é o requisito de negócio já levantado, para guiar a implementação quando o Contrato for especificado:

• Ao vincular uma proposta comercial a um contrato, o usuário escolhe qual modalidade usar — Pavão ou Irrecusável — dentre as que a proposta tiver disponíveis.
• Os valores do contrato (Matrícula, Aulas, Materiais, Total) vêm da modalidade escolhida, nunca das duas somadas.
• Para cada valor (Matrícula, Aulas, Materiais), a regra de parcelamento já cadastrada na proposta se aplica da mesma forma:
  • Incluso no Valor do Curso → soma no Valor Total do Curso; gera conta a receber só do Valor Total (parcelado conforme os campos de parcelamento do Total), sem cobrança separada para aquele item.
  • Permite Parcelar → não soma no Valor Total do Curso; gera conta a receber separada, parcelada com base na Quantidade de Parcelas Máximas daquele item — igual à lógica que os contratos já usam hoje para gerar contas a receber.
• Essa lógica (incluso vs. parcela separada → conta a receber) vale igualmente para Matrícula, Aulas e Materiais.
• É esperado que, ao detalhar o módulo de Contrato, sejam necessários campos adicionais nas tabelas de Pavão/Irrecusável (ex.: dia de vencimento, regra de geração de conta a receber) — a definir junto com a especificação do Contrato.