# Indicador de Desempenho (Geradoc)

> Ver `CLAUDE.md` nesta mesma pasta para o detalhamento técnico completo (models, fórmula de composição, departamento organizacional, layout do PDF). Ver `CLAUDE.md` na raiz para arquitetura geral/transversal do Portal. Ver também a skill `indicador-desempenho` (`.claude/skills/`) para contexto de negócio.

Segunda ferramenta de Geradoc — substitui a apuração manual do indicador de desempenho do Fiscontábil (departamentos Contábil/Fiscal), antes feita numa planilha (`.ods`) com fórmulas quebradas por edições manuais acumuladas. A partir de duas planilhas do Tareffa (Serviços/Honorários), calcula o percentual de indicador de cada colaborador (composição ponderada de critérios Individual/Grupo/Departamento) e gera um recibo em PDF por colaborador.

**Escopo atual: só o Fiscontábil** (papéis Balancete/Liberação Fiscal/Conciliação Financeira) — outros departamentos ficam para rodada futura, mas a estrutura de cadastro (departamentos, critérios, percentuais) já suporta múltiplos departamentos com regras próprias.

Critérios e percentuais são cadastros editáveis pela própria tela (histórico com `vigente_desde`, nunca editados in-place), não hardcoded. Recibo é documento interno do RH — sem visão própria do colaborador no Portal nesta versão.

## Onde mexer

- `portal_api/indicadores/` — `tipos.py` (tipo de colaborador por empresa), `leiaute.py` (leitura das planilhas Tareffa via `openpyxl`), `pipeline.py` (`processa_apuracao`), `entregas.py` (3 critérios automáticos), `calculo.py` (composição dos percentuais), `recibo.py` (PDF via `reportlab`), `departamentos.py`.
- `IndicadorDepartamento`, `IndicadorDepartamentoGerente`, `IndicadorCriterio`, `IndicadorPercentualTipo`, `IndicadorApuracao`, `IndicadorApuracaoColaborador`, `IndicadorApuracaoEmpresa`, `IndicadorApuracaoResposta` (`portal_api/models.py`).
- `indicador-desempenho.html`/`static/js/indicador-desempenho.js`/`static/css/indicador-desempenho.css`.
- `management/commands/seed_indicador_desempenho.py` — popula o primeiro histórico com os valores da planilha antiga.