# 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.
- **Importação de Plano de Saúde - De Paula** — a mesma ferramenta, para o plano de saúde dos próprios colaboradores do escritório em vez do de clientes. Histórico, cadastro de regras e permissão totalmente separados dos dados de cliente, de propósito. Acesso restrito por padrão (dado pessoal de colaborador).

### Relatórios (perfis com acesso liberado)
- **Não Conformidades** (Relatórios > Qualidade) — gestão contínua das ocorrências e ações do Sistema de Gestão da Qualidade (Sigsistem, ISO 9001), com reabertura automática quando algo muda desde o último tratamento e um dashboard de motivos de abertura e maior incidência. Acesso restrito por padrão.
- **Relatório Contábil** (Relatórios > Contabilidade) — o contador anexa o PDF de Balancete + DRE e a ferramenta roda um motor de regras de auditoria, com revisão das observações antes de gerar um relatório pronto para o cliente. Acesso restrito por padrão. Fora de escopo hoje: consolidar várias empresas/competências ao mesmo tempo.

### Recursos visuais (todo usuário, sem item de menu)
- **Temas Sazonais** — troca a marca P.I.D. por uma variante temática durante uma janela de datas (hoje só o Halloween), com um toggle no menu da conta para o usuário desligar por preferência ou acessibilidade. Fora da janela, tudo volta sozinho.

### Reservados no menu, sem tela própria ainda
- **Portais** (Portal do Cliente, Portal Fiscal), **Relatórios** (Indicadores), **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`.
- **Mapa das aplicações** (uma linha por aplicação, com link para a doc de cada uma): `README.md` na raiz.
- **Contexto de negócio por aplicação** (por quê, limitações conhecidas): as skills em `.claude/skills/`, que hoje cobrem quatro ferramentas (Importação de Plano de Saúde, a etapa específica do Questor, Indicador de Desempenho e Simulação de Custo de Contratação). As demais aplicações documentam isso no `README.md` da própria pasta.