Visualização das 5 dimensões da documentação + 2 seções de apoio. Diagrama mostra como cada parte se conecta e quando consultar cada uma .
Diagrama de articulação
FRENTES ESTRATÉGICAS Entregas concretas com objetivo institucional sites · dados · GPU · IDP · apps acadêmicas articula CAPACIDADES TRANSVERSAIS Requisitos horizontais que atravessam todas as camadas IAM · Secrets · Certs · Obs · CI/CD · Supply · Segurança · Backup · Governança atravessa CAMADAS (bottom-up) Arquitetura técnica 9 — Workloads 8 — Multi-cluster 7 — GitOps (ArgoCD) 6 — K8s networking 5 — K3s runtime 4 — Ingress 3 — Edge networking 2 — Backup (PBS) 1 — Storage (LINSTOR) 0 — Virtualização (Proxmox + Pulumi/Ansible) Cada camada usa a anterior como base manutenção evolução OPERAÇÕES Manutenção e execução rotineira runbooks · incidentes · upgrades ROADMAP Sequência temporal de evolução caminho crítico · ADRs · fases
Como ler o diagrama
Setas verticais = articulação (frentes articulam transversais que atravessam camadas)
Caixas roxas/azuis/verdes = as 3 dimensões centrais (frentes, transversais, camadas)
Caixas vermelha/laranja = dimensões de tempo (operações = agora; roadmap = futuro)
Pergunta-chave de cada dimensão
🟣 Frentes estratégicas
Que entregas concretas articulam camadas + transversais?
Sites · Plataforma de Dados · GPU distribuída · IDP · Apps acadêmicas
Ver →
🔵 Capacidades transversais
Que requisitos atravessam todas as camadas?
IAM · Secrets · Certs · Observabilidade · CI/CD · Supply chain · Segurança · Backup · Governança
Ver →
🟢 Camadas
Como cada parte da infra funciona tecnicamente?
10 camadas bottom-up: Virtualização → Storage → Backup → Rede → Ingress → K3s → Cilium → GitOps → Multi-cluster → Workloads
Ver →
🔴 Operações
Como a infra é mantida e executada hoje?
Runbooks · rotinas semanais/mensais · procedimentos de emergência · lessons learned · incidentes
Ver →
🟠 Roadmap
Em que sequência tudo evolui ao longo do tempo?
Caminho crítico (próximos PRs) · 10 fases ordenadas · 9 ADRs · decisões deferidas
Ver →
📚 Apoio: Fundamentos
Que conhecimento mínimo eu preciso?
Redes · Linux · Programação · Containers · Kubernetes · IaC
Ver →
Decision tree: por onde começar?
Operações — procedimentos rotineiros e emergência
Camadas — encontrar a camada do componente afetado
Dentro da camada: ler conceitos + runbooks específicos
Se for incidente novo: documentar como runbook depois
Diagrama: o que NÃO é cada dimensão
Pra evitar confusão, aqui está o que cada dimensão NÃO é — onde ela diferencia das outras.
CAMADAS Arquitetura técnica É: • Como Cilium funciona • Como Tutor é instalado • Como LINSTOR replica • Manifests, configs NÃO é: • Política horizontal • Estratégia institucional • Sequência temporal • Runbook de execução Pergunta: Como funciona tecnicamente? Atualização: Eixo contínuo TRANSVERSAIS Requisitos horizontais É: • Política de secrets • Diretriz de IAM • Princípio audit FAPESP • Padrão de TLS NÃO é: • Tecnologia específica • Configuração concreta • Runbook semanal • Plano com prazos Pergunta: Que requisitos atravessam tudo? Atualização: Eixo contínuo FRENTES Entregas concretas É: • “Plataforma de dados” • “GPU como serviço” • Estratégia institucional • Onboarding de grupo NÃO é: • Tecnologia (vai p/ camada) • Política (vai p/ transv.) • Runbook (vai p/ ops) • Cronograma (vai p/ roadmap) Pergunta: Que entrega articula tudo? Atualização: Por entrega OPERAÇÕES Manutenção rotineira É: • Runbook de backup • Calendário mensal • Procedimento emergência • Notas de incidentes NÃO é: • Decisão arquitetural • Plano futuro • Estratégia de entrega • Conceito tecnológico Pergunta: Como mantemos no dia-a-dia? Atualização: Memória viva ROADMAP Eixo temporal É: • Caminho crítico • 10 fases ordenadas • ADRs vigentes • Decisões deferidas NÃO é: • “O quê” entregar • Manual operacional • Política de governança • Conceito técnico Pergunta: Em que sequência? Atualização: Por fase
Risco de duplicação evitado
A diferenciação acima evita o erro mais comum: mesmo conteúdo aparecendo em várias dimensões . Por exemplo, “Tutor / Open edX” aparece em:
Camada 9 (técnica): manifests, configs, Helm values
Frente “Aplicações acadêmicas” (estratégica): governança, LGPD, ciclo de vida
Operações (rotina): runbook de backup do Tutor
Roadmap (temporal): “Tutor SP entra Fase 9”
Cada um com foco diferente . Não há repetição — há articulação.
Como cada dimensão se atualiza
🟢 Camadas
Eixo contínuo de manutenção técnica.
Atualização: a cada upgrade, mudança de versão, novo componente. Cada camada é “viva” — revisitada conforme tecnologia evolui.
🔵 Transversais
Eixo contínuo de política horizontal.
Atualização: a cada nova ferramenta de IAM, secret management, etc. Política se aprimora conforme requisitos institucionais mudam (ex: novo LGPD).
🟣 Frentes estratégicas
Por entrega.
Atualização: quando entrega avança fase, quando escopo muda, quando frente se “completa” e vira rotina (absorvida em camada/transversal).
🔴 Operações
Memória viva.
Atualização: a cada incidente resolvido, runbook atualizado, lesson learned registrada. Histórico via git.
🟠 Roadmap
Por fase de implementação.
Atualização: quando fase avança, quando ADR novo entra, quando decisão deferida volta a ser avaliada (gatilhos objetivos).
Resumo em 1 frase
Camadas explicam como funciona; transversais explicam o que tem que ser garantido; frentes explicam o que entregar; operações explicam como manter; roadmap explica em que ordem evoluir.
Catálogo visual
Os ~47 componentes em três perspectivas interativas — pirâmide de camadas, mapa de domínios e jornada de dados.
→ Abrir Catálogo visual