Ajuste mensal de descontos em folha

gistfile1.txt

### Ajuste mensal de descontos em folha

- Modulo financeiro de conferencia mensal em `/financeiro/descontos-folha`.
- Criacao/listagem de competencias mensais por tenant.
- Importacao do arquivo Excel da prefeitura, com parser para o layout Uniodonto:
  - aba principal `Plan1`.
  - coluna B como matricula funcional.
  - coluna C como nome do associado/dependente.
  - coluna D como tipo do registro.
  - coluna F como valor do desconto.
- Importacao alternativa por linhas JSON normalizadas para testes e operacao assistida.
- Conciliacao automatica por CPF, matricula funcional e nome normalizado.
- Classificacao de itens da conferencia:
  - desconto normal.
  - valor divergente.
  - associado sem desconto.
  - associado novo no relatorio.
  - associado removido/excluido da folha.
  - associado com retroativo acumulado.
  - associado incluido manualmente.
- Inclusao manual de associado na competencia.
- Ajuste de valor com motivo e observacao.
- Bloqueio mensal de desconto com motivo padronizado e opcao de gerar pendencia.
- Exclusao para proximos lancamentos sem apagar historico cadastral/financeiro.
- Criacao de cobranca retroativa para competencia futura.
- Acumulo de multiplas pendencias retroativas sem duplicidade.
- Painel de pendencias acumuladas por associado.
- Listagem individual de pendencias com reprogramacao e cancelamento.
- Fechamento de competencia com lista consolidada de valores finais.
- Reabertura controlada por perfil autorizado.
- Exportacao JSON da lista consolidada.
- Geracao idempotente de lancamentos em `finance_charges` a partir da conferencia fechada.
- Referencia externa de lancamento no formato `payroll-discount-{batchId}-{itemId}` para evitar duplicidade.
- Historico auditavel de importacao, inclusao, ajuste, bloqueio, retroativo, reprogramacao, cancelamento, exclusao futura, fechamento, reabertura e geracao financeira.
- Isolamento por `tenant_id` em todas as operacoes.
- RBAC do modulo:
  - `GESTOR`: acesso total no tenant.
  - `FINANCEIRO`: operacao, importacao, ajustes, fechamento e geracao de lancamentos.
  - `PRESIDENCIA`: consulta, auditoria, fechamento e reabertura autorizada.

Endpoints principais:

- `GET /financeiro/descontos-folha`
- `POST /financeiro/descontos-folha`
- `GET /financeiro/descontos-folha/competencias`
- `GET /financeiro/descontos-folha/pendencias`
- `GET /financeiro/descontos-folha/pendencias/detalhes`
- `PATCH /financeiro/descontos-folha/pendencias/:pendingId/reprogramar`
- `POST /financeiro/descontos-folha/pendencias/:pendingId/cancelar`
- `GET /financeiro/descontos-folha/:batchId`
- `POST /financeiro/descontos-folha/:batchId/import`
- `GET /financeiro/descontos-folha/:batchId/itens`
- `POST /financeiro/descontos-folha/:batchId/itens`
- `PATCH /financeiro/descontos-folha/:batchId/itens/:itemId`
- `POST /financeiro/descontos-folha/:batchId/itens/:itemId/bloquear`
- `POST /financeiro/descontos-folha/:batchId/itens/:itemId/retroativo`
- `POST /financeiro/descontos-folha/:batchId/itens/:itemId/excluir-proximos`
- `POST /financeiro/descontos-folha/:batchId/fechar`
- `POST /financeiro/descontos-folha/:batchId/reabrir`
- `POST /financeiro/descontos-folha/:batchId/gerar-lancamentos`
- `GET /financeiro/descontos-folha/:batchId/historico`
- `GET /financeiro/descontos-folha/:batchId/export`

---