GTI — ADR: Architecture Decision Record (S)

O que é

O ADR (Architecture Decision Record) documenta uma decisão arquitetural significativa e (potencialmente) irreversível no âmbito da GTI (Governança de TI). Deve conter contexto, alternativas consideradas, decisão tomada e consequências.

Variantes no mesmo tipo documental: ADR de privacidade (PDP) · ADR de dados (GDA)

Como usar

Abra um ADR em estado proposta antes de comprometer a organização com tecnologia, padrão ou fornecedor difícil de reverter.
Após aprovação (aceita), alterações passam por novo ADR que substitua o anterior — não edite o histórico da decisão aceite.
Marque impacto-em-pdp: true quando a decisão afetar tratamento de dados pessoais; alinhe com o PDP antes da implementação.
Ver também: Ciclo de status e Regras do ADR abaixo.

Exemplo

---
id: GTI-ADR-0001
tipo: ADR
titulo: "Escolha do banco de dados — PostgreSQL"
status: aceita   # proposta | aceita | rejeitada | substituida | depreciada
autor: fulano.de.tal
data: 2026-04-11
substitui: null
substituido-por: null
impacto-em-pdp: false
---

contexto: >
  A solução precisa de um banco relacional com suporte a JSONB para dados semi-estruturados
  e com extensão PostGIS para dados geográficos.

alternativas-consideradas:
  - MySQL 8: descartado por limitações com JSONB e PostGIS
  - MongoDB: descartado por ausência de suporte a transações ACID complexas
  - PostgreSQL: escolhido

decisao: >
  Adotar PostgreSQL 16 como banco de dados principal.

consequencias:
  positivas:
    - Suporte nativo a JSONB e PostGIS
    - Extenso suporte da comunidade e ecossistema
  negativas:
    - Equipe precisa de capacitação em administração PostgreSQL

Onde se aplica

Destino	Link / caminho
Framework GTI	/framework/gti/
Índice GTI (artefatos)	/artefatos/gti/
Monorepo	`artefatos/GTI (Governança de TI)/03-decisoes/` (padrão de pastas do PV)
ESP / IMP / INF	Quando a decisão atravessa requisitos (ESP), construção (IMP) ou infra (INF)
ADR PDP	/artefatos/pdp/adr/
ADR GDA	/artefatos/gda/adr/
Convenções	/framework/referencias/#115-tipos-documentais-complementares

Ciclo de status do ADR

Status	Significado
`proposta`	Rascunho aberto para discussão
`aceita`	Decisão aprovada — entra em vigor
`rejeitada`	Proposta recusada — mantida para histórico
`substituida`	Superada por ADR mais recente (campo `substituido-por`)
`depreciada`	Ainda válida mas em fase de saída

Regras do ADR

Uma vez aceito, um ADR só pode ser alterado por um novo ADR que o substitua.
ADRs rejeitados são mantidos para registro histórico — nunca excluir.
ADRs com impacto em privacidade (impacto-em-pdp: true) devem ser comunicados ao PDP antes da implementação.
Toda decisão arquitetural significativa exige ADR — inclusive a decisão de não mudar algo.
O contexto deve descrever por que a decisão foi necessária, não apenas o que foi decidido.

← Índice GTI · RFC →