S9 - Diagramas Dinámicos UML¶
1. Introducción¶
Tiempo: 20 min.
1.1 Presentación de la sesión¶
S8 cerró el diagrama de clases de diseño del módulo ventas por capas (Figura 6 de esa guía, explícitamente ubicada como "diagrama de código, nivel 4 de C4" — el zoom máximo del modelo C4, Context, Container, Component, Code, Brown, 2024, dentro de un solo componente del nivel 3): qué clases existen, de qué capa es cada una y quién depende de quién. Ese diagrama es estructural — una fotografía fija de las piezas y sus conexiones posibles —, y para la mayoría de las operaciones de ventas esa fotografía ya basta: buscar y obtener son una llamada directa, sin ramas que se combinen ni colaboraciones repetidas, y la ficha de clase de S8 (Tabla 13) ya dice todo lo que hace falta saber sobre ellas. crear, en cambio, no se deja explicar así: ¿en qué orden exacto colaboran las clases cuando una venta se registra de verdad?, ¿qué pasa si el producto no existe, y qué pasa si no hay stock, y qué pasa si eso ocurre a mitad de un bucle sobre varias líneas? Una misma flecha de dependencia (VentaServiceImpl --> ProductoService) puede significar una llamada, cien llamadas en un bucle, o ninguna si una condición falla antes — el diagrama de clases no distingue esos casos, y por eso una operación como crear sí necesita una vista adicional.
Esta sesión trabaja principalmente en el mismo nivel 4 (Código) que fijó S8, agregando el comportamiento en el tiempo de esas mismas clases con diagramas de secuencia, de actividades, el ciclo de vida de Venta y una vista alternativa de la misma colaboración (comunicación). El modelo C4 nombra este complemento el Dynamic diagram — un diagrama suplementario, no un quinto nivel, que muestra cómo colaboran en tiempo de ejecución los elementos de cualquiera de los cuatro niveles estáticos, y que el propio C4 model define de forma explícita a partir de un diagrama de comunicación UML (Unified Modeling Language, Brown, 2024). Esa flexibilidad de nivel no es solo una nota al pie: 2.6 la usa de verdad, mostrando la misma colaboración de crear una vez más, ahora a nivel Componente (C3) en vez de Código — la misma historia, contada con módulos completos en vez de clases.
Regla general, no solo de esta sesión. Ningún diagrama dinámico de hoy introduce una clase que no esté ya en la Figura 6 de S8: VentaController, VentaServiceImpl, ProductoService, VentaMapper y VentaRepository son exactamente los mismos participantes, vistos ahora en movimiento en vez de en reposo. Un diagrama de secuencia, de actividades o de comunicación no es un modelo aparte con sus propios elementos — es el mismo diagrama de clases, leído desde otro ángulo. El criterio para decidir si hace falta un diagrama dinámico más (hoy, en cualquier otro módulo de BomERP, o en cualquier proyecto futuro) es siempre el mismo: se agrega uno nuevo cuando el diagrama de clases, por sí solo, deja de alcanzar para entender cómo fluye un caso de negocio concreto —su orden, sus decisiones combinadas, su concurrencia—, nunca para describir clases o relaciones que el diagrama de clases todavía no tiene. Si un escenario necesitara una clase que no existe en la Figura 6, la tarea no es dibujarla dentro del diagrama de secuencia: es volver a S8 y extender el diagrama de clases primero. 2.2 convierte esta regla en un criterio verificable, con ejemplos reales de ventas a ambos lados.
El porqué de modelar explícitamente el orden en el tiempo y la continuidad del estado de un objeto —no solo las dependencias que ya existen— se desarrolla en 1.6, a partir de un caso real reciente.
1.2 Índice¶
- Cuándo hace falta (y cuándo no) un diagrama dinámico adicional.
- Diagrama de secuencia: colaboración ordenada en el tiempo.
- Diagrama de actividades: flujo de decisión del proceso de negocio.
- Ciclo de vida de objetos (diagrama de estados, opcional).
- Interacción entre componentes: la misma colaboración, a otro nivel de zoom.
- Diagrama de comunicación: la misma colaboración, otra vista.
1.3 Propósito de aprendizaje¶
Al concluir la clase, estarás en condiciones de:
- Decidir, con un criterio verificable, qué operaciones de tu propio diseño necesitan un diagrama dinámico y cuáles no, modelar la que sí lo necesita con secuencia, actividades, ciclo de vida, interacción entre componentes y comunicación —reutilizando siempre las mismas clases del diagrama de S8—, y verificar que responsabilidades, mensajes y componentes sean consistentes entre todos los diagramas dinámicos y el diagrama de clases.
1.4 Producto de sesión¶
Catálogo de diagramas dinámicos del escenario "registrar una venta" de BomERP: la decisión documentada de qué operaciones de VentaController sí necesitan un diagrama dinámico y cuáles no, con su justificación; diagrama de secuencia de la operación elegida (crear) con los casos alternativos de error (producto inexistente, stock insuficiente); diagrama de actividades equivalente organizado por carriles (swimlanes); diagrama de ciclo de vida de Venta (con sus estados diseñados desde S7, y la brecha real frente a S8/LP2 identificada); diagrama de interacción entre los componentes ventas y catalogo para el mismo escenario, a nivel C3; diagrama de comunicación de la misma colaboración del diagrama de secuencia; y una matriz de consistencia que cruza cada mensaje contra las fichas de clase de S8.
1.5 Metodología¶
Tabla 1. Metodología de la sesión
| Actividades a Realizar en el Periodo | Orientaciones generales (Orientaciones Metodológicas) | Material de estudio recomendado |
|---|---|---|
| Revisión previa individual | Releer el diagrama de clases por capas del módulo propio (S8, Figura 6) y las fichas de clase (S8, Tablas 12-15): qué recibe y devuelve cada operación. Trabajo individual, antes de clase. | S8 (Figura 6, Tablas 10-15). |
| Clase presencial | Decisión guiada de qué operaciones de ventas necesitan diagrama dinámico, y construcción de los diagramas de secuencia, actividades, ciclo de vida, interacción entre componentes y comunicación de la operación elegida, con la matriz de consistencia final. Trabajo individual, siguiendo al docente paso a paso; consulta inmediata ante dudas sobre fragmentos alternativos o concurrencia. |
Pasos 3.1 a 3.7 de esta guía. |
| Evaluación formativa | Revisión en clase del criterio de decisión aplicado, del diagrama de secuencia y de la matriz de consistencia. La evidencia se completa y sustenta de forma individual, fuera del aula, según los criterios mínimos de la sección 4.4. | Indicaciones de entrega (4.3), rúbrica de evaluación (4.6). |
1.6 Motivación de la sesión¶
1.6.1 Caso: los seis segundos que el auto autónomo de Uber perdió reclasificando a una persona¶
El 18 de marzo de 2018, en Tempe (Arizona), un vehículo autónomo de pruebas de Uber atropelló y mató a Elaine Herzberg mientras cruzaba una calle fuera de un paso peatonal señalizado. El sistema la detectó 6 segundos antes del impacto — tiempo de sobra para frenar —, pero durante esos 6 segundos el software de percepción no logró sostener una identidad estable para ese objeto: lo clasificó primero como "objeto desconocido", después como "vehículo" y después como "bicicleta", y cada vez que cambiaba de clasificación, descartaba el historial de trayectoria que ya había acumulado, porque el sistema no tenía una categoría de predicción de ruta para un peatón que cruza fuera de un cruce señalizado.
Fuente: National Transportation Safety Board. (2019). Collision Between Vehicle Controlled by Developmental Automated Driving System and Pedestrian (Highway Accident Report NTSB/HAR-19/03). https://www.ntsb.gov/investigations/accidentreports/reports/har1903.pdf
Recién 1.3 segundos antes del impacto el sistema determinó que hacía falta frenar de emergencia — pero el frenado automático de emergencia estaba deshabilitado a propósito durante las pruebas (para evitar maniobras "erráticas"), y la conductora de respaldo, que podía haber frenado a mano, no estaba atenta a la vía en ese momento.
El problema de fondo no fue "clasificar mal" — fue tratar cada reclasificación como si fuera un objeto nuevo, sin un ciclo de vida propio, en vez de la misma entidad que cambia de estado conservando su historia. Ningún diagrama de clases hubiera mostrado esto: las clases "objeto desconocido", "vehículo" y "bicicleta" podían estar perfectamente diseñadas por separado, cada una con sus propios atributos correctos. Lo que faltaba era exactamente lo que esta sesión construye: un diagrama de estados que dejara explícito qué información se conserva (y qué no debería perderse nunca) cuando un mismo objeto transita de un estado a otro, y un diagrama de secuencia con los tiempos reales, que hubiera hecho visible la ventana de 6 segundos desperdiciada antes de que el sistema decidiera actuar.
Preguntas de análisis
Activación de conocimientos previos
- Antes de leer la causa técnica, ¿por qué "detectar algo a tiempo" no sirve de nada si el sistema no conserva lo que ya sabía sobre ese mismo objeto?
Comprensión de los diagramas dinámicos
- Según el caso, ¿qué tendría que mostrar un diagrama de estados del objeto detectado para que el equipo notara que cada reclasificación borraba el historial de trayectoria acumulado?
- En tu propio proyecto, ¿hay algún objeto (como
Venta) cuyo comportamiento dependa de en qué estado se encuentra, y no solo de qué datos tiene?
1.7 Ubicación en el curso¶
- Producto del curso: Diseño Técnico Profesional Documentado.
- Producto de unidad: Catálogo UML con patrones de diseño e integración aplicados.
- Avance del producto en esta sesión: diagramas dinámicos (secuencia, actividades, ciclo de vida, interacción entre componentes, comunicación) de un escenario crítico de un módulo, verificados contra las clases y fichas de S8.
Figura 1. Roadmap del producto de la unidad
flowchart TB
S6["`**S6:** Descubrimiento y modelado del dominio`"]
S7["`**S7:** Diseño de clases del dominio`"]
S8["`**S8:** Diseño de clases avanzado y transformación OR`"]
S9["`**S9:** Diagramas dinámicos UML`"]
S10["`**S10:** Patrones de diseño (GoF y GRASP)`"]
S11["`**S11:** Integración y sistemas empresariales`"]
S12["`**S12:** Producto U2`"]
S6 --> S7 --> S8 --> S9 --> S10 --> S11 --> S12
classDef today fill:#ffe08a,stroke:#9a6b00,stroke-width:2px,color:#111;
class S9 today;
2. Explica¶
Tiempo: 40 min.
2.1 Arquitectura de la sesión¶
Figura 2. Del diagrama de clases por capas a los diagramas dinámicos
flowchart TB
A[Diagrama de clases por capas<br/>S8, Figura 6] --> Dec{"Necesita diagrama<br/>dinamico? (2.2)"}
Dec -- No --> Ficha[La ficha de clase de S8<br/>ya explica todo]
Dec -- Si --> B[Diagrama de secuencia:<br/>mensajes en el tiempo]
B --> C[Diagrama de actividades:<br/>flujo de decision por carriles]
A --> D[Ciclo de vida de objetos:<br/>estados y transiciones]
B --> G[Interaccion entre componentes:<br/>mismo escenario, nivel C3]
B --> E[Diagrama de comunicacion:<br/>misma colaboracion, otra vista]
C --> F[Matriz de consistencia:<br/>responsabilidades, mensajes, componentes]
D --> F
G --> F
E --> F
Lectura del diagrama: no toda operación de la Figura 6 de S8 llega al mismo punto. Primero se decide (2.2) si la operación necesita un diagrama dinámico; si no lo necesita, la ficha de clase de S8 queda como la documentación completa, sin diagramas adicionales. Si sí lo necesita, los cinco diagramas de hoy convergen en una sola verificación — la matriz de consistencia — que confirma que ninguno contradice al diagrama de clases ni a los otros. Cuatro de los cinco viven dentro del mismo nivel 4 (Código) de C4 que ya fijó la Figura 6 de S8 — ninguno dibuja un componente nuevo ni cruza a nivel 3 (salvo la llamada puntual a ProductoService, que ya era una dependencia entre componentes documentada en S8) —; el quinto, la interacción entre componentes (2.6), sube deliberadamente a nivel 3, mostrando la misma colaboración sin bajar a clases. Todos corresponden, en conjunto, a lo que el propio modelo C4 llama un Dynamic diagram (1.1): la vista suplementaria que muestra cómo colaboran en tiempo de ejecución los elementos que un diagrama estático ya fijó, en el nivel que haga falta. Cada apartado siguiente desarrolla uno de los bloques, en el mismo orden del Índice (1.2).
2.2 Cuándo hace falta (y cuándo no) un diagrama dinámico adicional¶
Dibujar un diagrama dinámico para cada operación del sistema —incluidas las triviales— no agrega información: solo repite, en otro formato, lo que la ficha de clase de S8 ya dice en una fila. El criterio para decidir si una operación concreta lo necesita no es "¿esta operación es importante?", sino una pregunta más precisa: ¿el diagrama de clases y la ficha de S8 ya explican por completo cómo fluye esta operación, o hay algo —orden, ramas combinadas, repetición, coordinación entre componentes— que solo se ve dibujando el tiempo?
Tabla 2. Señales de que una operación necesita un diagrama dinámico
| Señal | ¿Aporta un diagrama dinámico? | Ejemplo real en VentaController (S8) |
|---|---|---|
| Una sola llamada, sin bucles ni ramas que se combinen | No — la ficha de clase ya lo dice completo | obtener(id) (S8, Tabla 13): una búsqueda, un 404 si no existe. Una fila de tabla alcanza. |
| Varios filtros opcionales, pero sin colaboración entre distintos objetos | No — sigue siendo una sola llamada al repositorio | buscar(...), resumen(...) (S8, Tabla 13): arman un Sort y delegan; no hay nada que una secuencia muestre mejor que la firma de la operación. |
| Bucle sobre una colección, con una colaboración por elemento | Sí — un bucle no se ve en una fila de tabla | crear(request): una iteración por cada línea de detalles, con dos llamadas a ProductoService en cada vuelta. |
| Más de una condición que se combina o se anida (no solo "si falla, error X") | Sí — las condiciones compuestas se pierden en una tabla plana | crear: ¿existe el producto? Y solo si existe, ¿hay stock suficiente? |
| Colaboración entre dos o más componentes/módulos distintos | Sí — una sola flecha de dependencia no distingue una llamada de muchas, ni en qué orden | crear llama al ProductoService del módulo catalogo, dentro del bucle; buscar/obtener no colaboran con ningún otro módulo. |
| Comportamiento "todo o nada" (transaccional) que depende del orden de varias llamadas | Sí — el efecto conjunto no cabe en una ficha de una sola operación | crear (RN6, S8): si cualquier línea falla, toda la venta y todo el stock descontado se deshacen. |
Aplicando esta tabla a las cuatro operaciones reales de VentaController (S8, Figura 6): buscar, obtener y resumen no activan ninguna señal — son una llamada directa, sin bucles, sin ramas combinadas, sin colaboración entre módulos. crear activa las cuatro señales de la columna "Sí" a la vez. Por eso esta sesión construye los diagramas dinámicos únicamente sobre crear (3.1), y no sobre las otras tres operaciones del mismo controlador — no por ser la más importante, sino por ser la única donde el diagrama de clases deja de alcanzar.
2.3 Diagrama de secuencia: colaboración ordenada en el tiempo¶
Un diagrama de secuencia muestra los objetos que participan en un escenario como líneas verticales (lifelines) y los mensajes entre ellos como flechas horizontales, leídas de arriba hacia abajo en el orden en que ocurren (OMG, 2017). Es el diagrama dinámico más directo para responder la pregunta que el diagrama de clases no puede: en un escenario concreto, ¿quién llama a quién, en qué orden, y qué pasa si algo falla a mitad de camino? Larman (2004) lo ubica, junto con las tarjetas CRC (Class-Responsibility-Collaboration), como una de las herramientas más usadas en la práctica para explorar cómo se reparten las responsabilidades entre objetos durante el diseño — no solo para documentar después de programar, sino para decidir antes el reparto de la Figura 6 de S8.
Tabla 3. Elementos de un diagrama de secuencia en Mermaid
| Elemento | Sintaxis Mermaid | Qué representa |
|---|---|---|
| Participante | participant VentaController |
Un objeto o actor del escenario — siempre una clase que ya existe en el diagrama de S8 (1.1). |
| Mensaje síncrono | A->>B: mensaje(parametros) |
Una llamada a operación; quien llama espera la respuesta. |
| Mensaje de retorno | B-->>A: resultado |
El valor devuelto por la llamada. |
| Activación | activate B / deactivate B |
El objeto B está ejecutando la operación recibida. |
| Fragmento alternativo | alt condición ... else ... end |
Caminos que se excluyen entre sí — por ejemplo, producto existe o no existe. |
| Fragmento de repetición | loop por cada detalle ... end |
Un bloque de mensajes que se repite — por ejemplo, una línea por cada producto de la venta. |
| Fragmento paralelo | par rama A ... and rama B ... end |
Dos o más bloques de mensajes que ocurren al mismo tiempo, no uno después del otro. |
Dos detalles no son decorativos: la flecha ->> (síncrona, continua) es distinta de -->>(el retorno, discontinua) — confundirlas hace que el diagrama diga que el emisor no espera respuesta cuando sí la espera, y por eso el diagrama "miente" sobre el orden real. Y un fragmento alt sin su else oculta exactamente el tipo de camino alternativo (un error, una condición de borde) que conviene dejar explícito, no implícito en la cabeza de quien lo dibujó.
par, para cuando sí hace falta. Ninguno de los fragmentos anteriores (alt, loop) sirve para mostrar dos cosas ocurriendo a la vez — para eso existe par, que declara ramas concurrentes en vez de secuenciales. Es útil, por ejemplo, cuando un sistema dispara dos llamadas independientes al mismo tiempo (notificar a dos servicios externos, dos procesos que no dependen entre sí) y el orden relativo entre ellas importa para detectar un riesgo real: sin par, un diagrama de secuencia da a entender, por omisión, que todo ocurre uno después de otro, aunque en producción corra en paralelo — y dos flujos que comparten un dato sin ningún mecanismo que los sincronice son, justamente, el tipo de riesgo que un diagrama puramente secuencial no puede exponer. El escenario de crear que esta sesión modela (3.2) es, a propósito, secuencial de punta a punta — no lanza nada en paralelo, y por eso no usa par —; cualquier escenario futuro de BomERP que sí ejecute dos llamadas a la vez debe usar este fragmento para que ese riesgo quede visible antes de programarlo, no después de un incidente.
Un primer ejemplo, deliberadamente simple. Antes de enfrentar un escenario con bucles y condiciones anidadas (3.2), conviene fijar la notación de la Tabla 3 sobre algo corto. obtener(id) (S8, Tabla 13) sirve para eso: una sola búsqueda, un único fragmento alt, sin repetición ni colaboración entre módulos.
Figura 3. Diagrama de secuencia simple: consultar una venta por id
sequenceDiagram
actor Vendedor
participant VC as VentaController
participant VS as VentaServiceImpl
participant VR as VentaRepository
participant VM as VentaMapper
Vendedor->>VC: GET /api/v1/ventas/{id}
activate VC
VC->>VS: obtener(id)
activate VS
VS->>VR: findById(id)
activate VR
alt venta no existe
VR-->>VS: ResourceNotFoundException (404)
else venta existe
VR-->>VS: Venta
deactivate VR
VS->>VM: toResponse(venta)
VM-->>VS: VentaResponse
end
deactivate VS
VS-->>VC: VentaResponse
VC-->>Vendedor: 200 OK
deactivate VC
Cinco elementos de la Tabla 3 aparecen aquí y en ningún otro orden: una llamada síncrona (->>), su retorno (-->>), activación/desactivación, y un único alt con su else. No hay loop ni par porque no hacen falta — esas piezas se introducen recién en 3.2, cuando el escenario las exige de verdad.
Este primer ejemplo no contradice la decisión de 2.2: obtener sigue sin necesitar un diagrama dinámico en el catálogo real de esta sesión — una sola fila de la Tabla 13 de S8 ya la explica por completo (3.1 la deja fuera a propósito). Se dibuja aquí únicamente como ejercicio de lectura de la notación, antes de aplicarla al escenario que sí la necesita.
2.4 Diagrama de actividades: flujo de decisión del proceso de negocio¶
Un diagrama de actividades modela el flujo de un proceso como una serie de pasos conectados por transiciones, con nodos de decisión (rombos) donde el flujo se bifurca según una condición (OMG, 2017). A diferencia del diagrama de secuencia —centrado en qué objeto envía cada mensaje—, el diagrama de actividades se centra en la lógica del proceso: qué pasa primero, qué decisión se toma, y qué ocurre en cada rama. Mermaid no tiene un tipo de diagrama llamado "actividad"; se construye con flowchart, el mismo tipo ya usado en S2 y S8 para otros propósitos — la diferencia es de contenido (un proceso de negocio con decisiones), no de sintaxis.
Carriles (swimlanes). Cuando un proceso cruza varias capas o roles — como ocurre siempre que el escenario llega hasta el backend —, conviene agrupar los pasos por quién los ejecuta. Mermaid no tiene swimlanes nativos; esta guía usa subgraph (un rectángulo con título) para representar cada carril, mismo recurso que ADS ya usa para otros propósitos.
Tabla 4. Diagrama de secuencia frente a diagrama de actividades
| Diagrama de secuencia | Diagrama de actividades | |
|---|---|---|
| Pregunta que responde | ¿Quién envía qué mensaje a quién, y en qué orden? | ¿Qué decisión se toma, y qué camino sigue el proceso en cada caso? |
| Eje principal | Los objetos (una columna por clase) | Los pasos del proceso (uno por nodo) |
| Mejor para | Verificar contratos entre clases concretas | Explicar el proceso de negocio a alguien que no programa |
| Nodo de decisión | Fragmento alt |
Rombo con una condición |
2.5 Ciclo de vida de objetos (diagrama de estados, opcional)¶
Un diagrama de estados (o de ciclo de vida de objetos) muestra los estados posibles de un objeto y las transiciones válidas entre ellos — y, por omisión, cualquier transición no dibujada queda prohibida (OMG, 2017). No todo objeto necesita uno: el mismo criterio de 2.2 aplica aquí, con una pregunta más específica — tiene sentido solo cuando el comportamiento de un objeto depende de en qué estado se encuentra, no solo de sus datos. El propio sílabo marca este diagrama como "opcional" dentro del catálogo dinámico, precisamente porque esa condición no siempre se cumple.
El caso de 1.6 es, en el fondo, un problema de ciclo de vida mal modelado: el sistema trataba cada reclasificación del mismo objeto como si fuera una entidad nueva, descartando la historia de trayectoria que ya había acumulado, en vez de una transición de estado que conserva lo aprendido hasta ese momento. Un diagrama de estados completo, con sus transiciones explícitas y lo que cada una conserva o descarta, es una de las formas más directas de detectar ese tipo de hueco antes de escribir el código.
Cuándo sí vale la pena este diagrama:
- El objeto tiene al menos dos estados distintos con comportamiento o permisos diferentes (por ejemplo, una venta
REGISTRADAse puede anular; unaANULADAno se puede volver a anular). - Existen reglas que prohíben ciertas transiciones (una venta
ANULADAnunca vuelve aREGISTRADA).
Cuándo no aporta: un objeto con un único estado posible, o cuyo único "estado" es en realidad un atributo que no cambia el comportamiento del resto del sistema — documentarlo igual sería dibujar un diagrama con un solo nodo y ninguna transición, que no añade información sobre la estructura de clases que S8 no tenga ya.
2.6 Interacción entre componentes: la misma colaboración, a otro nivel de zoom¶
Los diagramas de 2.3 a 2.5 se quedan dentro de un solo componente: muestran las clases de ventas y, cuando corresponde, una llamada puntual a ProductoService de catalogo — siempre a nivel Código (C4, nivel 4). Pero el Dynamic diagram de C4 (1.1) no está atado a ese nivel: la misma pregunta —¿quién colabora con quién, y en qué orden?— se puede hacer también a nivel Componente (C3), reemplazando cada clase por el módulo completo al que pertenece.
Un diagrama de interacción entre componentes muestra esa misma colaboración, pero con cajas de componente en vez de clases: en vez de VentaServiceImpl --> ProductoService, se dibuja ventas --> catalogo. No es un diagrama con reglas distintas — es el mismo diagrama de secuencia o de comunicación de siempre, construido sobre el diagrama de componentes de S2 en vez de sobre el diagrama de clases de S8.
Tabla 5. Mismo escenario, dos niveles de zoom
| Código (C4, Figura 4) | Componente (C3, Figura 7) | |
|---|---|---|
| Participantes | Clases concretas: VentaController, VentaServiceImpl, ProductoService, VentaMapper, VentaRepository |
Módulos completos: ventas, catalogo |
| Qué se ve | Cada capa, cada clase, cada responsabilidad interna | Solo qué módulo le pide qué a cuál, y cuántas veces |
| Para quién | Quien programa dentro de ventas: necesita saber qué hace cada clase |
Quien revisa la arquitectura o el diagrama de componentes de S2: no necesita (ni debe) ver clases internas de catalogo |
| Corresponde a | S8, Figura 6 (diagrama de código) | S2 (diagrama de componentes, C3) |
Esta vista es la que corresponde directamente al diagrama de componentes estático de S2 (C3): si ese diagrama ya dibujaba una flecha ventas → catalogo, esta sección muestra, para el escenario crear, cuántas veces se usa esa flecha y en qué orden — la misma relación entre lo estático y lo dinámico que el resto de la sesión aplica a nivel de clases, ahora aplicada a nivel de componentes.
2.7 Diagrama de comunicación: la misma colaboración, otra vista¶
El diagrama de comunicación (antes llamado de colaboración) representa la misma información que un diagrama de secuencia —qué objetos colaboran y qué mensajes se envían— pero organizada espacialmente, alrededor de las relaciones entre objetos, con los mensajes numerados en vez de ordenados verticalmente (OMG, 2017). Mermaid no tiene un tipo de diagrama de comunicación nativo; esta guía lo representa con flowchart, etiquetando cada arista con el número de secuencia del mensaje (1, 1.1, 1.2, ...) — la misma convención de numeración que usa el estándar UML para este diagrama.
Esta no es una elección libre de notación: el modelo C4 define su propio Dynamic diagram (1.1, 2.1) explícitamente "basado en un diagrama de comunicación UML" (Brown, 2024) — es la vista que el propio C4 model recomienda para mostrar colaboración en tiempo de ejecución, precisamente con mensajes numerados en vez de líneas de vida verticales. El diagrama de esta sección, aplicado hoy al nivel 4 (Código) del módulo ventas, es ese Dynamic diagram en su forma más literal.
Tabla 6. Diagrama de secuencia frente a diagrama de comunicación
| Diagrama de secuencia | Diagrama de comunicación | |
|---|---|---|
| Qué enfatiza | El orden temporal (eje vertical) | Las relaciones estructurales entre objetos (como un grafo) |
| Mejor para | Escenarios largos, con muchos fragmentos alternativos | Ver de un vistazo cuántos objetos distintos colabora uno solo |
| Orden de los mensajes | Posición vertical | Numeración explícita en cada mensaje (1, 1.1, 2, ...) |
| Contenido | El mismo escenario, la misma información | El mismo escenario, la misma información |
Ambos diagramas son, en rigor, dos vistas de la misma información — por eso la matriz de consistencia de 3.7 verifica que los mensajes numerados del diagrama de comunicación sean exactamente los mismos del diagrama de secuencia, ni uno más ni uno menos.
3. Aplica: actividad práctica guiada¶
Tiempo: 100 min.
Actividad: decisión y modelado guiado de los diagramas dinámicos del escenario "registrar una venta" de BomERP, a partir de las clases y fichas del módulo ventas que S8 ya dejó diseñadas y verificadas contra el código real de LP2.
Propósito de la actividad: aplicar un criterio verificable para decidir cuándo un diagrama dinámico aporta información nueva, y llevar el diseño estático de S8 a una vista de comportamiento verificable en el caso que sí lo necesita — detectando, como en el caso de 1.6, qué información de orden, continuidad de estado o tiempo no aparecía todavía en ningún diagrama anterior.
Orientaciones metodológicas: en el laboratorio, el docente aplica el criterio de decisión y modela el escenario de ventas paso a paso frente a la clase; los estudiantes completan los mismos pasos para un escenario crítico de su propio proyecto (ver sección 4).
Actividades para realizar:
- 3.1 Decidir qué operaciones de
ventasnecesitan un diagrama dinámico. - 3.2 Diagramar la secuencia de "registrar una venta".
- 3.3 Diagramar las actividades del mismo proceso, por carriles.
- 3.4 Evaluar y diagramar el ciclo de vida de
Venta. - 3.5 Diagramar la interacción entre
ventasycatalogo, a nivel de componente. - 3.6 Diagramar la comunicación de la misma colaboración.
- 3.7 Armar la matriz de consistencia.
3.1 Decidir qué operaciones de ventas necesitan un diagrama dinámico¶
Producto del paso: una decisión explícita y documentada, aplicando la Tabla 2 (2.2) a las cuatro operaciones reales de VentaController (S8, Figura 6).
Tabla 7. Decisión aplicada a VentaController
| Operación | Bucle | Condiciones combinadas | Colaboración entre módulos | Transaccional | ¿Diagrama dinámico? |
|---|---|---|---|---|---|
buscar(...) |
No | No | No | No | No — la Tabla 13 de S8 ya es la documentación completa. |
resumen(...) |
No | No | No | No | No — mismo caso que buscar. |
obtener(id) |
No | No (un solo 404) |
No | No | No — una búsqueda y un error posible caben en una fila. |
crear(request) |
Sí (una vuelta por línea) | Sí (¿existe? → ¿hay stock?) | Sí (ProductoService, módulo catalogo) |
Sí (RN6, S8) | Sí — las cuatro señales de la Tabla 2 se activan a la vez. |
El resto de esta sesión (3.2 a 3.6) modela únicamente crear — no porque las otras tres operaciones sean menos importantes para el negocio, sino porque son las únicas donde el diagrama de clases de S8, con su ficha de operación, deja de ser suficiente para entender el flujo.
3.2 Diagramar la secuencia de "registrar una venta"¶
Producto del paso: diagrama de secuencia del escenario POST /api/v1/ventas (la operación seleccionada en 3.1), con los dos caminos de error ya identificados en S8 (Tabla 10: RN1, RN2).
El escenario se construye directamente sobre el código real de VentaServiceImpl.crear (no sobre una versión idealizada): un bucle por cada línea de la venta, que consulta el producto, descuenta su stock, y solo si ambas operaciones tienen éxito arma el detalle y lo agrega a la venta.
Figura 4. Diagrama de secuencia: registrar una venta
sequenceDiagram
actor Vendedor
participant VC as VentaController
participant VS as VentaServiceImpl
participant PS as ProductoService
participant VM as VentaMapper
participant VR as VentaRepository
Vendedor->>VC: POST /api/v1/ventas (VentaRequest)
activate VC
VC->>VS: crear(request)
activate VS
loop por cada DetalleVentaRequest
VS->>PS: obtener(productoId)
activate PS
alt producto no existe
PS-->>VS: ResourceNotFoundException (404)
else producto existe
PS-->>VS: ProductoResponse
deactivate PS
VS->>PS: descontarStock(productoId, cantidad)
activate PS
alt stock insuficiente
PS-->>VS: StockInsuficienteException (409)
else stock suficiente
PS-->>VS: stock actualizado
deactivate PS
VS->>VM: toDetalle(detalleRequest, producto)
VM-->>VS: DetalleVenta
end
end
end
VS->>VR: save(venta)
activate VR
VR-->>VS: Venta guardada
deactivate VR
VS->>VM: toResponse(venta)
VM-->>VS: VentaResponse
deactivate VS
VS-->>VC: VentaResponse
VC-->>Vendedor: 201 Created
deactivate VC
Tres lecturas que el diagrama de clases de S8 no podía mostrar — exactamente las señales que 3.1 marcó para crear:
- El
loopes nuevo. La flechaVentaServiceImpl --> ProductoServicede la Figura 6 de S8 solo decía que existe esa dependencia — no decía que, con una venta de cinco líneas,ProductoService.obtenerydescontarStockse llaman cinco veces cada uno, una vez por línea. - Dos
altdistintos, con dos errores distintos, anidados. RN1 (producto inexistente) y RN2 (stock insuficiente) ya estaban en la Tabla 10 de S8 como filas de una tabla; acá se ven como decisiones que ocurren dentro del mismo bucle, en un orden específico: primero se verifica que el producto exista, y solo después se intenta descontar su stock. - La transacción no es un mensaje.
@Transactional(S8, 2.3) envuelve todo el métodocrear, pero no aparece como una flecha — es una propiedad del método completo. Si cualquieraltde error se dispara, toda la transacción se deshace (RN6, S8); el diagrama lo da por entendido, no lo dibuja mensaje por mensaje.
Nota sobre concurrencia: este escenario no usa par (2.3) porque no lo necesita — crear es secuencial de punta a punta, sin ninguna llamada que ocurra a la vez que otra. Eso es, en sí mismo, una propiedad deseable del diseño: ninguna parte de esta operación corre en paralelo con otra, así que no hay ningún estado compartido que dos flujos puedan pisarse.
Error frecuente: dibujar la llamada a descontarStock antes de confirmar que el producto existe (invertir el orden del loop). Si descontarStock se llamara primero sobre un productoId inexistente, ProductoService fallaría con un error distinto al esperado (ni 404 de "producto no encontrado" ni 409 de "stock insuficiente", sino una falla al buscar un producto para descontar). El orden de las llamadas en el diagrama de secuencia es una decisión de diseño, no un detalle de implementación — por eso se verifica en la matriz de 3.7.
3.3 Diagramar las actividades del mismo proceso, por carriles¶
Producto del paso: diagrama de actividades del mismo escenario de 3.2, organizado por quién ejecuta cada paso — útil para explicar el proceso a alguien que no necesita ver clases ni mensajes.
Figura 5. Diagrama de actividades: registrar una venta, por carriles
flowchart TB
subgraph Vendedor["Carril: Vendedor"]
Inicio([Inicio]) --> Enviar[Enviar venta con sus líneas]
end
subgraph Controlador["Carril: VentaController"]
Validar{"¿Petición<br/>bien formada?"}
Validar -- No --> Error400[Responder 400]
end
subgraph Servicio["Carril: VentaServiceImpl"]
Iniciar[Iniciar transaccion]
SiguienteLinea{"¿Quedan<br/>lineas por procesar?"}
ArmarDetalle[Armar detalle y sumar al total]
Guardar[Guardar venta con sus detalles]
end
subgraph Catalogo["Carril: ProductoService (modulo catalogo)"]
Existe{"¿Producto<br/>existe?"}
Stock{"¿Stock<br/>suficiente?"}
Descontar[Descontar stock]
end
Enviar --> Validar
Validar -- Si --> Iniciar
Iniciar --> SiguienteLinea
SiguienteLinea -- Si --> Existe
Existe -- No --> Error404[Deshacer transaccion: 404]
Existe -- Si --> Stock
Stock -- No --> Error409[Deshacer transaccion: 409]
Stock -- Si --> Descontar
Descontar --> ArmarDetalle
ArmarDetalle --> SiguienteLinea
SiguienteLinea -- No --> Guardar
Guardar --> Fin([201 Created])
Lectura cruzada con la Figura 4: cada rombo del diagrama de actividades (¿Producto existe?, ¿Stock suficiente?) corresponde exactamente a un fragmento alt del diagrama de secuencia — son la misma decisión, en dos notaciones distintas. Si un rombo de este diagrama no tuviera su alt equivalente en la Figura 4 (o viceversa), sería una inconsistencia real que la matriz de 3.7 existe para detectar.
3.4 Evaluar y diagramar el ciclo de vida de Venta¶
Producto del paso: una decisión explícita sobre si Venta necesita un diagrama de estados (2.5), y el diagrama correspondiente.
El código real de EstadoVenta (LP2) declara hoy un único valor:
public enum EstadoVenta {
REGISTRADA
}
Con un solo estado posible, Venta no tiene todavía un ciclo de vida implementado que dibujar — pero sí tiene uno diseñado, desde antes de esta sesión: S7 ya modeló anular() como operación real de Venta, con la restricción {estado = 'REGISTRADA'} como precondición (S7, Tabla 5 y Figura de clases del dominio). El criterio de 2.5 (¿el comportamiento depende del estado?) ya estaba resuelto en el dominio — lo que faltaba era la vista que lo hiciera explícito como ciclo de vida, no la decisión en sí.
Al revisar la Figura 4 de S8 (clases de diseño, derivada del dominio de S7) aparece una brecha real: anular() no quedó entre las operaciones de Venta cuando S8 refinó el dominio a clases de diseño, y por eso tampoco está en EstadoVenta de LP2 (hoy, un único valor: REGISTRADA). El diagrama de esta sección documenta el ciclo de vida tal como S7 lo diseñó, y dejar constancia de esa brecha —no inventar la transición de la nada— es exactamente lo que la matriz de consistencia de 3.7 existe para capturar.
Figura 6. Ciclo de vida de Venta (diseñado en S7; brecha: S8 y LP2 todavía no lo llevan al diseño de clases ni al código)
stateDiagram-v2
[*] --> REGISTRADA : crear() exitoso
REGISTRADA --> ANULADA : anular() [S7]
ANULADA --> [*]
REGISTRADA --> [*] : consulta (sin cambio de estado)
note right of ANULADA
Diseñado en S7, sin bajar a S8 ni a LP2:
restaura el stock descontado de cada
DetalleVenta (operacion inversa de
descontarStock, S8 2.5)
end note
Tabla 8. Transiciones del ciclo de vida de Venta
| Transición | Disparada por | Precondición | Efecto |
|---|---|---|---|
[*] → REGISTRADA |
crear() (ya implementado, S8 3.3) |
RN1, RN2 cumplidas para cada línea | Venta guardada, stock descontado |
REGISTRADA → ANULADA |
anular() (diseñada en S7; brecha: sin refinar en S8, sin implementar en LP2) |
La venta está en REGISTRADA; ningún rol distinto de SUPERVISOR/ADMIN puede anular (permiso pendiente de definir, mismo criterio que RN8 de S8) |
El stock de cada DetalleVenta se restaura; la venta no se elimina, queda marcada |
ANULADA → * |
Ninguna | — | No existe ninguna transición válida desde ANULADA: es un estado final para el ciclo de negocio |
Error frecuente: dibujar una transición ANULADA → REGISTRADA "por si acaso se necesita revertir". Un diagrama de estados que permite volver a un estado anterior sin una regla de negocio real que lo justifique no documenta un camino más flexible — documenta una regla que no existe y que, si se programa tal cual, dejaría reactivar una venta anulada sin ningún control. Si tu propio dominio sí necesita revertir un estado, la transición debe nombrar una operación concreta y sus condiciones, no quedar implícita.
3.5 Diagramar la interacción entre ventas y catalogo, a nivel de componente¶
Producto del paso: la misma colaboración de 3.2, redibujada a nivel Componente (C3, 2.6) — sin ninguna clase, solo los dos módulos que participan.
Figura 7. Interacción entre componentes: registrar una venta (nivel C3)
sequenceDiagram
actor Vendedor
participant Ventas as ventas (componente)
participant Catalogo as catalogo (componente)
Vendedor->>Ventas: POST /api/v1/ventas (VentaRequest)
activate Ventas
loop por cada DetalleVentaRequest
Ventas->>Catalogo: obtener(productoId)
activate Catalogo
Catalogo-->>Ventas: ProductoResponse (o 404)
deactivate Catalogo
Ventas->>Catalogo: descontarStock(productoId, cantidad)
activate Catalogo
Catalogo-->>Ventas: stock actualizado (o 409)
deactivate Catalogo
end
Note over Ventas: Arma y guarda la venta<br/>internamente (detalle en Figura 4)
Ventas-->>Vendedor: 201 Created
deactivate Ventas
Lectura cruzada con la Figura 4: los cinco participantes de nivel Código (VentaController, VentaServiceImpl, ProductoService, VentaMapper, VentaRepository) se colapsan en dos cajas de componente (ventas, catalogo). Las dos llamadas por línea (obtener, descontarStock) siguen apareciendo — porque cruzan el límite del componente, que es justamente lo que esta vista quiere mostrar —, pero toDetalle y save desaparecen: son colaboración interna de ventas, invisible a este nivel de zoom, y por eso el diagrama las resume en una sola nota ("Arma y guarda la venta internamente"). Si este diagrama mostrara una clase, o una llamada interna de ventas que nunca cruza a catalogo, dejaría de ser un diagrama de componentes y volvería a ser el de la Figura 4 con otro nombre.
Error frecuente: dibujar aquí una flecha directa ventas --> BOM_CATALOGO.PRODUCTOS (la tabla) en vez de ventas --> catalogo (el componente). A nivel de interacción entre componentes, el destino de cada mensaje es siempre otro componente completo, nunca una clase, una tabla o un detalle de implementación interno — ese nivel de detalle es, precisamente, lo que esta vista decide no mostrar.
3.6 Diagramar la comunicación de la misma colaboración¶
Producto del paso: diagrama de comunicación del mismo escenario de 3.2, con los mensajes numerados (2.7).
Figura 8. Diagrama de comunicación: registrar una venta
flowchart LR
Vendedor((Vendedor))
VC[VentaController]
VS[VentaServiceImpl]
PS[ProductoService]
VM[VentaMapper]
VR[VentaRepository]
Vendedor -->|"1: crear(request)"| VC
VC -->|"1.1: crear(request)"| VS
VS -->|"1.1.1: obtener(productoId)"| PS
VS -->|"1.1.2: descontarStock(productoId, cantidad)"| PS
VS -->|"1.1.3: toDetalle(detalleRequest, producto)"| VM
VS -->|"1.2: save(venta)"| VR
VS -->|"1.3: toResponse(venta)"| VM
Lectura del diagrama: la numeración 1.1.1, 1.1.2, 1.1.3 dentro de 1.1 representa el mismo loop de la Figura 4 — todos esos mensajes ocurren una vez por cada línea de la venta, anidados dentro de la llamada crear(request). A diferencia de la Figura 4, acá se ve de un vistazo que VentaServiceImpl es el único objeto que colabora con los otros cuatro — ningún otro objeto del escenario llama directamente a ProductoService, VentaMapper o VentaRepository.
3.7 Armar la matriz de consistencia¶
Producto del paso: verificación cruzada de que las Figuras 4 a 8 sean consistentes entre sí y con las fichas de clase de S8 — exactamente lo que pide la columna "Evidencia" del sílabo para esta sesión ("revisar responsabilidades, mensajes y consistencia entre componentes").
Tabla 9. Matriz de consistencia de los diagramas dinámicos de ventas
| Mensaje o decisión | Secuencia (Fig. 4) | Actividades (Fig. 5) | Interacción de componentes (Fig. 7) | Comunicación (Fig. 8) | Ficha de clase (S8) |
|---|---|---|---|---|---|
crear(request) |
Sí | "Enviar venta" → "Validar" → "Iniciar transacción" | Sí (Vendedor → ventas) |
1, 1.1 |
S8, Tabla 13 (VentaService.crear) |
obtener(productoId) |
Sí, dentro del loop |
Rombo "¿Producto existe?" | Sí (ventas → catalogo) |
1.1.1 |
S8, Tabla 13 (RN1) |
descontarStock(productoId, cantidad) |
Sí, dentro del loop |
Rombo "¿Stock suficiente?" | Sí (ventas → catalogo) |
1.1.2 |
S8, Tabla 13 (RN2) |
toDetalle(detalleRequest, producto) |
Sí | "Armar detalle" | No aparece (colaboración interna de ventas, nota en Fig. 7) |
1.1.3 |
S8, Tabla 15 (VentaMapper.toDetalle) |
save(venta) |
Sí | "Guardar venta" | No aparece (colaboración interna de ventas, nota en Fig. 7) |
1.2 |
S8, Tabla 14 (VentaRepository) |
Transición REGISTRADA → ANULADA |
No aplica (otro escenario) | No aplica | No aplica | No aplica | S7 (diseñada); brecha en S8/LP2 (Figura 6) |
buscar, resumen, obtener |
Sin diagrama dinámico (3.1) | Sin diagrama dinámico (3.1) | Sin diagrama dinámico (3.1) | Sin diagrama dinámico (3.1) | S8, Tabla 13 — documentación completa por sí sola |
Ninguna fila quedó vacía ni contradictoria: los cuatro diagramas describen exactamente el mismo escenario (crear), cada mensaje corresponde a una operación ya documentada en las fichas de clase de S8 —no a un mensaje inventado para la sesión de hoy—, las dos ausencias de la columna de interacción entre componentes (toDetalle, save) están explicadas y no son un olvido, y las tres operaciones descartadas en 3.1 quedan registradas explícitamente como "sin diagrama", con su propia justificación.
Evidencia de aprendizaje:
- Decisión documentada de qué operaciones de
ventasnecesitan diagrama dinámico, aplicando un criterio verificable. - Diagrama de secuencia de "registrar una venta", con los fragmentos
altde RN1 y RN2. - Diagrama de actividades equivalente, organizado por carriles.
- Evaluación explícita de si
Ventanecesita un diagrama de estados, con el ciclo de vida diseñado en S7 documentado y su brecha frente a S8/LP2 identificada. - Diagrama de interacción entre
ventasycatalogoa nivel de componente (C3), consistente con el de nivel Código. - Diagrama de comunicación de la misma colaboración, con mensajes numerados.
- Matriz de consistencia entre los cuatro diagramas dinámicos, las fichas de clase de S8, y las operaciones descartadas en 3.1.
4. Crea: actividad autónoma¶
Tiempo: 2h fuera del aula.
4.1 Actividad¶
Modelado dinámico autónomo de un escenario crítico del módulo del proyecto propio del equipo ya diseñado en S8, documentado en evidencia individual.
Completa y evidencia estas tareas:
- Aplicar la Tabla 2 (2.2) a todas las operaciones de tu módulo de S8, en una tabla propia como la Tabla 7 (3.1): marca cuáles tienen bucle, condiciones combinadas, colaboración entre módulos o comportamiento transaccional, y cuáles no. Elige para diagramar la que active más señales — no necesariamente la que te parezca más importante de negocio.
- Diagramar la secuencia completa del escenario elegido, con al menos un fragmento
altpara cada regla que pueda rechazar la operación. Usa exactamente las clases de tu diagrama de S8 (1.1) — si el escenario necesitara una clase que todavía no existe ahí, vuelve primero a S8 y agrégala al diagrama de clases, no la inventes dentro de la secuencia. Si tu escenario tiene algo genuinamente concurrente, usapar(2.3); si no, documenta por qué no hace falta. - Diagramar las actividades del mismo escenario, organizadas por carriles (al menos dos: quien origina la petición y el backend).
- Evaluar si algún objeto de tu módulo necesita un diagrama de ciclo de vida (2.5) — si la respuesta es no, documentar por qué con el mismo criterio de esta guía; si es sí, diagramarlo con sus transiciones y al menos un estado final.
- Redibujar la misma colaboración del punto 2 a nivel de componente (2.6): reemplaza cada clase por el módulo al que pertenece, y conserva solo los mensajes que cruzan el límite entre componentes.
- Diagramar la comunicación de la misma colaboración del punto 2, con los mensajes numerados.
- Armar tu propia matriz de consistencia, cruzando cada mensaje contra tu ficha de clase de S8, incluyendo las operaciones del punto 1 que quedaron sin diagrama, y marcando cualquier inconsistencia encontrada.
4.2 Propósito¶
Que cada estudiante demuestre, de forma individual y fuera del aula, que puede decidir con un criterio verificable cuándo un diagrama dinámico aporta información nueva, y llevar el diseño estático de su propio módulo a una vista de comportamiento verificable en el escenario que sí lo necesita —en más de un nivel de zoom—, detectando inconsistencias entre diagramas antes de que lleguen al código.
4.3 Indicaciones¶
Entrega un PDF con el siguiente nombre:
S09_ADS_Equipo##_ApellidoNombre.pdf
Cada captura de pantalla del informe debe mostrar, sin recortar, el reloj del sistema (fecha y hora) y tu usuario o foto de perfil (Windows, VS Code o navegador) visibles en pantalla — es lo que permite verificar que la evidencia es tuya y que corresponde al momento real de tu trabajo.
4.3.1 Estructura del informe¶
Datos del estudiante
- Nombre:
- Equipo:
- Sesión: S09 - Diagramas Dinámicos UML
- Rol o aporte realizado:
- Link de GitHub:
Evidencia técnica
Incluye capturas o extractos con una breve explicación debajo de cada uno, organizados en los mismos 4 bloques de la rúbrica (4.6):
- Decisión y diagrama de secuencia
- Tabla de decisión aplicada a todas las operaciones de tu módulo, y diagrama de secuencia del escenario elegido, con al menos un fragmento
altpor cada regla de negocio que pueda fallar.
- Tabla de decisión aplicada a todas las operaciones de tu módulo, y diagrama de secuencia del escenario elegido, con al menos un fragmento
- Diagrama de actividades
- Mismo escenario, organizado por carriles, con los mismos puntos de decisión que el diagrama de secuencia.
- Ciclo de vida, interacción entre componentes y comunicación
- Evaluación explícita de si tu objeto necesita diagrama de estados (con el diagrama si corresponde), diagrama de interacción entre componentes a nivel C3, y diagrama de comunicación con mensajes numerados.
- Matriz de consistencia
- Matriz completa, sin filas vacías ni contradictorias, incluidas las operaciones sin diagrama, con cualquier inconsistencia encontrada y cómo se resolvió.
Error o hallazgo
Describe un error real: una operación que creíste que necesitaba diagrama dinámico y, al aplicar la Tabla 2, resultó no necesitarlo (o viceversa), un orden de mensajes que corregiste en el diagrama de secuencia porque invertía una validación, un rombo del diagrama de actividades que no tenía su alt equivalente, una clase que se te coló en el diagrama de interacción entre componentes en vez del módulo completo, o una transición de estado que quitaste por no tener ninguna regla de negocio real detrás.
Reflexión técnica breve
Responde en 5 a 8 líneas:
¿Qué decisión de orden o de continuidad de estado de tu escenario no se
veía en tu diagrama de clases de S8, y solo apareció al dibujar la
secuencia, las actividades o el ciclo de vida? Relaciona tu respuesta
con el caso del vehículo autónomo de Uber (1.6).
4.4 Criterios mínimos de aceptación¶
- El archivo respeta el nombre solicitado.
- Existe una tabla de decisión (como la Tabla 7) aplicada a todas las operaciones del módulo propio, con al menos una marcada "sin diagrama" y justificada.
- El diagrama de secuencia cubre el escenario con más señales de la tabla de decisión, con un fragmento
altpor cada regla de negocio relevante, orden de mensajes correcto, y usa exclusivamente clases que ya existen en el diagrama de clases de S8. - El diagrama de actividades usa carriles y sus puntos de decisión coinciden con los fragmentos
altdel diagrama de secuencia. - Existe una evaluación explícita (sí o no, con justificación) sobre si el objeto elegido necesita un diagrama de ciclo de vida.
- El diagrama de interacción entre componentes usa solo módulos completos (nunca clases ni tablas) y conserva únicamente los mensajes que cruzan el límite entre componentes.
- El diagrama de comunicación representa la misma colaboración del diagrama de secuencia, con mensajes numerados.
- La matriz de consistencia cruza cada mensaje contra la ficha de clase correspondiente de S8, incluye las operaciones sin diagrama, y no tiene filas vacías.
- Cada captura de la evidencia técnica muestra el reloj del sistema y el usuario/perfil visible, sin recortar.
- Las fechas y horas de las capturas son coherentes con el historial de commits de su repositorio en GitHub.
- Incluye un error o hallazgo técnico diagnosticado.
- Incluye la reflexión técnica breve solicitada.
4.5 Preguntas de defensa¶
- De todas las operaciones de tu módulo, ¿cuál tiene más señales de la Tabla 2, y por eso fue la que diagramaste?
- En tu diagrama de secuencia, ¿qué pasaría si el fragmento
altde tu regla de negocio más crítica no existiera? - ¿Por qué el diagrama de actividades usa carriles y el diagrama de secuencia no?
- ¿Qué criterio usaste para decidir si tu objeto necesitaba (o no) un diagrama de ciclo de vida?
- ¿Qué mensajes de tu diagrama de secuencia desaparecieron al redibujarlo a nivel de componente, y por qué esos y no otros?
- ¿Qué diferencia de fondo hay entre un diagrama de secuencia y uno de comunicación, si ambos representan la misma colaboración?
- ¿Tu escenario tiene algo genuinamente concurrente? Si no, ¿por qué no hacía falta usar
par; si sí, ¿por qué no lo usaste (o cómo lo mostrarías)? - Relaciona el caso del vehículo autónomo de Uber (1.6) con algo que tu matriz de consistencia (o la falta de ella) podría haber dejado pasar.
4.6 Rúbrica de evaluación¶
Tabla 10. Rúbrica de evaluación
| Criterio | Peso (%) | A (20 pts) | B (15 pts) | C (10 pts) | D (5 pts) | Nivel obtenido |
|---|---|---|---|---|---|---|
| 1. Decisión y diagrama de secuencia* | 25 | Tabla de decisión completa sobre todas las operaciones del módulo; secuencia del escenario correcto, con fragmentos alt para cada regla y solo clases ya existentes en S8. |
Secuencia completa, con la tabla de decisión o algún fragmento alternativo incompleto. | Secuencia sin fragmentos alternativos, con orden incorrecto, con alguna clase inventada, o sin tabla de decisión. | No presenta decisión ni diagrama de secuencia verificable. | |
| 2. Diagrama de actividades* | 25 | Carriles claros, puntos de decisión coherentes uno a uno con los fragmentos alt del diagrama de secuencia. |
Actividades completas, con algún carril o decisión no alineado con la secuencia. | Actividades sin carriles, o con decisiones que no corresponden a la secuencia. | No presenta diagrama de actividades verificable. | |
| 3. Ciclo de vida, interacción entre componentes y comunicación* | 25 | Los tres presentes y correctos: ciclo de vida evaluado y justificado, interacción entre componentes con solo módulos completos, comunicación consistente con la secuencia. | Los tres presentes, con alguno incompleto (numeración, justificación, o una clase colada en el diagrama de componentes). | Solo dos de los tres presentados correctamente. | Presenta uno o ninguno de los tres. | |
| 4. Matriz de consistencia* | 25 | Matriz completa, sin filas vacías, incluidas las operaciones sin diagrama, con cualquier inconsistencia detectada y resuelta explícitamente. | Matriz completa, con alguna fila superficial. | Matriz incompleta o sin verificar contra las fichas de S8. | No presenta matriz de consistencia. |
* Agregado manual.
Nota final = suma de (Peso / 100 × Puntos del nivel obtenido) = ____ / 20.
Para usar la rúbrica con IA (inteligencia artificial), solicita:
Evalúa el PDF usando la rúbrica de la sesión.
Para cada criterio selecciona el nivel obtenido usando la escala A=20, B=15, C=10, D=5 puntos.
Justifica brevemente cada nivel asignado.
Verifica que cada captura muestre reloj del sistema y usuario/perfil visible, y que las fechas sean coherentes con el historial de commits de GitHub. Si falta esta evidencia o hay inconsistencias, indícalo explícitamente antes de calificar.
Calcula la nota final con la fórmula: suma de (Peso/100 × Puntos del nivel obtenido), directamente sobre 20.
Indica 2 fortalezas y 2 recomendaciones.
5. Cierre¶
Tiempo: 5 min.
Resumen breve: hoy no todas las operaciones de ventas recibieron el mismo tratamiento, y eso fue intencional: un criterio verificable (bucles, condiciones combinadas, colaboración entre módulos, comportamiento transaccional) distinguió crear —que sí necesitaba una vista nueva— de buscar, obtener y resumen —cuya ficha de clase de S8 ya las explica por completo—. Sobre crear, las clases de S8 ganaron una vista de comportamiento en dos niveles de zoom: a nivel Código (C4) un diagrama de secuencia con sus caminos de error, uno de actividades equivalente por carriles, el ciclo de vida de Venta que S7 ya había diseñado (con la brecha real de S8/LP2 identificada) y un diagrama de comunicación de la misma colaboración; y a nivel Componente (C3) la misma historia contada con módulos completos en vez de clases — ambos, el mismo Dynamic diagram que el propio modelo C4 define, aplicado en dos niveles distintos. Una matriz final verificó que todos ellos, las fichas de clase de S8, y las operaciones descartadas dicen exactamente lo mismo, sin contradicciones.
Dinámica participativa: en una ronda rápida, cada estudiante comparte en una frase qué operación de su propio módulo descartó de diagramar, y por qué.
Metacognición: ¿qué te costó más entender hoy: el criterio para decidir si una operación necesita un diagrama dinámico, o qué mensajes desaparecen al subir del nivel Código al nivel Componente?
Proyección: S10 explica por qué las clases de ventas están organizadas así —con los patrones GoF (Gang of Four) y GRASP (General Responsibility Assignment Software Patterns) que respaldan cada responsabilidad de la Figura 6 de S8 y cada decisión que hoy se vio en acción en la Figura 4.
Bibliografía¶
- National Transportation Safety Board. (2019). Collision Between Vehicle Controlled by Developmental Automated Driving System and Pedestrian (Highway Accident Report NTSB/HAR-19/03). https://www.ntsb.gov/investigations/accidentreports/reports/har1903.pdf
- Object Management Group [OMG]. (2017). OMG Unified Modeling Language (OMG UML), Version 2.5.1. https://www.omg.org/spec/UML/2.5.1/
- Larman, C. (2004). Applying UML and Patterns: An Introduction to Object-Oriented Analysis and Design and Iterative Development (3rd ed.). Prentice Hall.
- Brown, S. (2024). C4 model - Dynamic diagram. https://c4model.com/diagrams/dynamic