Regras de Integridade entre Pastas e Arquivos do OLA

Breadcrumb físico e semântico

Breadcrumb físico: meulivro.info / governanca / regras_integridade_pastas_arquivos_ola.html

Breadcrumb semântico: OLA → Governança → Estrutura física → Integridade entre pastas e arquivos

Finalidade × Análise

Finalidade

Definir regras práticas para evitar perda de coerência estrutural no OLA à medida que novas páginas, pastas, demandas, entregas, versões e artefatos forem criados.

A página ajuda a decidir onde colocar arquivos, como nomeá-los, como relacioná-los e quando migrá-los para produção, histórico ou legado.

Análise

O OLA cresce por aprendizagem, experimentação e produção contínua. Sem regras de integridade, a raiz e as subpastas podem acumular arquivos soltos, nomes inconsistentes, páginas órfãs, versões duplicadas e links quebrados.

A integridade estrutural não impede a evolução; ela organiza a evolução para que o conhecimento continue recuperável.

Problema resolvido

Como manter a organização do OLA coerente quando novas páginas e pastas são criadas em ciclos sucessivos de demanda, entrega, revisão, homologação, produção e legado?

Risco

Arquivos podem ser criados na pasta errada, com nomes ambíguos ou sem vínculo com páginas índice.

Regra

Cada arquivo deve ter função, localização, nome, estado e relacionamento explícitos.

Resultado

O OLA permanece navegável, auditável, publicável e evolutivo.

O que é integridade estrutural no OLA

Integridade estrutural é a coerência entre a função do conteúdo, sua pasta de localização, seu nome de arquivo, suas relações com outras páginas e seu estado de uso no ciclo de vida do OLA.

Formulação central: um arquivo do OLA não deve existir apenas como arquivo. Ele deve existir como parte de uma rede de conhecimento, navegação, governança e evolução.

Arquivo íntegro no OLA
├── tem finalidade clara
├── está na pasta coerente
├── segue padrão de nomeação
├── é acessível por página índice ou página relacionada
├── aponta para referências importantes
├── possui estado definido: desenvolvimento, homologação, produção, histórico ou legado
└── pode ser encontrado, entendido, revisado e mantido

1. Regra de integridade de localização

A localização de um arquivo deve ser definida pela função predominante do conteúdo.

Função predominante	Local recomendado	Critério
Explicar conceitos, princípios, modelos, vocabulário ou pressupostos.	`fundamentos/`	É base conceitual do OLA.
Descrever estrutura, organização, componentes, fluxos, mapas e funcionamento.	`arquitetura/`	É desenho estrutural ou funcional.
Definir regra, decisão, critério, classificação, publicação, manutenção ou controle.	`governanca/`	É norma de organização ou decisão.
Planejar evolução, versões, prioridades, demandas e entregas transversais.	`projeto/`	É gestão do desenvolvimento do OLA.
Modelar o OLA como sistema, estados, fronteiras, elementos e relações.	`sistema/`	É modelagem sistêmica.
Contextualizar o OLA em relação a pessoas, instituições, IA, web e sociedade.	`ecossistema/`	É contexto ampliado.
Organizar experiência de quem chega pela primeira vez.	`visitante/`	É entrada pública por persona.
Organizar trilhas, objetos, práticas, avaliação e processo educacional.	`aprendizagem/`	É processo de aprendizagem.
Aplicar conhecimento a uma área específica.	`dominios/`	É domínio de conhecimento ou aplicação.
Produção autoral, laboratório, notas, experimentos e pendências pessoais.	`autor/`	É atividade do autor como produtor/curador.
CSS, JavaScript, imagens, ícones, logos e componentes técnicos.	`assets/`	É recurso técnico reutilizável.
Versões antigas, páginas substituídas, rascunhos preservados.	`legado/` ou `historico_rascunho/`	É memória ou material não canônico.

Regra: quando houver dúvida, escolher a pasta pela função do conteúdo, não apenas pelo assunto do título.

2. Regra de integridade de nomeação

O nome do arquivo deve permitir identificação, recuperação e manutenção.

Padrão recomendado

usar letras minúsculas;
não usar espaços;
não usar acentos;
usar underline entre palavras;
evitar nomes como final, novo, teste2 em produção.

Exemplos

Preferir:

regras_estrutura_raiz_ola.html

estrutura_raiz_ola.html

classificacao_areas_raiz_ola.html

Evitar: Regras da Raiz Final.html, estrutura-raiz-nova2.html, classificação áreas raiz.html.

3. Regra de páginas índice

Toda pasta estrutural relevante deve ter uma página de entrada.

governanca/index_governanca.html
arquitetura/index_arquitetura.html
fundamentos/index_fundamentos.html
dominios/index_dominios.html
projeto/index_projeto.html
aprendizagem/index_aprendizagem.html
visitante/index_visitante.html
autor/index_autor.html

Regra: uma pasta importante sem índice tende a virar depósito. A página índice deve explicar finalidade, conteúdo, páginas principais, páginas relacionadas e estado da área.

4. Regra de integridade de relacionamento

Páginas relacionadas devem se apontar mutuamente quando formam uma decisão, regra, estrutura ou fluxo.

Relacionamento mínimo

Uma página estrutural deve ter:

breadcrumb físico e semântico;
links para páginas relacionadas;
referência à página índice da pasta;
links de retorno quando alterar uma regra existente.

Exemplo

governanca/regras_estrutura_raiz_ola.html
    ↔ arquitetura/estrutura_raiz_ola.html
    ↔ governanca/classificacao_areas_raiz_ola.html
    ↔ governanca/regras_integridade_pastas_arquivos_ola.html

Regra: páginas de governança e arquitetura não devem ficar isoladas. Elas precisam formar rede de decisão e consulta.

5. Regra para demandas e entregas

Demandas e entregas não devem voltar a ser áreas principais da raiz. Elas são categorias internas de trabalho.

Caso	Local recomendado	Exemplo
Demanda transversal do OLA.	`projeto/demandas_entregas/`	`projeto/demandas_entregas/camada_publica_descoberta_ola/`
Demanda ligada a domínio de conhecimento.	`dominios/<dominio>/<tema>/demanda/`	`dominios/gestao/fabrica_brownie/demanda/`
Entrega ligada a domínio de conhecimento.	`dominios/<dominio>/<tema>/entrega/`	`dominios/gestao/fabrica_brownie/entrega/`
Demanda pessoal do autor.	`autor/demandas_autor/`	`autor/demandas_autor/pendencias/`

Regra de proteção da raiz: não criar novamente demandas/ e entregas/ como pastas definitivas de primeiro nível.

6. Regra para desenvolvimento, homologação e produção

A integridade depende também do ambiente onde o arquivo está.

Desenvolvimento

Fica no computador local. É onde se cria, testa, ajusta, experimenta e reorganiza.

Homologação

Pode existir no provedor para teste externo controlado, antes de produção.

Produção

Fica no provedor como versão publicada, revisada, acessível e coerente com a estrutura.

Regra: um arquivo só deve ir para produção quando estiver classificado, nomeado, linkado, revisado e coerente com a estrutura do OLA.

7. Regra para legado, histórico e rascunhos

Arquivos substituídos não devem ficar misturados com arquivos canônicos.

`legado/`

Preserva versões antigas, páginas substituídas e materiais históricos que não são mais a versão vigente.

`historico_rascunho/`

Preserva rascunhos, materiais em transição ou versões intermediárias ainda úteis para consulta.

Regra: a raiz deve mostrar o que é vigente. O que é histórico deve ser preservado, mas não confundido com o canônico.

Checklist antes de criar, mover ou publicar arquivos

Verificação	Pergunta de controle	Status
Função	A finalidade do arquivo está clara?	verificar
Localização	A pasta escolhida corresponde à função predominante?	verificar
Nomeação	O nome está em minúsculas, sem acentos, sem espaços e com underline?	verificar
Índice	A pasta possui página índice ou a página está acessível por outra entrada?	verificar
Relacionamentos	A página aponta para páginas relacionadas e recebe links de retorno quando necessário?	verificar
Estado	O arquivo está em desenvolvimento, homologação, produção, histórico ou legado?	verificar
Substituição	Se substituiu outro arquivo, o anterior foi enviado ao legado ou histórico?	verificar
Publicação	O arquivo está pronto para ir ao provedor de produção?	verificar

Exemplos de decisão de localização

Novo conteúdo	Onde colocar	Motivo
Regra de redirecionamento entre páginas antigas e novas.	`governanca/regras_redirecionamento_ola.html`	É regra de governança e manutenção.
Descrição da estrutura física da raiz.	`arquitetura/estrutura_raiz_ola.html`	É arquitetura estrutural.
Classificação semântica das pastas da raiz.	`governanca/classificacao_areas_raiz_ola.html`	É critério de classificação e governança.
Demanda da camada pública de descoberta.	`projeto/demandas_entregas/camada_publica_descoberta_ola/`	É demanda transversal do projeto OLA.
Experiência de custos da fábrica de brownie.	`dominios/gestao/fabrica_brownie/`	É aplicação em domínio de gestão.
Notas pessoais do autor durante uma observação de aprendizagem.	`autor/` ou `autor/demandas_autor/`	É produção/registro autoral.

Páginas relacionadas

Governança

Arquitetura e raiz

Próximo passo recomendado: incluir esta página em governanca/index_governanca.html e criar link cruzado a partir de regras_estrutura_raiz_ola.html.

Termo	Significado no OLA
Integridade estrutural	Coerência entre função, pasta, nome, links, estado e ciclo de vida de um arquivo.
Arquivo canônico	Arquivo vigente usado como referência atual.
Página órfã	Página sem link de entrada claro a partir de índice, mapa, portal ou página relacionada.
Legado	Área de preservação de versões antigas e materiais substituídos.
Homologação	Ambiente de teste externo antes da publicação definitiva.
Produção	Ambiente publicado e acessível como versão válida.
Função predominante	Critério principal para decidir a pasta de um arquivo.