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