Skip to content

Latest commit

 

History

History
56 lines (35 loc) · 2.26 KB

README.pt.md

File metadata and controls

56 lines (35 loc) · 2.26 KB

Registros de Decisões Arquiteturais (ADR)

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:


📜 O que é um ADR?

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.


🛠️ Processo para Adicionar um Novo ADR

Siga estes passos ao criar um novo ADR:

  1. Identifique a Decisão
    Defina claramente o problema ou desafio que levou à decisão.

  2. 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.
  3. Use o Modelo
    Copie e personalize o modelo de ADR fornecido para estruturar o documento. Certifique-se de preencher todas as seções relevantes.

  4. Atualize a Lista de ADRs
    Adicione manualmente o novo ADR à lista neste arquivo README.md na seção Lista de ADRs.

🗂️ 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

🖋️ Modelo

Consulte o arquivo Modelo de ADR para criar novos ADRs.


📚 Referências