Organização da Arquitetura do OLA
Esta página define como a pasta arquitetura/ deve ser organizada
no OLA. A regra principal é separar páginas estruturantes da área, mantidas
na raiz, de famílias especializadas de conteúdo, mantidas em subpastas,
mantendo coerência entre índice, mapa, sistema de navegação, padrões e governança.
Papel desta página
Finalidade
Definir critérios para organizar a pasta arquitetura/,
evitando duplicidade, excesso de subpastas, confusão entre páginas
estruturantes e páginas especializadas, e uso inadequado dos níveis M0–M3
como pastas físicas.
Análise
A Arquitetura é uma área estrutural do OLA. Ela organiza como o sistema é composto, navegado, representado, operado, modelado e evoluído. Por isso, sua organização física deve seguir a função sistêmica dos arquivos, e não apenas uma categorização superficial.
Que problema esta página resolve?
Problema
A pasta Arquitetura pode crescer com arquivos soltos, subpastas redundantes, duplicação de conteúdo e confusão entre níveis conceituais e estrutura física.
Solução
Definir uma regra explícita para separar páginas estruturantes, páginas especializadas, famílias de conteúdo, arquivos a avaliar e critérios de manutenção.
Resultado
Uma área Arquitetura mais clara, navegável, governável e coerente com o vocabulário controlado do OLA.
Regra central de organização da Arquitetura
Regra:
uma página fica na raiz de arquitetura/ quando tem papel
estruturante para a área inteira. Uma página fica em subpasta quando
pertence a uma família especializada de conteúdo. A raiz deve sintetizar,
integrar e apontar para as subpastas, mas não duplicar integralmente seus
conteúdos.
Relação entre raiz e subpastas
A estrutura da pasta arquitetura/ deve evitar dois extremos:
deixar todos os arquivos soltos na raiz ou criar subpastas demais sem função
clara. A organização deve ser feita pela função arquitetural de cada página.
| Local | Função | Tipo de conteúdo | Exemplo |
|---|---|---|---|
Raiz de arquitetura/ |
Entrada, síntese, integração e referência geral. | Páginas estruturantes da área. |
index_arquitetura.html,
mapa_arquitetura.html,
organizacao_arquitetura.html,
padroes_navegacao_ola.html.
|
| Subpastas | Organizar famílias especializadas. | Páginas de aprofundamento, modelos, templates, grafos, diagramas e padrões específicos. |
padroes/,
modelos/,
templates/,
grafos/,
processos/.
|
_avaliar/ |
Quarentena arquitetural. | Versões antigas, duplicatas, rascunhos, estruturas anteriores e arquivos ainda não classificados. |
index_arquitetura_v1.html,
m1/ antigo,
versões duplicadas de framework.
|
Diferença entre índice, mapa, organização, sistema de navegação e padrões
Algumas páginas da raiz de arquitetura/ têm papéis próximos,
mas não equivalentes. A separação abaixo evita duplicidade e ajuda a manter
cada página com uma função clara.
| Página | Pergunta que responde | Papel principal | Risco se ficar confusa |
|---|---|---|---|
index_arquitetura.html |
Que páginas existem na arquitetura? | Entrada operacional e catálogo da área. | Virar uma página explicativa longa demais. |
mapa_arquitetura.html |
Como os elementos da arquitetura se relacionam? | Âncora analítica, relacional e conceitual. | Virar apenas uma lista de links. |
organizacao_arquitetura.html |
Como a pasta arquitetura deve ser organizada? | Regra de organização física, semântica e operacional da área. | Duplicar conteúdo do índice ou do mapa. |
sistema_navegacao_ola.html |
Como o usuário se orienta no OLA? | Explicação arquitetural da navegação como orientação cognitiva. | Ser confundida com um simples padrão visual. |
padroes_navegacao_ola.html |
Quais padrões devem ser aplicados na navegação? | Padrões reutilizáveis para breadcrumbs, menus, hubs, índices e próximos passos. | Virar uma página conceitual geral, repetindo o sistema de navegação. |
M0–M3 são níveis de leitura, não estrutura física obrigatória
Os níveis M0–M3 pertencem à dimensão abstração. Eles ajudam a ler, modelar, analisar e governar o OLA, mas não determinam, por si só, a estrutura física de pastas.
| Nível | Função conceitual | Como usar na Arquitetura | O que evitar |
|---|---|---|---|
| M0 | Instância concreta. | Indicar páginas concretas, artefatos implementados e exemplos aplicados. | Criar pasta m0/ apenas por abstração. |
| M1 | Modelo aplicado. | Classificar modelos operacionais, estruturas de página e mecanismos aplicados. | Confundir modelo aplicado com pasta física obrigatória. |
| M2 | Padrão, framework ou método reutilizável. | Indicar páginas de padrões, frameworks, métodos e modelos reutilizáveis. | Duplicar páginas entre raiz e subpasta apenas por causa do nível. |
| M3 | Princípio, regra, governança e metamodelo. | Relacionar com Governança, Fundamentos e regras estruturais do OLA. | Transformar toda regra em nova pasta estrutural. |
Controle dos vocábulos usados na Arquitetura
A Arquitetura deve usar o vocabulário do OLA com controle, evitando que termos como sistema, ecossistema, ambiente, projeto, dimensão, camada, eixo, método, design e pesquisa sejam usados de forma sobreposta.
| Vocábulo | Uso na Arquitetura | Cuidado |
|---|---|---|
| Sistema | Todo organizado, funcional e evolutivo que integra páginas, relações, processos, regras e artefatos. | Não reduzir o OLA a site, repositório ou coleção de páginas. |
| Arquitetura | Organização estrutural, semântica, funcional, técnica e operacional do sistema. | Não tratar arquitetura apenas como layout. |
| Ecossistema | Contexto ampliado de atores, tecnologias, IA, domínios, instituições e práticas externas. | Não confundir ecossistema com pasta ou módulo interno. |
| Ambiente | Condições físicas, digitais, cognitivas e operacionais de uso e desenvolvimento. | Não usar como sinônimo genérico de sistema. |
| Projeto | Esforço intencional para construir, revisar e evoluir o sistema OLA. | Distinguir projeto, que constrói, de sistema, que funciona. |
| Dimensão | Recorte analítico do sistema. | Não transformar qualquer aspecto em dimensão. |
| Camada | Nível de composição, dependência ou organização arquitetural. | Não confundir camada com dimensão, eixo ou pasta. |
| Eixo | Direção de leitura, progressão, transformação ou variação. | Usar quando houver continuidade, orientação ou movimento. |
| Método | Caminho recorrente para transformar entrada em análise, estrutura, página, mapa ou artefato. | Distinguir método de processo, procedimento e abordagem. |
| Design | Concepção de solução, estrutura, experiência, interface, navegação e artefato. | Não reduzir design à aparência visual. |
| Pesquisa | Investigação, fundamentação, comparação, validação e melhoria dos artefatos e modelos. | Relacionar pesquisa à aprendizagem, validação e evolução do sistema. |
Estrutura recomendada da pasta Arquitetura
A estrutura abaixo organiza a raiz como área de páginas estruturantes e as subpastas como famílias especializadas.
Como decidir se uma página fica na raiz ou em subpasta?
| Pergunta | Se a resposta for sim | Destino provável |
|---|---|---|
| A página orienta a área Arquitetura inteira? | Ela tem papel estruturante, integrador ou de referência geral. | Raiz de arquitetura/. |
| A página detalha apenas um padrão específico? | Ela aprofunda uma parte de uma família maior. | arquitetura/padroes/. |
| A página é um modelo reutilizável? | Ela serve como forma ou estrutura reaplicável. | arquitetura/modelos/ ou arquitetura/templates/. |
| A página representa visualmente relações? | Ela contém grafo, diagrama ou mapa visual específico. | arquitetura/grafos/ ou arquitetura/diagramas/. |
| A página registra uma regra específica de arquitetura? | Ela é normativa ou criterial. | arquitetura/regras/ ou Governança, conforme escopo. |
| A página é rascunho, duplicata ou versão antiga? | Ela ainda pode ter valor, mas não deve concorrer com a estrutura ativa. | arquitetura/_avaliar/. |
index_arquitetura.html.
Função das subpastas da Arquitetura
| Subpasta | Família de conteúdo | Função | Exemplos possíveis |
|---|---|---|---|
padroes/ |
Padrões arquiteturais específicos. | Detalhar padrões de navegação, cards, breadcrumbs, páginas relacionadas, menus e blocos. | padrao_breadcrumbs_ola.html, padrao_paginas_relacionadas_ola.html. |
modelos/ |
Modelos reutilizáveis. | Guardar modelos conceituais ou estruturais aplicáveis a várias páginas. | modelo_pagina_ancora.html, modelo_index_area.html. |
templates/ |
Templates copiáveis. | Guardar HTML-base ou componentes reutilizáveis. | template_pagina_ola.html, template_objeto_aprendizagem.html. |
grafos/ |
Grafos e redes. | Guardar visualizações relacionais especializadas da arquitetura. | grafo_arquitetura_ola.html, grafo_motores_ola.html. |
diagramas/ |
Diagramas explicativos. | Representar blocos, fluxos, componentes e relações. | diagrama_blocos_ola.html, diagrama_fluxo_entrada_analise.html. |
processos/ |
Processos e pipelines. | Organizar fluxos de criação, revisão, validação, publicação e evolução. | pipeline_criacao_pagina_ola.html. |
linguagem/ |
Linguagem arquitetural. | Organizar rótulos, termos, expressões, padrões textuais e nomenclatura da arquitetura. | linguagem_navegacao_ola.html. |
regras/ |
Regras arquiteturais específicas. | Registrar decisões de arquitetura que não são regras gerais de Governança. | regra_uso_subpastas_arquitetura.html. |
principios/ |
Princípios arquiteturais. | Registrar princípios orientadores da arquitetura do OLA. | principio_navegacao_significativa.html. |
_avaliar/ |
Quarentena arquitetural. | Guardar arquivos que ainda não devem ser apagados nem considerados ativos. | Versões antigas, duplicatas, rascunhos, pastas M0–M3 antigas. |
Ciclo de Organização Arquitetural
A organização da Arquitetura deve seguir um ciclo simples, para evitar que novas páginas sejam criadas sem posição clara no sistema.
Dimensão cognitiva
Identifica o papel conceitual da página no sistema OLA.
Dimensão organizacional
Decide onde a página fica e com que área se relaciona.
Dimensão técnica
Materializa o arquivo HTML, links, menus, breadcrumbs e padrões.
Dimensão operacional
Atualiza index, mapa, páginas relacionadas, checklist e manutenção.
Checklist para criar ou mover uma página em Arquitetura
1. A página tem papel estruturante ou especializado?
Se for estruturante, deve ficar na raiz. Se for aprofundamento de uma família de conteúdo, deve ir para uma subpasta.
2. O vocábulo principal está claro?
Identificar se a página trata de sistema, arquitetura, camada, dimensão, eixo, método, padrão, modelo, template, processo, regra, design ou pesquisa.
3. Existe duplicidade?
Verificar se já existe página semelhante na raiz, em subpasta ou em
_avaliar/.
4. O index precisa ser atualizado?
Toda página ativa relevante deve estar acessível a partir de
index_arquitetura.html.
5. O mapa precisa ser atualizado?
Se a página altera relações arquiteturais, deve ser incluída ou referenciada
em mapa_arquitetura.html.
6. Há relação com Governança?
Se a página cria regra, critério ou padrão, deve se conectar ao
quadro_regras_ola.html ou a outra página de Governança.
7. Há relação com Fundamentos?
Se a página define vocábulo, conceito ou base teórica, deve se conectar ao vocabulário, ontologia, epistemologia ou framework do OLA.
Páginas relacionadas
Índice da Arquitetura
Porta de entrada operacional para localizar páginas e famílias da área.
Mapa da Arquitetura
Página âncora para visualizar relações conceituais e estruturais da arquitetura.
Padrões de Navegação
Define breadcrumbs, menus, hubs, índices internos, páginas relacionadas e próximos passos.
Sistema de Navegação do OLA
Explica a navegação como sistema de orientação cognitiva, articulando breadcrumb, jornada, trilha, persona, mapa, grafo, próximos passos e caminhos físico, lógico, conceitual e semântico.
Quadro de Regras do OLA
Registra regras gerais de governança que orientam a arquitetura.
Vocabulário do OLA
Define termos centrais como sistema, dimensão, camada, eixo, método, design, pesquisa e arquitetura.
Próximos passos sugeridos
- Salvar esta página como
arquitetura/organizacao_arquitetura.html. - Garantir link para ela em
index_arquitetura.html. - Garantir link para ela em
mapa_arquitetura.html. - Revisar se
sistema_navegacao_ola.htmlepadroes_navegacao_ola.htmlestão na raiz dearquitetura/, cada uma com função própria. - Verificar se a estrutura física atual da pasta Arquitetura corresponde à regra raiz/subpastas.
- Mover arquivos duplicados, antigos ou incertos para
_avaliar/. - Atualizar
governanca/quadro_regras_ola.htmlcom referência a esta regra e à regra de orientação de navegação, caso ainda não exista. - Atualizar o
readme.htmlgeral se ele ainda apresentar uma lógica antiga de organização por M0–M3 como pastas.