Architecture Decision Records (ADRs)
Registros de decisões arquiteturais importantes tomadas no desenvolvimento do Filament Core Suite.
O que são ADRs?
Architecture Decision Records (ADRs) são documentos que capturam decisões arquiteturais importantes, incluindo:
- Contexto: Por que a decisão foi necessária
- Decisão: O que foi decidido
- Consequências: Impactos positivos e negativos da decisão
- Status: Proposto, Aceito, Rejeitado, Descontinuado, Substituído
ADRs deste Projeto
Decisões de Arquitetura
- ADR-001: Arquitetura Monorepo - Aceito
- ADR-002: Estratégia Contracts-First - Aceito
- ADR-003: Event-Driven Communication - Aceito
- ADR-007: Spatie Laravel Data para Objetos de Dados - Aceito
Decisões de Ferramentas
- ADR-004: VitePress para Documentação - Aceito
- ADR-005: Markdown como Formato Único - Aceito
Decisões de Processo
Como Usar
Criar Novo ADR
- Copie o template:
cp docs/adr/template.md docs/adr/XXX-nome-decisao.md - Preencha as seções seguindo o formato
- Adicione link neste índice
- Abra PR para discussão
Status Possíveis
- Proposto: Em discussão, não implementado
- Aceito: Decisão tomada e implementada
- Rejeitado: Proposta considerada mas não aceita
- Descontinuado: Era aceito mas não é mais seguido
- Substituído: Substituído por outro ADR (indicar qual)
Template
Veja template.md para estrutura padrão de um ADR.