portal_publico/prd.md

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/.