1. Problema resolvido
O OLA precisa deixar claro que não é apenas um conjunto de páginas HTML. Ele é um sistema que recebe demandas, estrutura conhecimento, produz artefatos, conecta páginas e orienta a evolução do próprio conhecimento.
Antes
As páginas eram produzidas por demanda, mas nem sempre ficava explícito qual funcionalidade do OLA estava sendo exercida.
Durante
A análise passou a revelar operações recorrentes: organizar, mapear, refatorar, classificar, conectar, publicar e evoluir.
Depois
As funcionalidades tornam-se componentes reconhecíveis da arquitetura do OLA e passam a orientar novas páginas e novas decisões.
2. Finalidade × análise
Finalidade
Definir, em linguagem clara, o conjunto de funcionalidades que caracterizam o OLA como sistema de conhecimento, aprendizagem, governança e produção de artefatos.
Análise
A análise separa as funcionalidades em grupos: entrada, estruturação, organização, produção, refatoração, navegação, governança, aprendizagem, visualização e evolução.
3. Níveis de abstração M0–M3
As funcionalidades do OLA podem ser lidas nos níveis de abstração já usados no projeto. Isso ajuda a separar páginas concretas, modelos aplicados, padrões e princípios.
| Nível | Leitura funcional | Exemplo no OLA | Pergunta orientadora |
|---|---|---|---|
| M0 | Funcionalidade materializada em uma página ou artefato específico. | funcionalidades_ola.html, mapa_saude.html, index_governanca.html. | Que artefato concreto realiza esta função? |
| M1 | Modelo aplicado que organiza um tipo de página, domínio ou artefato. | Tríade mapa + organização + índice; página robusta OLA. | Qual modelo está sendo aplicado? |
| M2 | Fluxo, padrão ou procedimento reutilizável. | Entrada → análise → artefato → governança → evolução. | Qual padrão funcional se repete? |
| M3 | Princípio, regra, critério ou governança da funcionalidade. | Privacidade, LGPD, publicação, padrão visual, navegação, refatoração. | Qual regra orienta a decisão? |
4. Funcionalidade central do OLA
A funcionalidade central do OLA pode ser expressa como uma transformação:
entrada dispersa
→ análise estruturada
→ organização em domínio/sistema
→ produção de artefatos
→ conexão com a rede de conhecimento
→ governança
→ aprendizagem
→ evoluçãoEssa transformação mostra que o OLA não apenas responde a uma pergunta. Ele converte a pergunta em estrutura, localização, relação, página, trilha, mapa, regra, padrão ou novo ponto de evolução do sistema.
5. Grupos de funcionalidades
As funcionalidades do OLA podem ser agrupadas para facilitar leitura, especificação, desenvolvimento e governança.
| Grupo | Funcionalidade | O que faz | Exemplos de artefatos |
|---|---|---|---|
| Entrada | Receber demanda | Recebe pergunta, texto, problema, printscreen, imagem, dúvida ou necessidade. | Pergunta inicial, briefing, demanda de página, anotação. |
| Análise | Estruturar entendimento | Identifica problema, finalidade, conceitos, relações, contexto e escopo. | Seção de análise, quadro explicativo, mapa conceitual. |
| Organização | Posicionar no sistema | Localiza conteúdo em área, domínio, subdomínio, mapa, índice ou página de organização. | index_*.html, mapa_*.html, organizacao_*.html. |
| Produção | Gerar artefatos | Converte análise em página, tabela, grafo, dashboard, trilha ou objeto de aprendizagem. | HTML, grafo D3.js, dashboard, roteiro, README. |
| Refatoração | Melhorar artefatos existentes | Reorganiza layout, conteúdo, semântica, navegação, padrões e governança. | Página refatorada, layout robusto, links corrigidos. |
| Navegação | Conectar páginas | Cria caminhos físicos e semânticos entre áreas, domínios, mapas, índices e regras. | Breadcrumb, menu, cards relacionados, links internos. |
| Governança | Controlar qualidade e decisão | Define padrões, regras, privacidade, publicação, estrutura física e critérios de evolução. | Quadro de regras, política de publicação, LGPD, padrões de interface. |
| Aprendizagem | Promover aprendizado ativo | Transforma conhecimento em trilhas, objetos, problemas resolvidos e acompanhamento. | Objeto de aprendizagem, trilha, exercício, registro de evolução. |
| Visualização | Representar relações | Ajuda a compreender estrutura, dependências, redes, mapas, fluxos e padrões. | Grafo, diagrama de bloco, tabela, mapa, painel. |
| Evolução | Amadurecer o sistema | Registra lacunas, versões, próximos passos, refatorações e novas conexões. | Roadmap, checklist, páginas atualizadas, governança revisada. |
6. Refatoração como funcionalidade transversal
A refatoração é uma funcionalidade transversal do OLA porque pode atuar sobre qualquer artefato já produzido.
Refatoração de layout
Ajusta a página ao padrão robusto OLA: cabeçalho, hero, índice, cards, modais, tabela responsiva, tema claro/escuro e rodapé.
Refatoração conceitual
Reorganiza conceitos, hierarquias, vocabulário, escopo e relações quando o conteúdo ainda está disperso ou ambíguo.
Refatoração de navegação
Corrige ou melhora menus, breadcrumbs, links relacionados, caminhos físicos e caminhos semânticos.
Refatoração de governança
Verifica alinhamento com regras, padrões de publicação, privacidade, LGPD, classificação da informação e estrutura física.
7. Mapa funcional do OLA
O mapa funcional abaixo representa a sequência de transformação mais comum. Ele pode ser usado como base para diagramas, grafos e páginas futuras.
┌────────────────────┐
│ 1. Entrada │
│ pergunta, texto, │
│ problema, imagem │
└─────────┬──────────┘
│
▼
┌────────────────────┐
│ 2. Análise │
│ problema, contexto, │
│ conceitos, relações │
└─────────┬──────────┘
│
▼
┌────────────────────┐
│ 3. Organização │
│ domínio, mapa, │
│ índice, trilha │
└─────────┬──────────┘
│
▼
┌────────────────────┐
│ 4. Produção │
│ página, grafo, │
│ dashboard, objeto │
└─────────┬──────────┘
│
▼
┌────────────────────┐
│ 5. Conexão │
│ links, navegação, │
│ rede de conhecimento│
└─────────┬──────────┘
│
▼
┌────────────────────┐
│ 6. Governança │
│ regras, padrões, │
│ publicação, LGPD │
└─────────┬──────────┘
│
▼
┌────────────────────┐
│ 7. Evolução │
│ refatoração, versão,│
│ novos desdobramentos│
└────────────────────┘8. Relação entre funcionalidade e governança
Toda funcionalidade relevante do OLA pode exigir algum tipo de governança. A governança evita que a produção de páginas cresça sem padrão, sem conexão, sem critério de publicação ou sem cuidado com informação sensível.
Quando a funcionalidade envolve publicação
Deve ser analisada junto à política de publicação, à classificação da informação e aos critérios de privacidade.
Quando a funcionalidade envolve saúde, família ou dados pessoais
Deve separar registro pessoal, orientação geral, interpretação técnica e informação clínica. Nem tudo deve ir para o domínio público.
Quando a funcionalidade envolve layout
Deve verificar o padrão de interface OLA, responsividade, legibilidade, rolagem horizontal em tabelas largas, tema claro/escuro e consistência visual.
Quando a funcionalidade envolve organização física
Deve verificar diretório, nome de arquivo, links relativos, índice da área e relação com mapa e página de organização.
9. Como usar esta página
Para especificar
Use os grupos de funcionalidades para dizer o que uma nova página deve fazer dentro do OLA.
Para refatorar
Compare a página existente com as funcionalidades esperadas: organização, navegação, semântica, governança e layout.
Para evoluir
Use o mapa funcional para identificar o próximo desdobramento: mapa, índice, regra, trilha, dashboard, grafo ou objeto de aprendizagem.
10. Páginas relacionadas
Esta página deve ser conectada às áreas de Arquitetura, Governança, Fundamentos e Domínios.