Guía · Requisitos
Cómo redactar buenos requisitos de sistema: ejemplos y lista de comprobación
Escuchar esta guía (audio en inglés) 26 min
Un buen requisito dice una sola cosa que el sistema debe hacer o ser, con palabras que dos ingenieros leen igual, y con un valor que una prueba o un análisis puede comprobar. Esta guía trata las necesidades frente a los requisitos, las partes de un enunciado de requisito, las características de calidad de ISO/IEC/IEEE 29148 y de la INCOSE Guide to Writing Requirements, una lista de comprobación con ejemplos de antes y después, la verificación y los criterios de aceptación, los valores TBD y TBR y los tipos de requisitos, todo ello aplicado a una misma especificación de un CubeSat.
En esta página
- Por qué importa la redacción de un requisito
- Necesidades de las partes interesadas frente a requisitos
- La anatomía de un requisito
- Características de calidad de un buen requisito
- La lista de comprobación: reglas con ejemplos de antes y después
- Redactar el método de verificación y los criterios de aceptación junto con el requisito
- Gestionar los valores TBD y TBR
- Tipos de requisitos
- Ejemplo resuelto: revisión de la especificación de EO-1
- Errores habituales
- Pruébelo en Holarch
- Descargar la lista de comprobación
- Preguntas sobre la redacción de requisitos
- Siguientes pasos
Por qué importa la redacción de un requisito
Un requisito es un contrato entre quienes piden un sistema y quienes lo construyen. Todo lo que viene después lo lee: el diseñador dimensiona un componente frente a él, el ingeniero de pruebas redacta un criterio de aprobación a partir de él, el comité de cambios sopesa un cambio frente a él y el cliente acepta el sistema según él. Todos leen la misma frase, normalmente sin el autor delante. Si la frase se puede leer de dos maneras, se leerá de dos maneras, y la diferencia aflora tarde: en una prueba que «se aprueba» frente a un criterio que nadie acordó, o en la aceptación, cuando el cliente quería decir otra cosa.
Una mala redacción también rompe el resto del modelo. Un requisito sin valor no se puede asignar a un componente, porque nadie puede decir si el componente lo cumple. No se puede verificar, así que aparece como hueco de cobertura en la trazabilidad y en la matriz de verificación. Y cuando cambia, nadie sabe si el diseño vinculado sigue siendo válido. Redactar bien los requisitos es el trabajo de calidad más barato de un proyecto: una hora dedicada a una frase al principio ahorra una campaña de pruebas al final.
La guía usa un único ejemplo continuo, EO-1, un CubeSat 6U ficticio que toma imágenes de tierras de cultivo en cuatro bandas espectrales. Su especificación, SRS-001 EO-1 System Requirements Specification, tiene 32 requisitos, la mayoría sólidos y tres débiles a propósito. Es el mismo modelo que el proyecto de ejemplo de MBSE de principio a fin. Las necesidades de las partes interesadas N1 a N3 citadas aquí son las que la guía de trazabilidad añade al modelo.
Necesidades de las partes interesadas frente a requisitos
La redacción de requisitos empieza un paso antes, con las necesidades. Una necesidad de las partes interesadas es lo que espera un usuario, operador, cliente o regulador, en sus propios términos. Un requisito es el enunciado técnico frente al que se diseña y se verifica el sistema. ISO/IEC/IEEE 15288 mantiene ambos separados en procesos técnicos distintos: definición de necesidades y requisitos de las partes interesadas (6.4.2) y definición de requisitos del sistema (6.4.3). El INCOSE Needs and Requirements Manual hace la misma división y trata las necesidades como elementos por derecho propio, no como borradores de requisitos.
| Ejemplo de EO-1 | Se comprueba mediante | |
|---|---|---|
| Necesidad (N2 Twice-Weekly Revisit) | Farm customers need fresh imagery of their fields at least twice a week in the growing season. | Validación: ¿obtienen los clientes lo que necesitan del sistema entregado? |
| Requisito (1.6 Revisit Time) | The mission shall revisit each target region within 72 hours. | Verificación: ¿cumple el sistema el enunciado, mediante prueba, análisis, inspección o demostración? |
La diferencia se ve en cómo se comprueba cada uno. Un requisito se verifica: el sistema se mide frente al enunciado. Una necesidad se valida: alguien confirma que el sistema, en su uso previsto, hace lo que quería la parte interesada. Un sistema puede superar todas las verificaciones y aun así no superar la validación si los requisitos no dieron en el clavo; la guía de verificación frente a validación trata esa brecha. Para la redacción, la consecuencia práctica es sencilla: escriba primero la necesidad, después los requisitos que la satisfarían si se cumplen, y vincule cada requisito con la necesidad a la que responde.
La traducción rara vez es uno a uno. N2 se convierte en 1.6 Revisit Time, que después se descompone en 1.6.1 Ground Track Repeat (3 días) y 1.6.2 Off-Nadir Imaging (25 grados). Algunos requisitos no responden directamente a ninguna necesidad: 3.1 Orbit Average Power se deriva de 1.5 Daily Collection Volume, porque la carga de captura de imágenes fija la potencia que deben suministrar los paneles. Ningún cliente pidió 30 W, pero la captura de imágenes que sí pidieron no es posible sin ellos.
La anatomía de un requisito
Un requisito es más que su frase. La frase lleva la obligación; un conjunto de atributos a su alrededor lleva los motivos, el plan para demostrarlo y la contabilidad. Ambas mitades forman parte de su redacción.
El enunciado
La mayoría de los buenos enunciados de requisitos siguen un patrón. ISO/IEC/IEEE 29148 (5.2.4) lo describe como un sujeto, una acción, un objeto y restricciones sobre la acción, con una condición opcional delante; la INCOSE Guide to Writing Requirements recomienda el mismo orden y plantillas acordadas para cada tipo de requisito.
| Parte | Qué dice | EO-1 4.3 Fault Detection |
|---|---|---|
| Condición (opcional) | Cuándo, en qué modo o estado, se aplica el requisito | «…of undervoltage detection» (el evento desencadenante) |
| Sujeto | El sistema o elemento que debe cumplir, nombrado con exactitud | «The C&DH» |
| Verbo modal | La fuerza de la obligación | «shall» |
| Action | Lo que el sujeto hace o es, como verbo en voz activa | «enter» |
| Objeto | A qué se aplica la acción | «safe mode» |
| Rendimiento o restricción | El valor medible, con unidad y sentido del límite | «within 10 seconds» |
En conjunto: «The C&DH shall enter safe mode within 10 seconds of undervoltage detection.» El orden puede cambiar («When undervoltage is detected, the C&DH shall…» pone la condición delante, como en las plantillas EARS que usan muchos equipos), pero cada parte debe estar presente o faltar de forma deliberada.
Tres palabras llevan la mayor parte del peso. Shall marca un requisito vinculante; will expresa un hecho o una intención sobre algo ajeno al sistema; should expresa un objetivo que no se verifica. Sea cual sea la convención de un proyecto, defínala una vez en la especificación y manténgala. EO-1 1.1 Reference Orbit («The mission assumes a 500 km sun-synchronous orbit…») está correctamente redactado como hipótesis, no como requisito: es contexto para los requisitos que dependen de él, y el modelo lo guarda como un enunciado que no se puntúa ni se verifica.
Los atributos
Este es 3.1 Orbit Average Power tal como lo registra el modelo de EO-1, después del cambio posterior a la PDR de 28 W a 30 W:
| Atributo | 3.1 Orbit Average Power | Por qué está ahí |
|---|---|---|
| Identificador y nombre | 3.1 Orbit Average Power | Un asidero estable para vínculos, revisiones y solicitudes de cambio |
| Enunciado | The solar arrays shall generate at least 30 W orbit-average power at end of life. | La propia obligación |
| Justificación | Orbit-average load grew to 26 W after PDR; 30 W keeps 15% margin. | Permite que un lector posterior juzgue un cambio sin el autor |
| Origen y padre | Derived (systems analysis); derivado de 1.5 Daily Collection Volume | Trazabilidad hacia atrás: por qué existe el requisito |
| Método y nivel de verificación | Prueba, a nivel de subsistema | El plan para demostrarlo, decidido al redactarlo |
| Criterios de éxito | End-of-life orbit-average power predicted from measured peak power. | Qué resultado cuenta como cumplido |
| Responsable, prioridad, criticidad | Power Engineer; alta; alta | Quién responde de él y cuánto importa |
| Estado | En revisión (estaba aprobado; su texto cambió después de la aprobación) | En qué punto del proceso de acuerdo se encuentra |
| TBD/TBR | Ninguno | Si un valor sigue abierto |
ISO/IEC/IEEE 29148 (5.2.8) enumera atributos de este tipo, y la guía de INCOSE añade más; cada proyecto elige los que realmente va a mantener. La justificación es el que más a menudo se omite y el que más se echa de menos después. Sin «carga de 26 W, margen del 15 %», la siguiente persona que vea 3.1 no puede saber si 30 W es un límite físico estricto, una cifra del cliente o una elección de margen, y por tanto no puede saber qué significa para él un cambio en la carga.
Características de calidad de un buen requisito
Las reglas de estilo son más fáciles de aplicar cuando se sabe qué protegen. ISO/IEC/IEEE 29148 (5.2.5) nombra nueve características de un requisito individual, y la INCOSE Guide to Writing Requirements usa las mismas nueve como C1 a C9, cada una con una definición breve y las reglas que la respaldan. La tabla plantea cada una como una pregunta que puede hacer un revisor.
| Característica | Pregunta | Ejemplo de EO-1 |
|---|---|---|
| Necesario | Si se eliminara, ¿se perdería algo que necesitan las partes interesadas? ¿No es un duplicado? | 3.1 es necesario: sin él, nada dimensiona los paneles para la carga de captura de imágenes. |
| Apropiado | ¿Está redactado al nivel adecuado, sin fijar una decisión de diseño que debería tomar el nivel inferior? | 3.1 fija un nivel de potencia para los paneles, no un tipo de célula ni un número de paneles. |
| Inequívoco | ¿Se puede leer de una sola manera? | 6.4 «user friendly» no lo cumple: dos revisores discreparán sobre si se cumple. |
| Completo | ¿Dice todo lo necesario, sin condiciones ni valores que falten? | 3.5 «warm enough (TBD)» no lo cumple: falta el valor. |
| Singular | ¿Enuncia una sola obligación? | 2.5 no lo cumple: pide recuperarse y reanudar la captura de imágenes, unidas por «and». |
| Factible | ¿Se puede cumplir dentro de las restricciones conocidas de tecnología, coste y plazo? | 3.1 a 30 W está en duda: los paneles tal como están diseñados dan unos 28 W de media orbital. |
| Verificable | ¿Puede una prueba, un análisis, una inspección o una demostración mostrar que se cumple? | 2.5 «quickly» no lo cumple; «within 6 hours» sí. |
| Correcto | ¿Enuncia la necesidad real de su origen, con el valor adecuado? | 1.2, con 4,5 m de distancia de muestreo en el terreno, expresa correctamente los mapas a nivel de parcela de N3, con margen. |
| Conforme | ¿Sigue las plantillas y el vocabulario acordados del proyecto? | Cada requisito de EO-1 usa «shall», un sujeto nombrado y unidades del SI. |
Un conjunto de requisitos tiene características propias que ningún enunciado aislado puede mostrar. ISO/IEC/IEEE 29148 (5.2.6) indica que el conjunto debe ser completo, coherente, factible en su conjunto, comprensible y validable; la guía de INCOSE añade correcto como C15 y numera las características del conjunto de C10 a C15.
- Completo: el conjunto cubre las necesidades. EO-1 indica qué ocurre ante una subtensión (4.3), pero su único requisito de recuperación del modo seguro es 2.5, que tal como está redactado no se puede verificar, así que la recuperación queda, en la práctica, sin especificar.
- Coherente: no hay dos requisitos en conflicto, y los términos y las unidades se usan de la misma forma. 1.5 pide 3,2 GB de datos de imagen al día y 5.4, 3 GB recibidos en tierra; coinciden solo porque la justificación de 5.4 dice «after compression». Sin la justificación parecen un conflicto.
- Factible: los requisitos se pueden cumplir a la vez. Cada requisito de potencia puede ser factible por separado, mientras que 30 W de media orbital, la superficie de los paneles y el presupuesto de masa juntos pueden no serlo.
- Comprensible: un lector puede saber qué se espera del sistema y cómo se relacionan los requisitos, lo que depende de la estructura, la numeración y la trazabilidad tanto como de la redacción.
- Validable: se puede demostrar que el conjunto conduce a un sistema que satisface las necesidades, por eso cada requisito de nivel superior se vincula con una necesidad.
La lista de comprobación: reglas con ejemplos de antes y después
Las características se vuelven utilizables mediante reglas de redacción concretas. La INCOSE Guide to Writing Requirements las numera (R1, R2, etc.); el NASA Systems Engineering Handbook (apéndice C) tiene una lista de comprobación más corta en la misma línea. La tabla reúne las reglas que detectan la mayoría de los problemas en la práctica, con un ejemplo de la especificación de EO-1 para cada una. «Antes» es el texto tal como está en la demostración; «Después» es una reescritura. Los valores marcados como ilustrativos muestran la forma, no resultados de análisis de EO-1.
| Regla | Pregunta | Antes (EO-1) | Después |
|---|---|---|---|
| Una obligación por enunciado | ¿Exactamente un «shall», sin «and», «or» ni «and/or» que unan dos exigencias? | 2.5: «The spacecraft should recover from safe mode quickly and resume imaging as appropriate» | «The spacecraft shall resume imaging within 6 hours of a safe mode entry.» Los demás pasos de recuperación que importen tienen sus propios requisitos. |
| Redacción obligatoria | ¿«Shall» para un requisito vinculante, y no «should», «will» ni «may»? | 2.5: «should recover» | «shall resume» |
| Valor medible con unidad | ¿Tiene cada palabra de rendimiento un número y una unidad? | 2.5: «quickly» | «within 6 hours of a safe mode entry» |
| Sentido del límite indicado | ¿Está claro si el valor es un mínimo o un máximo? | 1.6.2: «image targets up to 25 degrees off nadir» | «image targets at off-nadir angles from 0 to 25 degrees» (un rango de capacidad, no un tope al apuntamiento) |
| Sin cláusulas de escape | ¿Se deja algo al criterio del proveedor («as appropriate», «if possible», «where practical»)? | 2.5: «as appropriate» | Eliminado; se enuncia la condición que importa |
| Sin términos vagos o subjetivos | ¿Podrían dos revisores discrepar sobre si se cumple («user friendly», «easy», «adequate», «enough»)? | 6.4: «The operator interface shall be user friendly and/or easy to use.» | «The operator interface shall let a trained operator book a ground station contact in no more than 5 minutes.» (ilustrativo; un requisito por cada tarea que importe) |
| Sustantivos explícitos, sin pronombres | ¿Tiene cada «it», «its» o «this» exactamente un referente posible? | 1.6.1: «The reference orbit shall repeat its ground track every 3 days.» | «The reference orbit shall repeat the ground track every 3 days.» Aquí el pronombre es inofensivo, pero en una frase más larga es lo primero que se desvía. |
| Condiciones indicadas | ¿Dice cuándo se aplica el valor: etapa de vida, modo, entorno? | «The solar arrays shall generate 30 W.» | «…at least 30 W orbit-average power at end of life.» |
| Valores cerrados o TBD con seguimiento | ¿Tiene cada valor abierto seguimiento con un responsable y una fecha límite, y no solo una mención en el texto? | 3.5: «The thermal design shall keep the battery warm enough (TBD).» | «The thermal design shall keep the battery cell temperature at or above 0 °C while charging.» (ilustrativo; hasta que lo fije el análisis térmico, el atributo TBD nombra al Thermal Engineer y una fecha límite) |
| Sin motivos ni notas en el enunciado | ¿Se han pasado a la justificación las frases de finalidad («so that», «in order to») y las notas entre paréntesis? | 3.5: «(TBD)» | Enunciado sin paréntesis; motivo en Justificación |
| Qué, no cómo | ¿Enuncia la necesidad en lugar de imponer una solución que debería elegir el nivel inferior? | «The thermal design shall keep the battery warm by means of a 2 W film heater.» (ilustrativo) | La reescritura de 3.5 de arriba: un límite de temperatura, dejando el calentador al diseño térmico |
| Positivo y alcanzable | ¿Evita «not», «never», «always» o «100%» cuando se quiere decir un límite medible? | «The C&DH shall never lose a stored command.» (ilustrativo) | «The C&DH shall execute each stored command within 1 second of the scheduled time.» (4.2 tal como está redactado) |
| Justificación registrada | ¿Dice por qué se eligió el valor? | 3.1 sin justificación | Justificación: «Orbit-average load grew to 26 W after PDR; 30 W keeps 15% margin.» |
| Método y criterios de verificación | ¿Se ha elegido el método y se ha derivado del enunciado el criterio de aprobación? | 3.1: método Prueba; TC-06 espera una potencia de pico ≥ 72 W | Criterio de aprobación derivado a través del presupuesto de potencia: unos 80,6 W de pico para 30 W de media orbital (véase la sección siguiente) |
| Trazable hacia arriba | ¿Está vinculado a una necesidad, un padre o un requisito de origen? | 3.1 sin vínculo aguas arriba | 3.1 derivado de 1.5 Daily Collection Volume |
| Único | ¿Dice algún otro requisito lo mismo con otras palabras? | Un segundo «The battery shall store 77 Wh» en la sección térmica (ilustrativo) | Un solo requisito, 3.2 Battery Capacity, referenciado donde haga falta |
Una lista de comprobación es una herramienta del revisor, no una plantilla de redacción. Lea cada requisito una vez frente a la lista completa en lugar de buscar una regla cada vez, y registre el hallazgo con la regla que incumple, para que el autor sepa qué cambiar. Las reglas también tienen falsos positivos. Una comprobación por lista de palabras marca «every» en 1.6.1 como cuantificador universal, pero «every 3 days» es un periodo, no una afirmación sobre todos los casos; decide un revisor.
Redactar el método de verificación y los criterios de aceptación junto con el requisito
La característica de verificable es más fácil de comprobar en el momento de redactar el requisito: si el autor no sabe decir cómo se demostraría que se cumple, no está terminado. Registre dos cosas con cada requisito.
- Método de verificación: prueba, análisis, inspección o demostración, y el nivel de ensamblaje en que se hace (componente, subsistema, sistema). EO-1 tiene los cuatro: 3.1 se verifica mediante prueba, 1.5 Daily Collection Volume mediante análisis, 3.4 Bus Regulation mediante inspección y 6.1 Contact Scheduling mediante demostración. La guía de la RVTM explica cómo elegir entre ellos.
- Criterios de éxito (criterios de aceptación): el resultado observable que cuenta como cumplido, expresado de forma que la prueba o el análisis se puedan redactar a partir de él. Para 3.2 Battery Capacity: «Measured capacity of at least 77 Wh at C/2 and 20 °C.» Para 6.2 Image Delivery: «Products on the portal within 6 h for 95% of passes in rehearsal.»
Redactar los criterios junto al enunciado detecta un tipo de error que, de otro modo, solo se encuentra al final. El 3.1 de EO-1 se verifica con TC-06 Solar Array Power Test, que mide la potencia de pico en un simulador solar y se aprueba con 72 W o más. Sin embargo, el requisito trata de la potencia media orbital, y el modelo convierte una en otra con la fracción iluminada (0,62) y la eficiencia de la cadena de potencia (0,6). Un pico de 72 W da 72 × 0,62 × 0,6 = 26,8 W de media orbital, por debajo de los 28 W originales, y no digamos de los 30 W actuales. El umbral de la prueba no se derivó del requisito. TC-06 midió 75,1 W y «se aprobó», pero 75,1 W equivalen a 27,9 W, por debajo de ambos valores. Si el criterio se hubiera redactado a partir del enunciado, habría dicho unos 30 / (0,62 × 0,6) = 80,6 W de pico, y el déficit se habría visto en la primera prueba. La guía de análisis de impacto de cambios sigue el mismo hallazgo a lo largo del cambio de 28 W a 30 W.
La lección es general: un criterio de aprobación debe poder trazarse hasta el valor del requisito mediante una aritmética que alguien pueda comprobar, y esa aritmética va en la justificación o en el plan de verificación, no en la memoria de un ingeniero.
Gestionar los valores TBD y TBR
Al principio de un proyecto, algunos valores aún no se conocen. Omitir el requisito oculta el hueco; inventar un número oculta la incertidumbre. La práctica habitual es redactar el requisito con un marcador de posición y hacer el seguimiento del marcador como elemento abierto.
- TBD (to be determined, por determinar): todavía no hay valor. «The thermal design shall keep the battery cell temperature at or above TBD °C while charging.»
- TBR (to be reviewed, a veces «to be resolved», por revisar): un mejor valor actual que no está confirmado. «…within 60 seconds» con el 60 marcado como TBR.
Prefiera un TBR con una estimación a un TBD a secas siempre que haya alguna base para un número: los diseñadores pueden trabajar con una estimación, y un valor que después se mueve es un cambio, que la trazabilidad seguirá. Cada elemento abierto necesita tres cosas, o no se está gestionando:
- Un responsable, la persona que lo cerrará.
- Una fecha límite o un hito, normalmente antes de las decisiones de diseño que dependen de él.
- Un plan de cierre: el análisis, la prueba o la decisión que fijará el valor.
La especificación de EO-1 tiene tres elementos abiertos. 3.5 Battery Thermal Control es un TBD cuyo responsable es el Thermal Engineer, y ya está vencido. 2.4 Target Slew («through 30 degrees within 60 seconds») es un TBR cuyo responsable es el ADCS Lead, y 5.3 Downlink Link Margin («at least 3 dB link margin at 10 degrees elevation») es un TBR cuyo responsable es el Comms Lead; ambos llevan valores de trabajo que los diseños usan mientras terminan los análisis.
Cuente los elementos abiertos en cada hito y espere que el número baje. Una línea base de requisitos con muchos TBD abiertos solo es una línea base de nombre. Los criterios de revisión del NASA Systems Engineering Handbook piden, a partir de la revisión de requisitos del sistema, que los TBD y TBR abiertos estén identificados con un plan y un calendario para cerrarlos. El seguimiento va en un atributo o en un registro, no solo en el texto: un «TBD» escrito en una frase no tiene responsable ni fecha, y nada recuerda a nadie que hay que cerrarlo.
Tipos de requisitos
Clasificar los requisitos ayuda a los revisores a hacer las preguntas adecuadas y ayuda a que el conjunto siga completo. Las categorías siguientes son las habituales; ISO/IEC/IEEE 29148 y la guía de INCOSE describen conjuntos parecidos, y muchos proyectos añaden los suyos.
| Tipo | Qué enuncia | Ejemplo de EO-1 | A qué prestar atención |
|---|---|---|---|
| Funcional | Lo que debe hacer el sistema | 4.3 Fault Detection: «The C&DH shall enter safe mode within 10 seconds of undervoltage detection.» | Una función sin rendimiento asociado; la mayoría de los requisitos funcionales también necesitan un «cómo de bien», aquí «within 10 seconds» |
| Rendimiento | Cómo de bien se realiza una función: cantidad, frecuencia, precisión, tiempo | 2.1 Pointing Accuracy: «The ADCS shall point the payload boresight within 0.1 degrees of the commanded target.» | Condiciones que faltan (qué modo, qué etapa de vida) y sentido del límite que falta |
| Interfaz | Lo que cruza un límite con otro sistema o elemento, y sus características | 5.2 UHF Command Uplink: «The UHF transceiver shall receive ground commands at 9.6 kbps.» La definición completa está en el documento de control de interfaces. | Requisitos que repiten el ICD en lugar de remitir a él, de modo que ambos se van separando |
| Restricción | Un límite al diseño o a cómo se construye el sistema, impuesto desde fuera | 4.4 Downlink Encryption: «The C&DH shall encrypt each downlink frame with 256-bit keys.» Su justificación: el contrato del cliente exige imágenes cifradas en tránsito, así que el requisito viene de fuera del proyecto, no de un estudio de alternativas interno. | Decisiones de diseño redactadas como restricciones cuando nadie de fuera las impuso |
| Ambientales, de fiabilidad, de seguridad | Condiciones que hay que soportar y confiabilidad que hay que alcanzar | 1.7 Mission Lifetime: «The spacecraft shall operate in orbit for at least 730 days.» | Valores sin la probabilidad o la confianza con que se afirman |
La línea entre requisitos funcionales y de rendimiento a menudo pasa por dentro de una misma frase: muchos requisitos enuncian una función con su rendimiento, como hace 4.3. No hay problema mientras la frase siga conteniendo una sola obligación. Los requisitos de interfaz se tratan con más detalle en la guía del documento de control de interfaces, y las funciones que hay detrás de los requisitos funcionales, en la guía de análisis funcional.
Ejemplo resuelto: revisión de la especificación de EO-1
Una revisión de SRS-001 con la lista de comprobación divide los 32 requisitos en tres grupos. La mayoría pasan. Unos pocos tienen hallazgos menores que merecen una frase cada uno. Tres necesitan reescribirse.
Una comprobación automática de la misma especificación coincide con la revisión: 29 de 32 requisitos se puntúan como buenos, y los tres débiles necesitan rehacerse. Los hallazgos de 2.5 enumeran cada regla incumplida por nombre y número, que es lo que necesita un autor para corregirlo. La comprobación también marca lo que no puede decidir: en 3.1, la corrección y la factibilidad esperan a un revisor porque el texto cambió después de la última revisión.
Hallazgos menores
- 1.6.2 Off-Nadir Imaging, «up to 25 degrees off nadir»: «up to» se lee como un máximo, pero la intención es una capacidad que la nave debe tener en cualquier ángulo de 0 a 25 grados. Una lectura errónea permitiría cumplir a un diseño que solo toma imágenes en el nadir.
- 1.6.1 Ground Track Repeat, «its ground track»: un pronombre con un único referente posible, así que el hallazgo es menor. El «every» de la misma frase es un falso positivo de una regla de cuantificador universal.
- 1.5 Daily Collection Volume tiene un método (análisis) y criterios de éxito («Simulated daily volume of at least 3.2 GB over a 30-day plan»), pero todavía no tiene ningún análisis vinculado. La redacción es correcta; la verificación no está hecha.
- 3.1 Orbit Average Power está bien redactado, pero su texto cambió después de la aprobación, así que su corrección y su factibilidad vuelven a necesitar el criterio de un revisor. La factibilidad es la verdadera cuestión: los paneles tal como están diseñados dan unos 28 W de media orbital.
Tres reescrituras
2.5 Safe Mode Recovery. «The spacecraft should recover from safe mode quickly and resume imaging as appropriate» incumple al menos seis reglas: «should» en lugar de «shall», dos obligaciones unidas por «and», «quickly» sin valor, la cláusula de escape «as appropriate», la falta de punto final y la falta de verificación. La reescritura conserva el único resultado que importa al cliente y le da un valor:
The spacecraft shall resume imaging within 6 hours of a safe mode entry.
La justificación debe decir de dónde salen las 6 horas (N1 pide alertas de estrés de cultivos en el mismo día, y 6.2 permite 6 horas desde la descarga hasta la entrega). Si los pasos de la recuperación importan por sí mismos, como volver a adquirir el apuntamiento al Sol o informar de la causa, cada uno se convierte en su propio requisito. Método: prueba, mediante inyección de fallos en el flatsat; criterio de éxito: la captura de imágenes se reanuda en un plazo de 6 horas en cada entrada en modo seguro inyectada.
3.5 Battery Thermal Control. «The thermal design shall keep the battery warm enough (TBD).» tiene un término vago, un TBD en el texto y un paréntesis. La corrección separa la obligación, el valor abierto y el motivo:
The thermal design shall keep the battery cell temperature at or above 0 °C while charging.
Los 0 °C son ilustrativos: las células de iones de litio no suelen cargarse por debajo del punto de congelación, pero el límite real sale de la hoja de datos de la célula y del análisis térmico. Hasta que ese análisis lo fije, el valor es un TBR cuyo responsable es el Thermal Engineer, con una fecha límite anterior a la revisión del diseño térmico. La reescritura también deja ver un hueco que el original ocultaba: no hay ningún requisito para el rango de temperatura de descarga, que necesita su propio enunciado.
6.4 Operator Interface. «The operator interface shall be user friendly and/or easy to use.» tiene dos términos subjetivos y un «and/or». La usabilidad se puede especificar, pero solo mediante tareas observables:
The operator interface shall let a trained operator book a ground station contact in no more than 5 minutes.
La tarea y el tiempo son ilustrativos. Un conjunto real enumeraría las pocas tareas que importan (reservar un contacto, subir una lista de objetivos, leer la telemetría de estado más reciente), cada una con un tiempo y un límite de errores, medidos en una demostración con operadores que hayan completado la formación.
Errores habituales
| Error | Qué sale mal | Mejor |
|---|---|---|
| Redactar soluciones de diseño como requisitos | El diseño queda fijado antes de hacer el estudio de alternativas, y se descarta una opción mejor sin que nadie lo decida. | Enuncie la necesidad («keep the cells at or above 0 °C while charging») y deje que el nivel inferior elija el calentador. |
| Copiar el lenguaje de las partes interesadas directamente en los requisitos | «Imágenes recientes dos veces por semana» es una necesidad; tal como está redactada no es verificable. | Conserve la necesidad y redacte un requisito con un valor y una condición que la satisfaga (1.6, en un plazo de 72 horas). |
| Varios requisitos en un párrafo | Un identificador lleva varias obligaciones, que comparten un estado, una prueba y un destino. | Un requisito por elemento, un «shall» por enunciado. |
| Valores sin condiciones | «30 W» al inicio y al final de la vida útil son diseños distintos. | Indique el modo, la etapa de vida, el entorno y el promedio. |
| Sin justificación | Nadie puede juzgar un cambio posterior, y el requisito sobrevive mucho tiempo después de que su motivo haya desaparecido. | Anote el motivo y los números que hay detrás del valor. |
| Umbrales de prueba no derivados del requisito | Una prueba se aprueba mientras el requisito no se cumple (TC-06 a 72 W de pico frente a 28 W de media orbital). | Derive el criterio de éxito del enunciado mediante aritmética, y regístrelo. |
| Un TBD escrito en el texto y olvidado | El valor abierto no tiene responsable ni fecha y llega a la línea base. | Haga el seguimiento de cada TBD y TBR con un responsable, una fecha límite y un plan de cierre. |
| Sobreespecificación (gold plating) | Requisitos que nadie pidió consumen esfuerzo de diseño y de pruebas. | Compruebe que cada requisito de nivel superior se traza a una necesidad o a un origen. |
| Confiar en exceso en las comprobaciones automáticas | Una comprobación de palabras sin hallazgos se toma por un requisito correcto. | Use las herramientas para las reglas mecánicas; una persona juzga si es correcto, factible y necesario. |
Pruébelo en Holarch
En un proyecto LML, cada requisito es una entidad de la clase Requirement con los atributos descritos arriba: Justificación, Estado, Prioridad, Criticidad, Responsable, Origen, Método de verificación, Nivel de verificación, Criterios de éxito y los campos TBD/TBR.
- Cree la demostración con Gestionar proyectos → Archivos de proyecto ▾ → Nuevo proyecto de demostración → CubeSat (ingeniería de sistemas guiada). Su especificación contiene los tres requisitos débiles y los elementos TBD/TBR abiertos que usa esta guía.
- Abra Necesidades y requisitos → Calidad, elija el documento en la lista de ámbito y haga clic en Comprobar calidad. Cada requisito se puntúa según las nueve características, y las sugerencias nombran los números de regla de la guía de INCOSE que una lista de palabras o un patrón pueden comprobar. Correcto y Factible necesitan un revisor: haga clic en la marca para registrar la decisión.
- Reescriba 2.5 como se indica arriba y vuelva a ejecutar la comprobación. Desaparecen los hallazgos de conector, cláusula de escape y término vago.
- Abra Necesidades y requisitos → TBD/TBR para ver los elementos abiertos con responsables y fechas límite, y haga clic en Cerrar en uno cuando su valor esté decidido.
- Para una segunda opinión sobre las características que una regla no puede decidir, use ✦ IA ▾ → Comprobación de requisitos con IA; cada veredicto y cada reescritura se muestran para su revisión antes de que cambie nada.
La referencia completa está en la documentación de Calidad de los requisitos y del Registro de TBD/TBR.
Descargar la lista de comprobación
La lista de comprobación de la calidad de requisitos con ejemplos de antes y después de EO-1 (CSV) contiene las reglas de la lista con sus preguntas de revisión y sus ejemplos, para usarla en una revisión o como punto de partida de las reglas de redacción propias de un proyecto. La guía de trazabilidad ofrece el mismo archivo.
Preguntas sobre la redacción de requisitos
¿Shall, must o will?
Cualquier convención funciona si la especificación la define y la mantiene. La más extendida usa «shall» para requisitos vinculantes, «will» para hechos e intenciones sobre cosas ajenas al sistema y «should» para objetivos que no se verifican. Algunas guías de estilo gubernamentales prefieren «must» por razones de lenguaje claro. El verdadero problema es mezclarlas dentro de una misma especificación.
¿Cuántos requisitos debe tener un sistema?
No hay un número correcto. Una nave pequeña puede tener unas pocas decenas de requisitos de sistema y unos pocos cientos por debajo; un programa grande tiene miles. Preguntas más útiles son si cada requisito se traza a una necesidad o a un padre, y si cada necesidad tiene requisitos por debajo.
¿Las historias de usuario son requisitos?
Una historia de usuario recoge una necesidad y su finalidad en los términos del usuario. Cumple el papel de una necesidad de las partes interesadas, y sus criterios de aceptación se parecen a los criterios de verificación. En un sistema que se construye, se integra y se verifica como hardware y software juntos, las historias siguen teniendo que convertirse en requisitos que se puedan asignar y probar.
¿Puede una herramienta comprobar la calidad de los requisitos?
Una herramienta puede comprobar de forma fiable las reglas mecánicas: verbos modales, conectores, palabras vagas, cláusulas de escape, pronombres, vínculos que faltan. No puede saber si 30 W es el valor correcto ni si los paneles pueden darlo. Use la comprobación automática para despejar los hallazgos mecánicos antes de una revisión, de modo que los revisores dediquen su tiempo a la corrección y la factibilidad.
Siguientes pasos
- Trazabilidad de requisitos e impacto de cambios: vincule estos requisitos con las necesidades, el diseño y las pruebas, y siga un cambio.
- Análisis funcional: convierta los requisitos en funciones y asígnelas.
- Matriz de verificación de requisitos: planifique el método de verificación de cada requisito y registre los resultados.
- Necesidades y requisitos en Holarch: documentos, comprobaciones de calidad, líneas base y trazabilidad en un solo modelo.