Caso de Uso "CU04 - Calcular Estimación por PHU"
SIGMA · 3-BYTE Team · Adrián Portillo, Glenda Flores, Franco Rosas
Laboratorio de Desarrollo de Software · UNPA-UARG
No había especificación previa. Ver verificación CU vs sistema.
Descripción
El caso de uso CU04 - Calcular Estimación por PHU tiene como propósito ofrecer la funcionalidad necesaria para la creación, consulta, modificación y eliminación de estimaciones basadas en Puntos de Historia de Usuario (PHU), utilizando el método de las tres estimaciones (PERT): caso mejor, caso probable y caso peor. El actor involucrado tiene el permiso "Estimaciones" y puede realizar las operaciones desde el listado global de estimaciones PHU.
Esta pantalla es un ABM global: no cuelga de un proyecto ni de un backlog. Cada estimación se vincula a un id_sprint. Los tres valores (mejor caso, caso probable, peor caso) y los totales (Total PHU y Total Velocidad) se cargan en el formulario.
Especificación
| Caso de uso | CU04 - Calcular Estimación por PHU |
|---|
| Actores | Usuario con permiso de sistema Estimaciones (hoy: Administrador). |
| Tipo | Primario: los casos primarios de uso representan los procesos comunes más importantes. |
| Propósito | Ofrecer la funcionalidad necesaria para crear, modificar, eliminar y consultar estimaciones PHU asociadas a un sprint. |
| Resumen | El caso de uso se inicia cuando el actor accede a la pantalla "Estimaciones PHU" (enlazada desde el panel de control de Administrador; no está en el navbar). |
| Precondiciones | Haber ingresado al sistema con el permiso Estimaciones. Para asociar una estimación a un sprint, ese sprint debe existir (no se valida en el alta; ver nota de implementación). Para modificar o eliminar una estimación, esta debe existir previamente en el sistema. |
| Poscondiciones | La estimación PHU queda creada, modificada o eliminada en la tabla estimacion_phu y el listado refleja el cambio. |
Flujo Principal
| Paso | Acción |
|---|
| 1 | El sistema despliega la pantalla estimacionesphu.php, que contiene el listado global de estimaciones PHU con: ID, ID Sprint. Opciones: botones "Ver detalle", "Modificar", "Eliminar" por fila, "Nueva Estimación PHU" sobre el listado y "Volver" al dashboard. |
| 2 | El actor presiona alguno de los botones: Nueva Estimación PHU, Ver detalle, Modificar o Eliminar. |
| 3 | Si el actor selecciona "Nueva Estimación PHU", el caso de uso continúa en el paso 1 del Subflujo 1 (Crear Estimación PHU). |
| 4 | Si el actor selecciona "Ver detalle", el caso de uso continúa en el paso 1 del Subflujo 2 (Ver Estimación PHU). |
| 5 | Si el actor selecciona "Modificar", el caso de uso continúa en el paso 1 del Subflujo 3 (Modificar Estimación PHU). |
| 6 | Si el actor selecciona "Eliminar", el caso de uso continúa en el paso 1 del Subflujo 4 (Eliminar Estimación PHU). |
Subflujo 1 — Crear Estimación PHU
| Paso | Acción |
|---|
| 1 | El sistema despliega estimacionphu.crear.php con el formulario: ID Sprint (número, obligatorio), Caso Probable (número, obligatorio), Mejor Caso, Peor Caso, Total PHU y Total Velocidad (estos cuatro últimos sin marca de obligatorios en el HTML). |
| 2 | El actor completa el formulario y presiona "Crear Estimación PHU". |
| 3 | Si la operación es exitosa (Excepción 1), el sistema inserta el registro en estimacion_phu mediante una consulta preparada. |
| 4 | Si la operación no es exitosa (Excepción 2), el sistema muestra "Ha ocurrido un error: {mensaje}". |
| 5 | El caso de uso finaliza. |
Subflujo 2 — Ver Estimación PHU
| Paso | Acción |
|---|
| 1 | El sistema despliega estimacionphu.ver.php en solo lectura, con: ID Sprint, Caso Probable, Mejor Caso, Peor Caso, Total PHU, Total Velocidad. |
| 2 | El actor presiona "Volver". |
| 3 | El caso de uso finaliza. |
Subflujo 3 — Modificar Estimación PHU
| Paso | Acción |
|---|
| 1 | El sistema despliega estimacionphu.modificar.php con el formulario precargado: ID Sprint (obligatorio), Caso Probable (obligatorio), Mejor Caso, Peor Caso, Total PHU, Total Velocidad (estos cuatro últimos sin marca de obligatorios en el HTML, a diferencia del alta). |
| 2 | El actor edita los campos y presiona "Modificar Estimación PHU". |
| 3 | Si la operación es exitosa (Excepción 1), el sistema actualiza el registro en estimacion_phu. |
| 4 | Si la operación no es exitosa (Excepción 3), el sistema muestra "Ha ocurrido un error." |
| 5 | El caso de uso finaliza. |
Subflujo 4 — Eliminar Estimación PHU
| Paso | Acción |
|---|
| 1 | El sistema despliega estimacionphu.eliminar.php con el ID de la estimación seleccionada y el mensaje de advertencia "ATENCIÓN. Esta operación no puede deshacerse." |
| 2 | Si el actor presiona "Sí, deseo eliminar" (Excepción 4), el sistema elimina el registro dentro de una transacción. |
| 3 | Si el actor presiona "NO (Salir de esta pantalla)" (Excepción 3), el sistema vuelve al listado sin realizar cambios. |
| 4 | El caso de uso finaliza. |
Excepciones
| Excepción | Acción |
|---|
| 1 | Operación exitosa. El sistema muestra "Operación realizada con éxito." y ofrece el botón "Salir" hacia el listado de estimaciones PHU. |
| 2 | Operación no exitosa (alta). El sistema muestra "Ha ocurrido un error: {mensaje de la excepción}" en la pantalla de resultado. |
| 3 | Cancelar operación. El sistema vuelve al listado de estimaciones sin modificar la base. |
| 4 | Confirmación de baja. El sistema ejecuta el DELETE dentro de una transacción (BEGIN / COMMIT); si falla, hace ROLLBACK y detiene la ejecución. |
Diagramas Asociados
Diagrama de Casos de Uso
Diagrama de Secuencia — Crear Estimación PHU
Diagrama de Secuencia — Modificar Estimación PHU
Diagrama de Secuencia — Eliminar Estimación PHU
Observaciones
- Los tres casos (mejor, probable, peor) y los totales se cargan a mano. El sistema no aplica una fórmula PERT.
- No se comprueba que el
id_sprint exista.
- El alta usa consulta preparada. La modificación arma el
UPDATE con los valores del formulario.
- No está en el menú. Se abre desde el panel de control del Administrador.
- La estimación PHU no lee las historias de usuario del sprint.