# Simulação de Custo de Contratação (Geradoc)

> Ver `CLAUDE.md` nesta mesma pasta para o detalhamento técnico (models, fórmula, tabelas fiscais). Ver `CLAUDE.md` na raiz para arquitetura geral/transversal do Portal.

Substitui a planilha manual de custo de contratação (`projects/planilha de custo/*.xlsx`) por um formulário no Portal: o usuário preenche os dados do empregado, a ferramenta calcula o custo total de contratação (salário, encargos, INSS, IRRF) e devolve um PDF pronto para enviar ao cliente.

**Escopo atual: só Empregado CLT.** O pedido original previa outras 4 modalidades (Simples Nacional, Regime Normal, Pró-labore, Empregado Doméstico), mas elas dependem de uma planilha/regra de referência validada pelo contador que ainda não existe.

As tabelas de INSS/IRRF e os parâmetros da redução de IRRF da Lei 15.270/2025 são editáveis pela própria tela (painel colapsável), não hardcoded — mudam por lei/todo ano.

## Onde mexer

- `portal_api/custo_contratacao/` — `tabelas.py` (seed/default das faixas fiscais), `calculo.py` (`ParametrosFiscais` + `calcula_custo_empregado`), `pdf.py` (`gera_pdf_simulacao`, via `reportlab`).
- `ParametroFiscalCustoContratacao` (`portal_api/models.py`) — singleton com as tabelas fiscais atuais.
- `custo-contratacao.html` / `static/js/custo-contratacao.js` (se existir) / `static/css/custo-contratacao.css`.
- Skill `simulacao-custo-contratacao` (`.claude/skills/`) — contexto de negócio, limitações conhecidas.