Una narrativa de caso de uso bien elaborada transforma objetivos abstractos del sistema en especificaciones accionables y paso a paso. Al documentar interacciones precisas, puntos de decisi\u00f3n y rutas de manejo de errores, los equipos establecen una \u00fanica fuente de verdad que alinea a los propietarios del producto, desarrolladores, testers y analistas de negocios. Este estudio de caso explora la anatom\u00eda de una documentaci\u00f3n de casos de uso efectiva, demostrando c\u00f3mo las narrativas estructuradas, las plantillas estandarizadas y los modelos visuales complementarios convergen para producir especificaciones funcionales inequ\u00edvocas. A trav\u00e9s de un escenario pr\u00e1ctico de retiro de efectivo en un cajero autom\u00e1tico, examinaremos c\u00f3mo capturar la l\u00f3gica de negocio, gestionar desviaciones y mantener la trazabilidad desde el concepto hasta la implementaci\u00f3n.<\/p>\n
![\"Mastering](\"https:\/\/blog.visual-paradigm.com\/wp-content\/uploads\/2026\/05\/img_6a0ff6c455a21.png\")
<\/p>\n
\n
1. Conceptos fundamentales<\/h2>\n
Antes de redactar especificaciones detalladas, es esencial comprender los componentes centrales que otorgan integridad estructural a un caso de uso:<\/p>\n
- \n
- \n
Actor:<\/strong>\u00a0Cualquier entidad (humana, sistema externo o hardware) que interact\u00faa con el sistema para alcanzar un objetivo.<\/p>\n
- \n
- \n
Actor principal:<\/em>\u00a0Inicia la interacci\u00f3n para cumplir un objetivo espec\u00edfico (por ejemplo, un cliente del banco).<\/p>\n<\/li>\n
- \n
Actor secundario\/soporte:<\/em>\u00a0Proporciona servicios o datos necesarios al sistema durante su ejecuci\u00f3n (por ejemplo, una API de banca central o una pasarela de pagos).<\/p>\n<\/li>\n<\/ul>\n<\/li>\n
- \n
Precondiciones:<\/strong>\u00a0El estado del sistema o del entorno que debe existir ya antes de que comience el caso de uso. Se asumen verdaderas y no se validan dentro del flujo.<\/p>\n<\/li>\n
- \n
Disparador:<\/strong>\u00a0El evento espec\u00edfico o acci\u00f3n del usuario que inicia el caso de uso.<\/p>\n<\/li>\n
- \n
Escenario de \u00e9xito principal (flujo b\u00e1sico):<\/strong>\u00a0La secuencia \u00f3ptima y libre de errores de pasos que conduce a la finalizaci\u00f3n exitosa del objetivo del actor. A menudo denominado la \u00abruta feliz\u00bb.<\/p>\n<\/li>\n
- \n
Extensiones \/ Flujos alternativos y de excepci\u00f3n:<\/strong>\u00a0Desviaciones documentadas respecto al flujo principal.<\/p>\n
- \n
- \n
Flujos alternativos:<\/em>\u00a0Diferentes caminos v\u00e1lidos para alcanzar el mismo objetivo (por ejemplo, usar un m\u00e9todo de pago diferente).<\/p>\n<\/li>\n
- \n
Flujos de excepci\u00f3n:<\/em>\u00a0Condiciones de error, fallas de validaci\u00f3n o restricciones del sistema que interrumpen el objetivo y requieren un manejo espec\u00edfico.<\/p>\n<\/li>\n<\/ul>\n<\/li>\n
- \n
Postcondiciones:<\/strong>\u00a0El estado garantizado del sistema, los datos o el entorno tras la finalizaci\u00f3n exitosa del caso de uso.<\/p>\n<\/li>\n<\/ul>\n
\n2. La plantilla de especificaci\u00f3n est\u00e1ndar<\/h2>\n
La consistencia es cr\u00edtica para la mantenibilidad. La siguiente plantilla proporciona una estructura ampliamente adoptada que garantiza la completitud sin verbosity innecesaria:<\/p>\n
\n\n
\n \nCampo<\/th>\n Descripci\u00f3n<\/th>\n<\/tr>\n<\/thead>\n \n ID y nombre del caso de uso<\/strong><\/td>\n Un identificador \u00fanico y un t\u00edtulo con verbo y sustantivo (por ejemplo,\u00a0 UC-201: Retirar efectivo<\/code>).<\/td>\n<\/tr>\n\n Actor(es)<\/strong><\/td>\n Lista a todos los participantes primarios y secundarios.<\/td>\n<\/tr>\n \n Descripci\u00f3n<\/strong><\/td>\n Un resumen conciso del prop\u00f3sito del caso de uso y su valor para el negocio.<\/td>\n<\/tr>\n \n Precondiciones<\/strong><\/td>\n Estados del sistema o del entorno necesarios antes de la iniciaci\u00f3n.<\/td>\n<\/tr>\n \n Disparador<\/strong><\/td>\n El evento exacto que inicia la interacci\u00f3n.<\/td>\n<\/tr>\n \n Escenario de \u00e9xito principal<\/strong><\/td>\n Pasos numerados y secuenciales que detallan la ruta exitosa predeterminada.<\/td>\n<\/tr>\n \n Extensiones \/ Excepciones<\/strong><\/td>\n Flujos alternativos mapeados a pasos espec\u00edficos del escenario principal (por ejemplo,\u00a0 3a<\/code>,\u00a08b<\/code>).<\/td>\n<\/tr>\n\n Postcondiciones<\/strong><\/td>\n El estado final del sistema tras la finalizaci\u00f3n exitosa.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
\n3. Narrativa del estudio de caso: UC-201 Retirar efectivo<\/h2>\n
La siguiente especificaci\u00f3n demuestra c\u00f3mo se aplican la plantilla y los conceptos fundamentales a un escenario real de banca.<\/p>\n
ID y nombre del caso de uso:<\/strong>\u00a0
UC-201 - Retirar efectivo<\/code>
\nActor principal:<\/strong>\u00a0Cliente del banco
\nActor secundario:<\/strong>\u00a0Sistema de banca central \/ Red de cajeros autom\u00e1ticos
\nDescripci\u00f3n:<\/strong>\u00a0Describe c\u00f3mo un cliente bancario autenticado retira efectivo de su cuenta corriente o de ahorros utilizando una m\u00e1quina expendedora de efectivo (ATM).
\nPrecondiciones:<\/strong>\u00a0La ATM mantiene una conexi\u00f3n de red activa y contiene efectivo f\u00edsico suficiente.
\nDisparador:<\/strong>\u00a0El cliente inserta su tarjeta bancaria en el lector de tarjetas de la ATM.<\/p>\nEscenario de \u00e9xito principal (flujo b\u00e1sico)<\/h3>\n
- \n
- \n
El sistema lee la tarjeta bancaria y solicita un n\u00famero de identificaci\u00f3n personal (PIN).<\/p>\n<\/li>\n
- \n
El cliente ingresa su PIN.<\/p>\n<\/li>\n
- \n
El sistema valida el PIN con el Sistema de Banca Central.<\/p>\n<\/li>\n
- \n
El sistema muestra las opciones de transacci\u00f3n disponibles.<\/p>\n<\/li>\n
- \n
El cliente selecciona \u00abRetirar efectivo\u00bb.<\/p>\n<\/li>\n
- \n
El sistema solicita el tipo de cuenta (corriente\/ahorros) y la cantidad a retirar.<\/p>\n<\/li>\n
- \n
El cliente selecciona la cuenta objetivo e ingresa una cantidad disponible.<\/p>\n<\/li>\n
- \n
El sistema verifica fondos suficientes con el Sistema de Banca Central.<\/p>\n<\/li>\n
- \n
El sistema carga la cuenta y ordena al dispensador de efectivo que libere la cantidad especificada.<\/p>\n<\/li>\n
- \n
El sistema entrega el efectivo, expulsa la tarjeta y imprime un comprobante de transacci\u00f3n.<\/p>\n<\/li>\n
- \n
El cliente recoge el efectivo, la tarjeta y el comprobante.<\/p>\n<\/li>\n<\/ol>\n
Extensiones (flujos alternativos y de excepci\u00f3n)<\/h3>\n
- \n
- \n
3a. PIN inv\u00e1lido:<\/strong><\/p>\n
- \n
- \n
El sistema notifica al cliente que el PIN es incorrecto y solicita una nueva entrada.<\/p>\n<\/li>\n
- \n
El cliente ingresa un nuevo PIN.<\/p>\n<\/li>\n
- \n
Continuar en el paso 3.<\/em><\/p>\n<\/li>\n
- \n
Excepci\u00f3n:<\/em>\u00a0Si el cliente ingresa un PIN inv\u00e1lido tres veces consecutivas, el sistema retiene la tarjeta y termina la sesi\u00f3n.<\/p>\n<\/li>\n<\/ol>\n<\/li>\n
- \n
8a. Fondos insuficientes:<\/strong><\/p>\n
- \n
- \n
El sistema muestra un error de \u00abFondos insuficientes\u00bb y solicita al cliente que ingrese una cantidad menor o cancele.<\/p>\n<\/li>\n
- \n
El cliente selecciona \u00abCancelar\u00bb.<\/p>\n<\/li>\n
- \n
El sistema expulsa la tarjeta y termina la sesi\u00f3n.<\/p>\n<\/li>\n<\/ol>\n<\/li>\n<\/ul>\n
Postcondiciones<\/h3>\n
La transacci\u00f3n se registra de forma segura, el saldo de la cuenta se actualiza con precisi\u00f3n, el inventario f\u00edsico de efectivo del cajero se reduce en consecuencia y el terminal vuelve a la pantalla de bienvenida inactiva.<\/p>\n
\n4. Mejores pr\u00e1cticas para la redacci\u00f3n<\/h2>\n
Para garantizar que las descripciones de casos de uso permanezcan accionables, escalables y amigables para desarrolladores, adhiera a estas pautas establecidas:<\/p>\n
- \n
- \n
Mantenga una perspectiva de caja negra:<\/strong>\u00a0Documente\u00a0qu\u00e9<\/em>\u00a0lo que el sistema hace desde la perspectiva del usuario, no\u00a0c\u00f3mo<\/em>\u00a0lo logra internamente. Evite referirse a esquemas de bases de datos, puntos finales de API o posiciones de p\u00edxeles en la interfaz de usuario.<\/p>\n<\/li>\n
- \n
Utilice voz activa y sintaxis clara:<\/strong>\u00a0Use construcciones directas sujeto-verbo para eliminar ambig\u00fcedades.<\/p>\n
- \n
- \n
Evite:<\/em>\u00a0\u201cEl PIN es evaluado por el sistema.\u201d<\/p>\n<\/li>\n
- \n
Preferido:<\/em>\u00a0\u201cEl sistema valida el PIN.\u201d<\/p>\n<\/li>\n<\/ul>\n<\/li>\n
- \n
Represente expl\u00edcitamente las extensiones:<\/strong>\u00a0Vincule siempre los flujos alternativos y de excepci\u00f3n directamente al n\u00famero de paso desde el que se desv\u00edan (por ejemplo,\u00a0
5a<\/code>\u00a0se desv\u00eda del paso 5). Esto preserva la trazabilidad y simplifica la generaci\u00f3n de casos de prueba.<\/p>\n<\/li>\n- \n
Dir\u00edjase a procesos elementales de negocio (EBP):<\/strong>\u00a0Cada caso de uso debe representar una tarea completa y valiosa realizada por un actor en respuesta a un \u00fanico evento de negocio. Evite documentar clics de interfaz de usuario detallados o microinteracciones del sistema.<\/p>\n<\/li>\n
- \n
Separe las precondiciones de los desencadenantes:<\/strong>\u00a0Una precondici\u00f3n es un estado est\u00e1tico (por ejemplo, \u201cEl usuario tiene una sesi\u00f3n activa\u201d), mientras que un desencadenante es una acci\u00f3n din\u00e1mica (por ejemplo, \u201cEl usuario hace clic en \u2018Enviar pedido\u2019\u201d). Mantenerlos separados evita solapamientos l\u00f3gicos y confusi\u00f3n de alcance.<\/p>\n<\/li>\n<\/ol>\n
\n5. Visualizaci\u00f3n de interacciones del sistema<\/h2>\n
Mientras que las narrativas textuales proporcionan profundidad, los modelos visuales ofrecen claridad estructural inmediata. Integrar diagramas de casos de uso y diagramas de secuencia junto con las especificaciones garantiza que los interesados compartan una comprensi\u00f3n unificada de los l\u00edmites del sistema y la ejecuci\u00f3n temporal.<\/p>\n
A. Diagrama de relaciones de casos de uso<\/h3>\n
Este diagrama representa las interacciones del actor, define los l\u00edmites del sistema e ilustra las relaciones de inclusi\u00f3n entre comportamientos reutilizables.<\/p>\n
![\"\"](\"https:\/\/blog.visual-paradigm.com\/wp-content\/uploads\/2026\/05\/img_6a0ff6731cd78.png\")
<\/p>\n\n\nPlantUML<\/span>
\n
\n - \n
- \n
- \n
- \n
- \n
- \n
- \n
- \n
- \n