Registro de decisión técnica

Qué es

Un registro de decisión técnica, conocido también como ADR por sus
siglas en inglés, es una explicación breve de una elección que tiene
consecuencias para el diseño. Indica qué decidió el equipo, qué
circunstancias motivaron la decisión, qué otras opciones se
estudiaron y qué efectos se aceptaron. Puede tratar sobre la
responsabilidad de conservar ciertos datos, el límite entre
servicios, una integración o la conducta prevista ante un fallo. Una
persona que se incorpora después puede entender por qué existe el
diseño y comprobar cuáles de sus supuestos siguen vigentes.

Unos pocos campos bastan para que el registro se pueda consultar. El
identificador y la fecha permiten citarlo. El estado indica si es
una propuesta, una decisión vigente o una decisión sustituida. El
contexto explica el problema y las restricciones. La decisión dice
qué se va a hacer. Las consecuencias recogen tanto lo que se gana
como el trabajo que queda por asumir. Puede que se incorpore un
servicio que habrá que mantener, que la transición se alargue o que
alguien tenga que ensayar una migración. Las alternativas se
describen con el detalle necesario para entender por qué se eligió
una opción.

Elija un lugar conocido por quienes deban leer el registro. Un
equipo puede guardar archivos Markdown junto al código y enlazarlos
desde el cambio que pone en práctica la decisión. Un proyecto
repartido entre varios repositorios puede usar un índice común. Lo
más útil es que el texto tenga una dirección estable y una
justificación comprensible por sí sola. Desde allí se puede remitir
a los informes, mediciones o pruebas que motivaron la elección.

Por qué importa

El código explica buena parte de lo que existe ahora. La historia se
deduce solo en parte. Una persona puede ver dos bases de datos y
pensar que hay que unificarlas. Tal vez la separación se eligió para
limitar un riesgo mientras un proveedor cambiaba el formato de sus
exportaciones. Un registro puede aclarar qué se protegía, por qué se
tomó esa decisión y qué acontecimiento permitiría reconsiderarla.
Evita repetir la investigación cada vez que cambia el equipo.

El registro también permite formular objeciones concretas. Un nuevo
componente puede evitar que el equipo escriba su propio
planificador. A cambio, la persona de guardia tendrá que saber cómo
recuperar el estado de ese componente. Una revisora puede preguntar
si existe esa capacidad y cuánto cuesta mantenerla. El razonamiento
también queda al alcance del equipo de operaciones antes de que la
elección se adopte. Tras la entrega, la misma explicación ayuda a
situar responsabilidades.

Dedique el esfuerzo en proporción al coste de cambiar de idea. Un
texto nuevo en un botón suele quedar suficientemente explicado en el
historial. Mover la responsabilidad del registro de pedidos o
cambiar la gestión de pagos duplicados tiene efectos en varias
partes del sistema. Conviene registrar la decisión mientras se
recuerdan las opciones y las pruebas disponibles. Una referencia
fechada permite saber qué datos tenía el equipo cuando decidió.

Cómo se aplica en la práctica

La página sobre las decisiones técnicas fundacionales de una
plataforma describe la elección de tecnologías centrales mientras se
definía la dirección del producto. Ese trabajo ilustra el tipo de
decisión que merece conservarse. El siguiente ejercicio ficticio
muestra cómo se podría registrar una decisión sobre la gestión de
datos.

Supongamos que un servicio de envíos tiene una base de datos de
pedidos y una página pública que permite a cada cliente consultar
los suyos. Algunos eventos de expedición llegan tarde. La página no
puede mostrar información de otro cliente. El equipo decide servir
el estado desde un modelo de lectura separado, alimentado únicamente
con los campos aprobados. Consultar de forma directa la base de
pedidos exigiría menos componentes y, normalmente, mostraría datos
más recientes. También acercaría el tráfico público y un nuevo
control de acceso al registro principal. Reutilizar una exportación
nocturna sería sencillo, a costa de dejar fuera los cambios del día.

Los efectos del diseño se pueden convertir en acciones. El personal
de soporte necesita un indicador de antigüedad para saber cuándo
recurrir a la consulta interna. Una prueba del contrato ayuda a
detectar campos que se hayan añadido por error. El proceso de
actualización y su alerta quedan a cargo de alguien. El acuerdo fija
una revisión si el retraso supera el umbral durante dos semanas de
demanda alta, o si cambia el requisito de aislamiento. Un enlace a
la prueba y al análisis permite comprobar por qué se introdujo el
componente adicional.

Cuando otro diseño sustituya el anterior, escriba una entrada que
refleje la nueva información y establezca enlaces en ambos sentidos.
El motivo de la primera decisión sigue siendo pertinente para
quienes investigan una versión antigua. El índice debe dejar claro
qué decisión se aplica hoy sin obligar a reconstruir cada discusión.

Antes de mostrar un estado, el servicio público verifica que quien
consulta tenga acceso a ese pedido concreto. Compruebe la denegación
para un pedido ajeno y el conjunto exacto de campos de una respuesta
autorizada.

Dónde surgen los problemas

Un registro pierde credibilidad cuando detalla la opción elegida y
reduce las demás a versiones que nadie habría defendido. Presente
los mejores argumentos reales de cada alternativa. Vincule las
afirmaciones importantes a la medición, norma o compromiso que
influyó en la elección. Una buena plantilla deja espacio para
describir las circunstancias específicas.

Otro fallo es registrar las ventajas y dejar los costes sin
responsable. Una nueva base de datos o una cola compartida cambia el
trabajo de otras personas. Indique quién mantendrá el servicio,
quién responde del límite de seguridad y cómo se entregarán esas
responsabilidades. Cuando una consecuencia aún no se pueda
comprobar, indique qué observación servirá y en qué momento se podrá
reunir.

Por último, mantenga una extensión que permita escribir el registro
durante el proceso. Las instrucciones de operación pueden tener su
propio lugar con enlaces. Al cambiar el rumbo, conserve las razones
anteriores y señale la decisión que tiene vigencia. El registro será
más útil en una revisión dentro de un año si sus referencias siguen
siendo localizables.

Lecturas adicionales

  * Guía de AWS sobre el proceso de decisión de arquitectura

  * Microsoft Azure Well-Architected sobre registros de decisiones

  * Marco británico para registrar decisiones de arquitectura

hEsta página en la web	URL:https://engineer.company/es/glossary/architecture-decision-record/	engineer.company	70
