From 51bc04ef6f6624440750ffa3c9ba7de10e81ba48 Mon Sep 17 00:00:00 2001 From: Gabriel Date: Fri, 28 Aug 2026 11:07:22 -0300 Subject: [PATCH] Projeto visual do Manual --- .claude/settings.json | 4 +- docs/manual/README.md | 24 + docs/manual/idealizacao-visual.html | 811 ++++++++++++++++++++++++++++ 3 files changed, 838 insertions(+), 1 deletion(-) create mode 100644 docs/manual/README.md create mode 100644 docs/manual/idealizacao-visual.html diff --git a/.claude/settings.json b/.claude/settings.json index cdbff6f..4594a05 100644 --- a/.claude/settings.json +++ b/.claude/settings.json @@ -19,7 +19,9 @@ "Bash(\"./.venv/Scripts/python.exe\" manage.py check)", "Bash(PYTHONIOENCODING=utf-8 ./.venv/Scripts/python.exe -c ' *)", "Bash(./.venv/Scripts/python.exe manage.py shell -c ' *)", - "Edit(/.claude/skills/importacao-plano-saude/**)" + "Edit(/.claude/skills/importacao-plano-saude/**)", + "Bash(mkdir -p \"/c/Users/Depaula/AppData/Local/Temp/claude/c--Users-Depaula-Documents-Portal/81285690-7341-4d2b-b15c-58956b5faf21/scratchpad/manual-subportal\")", + "Read(//c/Users/Depaula/AppData/Local/Temp/claude/c--Users-Depaula-Documents-Portal/81285690-7341-4d2b-b15c-58956b5faf21/scratchpad/**)" ] } } diff --git a/docs/manual/README.md b/docs/manual/README.md new file mode 100644 index 0000000..bed787f --- /dev/null +++ b/docs/manual/README.md @@ -0,0 +1,24 @@ +# Manual (idealização visual — não implementado) + +> Esta pasta não documenta uma aplicação existente, ao contrário das demais em `docs/`. Guarda o mockup de uma proposta ainda não decidida/implementada: um subportal de manual/tutoriais, funcionando **em paralelo** ao Portal (marca compartilhada, mas navegação própria — não um item dentro do menu do Portal principal). + +## O que é + +`idealizacao-visual.html` é uma página HTML estática e autocontida (sem backend, sem dependências) com 3 telas alternáveis por uma barra superior de visualização (que não faz parte do design em si, é só a navegação entre as opções mostradas): + +- **Home do Manual** — busca central + grade de categorias (uma por aplicação real do Portal) + artigos populares. +- **Categoria** (exemplo: Importação de Plano de Saúde) — cabeçalho da categoria + lista de artigos. +- **Artigo** (exemplo: "Como criar uma nova importação de plano de saúde") — tutorial passo a passo numerado, com placeholders de captura de tela, bloco de dica e um sumário "Nesta página". + +Para visualizar, basta abrir o arquivo `.html` direto no navegador. + +## Decisões de design já tomadas + +- Reaproveita fielmente a identidade visual do Portal (`tokens.css`): mesma paleta escura, mesma marca "P.I.D.", mesmo sistema de cards/botões/ícones (stroke-based, 24px de viewBox). +- A barra superior tem um seletor de cor de destaque (roxo/azul/verde/âmbar/rosa/vermelho), espelhando o `data-color-theme` que o Portal já suporta hoje. +- **A sidebar do Manual não é a sidebar do Portal** — é a navegação própria do Manual (árvore de categorias/subcategorias, mesmo padrão de accordion `nav-group` já usado no menu real, aplicado a um contexto diferente), com um link explícito "← Voltar ao Portal". Reflete a decisão do usuário de que o Manual deve funcionar como um portal irmão, não como mais uma página dentro do menu do Portal principal. +- Conteúdo (categorias, artigos, textos) é real/grounded nas aplicações que já existem no Portal — não é lorem ipsum — mas nenhum artigo foi de fato escrito; é só a estrutura visual. + +## Em aberto + +Nada disto foi implementado no backend/frontend do Portal — não existe model, endpoint, rota ou template para o Manual ainda. Antes de implementar, decidir pelo menos: onde o Manual mora tecnicamente (app Django próprio? CMS externo? Markdown versionado?), quem edita o conteúdo, e se a permissão de acesso segue o mesmo modelo de perfis do restante do Portal. diff --git a/docs/manual/idealizacao-visual.html b/docs/manual/idealizacao-visual.html new file mode 100644 index 0000000..6a04fda --- /dev/null +++ b/docs/manual/idealizacao-visual.html @@ -0,0 +1,811 @@ +Manual do Portal De Paula + + +
+
+ Idealização visual + Manual do Portal De Paula +
+
+ + + +
+
+ Cor do tema: + + + + + + +
+
+ + +
+ +
+
+
+

Manual

+
+
+
2
+
Gabriel
+
+
+
+
+

Manual do Portal

+

Como podemos ajudar?

+

Tutoriais, passo a passos e referências de cada aplicação do Portal — da Importação de Plano de Saúde ao Indicador de Desempenho.

+
+ + +
+
+ Importação de Plano de Saúde + Calendário Individual + Ramais + Indicador de Desempenho + Perfis de Acesso +
+
+ +
+

Categorias

9 aplicações documentadas

+
+
+
+

Calendário Individual e Widgets

+

Agenda pessoal, compromissos, eventos corporativos e os widgets da tela Principal.

+ 8 artigos +
+
+
+

Ramais

+

Diretório de ramais, telefones externos, funções de telefonia e controle de ausência.

+ 6 artigos +
+
+
+

Links & Ferramentas

+

Cartões de atalho para ferramentas externas usadas no dia a dia do escritório.

+ 5 artigos +
+
+
+

Acessos Gerais

+

Cadastro de logins e acessos compartilhados da equipe, organizados por seção.

+ 4 artigos +
+
+
+

Indicador de Desempenho

+

Apuração mensal do indicador do Fiscontábil e geração de recibos em PDF.

+ 7 artigos +
+
+
+

Simulação de Custo de Contratação

+

Cálculo do custo de contratar um Empregado CLT, com tabelas fiscais editáveis.

+ 3 artigos +
+
+
+

Importação de Plano de Saúde

+

Leitura do faturamento da operadora e geração do lançamento no Questor.

+ 9 artigos +
+
+
+

Perfis de Acesso e Usuários

+

Cadastro de contas, perfis de acesso e o vínculo de liderança entre usuários.

+ 6 artigos +
+
+
+

Favoritos e Solicitações

+

Como favoritar aplicações na tela Principal e abrir as Solicitações do escritório.

+ 4 artigos +
+
+
+ +
+

Artigos populares

Ver todos →
+
+
+ Passo a passo +

Como criar um Evento Corporativo no Calendário Individual

+

Marque um compromisso como evento e ele aparece automaticamente na agenda de todos os colaboradores.

+ Calendário Individual e Widgets · 3 min de leitura +
+
+ Passo a passo +

Cadastrando uma ausência de colaborador em Ramais

+

Registre férias ou licenças para que o diretório mostre "ausente agora" automaticamente.

+ Ramais · 2 min de leitura +
+
+ Passo a passo +

Adicionando um novo acesso em Acessos Gerais

+

Cadastre um login compartilhado dentro de uma seção existente ou crie uma seção nova.

+ Acessos Gerais · 2 min de leitura +
+
+ Conceito +

Entendendo os percentuais do Indicador de Desempenho

+

Como o percentual Individual, de Grupo e de Departamento se combinam no valor final.

+ Indicador de Desempenho · 4 min de leitura +
+
+ Passo a passo +

Importando o faturamento da Unimed em Plano de Saúde

+

Anexe o relatório da operadora e revise as linhas antes de gerar o arquivo do Questor.

+ Importação de Plano de Saúde · 5 min de leitura +
+
+ Passo a passo +

Vinculando um colaborador à sua liderança

+

Como um gerente ou coordenador adiciona liderados diretamente pelo próprio menu de conta.

+ Perfis de Acesso e Usuários · 2 min de leitura +
+
+
+
+
+
+ + +
+ +
+
+
+

Manual

+
+
+
2
+
Gabriel
+
+
+
+ +
+
+

Importação de Plano de Saúde

9 artigos nesta categoria

+
+
+
+
+

Como criar uma nova importação

Passo a passo para gerar uma importação a partir de uma regra de custeio já cadastrada.

+ Passo a passo +
+
+
+

Planilha padrão: buscar do Questor ou anexar manualmente

Quando usar a busca automática pela competência e quando anexar um arquivo exportado à mão.

+ Conceito +
+
+
+

Anexando o arquivo da operadora

Como anexar um ou mais arquivos quando mensalidade e coparticipação vêm separadas.

+ Passo a passo +
+
+
+

O que significa "em revisão" e "concluída"

Entenda em que momento uma importação trava para edição e como reabri-la.

+ Conceito +
+
+
+

Gerando o arquivo de lançamento (CSV ou ZIP)

Como gerar o arquivo final a partir das linhas já revisadas na tela.

+ Passo a passo +
+
+
+

Reabrindo uma importação já concluída

O botão "Editar" volta a importação para revisão, liberando os campos de novo.

+ Passo a passo +
+
+
+
+
+ + +
+ +
+
+
+

Manual

+
+
+
2
+
Gabriel
+
+
+
+ +
+
+ Passo a passo +

Como criar uma nova importação de plano de saúde

+

Importação de Plano de Saúde · Atualizado em 27/08/2026 · 4 min de leitura

+
+

Toda importação parte de uma regra de custeio já cadastrada para a empresa e a operadora — é ela que decide quem paga o quê antes mesmo do arquivo ser processado. Veja como criar uma nova importação a partir do histórico da ferramenta.

+
+
+
+
1
+
+

Escolha a empresa e a operadora

+

No histórico, clique em + Nova Importação. Ao selecionar a empresa e a operadora, a única regra de custeio já cadastrada para essa combinação é aplicada automaticamente — não há nada para configurar aqui.

+
Captura de tela — seleção de empresa e operadora
+
+
+
+
2
+
+

Defina a origem da planilha padrão

+

Marque Buscar automaticamente do Questor e informe a competência (MM/AAAA), ou escolha Anexar manualmente se preferir subir um arquivo já exportado.

+
Captura de tela — origem da planilha padrão
+
+
+
+
3
+
+

Anexe o arquivo da operadora e processe

+

Selecione um ou mais arquivos do relatório da operadora (algumas mandam mensalidade e coparticipação em arquivos separados) e clique em Processar. Cada arquivo é validado assim que anexado, antes do envio.

+
Captura de tela — arquivo(s) da operadora anexados
+
+
+
+
+
i
+

Dica: se a empresa que você precisa ainda não aparece na lista, cadastre a regra de custeio dela primeiro em Cadastro de Regras — Nova Importação só mostra combinações de empresa e operadora já cadastradas.

+
+ +
+ +
+
+
+
+ +