# Proposta Comercial — Ajustes v2

- Data Criação do Documento: 18 de Agosto de 2026
- Autor: Gabriel Alves (Desenvolvedor)
- Complementa: [proposta_comercial_v1.md](./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.