Propósito
Este documento serve como “How-to” corporativo para arquitetos de software na EximiaCo. Ele define regras, artefatos e processos fundamentais para conduzir qualquer projeto de software, garantindo consistência, alinhamento estratégico e conformidade com as políticas da empresa.
1. Objetivo e Escopo
- Objetivo: Padronizar a abordagem de arquitetura de software em todos os produtos e iniciativas da EximiaCo.
- Escopo:
- Todos os novos produtos e grandes evoluções de sistemas existentes.
- Governança de artefatos, estilos e decisões arquiteturais.
2. Princípios Arquiteturais Corporativos
- Alinhamento Estratégico
- Toda decisão arquitetural deve mapear-se a um objetivo de negócio ou KPI corporativo.
- Visão Sistêmica
- Entender o produto como parte de um portfólio: integrações, dependências e impactos.
- Qualidade e Restrições
- Definir atributos de qualidade (performance, segurança, escalabilidade) e restrições (legais, orçamentárias, tecnológicas) desde o início.
- Independência de Cloud
- Soluções devem ser desenhadas de forma agnóstica ao provedor de nuvem.
- Conformidade
- Seguir políticas de autenticação, observabilidade e radar de tecnologia da EximiaCo.
3. Fases do Processo Arquitetural
- Iniciação
- Explicitar o alinhamento estratégico com iniciativas da eximiaco (DEFINIR DOCUMENTO)
- Definição de stakeholders e escopo de alto nível
- Elaboração
- Haiku Arquitetural (DEFINIR TEMPLATE)
- Diagrama C4 (Contexto e Containers)
- Estilo arquitetural predominante
- Construção do Blueprint
- Desenho de Solution Architecture (infra-estrutura, segurança, CI/CD)
- Mapa de dados e fluxos de integração com aplicações existentes (DEFINIR TEMPLATE)
- Revisão de conformidade (OAuth2, observabilidade)
- Produção de playbook arquitetural (DEFINIR TEMPLATE)
4. Artefatos Obrigatórios
| Artefato | Descrição | Quando entregar |
|---|---|---|
| Relação com Estratégia | Mapa que vincula features e objetivos de produto aos KPIs corporativos | Fase de Iniciação |
| Haiku Arquitetural | 3 versos (negócio / restrições / qualidade) + lista de integrações principais | Fase de Elaboração |
| Diagrama C4 | System Context e Containers | Fase de Elaboração |
| Estilo Arquitetural | Monolito, Microsserviços, Event-Driven, etc., com justificativa | Fase de Elaboração |
| Solution Architecture | Infraestrutura homologação e produção (cloud-agnostic, rede, segurança, deploy) | Fase de Blueprint |
| Mapa de Dados & Integrações | Entidades, fluxos, sistemas impactados | Fase de Blueprint |
| Checklist de Conformidade | Autenticação, autorização, observabilidade, radar de tecnologia | Fase de Blueprint |
5. Conformidade e Políticas Corporativas
- Autenticação
- Serviço único: Keycloak (federação Google para internos)
- SPAs: OAuth2 Authorization Code + PKCE
- APIs públicas: API Key ou Client Credentials
- Cloud-Agnostic
- Sem recursos proprietários de nuvem
- Repositórios & CI/CD
- Mono-repo ou multi-repo alinhado à team topology e pipelines seletivos
- Radar de Tecnologia
- Só usar linguagens, frameworks e serviços do radar tecnologico
- Observabilidade
- OpenTelemetry para métricas, logs e traces
- Dashboards e alertas integrados a Grafana
6. Papéis e Responsabilidades
| Papel | Responsabilidades Principais |
|---|---|
| Arquiteto Corporativo | Define diretrizes, mantém ontologia, aprova governança geral |
| Arquiteto de Solução | Produz artefatos, conduz workshops, aplica práticas no produto |
| Líder Técnico | Implementa, garante qualidade de código e conformidade operacional |
| Comitê de Arquitetura | Revisão final, troca de lições aprendidas, atualização de padrões |
8. Governança e Manutenção
- Revisões Periódicas: semestrais, ou após grandes mudanças estratégicas
- Comitê de Arquitetura: reúne lições aprendidas e atualiza diretrizes
- Auditoria de Conformidade: integração com SRE e Segurança para validar observabilidade e autenticação
Este documento deve estar sempre acessível na ontologia de Arquitetura EximiaCo e referenciado em todos os kick-offs de novos projetos.
