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.
• 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.
• Relatório Contábil - De Paula (Diretoria) — a mesma ferramenta, para as empresas do próprio escritório. Mesmas regras e indicadores; análises, histórico e permissão totalmente separados da versão de clientes, de propósito: quem tem acesso só ao Relatório Contábil não acessa esta. Nasce sem acesso para nenhum perfil, liberada manualmente.

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.