OLA-M3-RA-SMI-002 — Separação Modelo × Instância

Regra arquitetural (M3) que define onde deve viver o modelo OLA (princípios, métodos e governança) e onde devem viver livros instanciados (sistemas concretos).

M3 regra M2 método M1 artefatos M0 evidência
Identificação
ID: OLA-M3-RA-SMI-002
Nome curto: Separação Modelo × Instância
Tipo: Regra arquitetural (M3)
M3 Regra
Frase canônica
No OLA, o modelo arquitetural do livro (princípios, métodos e governança) deve ser separado das instâncias concretas de livros, que devem existir como sistemas autônomos (domínio ou subdomínio próprio), explicitamente governados pelo modelo central.
Intenção
Evitar mistura de arquitetura e conteúdo específico, reduzir acoplamento, melhorar manutenção e permitir escalar para múltiplas instâncias de livros sem perder clareza.
Enunciado normativo
O site do OLA (modelo) é M3/M2 dominante; livros instanciados são M1/M0 dominantes e devem viver fora do modelo.
MUST (obrigatório)
  • MUST o domínio do modelo OLA conter apenas: princípios (M3), métodos/trilhas base (M2), padrões/templates (M1) e governança.
  • MUST cada livro instanciado existir fora do site do modelo, como domínio próprio (preferencial) ou subdomínio dedicado.
  • MUST toda instância declarar explicitamente: “Instância OLA” e a versão do modelo que a governa.
SHOULD (recomendado)
  • SHOULD instâncias terem identidade própria (nome, público, escopo e objetivos).
  • SHOULD vínculo com OLA ocorrer via rodapé institucional + “Sobre este livro” + link para arquitetura.
  • SHOULD o modelo OLA não depender de nenhuma instância específica (evita acoplamento reverso).
Estrutura recomendada (domínios e responsabilidades)
Modelo (OLA — M3/M2 dominante):
meulivro.info ├─ arquitetura/ ├─ principios/ ├─ metodos/ ├─ padroes/ └─ governanca/
Instância (ex.: Teoria das Categorias — M1/M0 dominante):
Opção A (subdomínio): categorias.meulivro.info Opção B (domínio próprio): teoriadascategorias.info
Anti-padrões (evitar)
  • Livro específico como pasta do OLA: meulivro.info/teoria-das-categorias
  • Conteúdo didático profundo misturado com princípios M3.
  • Instância alterando regras do modelo (acoplamento reverso).
  • Livro instanciado sem declarar “Instância OLA” e sem link para o modelo.
Relação com o Princípio M3 “Evolução Controlada”
Esta regra implementa operacionalmente o princípio de Evolução Controlada: o modelo evolui lentamente (M3/M2), as instâncias evoluem rapidamente (M1/M0), e a evidência nasce nas instâncias para depois consolidar padrões no modelo.
Checklist rápido (uso prático)
  • [ ] Este site é modelo ou instância?
  • [ ] Se for instância: tem domínio/subdomínio próprio?
  • [ ] Declara “Instância OLA” e a versão do modelo?
  • [ ] Mantém o modelo livre de conteúdo específico?