ADR vs NFR: Las decisiones de arquitectura y la calidad del sistema no son lo mismo

ADR vs NFR explicado: aprende cómo los requisitos de calidad del sistema impulsan las decisiones de arquitectura, cómo los ADR registran las compensaciones y por qué la validación se mantiene separada.
Publicado:
Aleksandar Stajić
Actualizado: 8 de octubre de 2026, 19:31
ADR vs NFR: Las decisiones de arquitectura y la calidad del sistema no son lo mismo

Un requisito no funcional (RNF) describe una cualidad, restricción o condición operativa que se espera que el sistema satisfaga. Un registro de decisión de arquitectura (ADR) registra una elección arquitectónicamente significativa realizada en respuesta a requisitos, restricciones, riesgos y compensaciones. Están conectados, pero no son intercambiables: un RNF establece qué debe ser verdadero; un ADR explica qué se decidió, por qué y con qué consecuencias.

¿Cuál es la diferencia entre un RNF y un ADR?

La distinción más simple es gramatical. Un requisito describe una condición que el sistema debe satisfacer. Un registro de decisión describe una elección que el equipo tomó.

Por ejemplo, “La API debe devolver el 95% de las solicitudes de lectura en 300 ms bajo la carga de referencia acordada” es un requisito de calidad. “Usar una caché de lectura para esta carga de trabajo porque la ruta medida solo con base de datos no puede cumplir el objetivo de latencia sin un costo inaceptable” es una decisión de arquitectura.

La primera afirmación sigue siendo válida incluso si la implementación cambia. La segunda afirmación puede ser reemplazada posteriormente por otra decisión si la carga de trabajo, la tecnología, el modelo de costos o la evidencia cambian.

RNF y ADR responden a preguntas diferentes

RNF / requisito de calidadADR / decisión de arquitectura
Pregunta principalWhat quality, constraint, or operating condition must the system satisfy?What architecturally significant choice did we make, and why?
Contenido típicoMeasurable target, scope, condition, constraint, acceptance or validation ruleContext, decision, rationale, alternatives, trade-offs, status and consequences
Rol en el ciclo de vidaA requirement to design for and validateA historical record of a significant decision
¿Qué lo prueba?Measurement, test, analysis, inspection, audit or other validation evidenceThe record proves what was decided, not that the resulting system meets the requirement
Cuándo cambiaWhen stakeholder need, operating conditions, policy or quality target changesWhen the decision is replaced, rejected, deprecated, or superseded

¿Qué es un RNF en términos arquitectónicos precisos?

“Requisito no funcional” es una etiqueta conveniente de la industria, pero puede ocultar varios tipos diferentes de afirmaciones. En el trabajo de arquitectura, la distinción útil es entre comportamiento funcional, requisitos de calidad y restricciones.

ISO/IEC 25010:2023 proporciona un modelo de calidad de producto con nueve características y subcaracterísticas que se pueden usar al especificar y evaluar la calidad de productos de TIC y software. El trabajo de arquitectura del SEI trata de manera similar los requisitos de atributos de calidad como impulsores principales de la arquitectura de software.

Un RNF útil, por lo tanto, no es “el sistema debería ser rápido” o “la plataforma debe ser segura”. Esas afirmaciones nombran aspiraciones. Un requisito que impulsa la arquitectura debe hacer que la propiedad esperada sea lo suficientemente verificable como para que las alternativas de diseño y la evidencia posterior puedan evaluarse contra él.

Afirmación débilForma de requisito más útilPor qué importa la diferencia
La API debe ser rápidaPara la carga de trabajo W, el 95% de la operación X se completa dentro de T milisegundosDefine carga de trabajo, operación, métrica y umbral
El servicio debe estar disponibleEl servicio S cumple un objetivo de disponibilidad acordado durante la ventana de medición M, excluyendo condiciones de mantenimiento definidas explícitamenteHace que la disponibilidad sea medible y define el alcance
Los datos de los inquilinos deben ser segurosUna solicitud autenticada para el inquilino A nunca debe recuperar o modificar datos del inquilino B a través de rutas de aplicación compatiblesConvierte un objetivo de seguridad vago en una propiedad de aislamiento
El sistema debería escalarEl sistema soporta la carga de trabajo W con concurrencia C mientras cumple los umbrales de latencia y tasa de erroresConecta la escala con un comportamiento de servicio medible
Necesitamos PostgreSQLNo es un RNF por sí mismo; indique primero las cualidades de persistencia requeridas o la restricción externaUna elección tecnológica normalmente es una solución, no el requisito que pretende satisfacer

¿Qué es un registro de decisión de arquitectura?

Un registro de decisión de arquitectura es un registro compacto de una decisión de arquitectura importante. La formulación original de ADR de Michael Nygard enfatiza el contexto, la decisión, su estado y las consecuencias resultantes.

El objeto importante es la decisión, no la plantilla. Diferentes equipos usan diferentes formatos de ADR. Un registro más completo también puede preservar alternativas, criterios de decisión, compensaciones, evidencia, enlaces a requisitos y la fecha o versión desde la cual aplica la decisión.

ISO/IEC/IEEE 42010:2022 es más amplio que la práctica de ADR: especifica requisitos para las descripciones de arquitectura y sus conceptos, mientras que explícitamente no prescribe un proceso, notación, herramienta, formato o medio para registrar una descripción de arquitectura. Por lo tanto, un ADR es una técnica práctica de registro de decisiones, no un formato exigido por ISO 42010.

Campo del ADRQué preservaPor qué importa
ContextoEl problema, las fuerzas, los requisitos, los supuestos y el entorno que rodean la elecciónLos lectores futuros pueden reconstruir por qué una elección era necesaria
DecisiónLa elección que se volvió autoritativaSepara la opción seleccionada de la discusión
EstadoPropuesto, aceptado, rechazado, obsoleto, reemplazado u otro estado controladoEvita que decisiones antiguas permanezcan activas silenciosamente
AlternativasOtras opciones viables consideradasMuestra que la solución seleccionada no era la única imaginable
Justificación / compensacionesPor qué se seleccionó la opción y qué sacrificaHace que el razonamiento arquitectónico sea inspeccionable
ConsecuenciasEfectos positivos y negativos esperados, trabajo de seguimiento, riesgosConecta una elección local con el impacto en el sistema
Fecha / versiónCuándo la decisión se volvió válidaApoya la trazabilidad histórica y el reemplazo posterior

El ejemplo más simple: requisito de latencia → decisión de arquitectura

Supongamos que un propietario de producto y un equipo de ingeniería acuerdan que un endpoint de búsqueda debe devolver la primera página de resultados dentro de 400 ms en el percentil 95 bajo una carga de trabajo de referencia definida.

Ese objetivo no es un ADR. Es un requisito de calidad. El trabajo de arquitectura comienza preguntando qué diseño puede satisfacerlo bajo las demás restricciones del sistema.

Del requisito a la evidencia

1
1. Enunciar el requisito
Definir el objetivo de calidad, la carga de trabajo, el alcance, el umbral y el método de validación.
2
2. Identificar la relevancia arquitectónica
Determinar si el requisito influye materialmente en la estructura, la tecnología, el despliegue, el flujo de datos o el modelo operativo.
3
3. Evaluar opciones
Comparar alternativas como indexación, caché, desnormalización, trabajo asíncrono, particionamiento u otra arquitectura de consulta.
4
4. Registrar la decisión
Capturar la elección de arquitectura seleccionada, la justificación, las alternativas, las compensaciones, el estado y las consecuencias en un ADR.
5
5. Implementar
Convertir la decisión en código, infraestructura, configuración y comportamiento operativo.
6
6. Validar
Medir el sistema real contra el requisito original. El resultado de la prueba valida el NFR; el ADR por sí solo no lo hace.

Los NFR y los ADR suelen tener una relación de muchos a muchos

Un requisito de calidad puede impulsar varias decisiones de arquitectura. Un requisito de aislamiento de inquilinos, por ejemplo, puede influir en la propagación de identidad, el alcance de la base de datos, el diseño de trabajos en segundo plano, las claves de caché, el registro de auditoría y las herramientas administrativas.

Una decisión de arquitectura también puede responder a varios requisitos a la vez. Elegir un límite de procesamiento asíncrono podría mejorar la capacidad de respuesta y el aislamiento de fallos, al tiempo que introduce compensaciones de consistencia, complejidad, observabilidad y operativas.

Por qué la relación no es uno a uno

Lado del requisitoLado de la decisiónLado de la validación
Un NFR → muchos ADRA broad quality target can constrain several architectural boundariesSeveral coordinated decisions may be requiredEvidence may need multiple tests or measurements
Muchos NFR → un ADRSeveral quality and constraint drivers can point at the same design problemOne decision may balance several driversEach requirement still needs its own acceptance evidence
ADR sin un NFR clásicoThe driver may be a functional need, policy, ecosystem constraint, cost or delivery conditionThe choice can still be architecturally significantValidate against the actual driver, not an invented NFR
Requisito estable, el ADR cambiaThe target can remain unchangedA better or necessary implementation choice can supersede the old decisionThe new architecture must still be checked against the same target

Una elección de tecnología no es automáticamente un requisito

Un error recurrente de arquitectura es escribir una tecnología preferida en la capa de requisitos y luego tratar el diseño resultante como inevitable.

«El sistema debe usar PostgreSQL» puede ser una restricción legítima si un contrato, una política de plataforma, un requisito de compatibilidad, una regla de licenciamiento, un estándar organizacional o un límite operativo existente realmente exigen PostgreSQL. Pero si la necesidad real es la consistencia transaccional, las consultas estructuradas, la familiaridad operativa o un objetivo de recuperación específico, el requisito debe enunciar esa necesidad y la selección de tecnología debe registrarse como una decisión.

DeclaraciónClasificaciónRazón
Todas las lecturas con alcance de inquilino deben aplicar aislamiento de inquilinosRequisito / propiedad de seguridadDescribe una propiedad que debe cumplirse
Usar Row Level Security de PostgreSQL para tablas seleccionadas con alcance de inquilinoDecisión de arquitecturaElige un mecanismo destinado a ayudar a satisfacer la propiedad de aislamiento
El destino de despliegue debe ejecutarse en un entorno aprobado operado en la UERestricción / condición operativa similar a un NFRRestringe dónde puede operar el sistema
Usar el proveedor X en la región YDecisión de arquitectura / despliegue a menos que esté impuesto externamenteSelecciona una solución particular dentro del límite permitido
Latencia de API en el percentil 95 ≤ 300 ms bajo la carga de trabajo WRequisito de calidadDefine un comportamiento de rendimiento medible
Introducir una caché para el endpoint XDecisión de arquitecturaSelecciona una táctica destinada a mejorar el comportamiento medido

Un ADR no es prueba de que se haya satisfecho un NFR

La documentación de decisiones y la validación del sistema responden a preguntas diferentes. Un ADR puede mostrar que se consideraron el rendimiento, la seguridad, la resiliencia o la mantenibilidad. Por sí solo no puede demostrar que el sistema entregado realmente alcanza esas propiedades.

La prueba debe provenir del método de validación apropiado para el requisito: benchmark, prueba de carga, prueba de fallos, prueba de seguridad, análisis de arquitectura, auditoría, inspección, telemetría operativa, ejercicio de recuperación, estudio de usuarios u otra forma de evidencia.

¿Cuándo se convierte un RNF en arquitectónicamente significativo?

No todos los requisitos no funcionales merecen una decisión de arquitectura. El subconjunto importante son los requisitos que moldean materialmente la arquitectura o fuerzan compensaciones en todo el sistema.

La literatura del SEI utiliza el concepto de requisitos arquitectónicamente significativos para requisitos con un efecto arquitectónico de gran alcance. Los atributos de calidad como el rendimiento, la fiabilidad, la seguridad y la modificabilidad son fuentes frecuentes de tales impulsores, especialmente cuando conllevan un alto valor empresarial o de misión.

Prueba de significancia arquitectónica

1
1. Preguntar si el requisito cambia la estructura
¿Forzarían valores diferentes componentes, límites, rutas de datos o topología de despliegue distintos?
2
2. Preguntar si restringe decisiones tecnológicas importantes
¿Elimina opciones de implementación que de otro modo serían viables?
3
3. Preguntar si crea un comportamiento transversal
¿Afecta a muchos componentes, equipos, interfaces o etapas del ciclo de vida?
4
4. Preguntar si crea una compensación difícil
¿Mejorar esta propiedad afecta materialmente a otra calidad, costo, cronograma, complejidad o riesgo?
5
5. Preguntar si el fallo es costoso
¿Incumplir el requisito crearía un impacto operativo, de seguridad, regulatorio, financiero o de producto material?
6
6. Registrar decisiones solo donde vale la pena preservar el razonamiento
No crees ADR para cada elección local de codificación; preserva las decisiones arquitectónicamente significativas y su justificación.

Un modelo de arquitectura más sólido: requisito → decisión → implementación → validación

La conexión más útil entre los RNF y los ADR es la trazabilidad. Un requisito debería poder señalar las decisiones de arquitectura que lo abordan; un ADR debería identificar los impulsores a los que responde; el trabajo de implementación debería realizar la decisión; la validación debería volver al requisito original.

Cadena de trazabilidad de arquitectura

1
Necesidad / objetivo de negocio
Por qué importa la calidad o la restricción.
2
Requisito / RNF
Qué debe lograr o respetar el sistema.
3
Impulsores de arquitectura
Qué requisitos son lo suficientemente significativos como para dar forma al diseño.
4
Opciones
Formas plausibles de abordar el impulsor.
5
ADR
La elección seleccionada, la justificación, las alternativas, las compensaciones y las consecuencias.
6
Implementación
Código, modelo de datos, infraestructura, interfaces y mecanismos operativos que realizan la decisión.
7
Evidencia de validación
Pruebas, mediciones, análisis o auditorías que demuestran si el requisito original se satisface realmente.
8
Cambio / sustitución
Nueva evidencia o requisitos modificados pueden desencadenar un nuevo ADR mientras se preserva el razonamiento histórico.

Evidencia de implementación: cómo separo requisitos y decisiones en SenseFlow

En SenseFlow, la Fuente de Verdad del proyecto coloca explícitamente los requisitos no funcionales dentro de la estructura de requisitos junto con dependencias, riesgos, supuestos, criterios de aceptación y un método de validación. El modelo de documentación define por separado la integridad de las decisiones para decisiones significativas.

Para decisiones significativas de SenseFlow, los campos registrados son Decisión, Razón, Alternativas, Compensaciones, Estado y Fecha / Versión. Las decisiones importantes de arquitectura y producto están destinadas a permanecer históricamente trazables en lugar de ser sobrescritas cuando el proyecto evoluciona.

SenseFlow también asigna roles operativos diferentes a Confluence y Jira. Confluence es el entorno estructurado de conocimiento y decisiones; Jira gestiona el trabajo de entrega accionable. Las Epics importantes de Jira deberían enlazar de vuelta a la documentación relevante de producto o requisitos. Esto preserva la cadena desde la intención del producto a través de los requisitos y las decisiones hasta la implementación, en lugar de convertir el backlog en la Fuente de Verdad de la arquitectura.

Capa de SenseFlowQué contieneRol en la separación ADR/RNF
Estructura de producto / requisitosObjetivo de producto, capacidad, epic, historia de usuario, criterios de aceptación, tareas técnicas; los requisitos pueden incluir RNF y método de validaciónPreserva qué debe lograrse y cómo se verificará el éxito
Integridad de decisionesDecisión, razón, alternativas, compensaciones, estado, fecha/versiónPreserva por qué una elección arquitectónicamente significativa se volvió autoritativa
ConfluenceRequisitos, arquitectura, investigación, registros de decisiones, riesgos, hoja de ruta y fuentes de apoyoMantiene la Fuente de Verdad conceptual e histórica
JiraIniciativas/objetivos, epics, historias, tareas y estado de entregaEjecuta el trabajo aprobado sin convertirse en la Fuente de Verdad conceptual
Gestión de cambiosEstado actual → nueva evidencia → cambio propuesto → impacto → decisiónPermite que las decisiones evolucionen sin borrar el rastro del razonamiento
Trazabilidad de extremo a extremoProblema → necesidad → valor → objetivo de producto → requisito → implementación → validaciónMantiene la documentación de decisiones conectada al producto real y al ciclo de vida de la evidencia

Contexto de proyecto empresarial: los requisitos deben preceder a las elecciones de arquitectura

La misma separación es útil en el trabajo de proyectos orientados a la empresa. Las decisiones de arquitectura tomadas antes de que los requisitos, riesgos, restricciones y condiciones de aceptación se comprendan suficientemente pueden convertir las preferencias en falsas necesidades.

Para Enterprise Aaasaasa 0.1, la lección relevante es metodológica más que una afirmación sobre un ADR particular: los requisitos, la arquitectura, la validación, los hitos, la gestión de riesgos y la aceptación pertenecen a un sistema de entrega conectado. Una elección de arquitectura debe permanecer trazable al requisito o restricción que pretende abordar.

Modos de fallo comunes cuando se mezclan ADR y NFR

Modo de falloQué sucedeConsecuencia
Tecnología disfrazada de requisitoSe escribe una solución preferida como “debe usar X” sin establecer la necesidad subyacenteNunca se evalúan alternativas y la arquitectura se fija prematuramente
NFR oculto solo dentro de un ADRLa decisión menciona un objetivo de rendimiento/seguridad que está ausente de la línea base de requisitosEl objetivo es difícil de validar, priorizar o gestionar de forma independiente
ADR tratado como pruebaSe asume que una elección documentada significa que el requisito está satisfechoLa intención arquitectónica reemplaza la medición o la verificación
NFR vagoPalabras como rápido, escalable, seguro o mantenible no tienen un alcance medibleDiferentes partes interesadas pueden creer que el mismo requisito significa cosas distintas
Sin alternativas registradasEl equipo registra solo la tecnología seleccionadaLos futuros mantenedores no pueden reconstruir por qué se rechazó otra opción
Sin modelo de sustituciónLos ADR antiguos se editan o eliminan cuando cambia la arquitecturaEl razonamiento histórico desaparece y las decisiones obsoletas pueden quedar ambiguas
Cada detalle de implementación se convierte en un ADREl repositorio se llena de registros de bajo valorLas decisiones arquitectónicas importantes se vuelven difíciles de encontrar
El backlog se convierte en la fuente de verdad de la arquitecturaLas tareas de Jira se tratan como la única explicación del sistemaEl estado de entrega sobrevive, pero se pierden la justificación arquitectónica y los impulsores de calidad

El marco de decisión ADR–NFR

Cuando un equipo se encuentra con una nueva preocupación arquitectónica, la siguiente secuencia ayuda a determinar qué pertenece a los requisitos, qué pertenece a un ADR y qué pertenece a la evidencia.

Prueba de clasificación ADR–NFR

1
1. ¿Es una propiedad requerida o una restricción externa?
Si es así, escriba o haga referencia al requisito antes de elegir un mecanismo.
2
2. ¿Se puede validar?
Defina el alcance, la condición, la métrica, la regla de aceptación, el método de análisis u otra evidencia necesaria.
3
3. ¿Es arquitectónicamente significativo?
Identifique si el requisito moldea materialmente la estructura, la tecnología, los datos, el despliegue o las compensaciones transversales.
4
4. ¿Existen alternativas significativas?
Compare tácticas u opciones de arquitectura viables en lugar de saltar directamente a una tecnología preferida.
5
5. ¿Se ha vuelto autoritativa una elección?
Cree o actualice el ADR con contexto, decisión, justificación, alternativas, compensaciones, estado y consecuencias.
6
6. ¿Está implementada la decisión?
Rastree el ADR hasta el diseño, las tareas, el código, la configuración y las operaciones.
7
7. ¿Está satisfecho el requisito?
Recopile evidencia de validación contra el requisito mismo.
8
8. ¿Cambiaron las condiciones?
Vuelva a evaluar el requisito y, cuando sea necesario, sustituya el ADR sin borrar el historial.

Lo que ADR y NFR no son

Errores de categoría comunes

ConceptoNo esRazón
NFR / requisito de calidadA required quality, constraint or operating conditionA technology shopping listRequirements should preserve the need independently from one implementation when possible
ADRA record of an architecturally significant decisionThe complete architecture descriptionArchitecture also needs views, interfaces, models, responsibilities and other documentation
Evidencia de validaciónEvidence that checks whether a requirement is satisfiedThe ADR itselfDocumented intent is different from measured or analyzed system behavior
Elemento del backlogActionable delivery workA durable substitute for architecture rationaleTask state answers what is being delivered, not necessarily why the architecture exists
RestricciónA condition that restricts the solution spaceAlways an internally chosen architecture decisionSome constraints come from regulation, contracts, existing platforms or organizational boundaries

Qué cambiaría esta respuesta

La terminología puede evolucionar. ISO/IEC/IEEE 29148:2018 sigue siendo el estándar de ingeniería de requisitos publicado vigente a 8 de octubre de 2026, pero ISO enumera un Proyecto de Norma Internacional destinado a reemplazarlo. Si la nueva edición cambia la terminología relevante o la guía de requisitos, las referencias específicas de la versión en este artículo deberían actualizarse.

Las plantillas de ADR también pueden evolucionar sin cambiar la distinción central. La plantilla mínima de Michael Nygard, MADR, plantillas específicas de la organización, herramientas de conocimiento arquitectónico o bases de datos de decisiones estructuradas pueden registrar decisiones. La pregunta duradera es si el registro conserva suficiente contexto y justificación para comprender una elección arquitectónicamente significativa.

La distinción solo colapsaría si una organización eligiera deliberadamente un artefacto combinado que almacene tanto datos de requisitos como de decisiones en un solo documento. Incluso entonces, los roles semánticos siguen siendo diferentes: un campo establece el resultado o la restricción requeridos; otro registra la respuesta elegida.

Limitaciones

Este artículo usa NFR como abreviatura práctica. Algunos métodos de ingeniería prefieren términos como requisito de atributo de calidad, requisito de calidad, calidad del sistema, restricción, objetivo de nivel de servicio o requisito arquitectónicamente significativo. Esos términos no son perfectamente intercambiables, y la terminología del proyecto debe ser explícita.

No todos los requisitos pueden reducirse a un único umbral numérico. La seguridad, la protección, la mantenibilidad, la interoperabilidad, la usabilidad, la explicabilidad, la portabilidad y la gobernanza pueden requerir combinaciones de escenarios, reglas estructurales, análisis, controles de proceso y evidencia cualitativa. “Medible” debería significar suficientemente verificable para la decisión, no artificialmente numérico.

No toda decisión de arquitectura necesita un ADR formal. El costo de documentación debe ser proporcional a la importancia arquitectónica, la longevidad, la incertidumbre, la complejidad de las compensaciones y el costo de perder la justificación.

Conclusión

ADR y NFR pertenecen a capas diferentes del trabajo de arquitectura. El NFR define un objetivo de calidad, una restricción o una condición operativa. El ADR registra una respuesta arquitectónica significativa a uno o más impulsores.

Mantener esas capas separadas hace que la arquitectura sea más fácil de razonar. Los requisitos pueden validarse independientemente de la tecnología. Las decisiones pueden sustituirse sin reescribir el historial. Las alternativas y las compensaciones permanecen visibles. El trabajo de entrega puede rastrearse hasta la intención arquitectónica. La evidencia puede mostrar si el sistema resultante satisface realmente el requisito.

La cadena más sólida, por lo tanto, no es “NFR → ADR → hecho”. Es necesidad → requisito → impulsores arquitectónicos → opciones → decisión → implementación → validación → cambio. Esa cadena convierte la documentación de arquitectura de papeleo estático en un registro comprobable de por qué el sistema tiene la forma que tiene.

Preguntas frecuentes

ADR vs NFR

¿Es un ADR un requisito no funcional?

No. Un NFR establece una cualidad, restricción o condición operativa requerida. Un ADR registra una elección arquitectónicamente significativa hecha en respuesta a requisitos, restricciones, riesgos y compensaciones.

¿Debería cada NFR tener un ADR?

No. Solo los requisitos que influyen materialmente en la arquitectura necesitan decisiones a nivel de arquitectura que merezca la pena preservar. Un NFR también puede impulsar varios ADR, y un ADR puede responder a varios requisitos.

¿Puede “usar PostgreSQL” ser un NFR?

Solo cuando PostgreSQL se impone genuinamente como una restricción externa. De lo contrario, la necesidad subyacente debería expresarse primero, y seleccionar PostgreSQL normalmente debería tratarse como una decisión de arquitectura.

¿Demuestra un ADR que se cumple un requisito de rendimiento o seguridad?

No. Un ADR registra la intención y el razonamiento. El requisito se valida mediante evidencia apropiada, como pruebas, medición, análisis, auditoría o telemetría operativa.

¿Qué debería contener un ADR?

Como mínimo, un ADR debería dejar claros el contexto y la decisión. Las estructuras comunes también incluyen estado y consecuencias. Los equipos pueden añadir alternativas, justificación, compensaciones, enlaces a requisitos, evidencia, responsables, fechas y relaciones de sustitución.

¿Qué hace que un NFR sea arquitectónicamente significativo?

Un requisito es arquitectónicamente significativo cuando da forma material a la estructura del sistema, la tecnología, los flujos de datos, el despliegue, el comportamiento transversal o compensaciones de calidad difíciles, especialmente cuando el fallo conlleva un alto impacto empresarial o de misión.

¿Debería eliminarse un ADR antiguo cuando cambia la arquitectura?

Normalmente no. Una decisión de reemplazo debería normalmente sustituir el registro antiguo para que el razonamiento histórico siga siendo rastreable.

Glosario

Términos centrales de arquitectura

NFR
Requisito no funcional: abreviatura práctica para una cualidad, restricción o condición operativa requerida del sistema; la terminología exacta varía según el método y el estándar.
Requisito de atributo de calidad
Un requisito que describe una propiedad de calidad que se espera que el sistema exhiba bajo condiciones definidas, como rendimiento, disponibilidad, seguridad, fiabilidad o modificabilidad.
Registro de decisión de arquitectura (ADR)
Un registro duradero de una decisión arquitectónicamente significativa y suficiente contexto para entender por qué se tomó la elección y qué consecuencias se derivan.
Requisito arquitectónicamente significativo (ASR)
Un requisito con un impacto arquitectónico suficientemente amplio como para influir materialmente en el diseño del sistema.
Restricción
Una condición que restringe el espacio de solución, incluidos límites externos de política, regulación, plataforma, compatibilidad, contractuales u organizativos.
Compensación
Una relación de diseño en la que mejorar un objetivo, propiedad o dimensión de coste puede empeorar otra.
Validación
Trabajo que produce evidencia utilizado para determinar si el sistema implementado satisface el requisito declarado bajo las condiciones relevantes.
ADR sustituido
Un registro histórico de decisión que ha sido reemplazado por una decisión autoritativa más reciente, pero que sigue disponible para trazabilidad.

Fuentes primarias y evidencia de implementación

Este artículo separa los estándares actuales de la evidencia de implementación del proyecto. ISO/IEC/IEEE 29148:2018 sigue vigente a 8 de octubre de 2026, pero está marcado para revisión; ISO/IEC 25010:2023 e ISO/IEC/IEEE 42010:2022 son ediciones publicadas vigentes. SenseFlow es evidencia original del proyecto para el modelo de trazabilidad e integridad de decisiones descrito anteriormente.

ISO/IEC/IEEE 29148:2018 — Ingeniería de requisitos

Estándar de ingeniería de requisitos publicado vigente. ISO indica que la edición de 2018 fue revisada y confirmada en 2024 y se espera que sea reemplazada por el DIS actualmente en desarrollo.

ISO/IEC/IEEE DIS 29148 — Ingeniería de requisitos

Borrador de Norma Internacional actualmente en desarrollo y destinado a reemplazar ISO/IEC/IEEE 29148:2018.

ISO/IEC 25010:2023 — Modelo de calidad del producto

Modelo de calidad del producto vigente con nueve características de calidad utilizadas para especificar, medir y evaluar la calidad de productos TIC y de software.

ISO/IEC/IEEE 42010:2022 — Descripción de arquitectura

Estándar de descripción de arquitectura vigente. Especifica conceptos de descripción de arquitectura y requisitos de conformidad sin prescribir un único formato de registro, notación, proceso o herramienta.

Michael Nygard — Documentar decisiones de arquitectura

Artículo original influyente sobre ADR que describe registros ligeros centrados en contexto, decisión, estado y consecuencias, con decisiones sustituidas conservadas para la comprensión histórica.

SEI — Relacionar objetivos de negocio con requisitos arquitectónicamente significativos

Informe del SEI que explica cómo los requisitos de atributos de calidad y los objetivos de negocio impulsan la arquitectura de software y por qué los requisitos arquitectónicamente significativos necesitan una elicitación explícita.

SEI — Definir cualidades no funcionales del sistema

Resumen del SEI que conecta atributos no funcionales/de calidad con arquitectura, escenarios, compensaciones y evaluación objetiva del sistema.

SEI — Colección del método de diseño guiado por atributos

Método de diseño de arquitectura basado en requisitos funcionales, requisitos de atributos de calidad y restricciones, con tácticas y patrones arquitectónicos seleccionados para satisfacer escenarios de calidad.

SEI — Colección Views and Beyond

Guía de documentación de arquitectura que enfatiza las vistas relevantes y el registro de las decisiones de diseño necesarias como parte del trabajo de arquitectura.

Related Articles

Conmutación por error de doble SIM del ZBT Z8102AX: qué funciona, qué falta y qué necesita un mejor firmware

Conmutación por error de doble SIM del ZBT Z8102AX: qué funciona, qué falta y qué necesita un mejor firmware

El ZBT Z8102AX es un router OpenWrt 5G de doble SIM, pero el hardware de doble SIM por sí solo no es lo mismo que una conmutación por error inteligente. El router reconoce la SIM y se conecta correctamente, pero el cambio automático, la recuperación del módem, las decisiones basadas en la señal y una lógica de conmutación por error limpia aún necesitan pruebas más profundas.

Guía Definitiva de Criterios de Aceptación para la Adopción de LLM en Playbooks Empresariales

Guía Definitiva de Criterios de Aceptación para la Adopción de LLM en Playbooks Empresariales

Domina el arte de definir criterios de aceptación precisos para garantizar una integración exitosa de LLM en tu entorno empresarial. Esta guía integral proporciona marcos accionables, ejemplos y mejores prácticas adaptados para la adopción impulsada por playbooks.

IA generativa explicada: modelos, recuperación, herramientas y aplicaciones no son lo mismo

IA generativa explicada: modelos, recuperación, herramientas y aplicaciones no son lo mismo

La IA generativa es más que un modelo. Aprende cómo los modelos, la recuperación, las herramientas, el contexto, los entornos de ejecución y las aplicaciones encajan en los sistemas de IA en producción.

Dominando el flujo de trabajo SEO: Estrategias de optimización esenciales para el crecimiento orgánico

Dominando el flujo de trabajo SEO: Estrategias de optimización esenciales para el crecimiento orgánico

Un flujo de trabajo SEO estructurado es crucial para un crecimiento orgánico sostenible. Aprende las diez estrategias fundamentales, desde la investigación de palabras clave y la optimización técnica hasta la calidad del contenido y el análisis de rendimiento.