Competência 6 — Documentação de arquitetura e ADRs

[mellyssamnds]

O que foi feito

Documentação da arquitetura da solução implantada nas Competências 3-5, incluindo diagrama, decisões técnicas e análise de trade-offs.

Arquivos adicionados

• docs/architecture.md

  • Diagrama de arquitetura (Mermaid, nível C4/Container)
  • Tabela de componentes da solução
  • Requisitos não-funcionais (disponibilidade, latência, escalabilidade, custo)
  • Estilo arquitetural (monolito em camadas)
  • Tabela de trade-offs das principais decisões
  • Pontos de melhoria e próximos passos

• docs/adr/001-kubernetes-deploy.md

  • Decisão de usar K3s em VM para o deploy da aplicação

• docs/adr/002-dbaas-postgresql.md

  • Decisão de usar PostgreSQL gerenciado (DBaaS) da Magalu Cloud

Checklist

• Diagrama Mermaid renderizando corretamente
• Tabela de componentes
• Requisitos não-funcionais com métricas e alvos numéricos
• Estilo arquitetural nomeado
• Tabela de trade-offs preenchida
• ADR 001 (Kubernetes) com Contexto, Alternativas, Decisão e Consequências
• ADR 002 (DBaaS PostgreSQL) com Contexto, Alternativas, Decisão e Consequências
• Pontos de melhoria identificados