ADS - Producto de Unidad 2¶
Este documento es el ejemplo BomERP del docente, no una plantilla obligatoria. Cada sede (Lima, Juliaca, Tarapoto) y cada grupo dentro de una misma sede sustenta su propio catálogo UML sobre su propio dominio, definido desde el brief.md de S2 y consolidado en su Producto ADS U1. El diagrama de clases y la matriz de trazabilidad de este documento son los del ejemplo BomERP; cada equipo los reemplaza por los de su propio módulo transaccional (equivalente a ventas) y no transaccional (equivalente a catalogo). Lo exigible a todos es la estructura: modelo de dominio, diagrama de clases, transformación objeto-relacional, diagramas dinámicos, patrones aplicados y diseño de integración.
Producto¶
Catálogo UML con patrones de diseño e integración aplicados.
1. Artefactos mínimos¶
Tabla 1. Artefactos mínimos del producto U2
| Artefacto | Evidencia |
|---|---|
| Modelo de dominio | Entidades, objetos de valor, reglas y módulos, con el lenguaje ubicuo y los agregados identificados (S6). |
| Diagrama de clases | Clases, atributos, operaciones, relaciones y multiplicidades, con agregación, composición y herencia (S7). |
| Diseño de clases por capas | Controller, Service, Repository, Mapper, entidades y DTO de un módulo, con su contrato REST (S8). |
| Transformación objeto-relacional | Relación clase-tabla-clave-DTO (S8). |
| Diagramas dinámicos | Secuencia y actividad del flujo principal, diagrama de interacción entre componentes (C3) y de comunicación de la misma colaboración, ciclo de vida de estados (si aplica), y matriz de consistencia frente a las clases de S8 (S9). |
| Patrones aplicados | Patrones GoF y GRASP aplicados sobre las clases de diseño (S10). |
| Diseño de integración | Capa anticorrupción y Circuit Breaker protegiendo un sistema externo obligatorio, evento de dominio con publicación confiable (Outbox), consumidor desacoplado, Saga coreografiada con su paso de compensación, y matriz de integración completa (S11). |
2. Diagrama de clases de referencia¶
Este es el diagrama de dominio (UML/DDD, S6-S7), no una vista de Código C4 — no mezcla entidades con clases de implementación (Service/Repository/Controller, esas sí viven en la Vista de código de C4, ADS S2 2.6). Cruza los módulos catalogo, ventas y clientes a propósito: ese es precisamente el trabajo del modelo de dominio, mostrar el negocio completo, no cómo se organiza el código en componentes desplegables (S7, 3.6).
Figura 1. Diagrama de clases de dominio de BomERP (U2)
classDiagram
class Categoria {
+Long id
+String nombre
+String descripcion
}
class Producto {
+Long id
+String nombre
+Dinero precio
+Integer stock
+descontarStock(cantidad)
}
class Dinero {
<<value object>>
+BigDecimal monto
+String moneda
}
class Cliente {
<<abstract>>
+Long id
+String nombreORazonSocial
+EstadoCliente estado
+suspender()
}
class ClientePersonaNatural {
+String dni
}
class ClienteEmpresa {
+String ruc
}
class Venta {
+Long id
+LocalDateTime fecha
+EstadoVenta estado
+Dinero total
+calcularTotal()
+anular()
}
class DetalleVenta {
+Long id
+Integer cantidad
+Dinero precioUnitario
+subtotal() Dinero
}
Categoria "1" o-- "0..*" Producto : clasifica
Cliente <|-- ClientePersonaNatural
Cliente <|-- ClienteEmpresa
Cliente "1" -- "0..*" Venta : registra
Venta "1" *-- "1..*" DetalleVenta : compone
DetalleVenta "0..*" -- "1" Producto : referencia
Producto ..> Dinero : usa
DetalleVenta ..> Dinero : usa
Venta.anular() y Venta.calcularTotal() ya viven en la entidad, no en un VentaService externo (Information Expert, ADS S7 2.3) — evitar el Anemic Domain Model no es un paso opcional que "el equipo puede aplicar si quiere": ya está hecho desde S7. Lo que sí queda como trabajo de S8 es la organización por capas de cada módulo: un VentaRepository por raíz de agregado (Venta, no DetalleVenta), VentaService como interfaz con su implementación, y el DTO y el contrato REST que separan lo que decide el cliente de lo que decide el servidor. catalogo (CRUD simple de Categoria/Producto) sigue el mismo esquema de capas, pero no necesita un tratamiento de dominio más elaborado — esa decisión es por módulo, no para todo el sistema (S7, 2.8 vía S6). S10 no vuelve a dibujar esas clases: explica con patrones GoF y GRASP por qué están organizadas así. S11 cierra la unidad diseñando la frontera que ninguna sesión anterior cruzó: la integración de ventas con SUNAT (síncrona, vía Factura, y asíncrona por ticket, vía el Resumen Diario de Boletas, coordinado con una Saga coreografiada), protegida con capa anticorrupción y Circuit Breaker, y la publicación confiable del evento VentaRegistrada hacia consumidores internos.
3. Trazabilidad U2¶
Tabla 2. Trazabilidad técnica U2
| Diseño ADS | Evidencia BD2 | Evidencia LP2 |
|---|---|---|
Categoria agregación Producto |
Tablas categorias/productos, FK sin ON DELETE CASCADE |
@ManyToOne de Producto hacia Categoria |
Venta composición DetalleVenta |
FK NOT NULL de detalle_venta hacia venta |
@OneToMany(cascade = ALL) en Venta |
Cliente con herencia (persona natural/empresa) |
Estrategia de mapeo objeto-relacional (S8) | Aún no implementado en LP2 (módulo clientes sin sesión propia) |
Venta.anular()/calcularTotal() como operaciones de entidad |
Trigger/CHECK de auditoría e integridad |
Lógica movida de VentaService a Venta |
| Diagrama de secuencia anular (S9) | Trigger de auditoría | Acción anular desde SPA |
| Integración full-stack | Persistencia y auditoría Oracle | Flujo SPA -> API -> Oracle |
4. Rúbrica de Evaluación¶
Tabla 3. Rúbrica de evaluación de la Unidad 2
| Criterio | Peso | CE / Nivel | A (20 pts) | B (15 pts) | C (10 pts) | D (5 pts) | Calificación obtenida |
|---|---|---|---|---|---|---|---|
| 1. Modela el dominio y delimita módulos funcionales | 16% | CE021-N2 (parcial) | Subdominios, entidades y reglas identificados, con lenguaje ubicuo y al menos un agregado como límite de consistencia, verificado contra el código real. | Dominio modelado con lenguaje ubicuo y agregado identificado, sin verificación completa contra el código. | Dominio modelado de forma parcial o genérica, sin lenguaje ubicuo claro ni agregado identificado. | No presenta modelo de dominio verificable. | |
| 2. Diseña clases, relaciones, multiplicidades y restricciones | 16% | CE021-N2 (parcial) | Diagrama de clases completo, con atributos, operaciones, multiplicidades, al menos una agregación, una composición y una jerarquía de herencia, coherente con el dominio de S6. | Diagrama completo con las relaciones exigidas, con alguna inconsistencia menor frente al dominio. | Diagrama incompleto o falta alguna de las relaciones exigidas (agregación, composición o herencia). | No presenta diagrama de clases verificable. | |
| 3. Relaciona diseño de clases con modelo relacional y persistencia | 16% | CE021-N2 (parcial) | Diseño de clases por capas completo (Controller, Service, Repository, Mapper, DTO), contrato REST conceptual y matriz de trazabilidad dominio-clase-tabla-DTO coherente con BD2. | Diseño por capas completo, con la matriz de trazabilidad con alguna inconsistencia frente a BD2. | Diseño por capas incompleto, o matriz de trazabilidad ausente o incoherente. | No presenta diseño de clases por capas ni transformación objeto-relacional. | |
| 4. Modela escenarios dinámicos mediante UML | 16% | CE021-N2 (parcial) | Diagramas de secuencia y actividad del escenario crítico, con interacción entre componentes, comunicación, y matriz de consistencia frente a las clases de S8, sin inconsistencias. | Diagramas de secuencia y actividad presentes, con la interacción/comunicación o la matriz de consistencia incompleta. | Solo diagrama de secuencia o solo de actividad, sin matriz de consistencia. | No presenta diagramas dinámicos verificables. | |
| 5. Aplica patrones de diseño, arquitectura empresarial e integración | 16% | CE021-N2 (parcial) | Al menos tres patrones GoF/GRASP aplicados y justificados sobre código real, más integración empresarial completa (capa anticorrupción, Circuit Breaker, evento con Outbox, Saga coreografiada con compensación). | Patrones aplicados y justificados, con la integración empresarial incompleta (falta la Saga o algún patrón de protección). | Patrones mencionados sin aplicación real sobre código propio, o integración limitada a una llamada sin ningún patrón de protección. | No presenta patrones aplicados ni diseño de integración. | |
| 6. Sustentación | 20% | CG | Sustenta con claridad y profesionalismo su aporte individual, respondiendo con precisión las preguntas del jurado. | Sustenta con solvencia, con detalles menores en claridad, orden o precisión. | Sustenta con dificultad; claridad, orden o precisión insuficientes. | No sustenta adecuadamente ni demuestra su aporte individual. |
Nota final = suma de (Peso / 100 × Puntos de la calificación obtenida) = ____ / 20.
CE021-N2 (parcial) = porción de diseño detallado del Nivel 2 de CE021 (Ingeniería de Requerimientos) — la otra porción (arquitectura) ya se completó en la Unidad 1 de ADS. CG = Competencia General "Servicio y misión" del sílabo de ADS — no es CE021: los criterios 1-5 ya son la evidencia técnica, incluida su verificación en vivo; el criterio 6 verifica aporte individual y comunicación.
Tabla 4. Subaspectos de la sustentación (Unidad 2)
El criterio 6 se evalúa con los mismos 6 subaspectos de la sustentación integral del Proyecto Integrador (Guía de Sustentación Final) — exigibles también en esta segunda sustentación de unidad, igual que en la Unidad 1.
| Subaspecto | Qué observa en Unidad 2 |
|---|---|
| 1. Aporte individual | Cada integrante demuestra su propio aporte: una fase completa del diseño (dominio, clases, diseño por capas/transformación, diagramas dinámicos, patrones o integración) que modeló. |
| 2. Comunicación y orden | Claridad, estructura, tiempo y lenguaje técnico durante la presentación. |
| 3. Presentación personal y actitud | Puntualidad, vestimenta limpia y adecuada, higiene, cabello ordenado, actitud profesional, respeto, honestidad y coherencia con los valores y principios cristianos de la institución. |
| 4. Repositorio y estándares | Organización, commits y reproducibilidad de la documentación de diseño detallado desde S6. |
| 5. MkDocs o equivalente | Documentación de Unidad 2 publicada, navegable y alineada con ads-producto.md. |
| 6. Pitch/demo ejecutiva | Avance del sistema con el diseño detallado ya aplicado, con apoyo visual (.pptx, Canva o equivalente) — no reemplaza la presentación técnica de S12, la precede. |
5. Trazabilidad y procedencia de la rúbrica¶
Los primeros cinco criterios son cita literal de los "Criterios de evaluación del producto" de la Unidad 2 en el sílabo de ADS; el sexto (Sustentación) corresponde a la sustentación exigida por el mismo sílabo (sesión 12, actividad 2).
Con la malla curricular: los criterios 1-5 corresponden a la porción de diseño detallado del Nivel 2 de CE021 (Ingeniería de Requerimientos) — la porción de arquitectura de ese mismo nivel ya se completó en la Unidad 1 de ADS (vistas C1-C3, SOLID y estilo arquitectónico, frente al modelo de dominio, UML estructural/dinámico, patrones e integración de esta unidad). El criterio 6 (Sustentación) es transversal y no forma parte de la definición de la competencia.
A diferencia de la Unidad 1, esta unidad no aporta a CE024 (Calidad de Software): esa competencia solo usa la Sección 2 (Atributos de calidad) del Producto U1 como insumo, formalizado recién en la Unidad 3 (criterio 3, "Justifica atributos de calidad y decisiones técnicas").