---
name: comissao_override
description: Comissão manual por aluno (override) implementada em 2026-03-20 - sobrepõe regra padrão por matrícula
type: project
---

## Comissão Override por Matrícula (2026-03-20)

### Campos adicionados na tabela `matriculas`:
- `comissao_override_tipo` ENUM('percentual','valor_fixo') NULL
- `comissao_override_valor` DECIMAL(10,2) NULL
- `comissao_override_motivo` VARCHAR(255) NULL

### Lógica de prioridade no cálculo (FinanceiroController):
1. **Override da matrícula** (se preenchido) → usa comissao_override_tipo/valor
2. **ComissaoAnualModel::resolverComissao()** → regra por ano de matrícula
3. **Fallback do professor** → professores.comissao_tipo/comissao_valor

### UI:
- Seção amarela "Comissão Especial (Override)" nas views matricula_editar.php e matricula_nova.php
- Campos: Tipo (percentual/valor_fixo), Valor, Motivo da exceção
- Toggle: desabilitado quando tipo = "Usar regra padrão"

### Migration:
- `2026-03-20-100000_AddComissaoOverrideMatriculas.php` (com fieldExists check)