Documentación de Requisitos de Software: Casos de Uso, ISO 29148 y UML

Conceptos Fundamentales en la Ingeniería de Requisitos

Casos de Uso: Descripción de Requisitos Funcionales

Los Casos de Uso son la técnica principal para describir requisitos funcionales desde la perspectiva del usuario, mostrando la interacción de actores (usuarios o sistemas externos) con el sistema.

• Elementos Clave: Actor, objetivo, precondiciones, flujo principal (pasos numerados), flujos alternativos, poscondiciones, requisitos especiales.
• Relaciones: Inclusión (include), extensión (extend) y generalización para variantes.
• Detalle Importante: Deben representar procesos completos y útiles para el usuario.

Planillas de Casos de Uso

Documentos que describen detalladamente la secuencia de acciones entre actores y el sistema.

• Partes Esenciales: Nombre, actores, objetivo, precondiciones, descripción, flujo principal, flujos alternativos, poscondiciones.
• Importancia: Mejoran la comprensión y la comunicación en el proyecto.

Tipos de Requisitos

Requisitos Funcionales

• Definición: Especifican las funciones y servicios que debe proveer el sistema.
• Redacción Recomendada: “El sistema debe…” + verbo de acción. Deben ser claros y verificables.
• Ejemplos: Gestión de reservas, gestión de usuarios, gestión de pagos, historial, notificaciones.

Requisitos No Funcionales (Restricciones y Cualidades)

• Definición: Describen restricciones y cualidades del sistema, como rendimiento, seguridad, usabilidad, etc.
• Redacción Recomendada: “El sistema debe…” + condición medible y verificable. Evitar términos vagos.
• Ejemplos: Autenticación en dos pasos, tiempo de respuesta, disponibilidad, escalabilidad, accesibilidad, respaldo, cumplimiento legal.

Estándares y Modelado

Norma ISO/IEC/IEEE 29148: Estándar para la Documentación de Requisitos

• Qué es: Estándar internacional que establece pautas para documentar y gestionar requisitos en software y sistemas.
• Objetivo Principal: Asegurar que los requisitos sean claros, completos, verificables y trazables.
• Estructura del ESRE (Especificación de Requisitos de Software): Propósito, alcance, funciones, requerimientos funcionales y no funcionales, interfaces, supuestos, verificación, interesados, anexos.
• Buenas Prácticas: Redacción clara, sin ambigüedades, requisitos unitarios y uso de matriz de trazabilidad.

UML Básico (Lenguaje Unificado de Modelado)

• Definición: Lenguaje gráfico estándar para modelar sistemas y comunicar requisitos, estructura y comportamiento.
• Diagramas Clave: Casos de uso, clases, secuencia, estados, actividades.
• Uso: Puede emplearse como bocetos rápidos o como modelos detallados, según las necesidades del equipo.

Gestión de Requisitos y Metodologías

Trazabilidad de Requisitos

La trazabilidad relaciona casos de uso con sus requisitos para asegurar la implementación y las pruebas completas.

• Herramienta Esencial: Matriz de trazabilidad.

Metodologías Ágiles y Requisitos

• Enfoque: Priorizan entregas incrementales, adaptación y colaboración constante.
• Documentación: Ligera y útil, se centra en lo esencial.
• Rol de los Casos de Uso: Funcionan como historias de usuario ampliadas o detalladas.