1. Finalidade
A finalidade desta página é orientar a organização da visão “Sistema” no OLA, evitando que o conceito de sistema fique disperso entre páginas de arquitetura, governança, fundamentos, domínios e projeto.
2. Problema resolvido
O problema resolvido por esta página é estabelecer uma regra de organização para o tema “Sistema” no OLA.
Situação sem organização
O conceito de sistema aparece em várias páginas, mas pode ficar fragmentado, sem uma visão explícita de conjunto.
Situação com organização
A visão de sistema passa a ter mapa, página de organização, ligações com arquitetura, fundamentos, governança, domínios e projeto.
3. Papel desta página no OLA
Esta página não substitui o Mapa do Sistema OLA. Ela complementa o mapa.
| Página | Função | Tipo de pergunta que responde |
|---|---|---|
mapa.sistema.html |
Explicita o OLA como sistema. | O que compõe o sistema? Quais são suas partes, relações, entradas, saídas e estados? |
organizacao_sistema.html |
Define como a visão de sistema deve ser organizada e mantida. | Como registrar, conectar, nomear, revisar e evoluir as páginas relacionadas ao sistema? |
4. Escopo da visão Sistema
A visão “Sistema” no OLA deve abranger os elementos necessários para compreender o OLA como um conjunto organizado de partes em interação.
Componentes
Partes internas do OLA, como portal, README, arquitetura, fundamentos, governança, domínios, mapas, índices e artefatos.
Fronteiras
Separação entre o que pertence ao OLA, o que apoia o OLA e o que faz parte do ambiente externo.
Ambiente
Condições externas e internas que influenciam o uso, a construção, a publicação e a evolução do sistema.
Entradas
Perguntas, textos, dúvidas, necessidades, demandas, arquivos, problemas e observações.
Saídas
Páginas, mapas, trilhas, quadros, modelos, regras, artefatos e critérios de evolução.
Estados
Exploração, estruturação, consolidação, uso, refatoração e evolução.
5. Estrutura recomendada para a visão Sistema
Como a visão “Sistema” é transversal, ela pode ficar representada na raiz por páginas sintéticas e conectada às áreas especializadas.
| Elemento | Local recomendado | Função | Observação |
|---|---|---|---|
| Mapa do Sistema | /mapa.sistema.html |
Explicitar o OLA como sistema. | Página de visão geral, localizada na raiz. |
| Organização do Sistema | /organizacao_sistema.html |
Definir como manter a visão sistêmica. | Página operacional e normativa leve. |
| Entradas do OLA | /arquitetura/entradas_ola.html |
Detalhar tipos de entrada. | Fica em arquitetura porque trata de componente funcional. |
| Saídas do OLA | /arquitetura/saidas_ola.html |
Detalhar tipos de saída. | Complementa entradas e funcionalidades. |
| Funcionalidades do OLA | /arquitetura/funcionalidades_ola.html |
Descrever capacidades funcionais do sistema. | Mostra o que o sistema faz. |
| Vocabulário do OLA | /fundamentos/vocabulario_ola.html |
Definir termos usados na visão sistêmica. | Evita confusão entre sistema, ambiente, ecossistema, modelo e método. |
| Quadro de Regras | /governanca/quadro_regras_ola.html |
Registrar regras relacionadas ao sistema. | Conecta organização, navegação, publicação e evolução. |
6. Arquivos relacionados
A visão “Sistema” deve se relacionar com páginas já existentes ou previstas em diferentes áreas do OLA.
Na raiz
index.html— entrada externa do OLA.portal.html— entrada interna do OLA.readme.html— explicação da estrutura geral.mapa.sistema.html— visão sistêmica geral.organizacao_sistema.html— organização da visão sistêmica.
Em áreas especializadas
arquitetura/index_arquitetura.htmlarquitetura/mapa_arquitetura.htmlarquitetura/entradas_ola.htmlarquitetura/saidas_ola.htmlarquitetura/funcionalidades_ola.htmlfundamentos/vocabulario_ola.htmlgovernanca/index_governanca.htmlgovernanca/quadro_regras_ola.html
7. Regra de nomeação
O OLA já utiliza nomes de arquivos com sublinhado em muitas páginas.
Entretanto, a página mapa.sistema.html pode ser mantida
com ponto porque ela funciona como uma página especial da raiz,
explicitando uma visão sistêmica geral.
mapa.sistema.html como página especial de mapa do sistema
na raiz e usar organizacao_sistema.html como página de organização
correspondente.
| Padrão | Quando usar | Exemplo |
|---|---|---|
| Ponto no nome | Quando a página for uma visão especial da raiz ou uma página simbólica de alto nível. | mapa.sistema.html |
| Sublinhado | Quando a página seguir o padrão operacional comum do OLA. | organizacao_sistema.html |
Prefixo index_ |
Quando a página funcionar como porta de entrada de área ou domínio. | index_arquitetura.html |
Prefixo mapa_ |
Quando a página for mapa de uma área, domínio ou tema específico. | mapa_arquitetura.html |
Prefixo organizacao_ |
Quando a página definir regras de organização de uma área ou visão. | organizacao_dominios.html |
8. Relações com outras áreas do OLA
A visão “Sistema” deve funcionar como uma ponte entre as grandes áreas estruturantes do OLA.
| Área | Relação com Sistema | Como conectar |
|---|---|---|
| Portal | Mostra a entrada interna do sistema. | Adicionar card ou link para mapa.sistema.html. |
| README | Explica a estrutura física geral do OLA. | Registrar o mapa do sistema como página de visão integradora. |
| Arquitetura | Materializa o sistema em componentes, fluxos e funcionalidades. | Relacionar sistema com entradas, saídas, funcionalidades e modelos. |
| Fundamentos | Define conceitos que sustentam a leitura sistêmica. | Relacionar com sistema, ambiente, ecossistema, modelo, método, eixo e camada. |
| Governança | Controla evolução, publicação, classificação e padrões. | Registrar regras para novas páginas, domínios, mapas e artefatos. |
| Domínios | Aplicam o sistema a temas e demandas concretas. | Relacionar cada domínio como subsistema de conhecimento aplicado. |
| Projeto | Mostra a construção e evolução do OLA. | Relacionar escopo evolutivo, entregas evolutivas e método de desenvolvimento. |
9. Fluxo de manutenção da visão Sistema
Sempre que uma nova página estrutural for criada, a visão “Sistema” deve ser revisada para verificar se ela altera componentes, relações, entradas, saídas, estados ou regras.
Quando revisar o mapa do sistema?
Quando surgir uma nova área estrutural, uma nova funcionalidade, uma nova política de governança, uma nova classe de entrada/saída ou uma mudança relevante na interpretação do OLA como sistema.
Quando revisar esta página de organização?
Quando houver mudança em regras de nomeação, localização física, relações entre áreas, critérios de evolução ou padrões de navegação.
Quando atualizar a governança?
Quando a mudança deixar de ser apenas local e passar a afetar várias páginas, vários domínios ou a forma geral de evolução do OLA.
10. Critérios de evolução
Uma nova página, domínio ou artefato deve ser analisado quanto ao seu impacto na visão sistêmica do OLA.
| Critério | Pergunta de verificação | Ação recomendada |
|---|---|---|
| Componente | A nova página representa uma parte nova do sistema? | Registrar no mapa do sistema ou em mapa especializado. |
| Entrada | Ela cria novo tipo de entrada para o OLA? | Atualizar arquitetura/entradas_ola.html. |
| Saída | Ela cria novo tipo de artefato ou produto? | Atualizar arquitetura/saidas_ola.html. |
| Funcionalidade | Ela explicita uma nova capacidade do OLA? | Atualizar arquitetura/funcionalidades_ola.html. |
| Governança | Ela exige regra, critério ou política? | Atualizar o quadro de regras ou página de governança correspondente. |
| Domínio | Ela pertence a uma área temática aplicada? | Conectar ao índice, mapa e organização do domínio. |
| Vocabulário | Ela introduz termo importante ou ambíguo? | Atualizar o vocabulário do OLA. |
11. Regras de governança associadas
A visão “Sistema” deve obedecer às regras gerais de governança do OLA e também ajudar a identificar novas regras necessárias.
Regra curta sugerida
Toda página estrutural do OLA deve ser analisada quanto ao seu papel no sistema: componente, entrada, saída, estado, relação, regra, domínio, artefato ou mecanismo de evolução.
Onde registrar
Essa regra pode ser registrada em
governanca/quadro_regras_ola.html, associada às regras
de arquitetura, organização física, navegação e evolução de artefatos.
12. Próximos passos
Depois de criar esta página, os próximos ajustes naturais são:
1. Atualizar o portal
Inserir link para mapa.sistema.html e, se necessário,
para organizacao_sistema.html.
2. Atualizar o README
Registrar que a raiz contém páginas de visão sistêmica do OLA.
3. Atualizar arquitetura
Relacionar a visão de sistema com entradas, saídas, funcionalidades e modelo relacional de uso e evolução.
4. Atualizar governança
Incluir regra sobre análise sistêmica de novas páginas estruturais.
5. Atualizar fundamentos
Verificar se o vocabulário diferencia bem sistema, ambiente, ecossistema, projeto, modelo e método.
6. Atualizar domínios
Reforçar que cada domínio pode evoluir para um sistema de conhecimento aplicado.