Cómo especificar tu producto antes de contratar un ingeniero
Si pides tres presupuestos con una idea descrita en dos párrafos, recibirás tres presupuestos de tres productos distintos. Cada ingeniero rellenará los huecos con sus propios supuestos, y no habrá forma de compararlos. La especificación es lo que hace comparables las ofertas y lo que permite saber, al final, si lo entregado cumple. No hace falta un documento de cien páginas, pero sí unas cuantas cosas bien escritas.
Qué es una especificación (y qué no es)
El V-Modell XT, el modelo de referencia de la Administración federal alemana para desarrollar sistemas, llama a este documento pliego de requisitos del cliente. Lo define así:
- Recoge todos los requisitos vinculantes que el cliente fija para el producto, funcionales y no funcionales.
- Es la base de la oferta y del contrato.
- Incluye también las fases de la vida del producto que hay que cubrir, las condiciones de entrega y los criterios de aceptación.
- Su calidad es responsabilidad del cliente.
- En general no debe imponer soluciones técnicas, para no limitar a quien diseña.
Es decir: la especificación dice qué tiene que hacer el producto. El cómo, la arquitectura, los componentes y el diseño, lo propone el ingeniero en su oferta y en su diseño, con trazabilidad entre ambos documentos.
Si tienes restricciones reales, como una caja ya fabricada, una plataforma elegida o un conector obligatorio, escríbelas aparte, como restricciones y con su motivo. Así quien diseña sabe qué es fijo y qué puede proponer.
Es la primera de las fases del desarrollo: la referencia contra la que se probará todo lo demás.
Cómo escribir un requisito
El manual de ingeniería de sistemas de la NASA dedica un apéndice a cómo escribir un buen requisito. Para un producto pequeño bastan sus reglas básicas:
- "Debe" para requisitos, "debería" para deseos. "El equipo debe funcionar entre −10 y 50 °C" es un requisito. "El equipo debería pesar menos de 200 g" es un objetivo. Separarlos dice al ingeniero dónde puede negociar.
- Valores con tolerancia. No "autonomía de una semana", sino "autonomía de al menos 7 días con una medida cada 15 minutos".
- Una idea por requisito, numerado. Así se puede citar en la oferta, en el plan de pruebas y en el acta de entrega.
- Qué, no cómo. Si escribes "debe usar el microcontrolador X", pregúntate por qué lo necesitas. La respuesta suele ser el requisito real.
- Con su justificación y sus supuestos. Una línea que explique de dónde sale el valor.
- Comprobable. Cada requisito tiene que poder verificarse mediante ensayo, demostración, inspección o análisis.
La NASA da también una lista de palabras que no se pueden comprobar y conviene evitar: fácil, suficiente, adecuado, rápido, pequeño, ligero, robusto, amigable, "cuando se requiera"... Cada vez que aparezca una, sustitúyela por un número o una condición.
Dos preguntas ayudan a depurar la lista. "¿Qué es lo peor que pasaría si este requisito no estuviera?" separa las necesidades de los deseos. "¿Y si la tolerancia fuera el doble?" detecta las tolerancias que encarecen el producto sin motivo.
Lo que todavía no sabes
Es normal no tenerlo todo claro al principio. La NASA propone una distinción útil:
- Por determinar: el valor no se conoce. Hay que reducir estos casos al mínimo.
- Por confirmar: es mejor dar una estimación y marcarla así, indicando qué hay que hacer para cerrarla, quién lo hará y para cuándo.
"Autonomía: 7 días (por confirmar con el piloto de enero)" permite presupuestar. "Autonomía: por determinar" obliga al ingeniero a suponer. Mantén al final del documento una lista de todo lo que queda abierto.
Plantilla de mínimos
Con las áreas que la NASA recomienda no olvidar y lo que hemos visto en artículos anteriores, esta es una plantilla de mínimos para un producto electrónico:
- Finalidad y usuarios. Qué problema resuelve, quién lo usa y dónde.
- Funciones. Qué tiene que hacer, en requisitos numerados.
- Prestaciones. Precisión, tiempos de respuesta, alcance de la comunicación, autonomía, siempre con tolerancias.
- Interfaces. Con el usuario (pantalla, botones, indicadores), con otros equipos (conectores, protocolos) y con la nube o una aplicación, si las hay.
- Alimentación. Red, batería o ambas, y cómo se carga.
- Entorno. Temperatura, humedad, polvo y agua, vibración, no solo durante el uso, también en el transporte y el almacenamiento.
- Mercados y normativa. Dónde se va a vender, porque eso decide las certificaciones. Si tiene conexión, entra en el Reglamento de Ciberresiliencia. Si tiene una finalidad médica, puede ser un producto sanitario.
- Volumen y coste objetivo. Cuántas unidades al año y a qué coste de fabricación. Junto con las funciones, el entorno y las normas, es de lo primero que ponemos por escrito con cada cliente.
- Restricciones. Lo que ya está decidido, con su motivo.
- Aceptación y entrega. Qué pruebas tiene que superar el prototipo para darlo por bueno y qué se entrega: esquemas, ficheros de fabricación, firmware, documentación.
- Lo que queda abierto. La lista de puntos por determinar y por confirmar.
Si los criterios de aceptación del punto 10 están escritos desde el principio, los ensayos de validación se diseñan contra ellos y la entrega no depende de interpretaciones.
Con la especificación en la mano
Una especificación así permite pedir una propuesta con alcance, plazo y precio por escrito. En nuestra forma de trabajar, cuando el alcance está claro el precio es cerrado, y cuando no lo está damos una estimación con tope. Una buena especificación es lo que permite el precio cerrado.
Si ya tienes una especificación, la revisamos contigo y señalamos lagunas o conflictos antes de diseñar. Si solo tienes una idea, te ayudamos a convertirla en especificación como primer paso del diseño de hardware.
Del requisito al diseño:Diseño de hardwareFirmware embebido
Fuentes
- ITZBund, V-Modell XT Bund, versión 2.3: pliego de requisitos (Lastenheft), apartado C.1.10.1.
- NASA, Systems Engineering Handbook, SP-2016-6105 Rev2: apéndice C, How to Write a Good Requirement.