Portal De Paula

Portal interno da De Paula Contadores — Python 3.13 + Django 6.0 + Django REST Framework + PostgreSQL 14, servindo tanto a API (/api/...) quanto o frontend HTML/CSS/JS (mesma origem). Portal/ é o próprio projeto Django (manage.py na raiz), organizado no padrão convencional de um projeto Django.

Como rodar localmente

cd Portal
python -m venv .venv
.venv\Scripts\activate          # Windows
pip install -r requirements.txt

Configurar as variáveis de ambiente do Postgres 14 antes de migrar — config/settings.py lê DB_NAME, DB_USER, DB_PASSWORD, DB_HOST, DB_PORT do .env (já existe na raiz de Portal/):

python manage.py makemigrations portal_api
python manage.py migrate
python manage.py seed_portal      # recria os 8 perfis + usuários gabriel/bruno
python manage.py runserver

Abrir http://localhost:8000/ — o Django serve index.html e as demais páginas do frontend diretamente, sem precisar de um segundo servidor pro frontend.

Contas de demonstração (criadas por seed_portal): gabriel/gabriel (perfil "Inovação", acesso total) e bruno/bruno (sem perfil vinculado, testa o estado "sem acesso").

Não há suíte de testes, lint ou build configurados neste projeto.

Mapa das aplicações

Aplicação	Seção do menu	Documentação
Principal (favoritos, widgets)	Principal	Favoritos, Calendário Individual e Widgets
Calendário Individual	Calendário	docs/calendario-individual/
Links & Ferramentas / Acessos Gerais	Links & Ferramentas	docs/links-ferramentas-acessos-gerais/
Ramais	Ramais	docs/ramais/
Solicitações	Solicitações	docs/solicitacoes/
Perfis de Acesso / Usuários	Administração	docs/perfis-usuarios/
Importação de Plano de Saúde	Utilitários	portal_api/planos_saude/
Simulação de Custo de Contratação	Geradoc	portal_api/custo_contratacao/
Indicador de Desempenho	Geradoc	portal_api/indicadores/

Cada pasta acima tem um README.md (o que a aplicação faz, estado atual) e um CHANGELOG.md (histórico rodada a rodada, extraído de plano.md). As 3 aplicações com pacote Python próprio também têm um CLAUDE.md com o detalhamento técnico completo, carregado automaticamente pelo Claude Code; as demais têm esse detalhe no arquivo dentro da própria pasta em docs/.

Documentação transversal

• CLAUDE.md — arquitetura geral do Portal (estrutura de pastas, modelo de permissões, API, CSS, animações). Carregado automaticamente pelo Claude Code.
• plano.md — histórico de decisões estruturais/transversais (rodadas que mudaram mais de uma aplicação ao mesmo tempo, migração pra Django, modelo de permissões em si, identidade visual). Histórico específico de cada aplicação vive no CHANGELOG.md dela.