Decisiones de arquitectura (ADR)¶
Un ADR registra una decisión técnica importante, su contexto y sus consecuencias.
Índice¶
Cuándo crear un ADR¶
- Cambio de stack o framework.
- Cambio de base de datos, caché o cola.
- Nuevo patrón de integración entre servicios.
- Decisión de seguridad o multi-tenant.
- Cualquier decisión que sea costosa de revertir.
Formato¶
# ADR NNNN - Título
## Estado
Propuesto | Aceptado | Reemplazado | Deprecado
## Contexto
¿Qué problema o fuerza motiva la decisión?
## Decisión
¿Qué se decidió?
## Consecuencias
¿Qué mejora, qué empeora y qué queda pendiente?
Los ADRs son inmutables: si una decisión cambia, se crea uno nuevo que reemplaza al anterior.