Este diretório contém os Registros de Decisões Arquiteturais (ADRs) do projeto.
Cada ADR documenta uma decisão significativa tomada durante o desenvolvimento do sistema, garantindo rastreabilidade e compreensão das escolhas arquiteturais.
📚 Leia em:
- 🇬🇧 English
Um Registro de Decisão Arquitetural (ADR) é um documento que captura uma decisão arquitetural importante, juntamente com seu contexto e consequências. Isso ajuda a manter a transparência e fornece uma referência para revisitar decisões no futuro.
Siga estes passos ao criar um novo ADR:
-
Identifique a Decisão
Defina claramente o problema ou desafio que levou à decisão. -
Crie um Novo Arquivo ADR
Use a seguinte convenção de nomenclatura para o arquivo:
NNNN-titulo-da-decisao.md
NNNN
: Um número sequencial com zeros à esquerda (ex.:0001
).titulo-da-decisao
: Um título curto e descritivo em letras minúsculas, com palavras separadas por hífens.
-
Use o Modelo
Copie e personalize o modelo de ADR fornecido para estruturar o documento. Certifique-se de preencher todas as seções relevantes. -
Atualize a Lista de ADRs
Adicione manualmente o novo ADR à lista neste arquivoREADME.md
na seção Lista de ADRs.
# | Título | Status | Data |
---|---|---|---|
0001 | Adotar REST para Comunicação de API | Aceito | 2024-12-31 |
0002 | Usar MySQL como Banco de Dados Primário | Aceito | 2024-12-31 |
0003 | Usar Kafka para Streaming de Eventos | Aceito | 2024-12-31 |
Consulte o arquivo Modelo de ADR para criar novos ADRs.