Governança • Estrutura Física — Arquivos & Pastas

Regra canônica de organização física do OLA

↩ Home Portal README Governança
GOVERNANÇA ESTRUTURAL • DOCUMENTO CANÔNICO

O que esta página decide e sustenta

Esta página é a referência canônica de governança estrutural para a organização física do OLA. Ela define como a raiz representa o próprio OLA, como se distinguem infraestrutura, uso/perspectiva, laboratório/transição, domínios de aplicação e publicações editoriais, e como decidir onde uma nova página deve nascer fisicamente.

Infraestrutura do OLA Uso / perspectiva / navegação Laboratório / transição Aplicação por domínio Publicação editorial
Relação com o README: o readme.html, na raiz, apresenta a visão institucional e resumida. Esta página, em governanca/, define a regra oficial de organização física.
LEITURA DO SISTEMA

Breadcrumb físico e semântico

A navegação no OLA pode ser entendida em dois planos complementares: o físico, ligado à estrutura de pastas, e o semântico, ligado ao papel do conteúdo no sistema.

Breadcrumb físico:
Home → Portal Interno → Governança → Estrutura Física
Breadcrumb semântico:
OLA → Governança Estrutural → Regra de Organização Física
METAMODELO DO OLA

Quatro dimensões e eixos de leitura

A estrutura física é apenas uma parte do OLA, que pode ser lido como sistema que opera em quatro dimensões.

Físico Digital Semântico Transformacional
  • Físico: pastas, arquivos, endereços e organização material.
  • Digital: páginas, componentes, navegação e operação web.
  • Semântico: conceitos, relações, significados, domínios e modelo.
  • Transformacional: aprendizagem, evolução e promoção de conteúdo.
Eixos principais:
  • Eixo de abstração: M0, M1, M2 e M3.
  • Eixo estrutural: Projeto, Site, Sistema e Ecossistema.
DIAGRAMA VISUAL

Leitura visual da estrutura física do OLA

Neste modelo, a raiz já representa o OLA. A partir dela, a estrutura se organiza em cinco classes principais: infraestrutura, uso / perspectiva, laboratório / transição, domínios de aplicação e publicações editoriais.

Raiz = OLA

Espaço institucional, estrutural, semântico e operacional do sistema

Infraestrutura

Constrói, organiza, padroniza, governa e instancia o OLA.

fundamentos/ arquitetura/ governanca/ sistema/ projeto/ assets/ base/

Uso / Perspectiva

Mostra o OLA por contexto, perfil, experiência de uso e navegação.

ecossistema/ aprendizagem/ aprendiz/ visitante/ livro_personas/

Laboratório / Transição

Área de experimento, protótipo, teste e amadurecimento.

autor/lab/ analises/ experimentos_ativos/ prototipos/

Domínios

Demandas externas organizadas por tema ou campo de conhecimento.

dominios/eletricidade/ dominios/ergonomia/ dominios/filosofia/

Artigo

Publicações editoriais organizadas por formato textual.

artigo/analiticos/ artigo/conceituais/ artigo/aplicados/
Leitura correta: a raiz não é apenas um diretório técnico. Ela já funciona como o espaço institucional do OLA. As demais áreas são especializações funcionais dessa raiz.
Resumo estrutural: fundamentos/, arquitetura/, governanca/, sistema/, projeto/, assets/ e base/ sustentam o OLA como sistema. dominios/ atende a organização temática de demandas externas, e artigo/ atende a organização editorial.
DECISÃO ESTRUTURAL

O que foi consolidado

  • A pasta ola/ não será criada.
  • A raiz continua representando o OLA.
  • O README permanece na raiz como documento institucional.
  • A estrutura física passa a ser documento canônico em governança.
  • dominios/ atende a demandas externas organizadas por tema.
  • artigo/ atende a organização editorial.
  • glossario/ permanece em fundamentos/.
CONSEQUÊNCIA PRÁTICA

O que esta organização evita

Vantagem principal: preserva caminhos existentes, evita quebra de links, reduz entropia estrutural e diferencia melhor o que é OLA como sistema do que é conteúdo externo colocado no padrão OLA.

A lógica é classificatória e sistêmica antes de ser apenas operacional.

ÁRVORE CANÔNICA

Estrutura em árvore com uso ao lado de cada item

meulivro.info/                                              [raiz • OLA como espaço institucional e operacional]
├─ index.html                                               [entrada pública • acesso inicial ao OLA]
├─ portal.html                                              [entrada interna • construção e evolução do OLA]
├─ readme.html                                              [documentação institucional • visão geral da estrutura física]
├─ sobre_autor.html                                         [apresentação pública • autoria e contexto do projeto]
│
├─ assets/                                                  [infraestrutura • recursos visuais e técnicos compartilhados]
│  ├─ componentes/                                          [assets • componentes reutilizáveis]
│  ├─ css/                                                  [assets • estilos globais]
│  ├─ img/                                                  [assets • imagens e ilustrações]
│  └─ js/                                                   [assets • scripts reutilizáveis]
│
├─ base/                                                    [infraestrutura • modelos e apoio à construção]
│  ├─ snippets/                                             [base • trechos reutilizáveis de código]
│  └─ templates/                                            [base • modelos de páginas e estruturas]
│
├─ fundamentos/                                             [infraestrutura • base conceitual do OLA]
│  ├─ conceitos/                                            [fundamentos • conceitos-base do sistema]
│  ├─ glossario/                                            [fundamentos • glossário e dicionário geral de termos]
│  ├─ linguagem/                                            [fundamentos • linguagem conceitual e terminológica]
│  ├─ metodos/                                              [fundamentos • métodos usados no OLA]
│  ├─ modelos/                                              [fundamentos • modelos conceituais e estruturais]
│  ├─ padroes/                                              [fundamentos • padrões conceituais e de organização]
│  ├─ principios/                                           [fundamentos • princípios orientadores]
│  ├─ processos/                                            [fundamentos • processos gerais do OLA]
│  ├─ regras/                                               [fundamentos • regras gerais do sistema]
│  ├─ referencias/                                          [fundamentos • bibliografia e base teórica]
│  │  ├─ index_referencias.html                             [referências • entrada para referências]
│  │  └─ referencias_iniciais_ola.html                      [referências • base inicial de apoio]
│  └─ visual/                                               [fundamentos • apoio visual e semântico]
│
├─ arquitetura/                                             [infraestrutura • desenho estrutural do OLA]
│  ├─ contratos/                                            [arquitetura • contratos estruturais]
│  ├─ diagramas/                                            [arquitetura • diagramas e mapas]
│  ├─ instanciacao/                                         [arquitetura • passagem do modelo para instâncias]
│  ├─ modelos/                                              [arquitetura • modelos de organização]
│  └─ padroes/                                              [arquitetura • padrões estruturais e técnicos]
│
├─ governanca/                                              [infraestrutura • decisões, direção e integridade do OLA]
│  ├─ decisoes/                                             [governança • decisões registradas]
│  ├─ estrategia/                                           [governança • direção estratégica]
│  ├─ portfolio/                                            [governança • visão consolidada do conjunto]
│  ├─ projetos/                                             [governança • articulação de iniciativas e frentes]
│  ├─ politicas/                                            [governança • políticas e critérios institucionais]
│  ├─ infra/                                                [governança • apoio à organização da infraestrutura]
│  ├─ index_governanca.html                                 [governança • entrada da área]
│  └─ estrutura_fisica_arquivos_pastas.html                 [governança • regra canônica de organização física]
│
├─ sistema/                                                 [infraestrutura • núcleo integrador do OLA]
│  ├─ arquitetura/                                          [sistema • arquitetura do núcleo]
│  ├─ componentes/                                          [sistema • partes do sistema]
│  ├─ contratos/                                            [sistema • contratos do núcleo]
│  ├─ instanciacao/                                         [sistema • instâncias do sistema]
│  └─ modelos/                                              [sistema • modelos do núcleo]
│
├─ projeto/                                                 [infraestrutura • execução, acompanhamento e evolução]
│  ├─ index_projeto.html                                    [projeto • entrada da área de projeto]
│  ├─ changelog.html                                        [projeto • histórico de mudanças]
│  ├─ checklists.html                                       [projeto • listas de controle]
│  ├─ visao_geral.html                                      [projeto • acompanhamento e visão de execução]
│  └─ migracao_estrutura.html                               [projeto • plano de mudança estrutural, se houver]
│
├─ ecossistema/                                             [uso/perspectiva • contexto ampliado do OLA]
│  ├─ index_ecossistema.html                                [ecossistema • entrada contextual]
│  ├─ mapa_ecossistema.html                                 [ecossistema • mapa geral]
│  ├─ ambientes/                                            [ecossistema • contextos de uso]
│  ├─ atores/                                               [ecossistema • participantes e papéis]
│  ├─ canais/                                               [ecossistema • canais e meios]
│  ├─ evidencias/                                           [ecossistema • registros contextuais]
│  └─ restricoes/                                           [ecossistema • limites e condicionantes]
│
├─ aprendizagem/                                            [uso/perspectiva • organização do uso educacional]
│  ├─ index_aprendizagem.html                               [aprendizagem • entrada da área]
│  ├─ avaliacao/                                            [aprendizagem • avaliação]
│  ├─ evidencias/                                           [aprendizagem • evidências de aprendizagem]
│  ├─ guias/                                                [aprendizagem • guias de uso e estudo]
│  ├─ oas/                                                  [aprendizagem • objetos de aprendizagem]
│  ├─ _midia/                                               [aprendizagem • mídia de apoio]
│  └─ trilhas/                                              [aprendizagem • trilhas de aprendizagem]
│
├─ aprendiz/                                                [uso/perspectiva • experiência do aprendiz]
│  ├─ index_aprendiz.html                                   [aprendiz • entrada da persona]
│  ├─ evidencias/                                           [aprendiz • registros do aprendiz]
│  ├─ governanca/                                           [aprendiz • acompanhamento e organização local]
│  ├─ oas/                                                  [aprendiz • objetos voltados ao aprendiz]
│  ├─ perfil/                                               [aprendiz • perfil do aprendiz]
│  └─ trilhas/                                              [aprendiz • trilhas específicas]
│
├─ visitante/                                               [uso/perspectiva • entrada simplificada]
│  ├─ index_visitante.html                                  [visitante • entrada da persona]
│  └─ index_leitor.html                                     [visitante • modo leitor, se adotado]
│
├─ livro_personas/                                          [uso/perspectiva • navegação por perfis]
│  ├─ index_aprendiz.html                                   [personas • entrada do aprendiz]
│  ├─ index_autor.html                                      [personas • entrada do autor]
│  └─ index_leitor.html                                     [personas • entrada do leitor]
│
├─ autor/                                                   [laboratório/transição • incubação e produção em amadurecimento]
│  ├─ lab/                                                  [laboratório • experimentação principal]
│  │  ├─ index_lab.html                                     [lab • entrada do laboratório]
│  │  ├─ entradas_textuais/                                 [lab • insumos brutos]
│  │  ├─ analises/                                          [lab • leituras e estruturações]
│  │  ├─ experimentos_ativos/                               [lab • casos em elaboração]
│  │  ├─ prototipos/                                        [lab • formas intermediárias]
│  │  ├─ cursos_seminarios/                                 [lab • estudos e registros de formação]
│  │  └─ utilitarios/                                       [lab • ferramentas de apoio]
│  ├─ producao/                                             [autor • produção em andamento]
│  ├─ publicacoes/                                          [autor • materiais prontos ou quase prontos]
│  ├─ fontes/                                               [autor • insumos e materiais de origem]
│  ├─ historico/                                            [autor • histórico de trabalho]
│  └─ wip/                                                  [autor • trabalho em progresso]
│
├─ dominios/                                                [aplicação • demandas externas organizadas por tema]
│  ├─ index_dominios.html                                   [domínios • entrada temática]
│  ├─ eletricidade/                                         [domínio • aplicações em eletricidade]
│  ├─ ergonomia/                                            [domínio • aplicações em ergonomia]
│  ├─ filosofia/                                            [domínio • aplicações em filosofia]
│  ├─ computacao/                                           [domínio • aplicações em computação]
│  ├─ matematica/                                           [domínio • aplicações em matemática]
│  └─ sistemas_informacao/                                  [domínio • aplicações em sistemas de informação]
│
├─ artigo/                                                  [editorial • publicações textuais estruturadas]
│  ├─ index_artigos.html                                    [artigo • entrada editorial]
│  ├─ analiticos/                                           [artigo • textos analíticos]
│  ├─ conceituais/                                          [artigo • textos conceituais]
│  ├─ aplicados/                                            [artigo • textos aplicados]
│  └─ referencias/                                          [artigo • referências editoriais]
│
├─ index_expandidos/                                        [derivados do index • artefatos gerados a partir da entrada]
│  ├─ artefato_base/                                        [index expandido • artefato-base]
│  ├─ conceitos_estruturados/                               [index expandido • conceitos detalhados]
│  ├─ trilhas_geradas/                                      [index expandido • trilhas produzidas]
│  ├─ redes_e_grafos/                                       [index expandido • mapas, redes e grafos]
│  └─ paginas_exemplo/                                      [index expandido • exemplos estruturados]
│
└─ legado/                                                  [histórico • versões anteriores e compatibilidade]
   ├─ redirecionamentos/                                    [legado • apoio à migração]
   └─ versoes/                                              [legado • versões anteriores]

Nesta versão, a árvore já incorpora classe funcional e uso principal ao lado de cada item.

LEITURA FUNCIONAL

Como interpretar a lógica atual

Infraestrutura Uso / perspectiva Laboratório Domínios Artigo
Infraestrutura do OLA: pastas que constroem, explicam, instanciam, governam e padronizam o próprio sistema.
Laboratório / transição: espaço para experimento, análise, teste, prototipação e amadurecimento antes da promoção para áreas estáveis.
Domínios: área para conteúdos temáticos e demandas externas organizadas por tema.
Artigo: área editorial. Não substitui domínios; organiza textos por formato/publicação.
Personas e contexto: aprendiz/, visitante/, livro_personas/ e ecossistema/ mostram que o OLA também é organizado por perspectiva de uso e contexto.
TABELA • CLASSIFICAÇÃO DAS ÁREAS

Leitura funcional das áreas da raiz

Pasta / área Classe Função principal Observação estrutural
/fundamentos/ Infraestrutura do OLA Base conceitual, princípios, métodos, regras, glossário, referências e visualizações estruturantes. Permanece na raiz como base conceitual do sistema.
/arquitetura/ Infraestrutura do OLA Contratos, padrões, modelos, diagramas e instanciação. Permanece na raiz.
/governanca/ Infraestrutura do OLA Decisões, políticas, portfólio e direção estrutural. Agora abriga a regra canônica de organização física.
/sistema/ Infraestrutura do OLA Núcleo integrador do OLA e suas instâncias estruturais. Permanece na raiz.
/projeto/ Infraestrutura do OLA Execução, acompanhamento, changelog e checklists. Foco em evolução e execução, não na regra canônica.
/ecossistema/ Uso / perspectiva Contexto ampliado do OLA, atores, canais, ambientes e restrições. Não é domínio externo; é perspectiva do próprio OLA.
/aprendizagem/ Uso / perspectiva Uso educacional, trilhas, avaliação, evidências e objetos publicados. Área de uso e aprendizagem.
/aprendiz/ Uso / perspectiva Experiência, perfil, trilhas e evidências do aprendiz. Perspectiva de persona e uso.
/visitante/ Uso / perspectiva Modo simplificado de navegação e leitura. Perspectiva de entrada.
/livro_personas/ Uso / perspectiva Organização por perfis, papéis e tipos de leitor/usuário. Ligado à navegação por persona.
/autor/lab/ Laboratório / transição Entradas textuais, análises, experimentos, protótipos e amadurecimento. Incubadora antes da promoção.
/dominios/ Aplicação por domínio Conteúdos externos ou aplicados organizados por tema. Nova área temática estruturante.
/artigo/ Publicação editorial Textos longos, analíticos, conceituais ou aplicados organizados como publicações. Formato editorial, não substitui domínios.
/index_expandidos/ Família derivada do index Artefatos-base, páginas exemplo, trilhas geradas, conceitos estruturados e grafos. Pode coexistir com o laboratório como família derivada da entrada.
/legado/ Histórico / migração Compatibilidade, redirecionamentos e versões anteriores. Preserva rastreabilidade histórica.
Regra de decisão

Como decidir onde uma nova página deve nascer

1. É sobre o próprio OLA?

Vai para uma pasta de infraestrutura já existente na raiz, como fundamentos/, arquitetura/, governanca/, sistema/ ou projeto/.

2. É uma perspectiva de uso?

Vai para áreas como ecossistema/, aprendizagem/, aprendiz/, visitante/ ou livro_personas/.

3. É um experimento?

Vai para autor/lab/. Se amadurecer, pode subir depois para dominios/, artigo/ ou outra área estável.

4. É conteúdo aplicado por tema?

Vai para dominios/. Ex.: eletricidade, ergonomia, filosofia, computação.

5. É uma peça editorial?

Vai para artigo/, quando o principal critério for o formato textual/editorial.

Origem declarada

Como tratar interseções entre domínios

Quando um conteúdo cruza mais de um domínio, a estrutura física não deve resolver isso por duplicação. Usa-se o princípio de origem declarada.

Origem principal

O conteúdo nasce em um único domínio principal, escolhido como ponto de entrada.

/dominios/eletricidade/conceitos/lei_de_ohm.html
Domínio de origem: Eletricidade
Domínios relacionados: Matemática, Física, Eletrônica

Relações complementares

  • referência cruzada entre páginas;
  • registro dos domínios relacionados;
  • grafo como representação da rede;
  • evitar duplicação por padrão.
Resumo: a pasta organiza o armazenamento; o grafo organiza a complexidade relacional.
FLUXO OPERACIONAL

Fluxo resumido de promoção estrutural

Entrada / experimento
Laboratório
Domínio ou artigo
Integração ao OLA

Esse fluxo permite crescimento com baixo risco: o conteúdo amadurece antes de ocupar uma área estável.

SÍNTESE FINAL

Decisão consolidada

Solução adotada: a raiz continua sendo o OLA; o readme.html permanece na raiz como guia institucional; governanca/estrutura_fisica_arquivos_pastas.html torna-se a referência canônica de organização física; dominios/ atende a demandas externas organizadas por tema; artigo/ atende a publicações editoriais; e autor/lab/ continua sendo a incubadora do sistema.