portal_publico/portal_api/custo_contratacao/README.md

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.