Contratos de Software y Casos de Uso: Componentes Clave para la Especificación de Requisitos

Contratos de Software: Definición y Componentes Esenciales

Un contrato es un documento que especifica el cambio del estado del sistema a partir de la ejecución de la operación que describe. Su enfoque principal debe estar en el qué se logra y no en el cómo se implementa. Para una documentación completa, se recomienda construir un contrato por cada operación del sistema.

Partes Fundamentales de un Contrato de Software

Los contratos deben incluir las siguientes secciones clave:

• Nombre: Identificación de la operación y sus parámetros asociados.
• Responsabilidades: Descripción informal de las responsabilidades que debe cumplir la operación.
• Salida: El valor o retorno esperado de la operación.
• Precondiciones: Suposiciones necesarias sobre el estado del sistema antes de ejecutar la operación.
• Postcondiciones: El estado resultante del sistema después de la ejecución exitosa de la operación.

Casos de Uso (CU): Interacciones y Formatos

Un Caso de Uso (CU) es una secuencia de interacciones que se desarrolla entre un sistema y sus actores, generada en respuesta a un evento iniciado por un actor principal sobre el propio sistema. Gráficamente, es un diagrama que ilustra la relación entre los actores y las funcionalidades (casos de uso) dentro de un sistema.

Tipos de Formatos de Casos de Uso

Se distinguen tres formatos principales para documentar los Casos de Uso:

1. Identificado: Incluye únicamente el nombre del CU y el o los actores involucrados.
2. Alto Nivel: Agrega una descripción concisa (uno o dos párrafos) que describe a alto nivel el comportamiento general del CU.
3. Expandido: Es el formato más detallado. Agrega los escenarios (tanto el típico como los alternativos, si existen) y, opcionalmente, otras secciones como el Objetivo, Precondiciones, etc.

Actores en el Desarrollo de Software

Un actor representa un conjunto coherente de roles que desempeñan los usuarios o sistemas externos al interactuar con los casos de uso del sistema.

Clasificación de Actores

• Actor Principal: Es aquel que requiere al sistema el cumplimiento de un objetivo específico.
• Actor Secundario: Es aquel que el sistema necesita para poder satisfacer un objetivo del actor principal.

Escenarios: Flujos de Interacción

Los escenarios detallan los flujos específicos de interacción que ocurren dentro de un Caso de Uso.

Escenario Típico

Muestra la interacción habitual y el flujo principal entre los actores y el sistema, concentrándose en los elementos más importantes. Este enfoque facilita el entendimiento al dejar problemas, condiciones, excepciones, etc., para los escenarios alternativos. El escenario típico siempre debe terminar en éxito (cumplimiento del objetivo).

Escenarios Alternativos

Muestran variaciones, alternativas o extensiones al flujo del escenario típico en alguno de sus pasos. Esto permite ubicar todas las posibles desviaciones fuera del flujo principal. Los escenarios alternativos pueden terminar tanto en éxito (cumpliendo el objetivo) como en fracaso (no cumpliéndolo).