Manutenção da Estrutura Atual do OLA

Esta página descreve o estado atual da manutenção das pastas físicas do OLA no diretório meulivro/. Trata-se de um procedimento humano interno, executado pelo autor/construtor do OLA, com apoio pontual da IA para análise, comparação, organização e geração de páginas.

Tipo: procedimento interno Área: governança Estado: atual Execução: humana Apoio: IA conversacional

1. Finalidade da página

A finalidade desta página é registrar como o OLA é mantido hoje, no nível físico das pastas e arquivos do diretório raiz meulivro/.

O foco não está no uso público do OLA, mas na operação interna necessária para manter coerência entre:

a estrutura real das pastas no computador;
as páginas âncora de cada área;
os índices estruturais;
os mapas analíticos;
os critérios de governança física do projeto.

Esta página representa o modo atual de trabalho: manual, humano, supervisionado pelo autor, com uso da IA como apoio de análise e geração textual.

2. Natureza do procedimento

Aspecto	Classificação no OLA
Natureza	Procedimento humano interno de manutenção estrutural
Camada	Governança operacional
Ator principal	Autor, construtor e mantenedor do OLA
Ambiente	Computador local, no diretório `meulivro/`
Objeto mantido	Pastas, arquivos HTML, índices, mapas, páginas de organização e páginas derivadas
Risco principal	Perda de coerência entre estrutura física, estrutura semântica e estrutura de navegação

3. Por que é procedimento e não apenas caso de uso ou pipeline?

Não é apenas caso de uso

Um caso de uso descreve o objetivo do ator. Aqui há também uma sequência operacional, critérios de decisão e manutenção física.

Não é ainda pipeline

Um pipeline seria executável ou semi-automatizado. Hoje, a execução ainda depende de análise humana, print screen, julgamento e decisão manual.

É procedimento

Porque define uma rotina recorrente: o que fazer, em que ordem, com quais critérios e com quais saídas esperadas.

4. Escopo do procedimento atual

Este procedimento se aplica às pastas que estão no nível da raiz do diretório físico do OLA:

meulivro/
├── governanca/
├── arquitetura/
├── fundamentos/
├── dominios/
├── sistema/
├── projeto/
├── aprendizagem/
├── aprendiz/
├── ecossistema/
├── visitante/
├── legado/
└── assets/

O procedimento é usado quando uma dessas áreas já existe e precisa ser revisada, organizada ou atualizada.

5. Entradas do procedimento

Entrada	Descrição	Exemplo
Pasta física existente	Área real do OLA no computador	`meulivro/arquitetura/`
Print screen da pasta	Imagem da estrutura atual com arquivos e subpastas	captura da pasta no Finder
Página âncora	Mapa analítico da área	`mapa_arquitetura.html`
Seção de estrutura física representada	Estrutura planejada ou sugerida para a área	bloco dentro da página mapa
Critérios de governança	Regras para manter, criar, mover ou avaliar arquivos	`estrutura_fisica_arquivos_pastas.html`

6. Fluxo operacional atual

Escolher pasta

→

Criar mapa

→

Fazer print

→

Comparar

→

Classificar arquivos

→

Gerar organização

→

Atualizar índice

→

Gerar derivados

7. Passo a passo do procedimento atual

7.1 Selecionar a pasta de área

Escolher uma pasta existente no nível raiz do diretório meulivro/.

Exemplo:

meulivro/arquitetura/

7.2 Criar ou revisar a página âncora analítica

Criar ou atualizar a página:

mapa_nome_pasta.html

Essa página deve conter uma seção chamada:

Estrutura física representada

Essa seção registra como a estrutura da área deveria estar organizada.

7.3 Fazer print screen da pasta real

Abrir a pasta no computador e capturar a imagem da estrutura atual, incluindo arquivos e subpastas.

7.4 Comparar estrutura planejada com estrutura real

Comparar o que está descrito no mapa com o que aparece no print screen da pasta real.

7.5 Classificar os arquivos encontrados

Cada arquivo deve ser classificado conforme sua situação.

Situação encontrada	Decisão recomendada
Existe e está coerente com a área	Manter
Existe, mas precisa atualização	Atualizar conteúdo, links, breadcrumb ou padrão visual
Não existe, mas aparece como necessário no mapa	Criar novo arquivo
Existe, mas pertence a outra área	Mover para a área correta ou para `_avaliar/`
Existe, mas parece duplicado, antigo ou incerto	Mover para `_avaliar/`

7.6 Criar ou atualizar a pasta `_avaliar/`

A pasta _avaliar/ deve receber arquivos que não devem ser excluídos imediatamente, mas que também não devem permanecer como parte ativa da área.

A pasta _avaliar/ não é lixeira. Ela é uma área temporária de decisão, revisão e curadoria.

7.7 Gerar a página de organização da área

Criar ou atualizar:

organizacao_nome_pasta.html

Essa página explica como a área deve ser organizada fisicamente e semanticamente.

7.8 Gerar ou atualizar o índice estrutural da área

Criar ou atualizar:

index_nome_pasta.html

O índice é a porta de entrada estrutural da área. Ele deve apresentar o catálogo oficial das páginas ativas.

7.9 Gerar arquivos derivados

A partir do índice, podem ser gerados arquivos derivados, quando fizerem sentido.

glossario_nome_pasta.html
referencias_nome_pasta.html
quadro_regras_nome_pasta.html
modelo_nome_pasta.html
fluxo_nome_pasta.html

8. Exemplo de aplicação do procedimento: pasta `dominios/`

Este exemplo mostra como o procedimento de manutenção da estrutura atual pode ser aplicado a uma área real do OLA: a pasta meulivro/dominios/, localizada no ambiente do computador.

A pasta dominios/ reúne as áreas temáticas do OLA. Por isso, sua manutenção exige atenção especial à coerência entre a estrutura física das subpastas, o catálogo apresentado em index_dominios.html, os mapas analíticos de cada domínio e os critérios de governança da organização física do projeto.

8.1 Situação inicial

A manutenção começa com a escolha da pasta física existente:

meulivro/dominios/

Em seguida, é feita uma captura de tela da pasta no computador, mostrando as subpastas e arquivos atualmente existentes. Essa captura funciona como evidência visual da estrutura real no momento da manutenção.

8.2 Prompt inicial para orientar a manutenção

O prompt abaixo pode ser usado como ponto de partida para solicitar à IA a criação da página âncora analítica da área dominios/:

Com base no procedimento de manutenção da estrutura física atual do OLA,
escolher a pasta meulivro/dominios/ no ambiente do computador e elaborar
a página âncora analítica da área Domínios, com o nome mapa_dominios.html.

A página deve funcionar como mapa analítico da área Domínios, representando
a estrutura física observada no print screen anexado da pasta dominios/,
identificando subpastas, arquivos principais, possíveis inconsistências,
itens a manter, itens a avaliar e relações com o índice estrutural
index_dominios.html.

O resultado esperado é uma página HTML completa, no padrão OLA, com:

1. Cabeçalho institucional do OLA;
2. Hero de apresentação da página;
3. Layout com índice lateral fixo ou aderente, alinhado à esquerda em telas grandes;
4. Em telas pequenas, o índice lateral deve se adaptar para navegação responsiva;
5. Links internos no índice apontando para as seções correspondentes por âncoras HTML;
6. Botão para alternar tema claro/escuro;
7. Conteúdo organizado em cards, tabelas e blocos analíticos;
8. Quando houver grafo, usar D3.js com descrição do nó ao clicar.

O índice lateral da página deve conter, pelo menos, os seguintes itens:

1. Início
2. Breadcrumbs
3. Finalidade × Análise
4. Problema resolvido
5. Papel dos Domínios no OLA
6. Grafo dos Domínios
7. Camadas de abstração e leitura
8. Dimensão estrutural
9. Leitura analítica
10. Estrutura física representada
11. Classificação das pastas e arquivos
12. Possíveis itens para _avaliar
13. Relação com o índice estrutural
14. Leitura do catálogo
15. Inconsistências e pontos de atenção
16. Critérios de manutenção
17. Próximos passos
18. Síntese

Cada item do índice lateral deve corresponder a uma seção real da página,
com id próprio, por exemplo:

- Início → #inicio
- Breadcrumbs → #breadcrumbs
- Finalidade × Análise → #finalidade-analise
- Problema resolvido → #problema-resolvido
- Papel dos Domínios no OLA → #papel-dominios
- Grafo dos Domínios → #grafo-dominios
- Camadas de abstração e leitura → #camadas-abstracao
- Dimensão estrutural → #dimensao-estrutural
- Leitura analítica → #leitura-analitica
- Estrutura física representada → #estrutura-fisica
- Classificação das pastas e arquivos → #classificacao
- Possíveis itens para _avaliar → #itens-avaliar
- Relação com o índice estrutural → #relacao-indice
- Leitura do catálogo → #leitura-catalogo
- Inconsistências e pontos de atenção → #inconsistencias
- Critérios de manutenção → #criterios-manutencao
- Próximos passos → #proximos-passos
- Síntese → #sintese

A página deve também deixar clara a diferença entre:

- index_dominios.html como índice estrutural da área Domínios;
- mapa_dominios.html como mapa analítico da área Domínios;
- organizacao_dominios.html como possível página operacional complementar
  para explicar como a pasta dominios/ deve ser organizada física e semanticamente.

A análise deve considerar a estrutura física observada no print screen da pasta dominios/,
incluindo domínios principais, domínios estruturantes/transversais,
domínios especializados, itens com possível caráter provisório ou legado
e arquivos que exigem decisão de governança.

O HTML deve ser entregue completo, em um único arquivo, com CSS e JavaScript incorporados,
mantendo o padrão visual institucional do OLA.

8.3 Leitura inicial da pasta `dominios/`

A partir da captura de tela, a análise deve verificar quais elementos já estão coerentes com o catálogo de domínios do OLA e quais precisam de decisão de manutenção.

Elemento observado	Leitura inicial	Ação provável
Pastas de domínio consolidadas	Representam domínios ativos ou já previstos no catálogo.	Manter e relacionar com `index_dominios.html`.
`index_dominios.html`	Funciona como índice estrutural da área Domínios.	Manter como entrada estrutural da área.
`mapa_dominios.html`	Página a ser criada ou atualizada como âncora analítica.	Criar ou revisar.
Pastas com nomes incertos, legados ou provisórios	Podem representar histórico, rascunho, duplicidade ou conteúdo fora do padrão atual.	Analisar e, se necessário, mover para `_avaliar/`.
Arquivos de origem, padrão ou declaração	Podem ter função de governança, documentação ou rastreabilidade.	Verificar se pertencem a `dominios/` ou a `governanca/`.

8.4 Subpastas observadas no exemplo da área Domínios

No exemplo da pasta dominios/, a captura de tela mostra um conjunto de subpastas que representam domínios temáticos, domínios estruturantes, áreas transversais e possíveis itens de legado ou avaliação.

Grupo observado	Exemplos na pasta `dominios/`	Leitura de manutenção
Domínios principais	`aprendizagem`, `eletricidade`, `cinematica`, `sistema`, `computacao`, `pagina_web`, `livro`, `software`, `eletronica`, `entidade_negocios`	Devem permanecer como subpastas ativas da área Domínios, desde que estejam coerentes com o catálogo em `index_dominios.html`.
Domínios estruturantes ou transversais	`conhecimento`, `epistemologia`, `ontologia`, `ciencia_tecnologia`, `educacao`, `llm`	Devem ser tratados como domínios de apoio conceitual, com papel transversal na arquitetura de conhecimento do OLA.
Domínios especializados	`saude`, `nautica`, `filosofia`, `engenharia_conhecimento`, `educacao_aprendizagem`	Devem ser avaliados quanto à posição no catálogo e quanto à possível relação com outros domínios próximos.
Itens com possível caráter provisório ou legado	`historico_rascunho`, `engenharia_conhecimento_legado`	Devem ser analisados para decidir se permanecem como histórico, se vão para `_avaliar/` ou se serão incorporados a uma área de legado.
Itens que exigem decisão de governança	`ola`, `padrao_origem_declarada_dominios.html`	Devem ser verificados quanto à natureza: domínio, documentação de governança, padrão transversal ou arquivo a mover para outra área.

8.5 Saídas esperadas do exemplo

A aplicação do procedimento à pasta dominios/ deve gerar ou revisar os seguintes artefatos:

mapa_dominios.html — página âncora analítica da área Domínios;
index_dominios.html — índice estrutural atualizado da área;
organizacao_dominios.html — página de organização física e semântica da área, se necessário;
_avaliar/ — pasta para itens incertos, antigos, duplicados ou fora de lugar;
lista de decisões sobre o que manter, mover, atualizar ou revisar.

Este exemplo transforma o procedimento geral em uma aplicação concreta. A pasta dominios/ passa a funcionar como caso de referência para futuras manutenções de outras áreas do OLA.

9. Produtos gerados pelo procedimento

Produto	Função
`mapa_nome_pasta.html`	Representa a área de forma analítica
`organizacao_nome_pasta.html`	Explica a organização física e lógica da área
`index_nome_pasta.html`	Serve como entrada estrutural e catálogo ativo da área
`_avaliar/`	Recebe arquivos incertos, antigos, duplicados ou fora de lugar
Páginas derivadas	Complementam a área com glossário, referências, regras, fluxos ou modelos

10. Critérios de decisão

Critério	Pergunta orientadora	Ação provável
Pertinência	Este arquivo pertence conceitualmente a esta área?	Manter ou mover
Atualidade	Este arquivo ainda representa a versão válida?	Manter ou mover para `_avaliar/`
Função estrutural	Este arquivo é índice, mapa, organização, regra, glossário ou referência?	Classificar corretamente
Duplicidade	Existe outro arquivo com função semelhante?	Consolidar ou avaliar
Navegação	Este arquivo está ligado ao índice, ao mapa ou ao portal?	Atualizar links
Governança	Este arquivo segue os padrões atuais do OLA?	Atualizar padrão visual e estrutural

11. Relação com outras páginas de governança

Página relacionada	Relação com este procedimento
`estrutura_fisica_arquivos_pastas.html`	Define regras gerais para organização física do OLA
`quadro_regras_ola.html`	Concentra regras gerais de navegação, estrutura e manutenção
`mapa_governanca.html`	Mostra a posição analítica deste procedimento dentro da governança
`index_governanca.html`	Deve catalogar esta página como procedimento interno de manutenção

12. Limitações do estado atual

depende de print screen manual;
depende de interpretação humana da estrutura física;
não há leitura automática da árvore de diretórios;
não há comparação automática entre mapa e pasta real;
não há movimentação automática de arquivos;
não há validação automática de links quebrados;
não há relatório automático de inconsistências.

A principal limitação é que a coerência estrutural depende da atenção humana. Por isso, o procedimento precisa ser explícito, repetível e documentado.

13. Preparação para evolução futura

Embora o estado atual seja humano e manual, este procedimento já prepara o caminho para dois estados futuros:

Estado intermediário

IA assistiva ajuda a ler a estrutura, comparar, sugerir reorganizações e gerar relatórios, mas o humano ainda decide.

Estado futuro

Pipeline semi-autônomo executa leitura, comparação, classificação e sugestão de mudanças, com aprovação humana antes da aplicação.

Assim, esta página funciona como a base operacional do estágio atual e como ponto de partida para a evolução da manutenção estrutural do OLA.

14. Síntese

A manutenção atual da estrutura física do OLA é um procedimento humano interno, localizado na governança operacional do sistema.

pasta existente
→ mapa da área
→ print da pasta real
→ comparação
→ classificação
→ _avaliar
→ organização da área
→ índice da área
→ páginas derivadas

Esse procedimento garante que o OLA continue sendo um sistema de conhecimento vivo, mas com evolução controlada, rastreável e coerente.