Registro de decisión técnica
un registro breve de una decisión y su justificación
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.

Foto: Engin_Akyurt / Pixabay 
Foto: BRRT / Pixabay
Utilice el concepto en una decisión
Aplique «¿Qué es un registro de decisión técnica?» a una decisión real. Podemos ayudarle a relacionar el concepto con el sistema que está construyendo o comprando. La estructura del sistema se define primero sobre el papel para que las piezas encajen y los costes se conozcan antes de escribir código.
Compruebe los supuestos detrás del término
Utilice la explicación y los trabajos enlazados para formular preguntas sobre su proyecto. Podemos examinar los supuestos con usted antes de elegir una herramienta. Un plan de infraestructura para 14 departamentos — 14 departamentos de investigación con un único plan de infraestructura
Un plan de infraestructura para 14 departamentos Póngase en contacto
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.

