25 lines
2.5 KiB
Markdown
25 lines
2.5 KiB
Markdown
# 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.
|