---
tags: [ag-music, comissoes, override]
created: 2026-03-20
updated: 2026-03-20
parent: "[[AG-Music]]"
---

# Comissao Override por Matricula

Permite definir uma comissao manual por aluno, sobrepondo a regra padrao.

## 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

## Logica de Prioridade no Calculo

`FinanceiroController`:

1. **Override da matricula** (se preenchido) -> usa `comissao_override_tipo/valor`
2. **ComissaoAnualModel::resolverComissao()** -> regra por ano de matricula
3. **Fallback do professor** -> `professores.comissao_tipo/comissao_valor`

## UI
- Secao amarela "Comissao Especial (Override)" nas views `matricula_editar.php` e `matricula_nova.php`
- Campos: Tipo (percentual/valor_fixo), Valor, Motivo da excecao
- Toggle: desabilitado quando tipo = "Usar regra padrao"

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

## Ver tambem
- [[Comissoes]] - sistema de comissoes principal
- [[AG-Music]] - visao geral do projeto