ADRs

Registro da decisão vigente. O contexto explica o problema. A decisão é a escolha. As consequências dizem o que passa a ser obrigatório. Uma decisão substituída não é apagada: o status muda para substituída e o texto aponta para o ADR novo.

Status

proposta, aceita, substituída.

Nome do arquivo

Decisão de plataforma: docs/mudancas/adr/AAAA-MM-DD-assunto.md.

Decisão de um produto ou contrato: prefixo do contexto, como zesalgados- ou pdv-sales-.

Modelo

# ADR: título

**Status:** proposta
**Data:** AAAA-MM-DD

## Contexto

## Decisão

## Consequências

## Alternativas

Registro

Data	Decisão	Contexto	Status
2026-03-25	Stack CDK por domínio	Plataforma	Aceita
2026-03-25	Versionamento da API por path	Plataforma	Aceita
2026-03-25	Logs estruturados sem PII	Plataforma	Aceita
2026-04-05	CQRS incremental com Athena em pedidos	Sales	Aceita
2026-04-05	Envelope único de evento	Sales, Delivery, Audit	Aceita
2026-10-13	Acesso ao DynamoDB em fases	Plataforma	Aceita
—	PDV e Sales não se importam	PDV, Sales	Aceita
—	Product publica catálogo para o PDV	Product, PDV	Aceita
—	Person publica pessoas para o PDV	Person, PDV	Aceita

Os três contratos de PDV estavam nos pacotes compartilhados, sem data no original.

Decisão que também obriga um front fica no wmreis-docs. A decisão da interface do Zé Salgados fica no zesalgados-docs.