Pular para conteúdo

Architecture Decision Records (ADRs)

Registro das decisões arquiteturais significativas tomadas ao longo do desenvolvimento da plataforma AMia.

O que é um ADR?

Um ADR documenta uma decisão de arquitetura importante, incluindo o contexto que levou à decisão, a decisão em si e suas consequências. ADRs são imutáveis — quando uma decisão é revisada, o ADR original é marcado como depreciado e um novo ADR é criado.

Status possíveis

Status Significado
🟡 Proposto Decisão em análise — ainda não ratificada pelo time
✅ Aceito Decisão ratificada e em vigor
❌ Depreciado Decisão substituída por um ADR mais recente

Registro de ADRs

ADR Título Status Data
ADR-001 Uso de Mermaid para diagramas de arquitetura ✅ Aceito 2026-06-10
ADR-002 MkDocs com tema Material para documentação ✅ Aceito 2026-06-10
ADR-003 Prompt As Code — prompts versionados em repositório Git ✅ Aceito 2026-06-10
ADR-004 Azure Static Web Apps para hospedagem da documentação ✅ Aceito 2026-06-10
ADR-005 amIA-Ingest: serviço dedicado de ingestão e busca vetorial ✅ Aceito 2026-06-12
ADR-006 Schema ams no PostgreSQL para isolamento de contexto de módulos ✅ Aceito 2026-06-12

Como adicionar um novo ADR

  1. Copie o template _template.md desta pasta
  2. Nomeie o arquivo adr-NNN-titulo-kebab-case.md
  3. Preencha todas as seções
  4. Adicione a entrada na tabela acima
  5. Atualize o mkdocs.yml com a nova página