# prd.md — Product Requirements Document

> O que é o Portal De Paula, para quem é e o que ele faz — visão de produto, não de implementação. "Como construir" e em que ordem fica em `plano.md`; "como o código funciona" fica em `CLAUDE.md`.

## O que é

Portal interno da De Paula Contadores ("Portal De Paula") — ponto único de acesso a ferramentas, cadastros e informações do dia a dia do escritório, substituindo planilhas manuais e processos dispersos por telas e fluxos centralizados, com controle de acesso por perfil.

## Quem usa

Colaboradores do escritório, autenticados por login/senha (sessão Django). O acesso a cada módulo/aplicação é controlado por **Perfis de Acesso** — um usuário pode ter mais de um perfil vinculado, e o que ele vê no menu é a união das permissões de todos os seus perfis. Um perfil especial (`gerencia_permissoes=True`) administra os próprios perfis e usuários; hoje é o perfil "Inovação".

## Funcionalidades principais

### Base (todo usuário autenticado)
- **Principal** — busca de aplicações, grade de favoritos, widgets personalizáveis.
- **Calendário Individual** — agenda pessoal (compromissos privados, de departamento ou de todos), feriados nacionais/estaduais, eventos corporativos (para quem tem permissão de criar), agenda da equipe para gerentes/coordenadores.
- **Links & Ferramentas** — atalhos para ferramentas externas, em cartões.
- **Acessos Gerais** — cadastro de logins/acessos compartilhados da equipe, organizados em seções.
- **Ramais** — diretório de ramais internos (automático a partir do cadastro de usuários + linhas avulsas), telefones externos, funções de telefonia, controle de ausência.
- **Solicitações** — atalhos para formulários externos (chamados, indicações, sugestões).

### Administração (perfil com `gerencia_permissoes`)
- **Perfis de Acesso** — CRUD de perfis e da árvore de permissões por módulo/aplicação.
- **Usuários** — CRUD de contas, vínculo de perfis/departamentos, liderança (gerente → liderados), inativação.

### Geradoc (perfis com acesso liberado)
- **Simulação de Custo de Contratação** — calcula o custo de contratar um Empregado CLT e gera PDF pronto para o cliente. Escopo atual: só Empregado CLT.
- **Indicador de Desempenho** — apuração mensal do indicador de desempenho do Fiscontábil, a partir de planilhas do Tareffa, com geração de recibo em PDF por colaborador. Escopo atual: só departamento Fisco/Contábil.

### Utilitários (perfis com acesso liberado)
- **Importação de Plano de Saúde** — importa o faturamento de uma operadora de plano de saúde/odontológico e gera o arquivo de lançamento no leiaute do Questor, com auditoria do que não casou automaticamente.

### Reservados no menu, sem tela própria ainda
- **Portais** (Portal do Cliente, Portal Fiscal), **Relatórios** (Relatório Setorial), **Relatórios Gerenciais** (Visão Diretoria, Visão Gerencial), **Integrações** (Questor), **Auditorias** (Consultoria Tributária, Fisco/Contábil) — já existem no catálogo de permissões (menu, controle de acesso), mas ainda não têm funcionalidade implementada.

## Fora de escopo, por decisão explícita (não implementar sem confirmar de novo)

- Simulação de Custo de Contratação: as outras 4 modalidades (Simples Nacional, Regime Normal, Pró-labore, Empregado Doméstico) — faltam fontes de regra validadas.
- Indicador de Desempenho: departamentos além do Fisco/Contábil — a resolução por gerente tem uma limitação conhecida que precisa ser resolvida antes de expandir.
- Ramais: abas "Férias" e "Responsável no Tareffa" — espaço reservado na navegação, conteúdo adiado.
- Um calendário interno tipo "Calendário De Paula" — hoje é um iframe para ferramenta externa, de propósito.
- Preferência de tema continua só no `localStorage` do navegador, não migra para o banco.

## Onde encontrar o resto

- **Como construir / ordem de execução**: `plano.md`.
- **Como o código funciona hoje** (arquitetura, models, endpoints, decisões técnicas): `CLAUDE.md`.
- **Contexto de negócio por aplicação** (por quê, limitações conhecidas): skills em `.claude/skills/`.