portal_publico/docs/manual/README.md

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.