portal_publico/portal_api/indicadores

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.