academia/docs/architecture/decisions/README.md

963 B

Architecture Decision Records (ADR)

Registro de decisiones arquitectónicas del proyecto.

Índice

ADR Título Estado
ADR-001 Clean Architecture Aceptado
ADR-002 GraphQL vs REST Aceptado
ADR-003 Signals vs RxJS Aceptado
ADR-004 Estrategia de Validación Aceptado

Formato ADR

Cada ADR sigue el formato:

  1. Título: Nombre descriptivo
  2. Estado: Propuesto | Aceptado | Deprecado | Reemplazado
  3. Contexto: Por qué se necesita esta decisión
  4. Decisión: Qué se decidió
  5. Consecuencias: Positivas y negativas
  6. Alternativas: Opciones consideradas y descartadas

Convenciones

  • Nuevos ADRs: ADR-XXX-nombre-descriptivo.md
  • Nunca modificar ADRs aceptados (crear uno nuevo que lo reemplace)
  • Mantener este índice actualizado