Saltar a contenido

ADS - Producto de Unidad 3

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 cierra su propio diseño técnico sobre su propio dominio, definido desde S2 y consolidado en sus propios productos U1/U2. Los ADR y la matriz de trazabilidad de este documento son los del ejemplo BomERP; cada equipo los reemplaza por los suyos, con sus propios códigos si ya vienen de U1/U2. Lo exigible a todos es la estructura: arquitectura final, modelo de dominio, catálogo UML, patrones, ADR y trazabilidad completa.

Producto

Diseño Técnico Profesional Documentado.

Componentes finales

Componente Evidencia esperada
Arquitectura final C4 actualizado: contexto, contenedores, componentes y despliegue si aplica.
Modelo de dominio Entidades, reglas, módulos y límites del sistema.
Catálogo UML Clases, secuencia, actividad y estados si aplica.
Patrones Controller, Service, Repository, DTO, Mapper u otros aplicados; Domain-Driven Design táctico (agregado) en los módulos donde se justificó por invariantes reales (candidato: ventas, ver Producto ADS U2).
ADRs Decisiones arquitectónicas finales con contexto y consecuencia.
Trazabilidad Relación diseño-BD2-LP2-pruebas.

Matriz final de trazabilidad

La columna "Requerimiento" se agregó en S14 (3.5) — el sílabo de esta sesión exige trazabilidad "entre requerimientos, arquitectura y diseño", no solo entre decisión, base de datos y backend.

Requerimiento Decisión o modelo ADS Evidencia BD2 Evidencia LP2 Prueba o sustentación
RN8 (filtra por vendedorId si es VENDEDOR, S8) API REST stateless con JWT Usuario/rol de aplicación Backend y SPA protegidos Login, guard e interceptor.
Precondición de anular(): {estado = 'REGISTRADA'} (S7, 2.7) Auditabilidad de ventas Trigger o auditoría Oracle Registro/anulación de venta Evidencia de evento auditado.
RN10 (ordenarPor de lista cerrada, S8) Rendimiento en consultas Índice, estadísticas o AWR Filtros y consultas API Comparación de plan o tiempo.
RN1 (404 si el producto no existe o no está activo, S8) Service + Repository Paquetes/tablas Oracle Servicios y repositorios Demo de flujo transaccional.
Requisito no funcional: listar grandes volúmenes sin degradar Paginación de alto volumen Índices y consulta estable Metadatos, filtros y ordenamiento Prueba con volumen justificable.
Requisito no funcional: diagnosticar un error en producción Observabilidad Sesiones, bloqueos y monitoreo Oracle Logs, salud y monitoreo básico Diagnóstico de una operación y un error.
RN2 (stock suficiente, 409, S8) Integración full-stack Dato persistido y auditado Flujo SPA -> API -> Oracle Prueba end-to-end y regresión.

Atributos de calidad: justificación final (S14)

La Sección 2 del Producto U1 priorizó estos atributos como decisión inicial, sin evidencia todavía. S14 (3.3) los justifica con evidencia real de las 13 sesiones siguientes — el criterio 3 de esta unidad ("Justifica atributos de calidad y decisiones técnicas") se califica aquí, no antes.

Atributo Decisión inicial (U1) Evidencia real (S14)
Seguridad futura Autenticación y autorización para U2. Keycloak integrado (LP2 S10b-S11): JWT con realm_access.roles, Gateway valida el rol antes de reenviar.
Mantenibilidad Ejecutable único, paquetes de módulo cohesionados. ModularityTests en verde (ADR-002), verificado contra el código real.
Integridad Reglas transaccionales en servicio y Oracle. RN1-RN10 (S8) + TRG_PRODUCTO_AUDITORIA (BD2 S2).
Rendimiento Índices y consultas optimizadas por fecha. IX_VENTAS_FECHA (BD2 S5), selectividad medida (BD2 S10).
Auditabilidad Trigger de auditoría de cambios de precio/stock. TRG_PRODUCTO_AUDITORIA disparado en vivo (BD2 S2) + Unified Auditing (BD2 S9).
Escalabilidad inicial API stateless preparada para SPA. JWT sin sesión de servidor (LP2 S10b); VENTAS_HISTORICO particionado (BD2 S11).

ADR final de referencia

Los códigos de ADR no se reinventan por unidad: son los mismos a lo largo del ciclo. Los tres primeros ya son ADR reales del código (docs/lp2/adr/), verificados desde U1; los siguientes se formalizan cuando su sesión llega, no antes (ver Producto ADS U1, sección 7):

Código Decisión Estado Evidencia
ADR-001 Un único proyecto Spring Boot, sin reactor Maven multi-módulo. Aprobada (U1) mvnw test verde desde S1.
ADR-002 Módulos de negocio verificados con Spring Modulith. Aprobada (U1) ModularityTests en verde.
ADR-003 Spring Boot exacto en 4.0.7. Aprobada (U1) Verificado contra start.spring.io.
ADR-004 API REST protegida con JWT. Formalizada en S10 Backend y SPA usan token.
ADR-005 Una sola SPA organizada por funcionalidades. Formalizada en S7 core/shared/módulos con rutas propias.
ADR-006 Documentación MkDocs como evidencia técnica navegable. Formalizada al publicar el sitio Publicación y repositorio.
ADR-007 Caché y Redis se aplican solo cuando existe beneficio medible. Formalizada en S13 Evidencia de caché o decisión documentada de no usarlo.
ADR-008 Venta.calcularTotal() es responsabilidad de la entidad (Information Expert), no del servicio — el cálculo actual en VentaServiceImpl.crear queda como deuda técnica. Formalizada en S14 (ADS) Hallazgo real de auditoría (S13, Tabla 7); refactor pendiente registrado para LP2.

Rúbrica de Evaluación

Tabla 1. Rúbrica de evaluación de la Unidad 3

Criterio Peso CE / Nivel A (20 pts) B (15 pts) C (10 pts) D (5 pts) Calificación obtenida
1. Consolida arquitectura, dominio, UML, patrones e integraciones 16% CE021-N2 (cierre) Auditoría de consistencia real entre U1 y U2 (S13), con hallazgos registrados y resueltos o diferidos explícitamente. Consolidación presente, con algún hallazgo real sin resolución explícita. Consolidación superficial, sin auditoría real entre unidades. No presenta consolidación verificable.
2. Registra decisiones arquitectónicas mediante ADRs 16% CE021-N2 (cierre) Al menos un ADR nuevo (4 partes completas) a partir de un hallazgo real, verificable contra el código. ADR completo, con la decisión poco verificable. ADR incompleto o sin hallazgo real que lo motive. No presenta ADR nuevo en esta unidad.
3. Justifica atributos de calidad y decisiones técnicas 16% CE024-N1 (cierre) Al menos 4 atributos de la Tabla de S1 justificados con evidencia real, correctamente asignada. Al menos 4 atributos, con alguna evidencia mal asignada. Menos de 4 atributos, o evidencia genérica. No presenta justificación de atributos de calidad.
4. Mantiene trazabilidad entre requerimientos, arquitectura, base de datos y diseño 16% CE021-N2 (cierre) Al menos 2 requerimientos reales trazados de punta a punta, con los 5 eslabones completos o pendientes registrados. Al menos 2 requerimientos, con algún eslabón faltante sin registrar. Solo 1 requerimiento trazado completo. No presenta trazabilidad de ningún requerimiento.
5. Presenta un dossier técnico profesional listo para BD2 y LP2 16% CE021-N2 (cierre) Dossier completo y coherente (arquitectura, dominio, UML, patrones, ADR, trazabilidad), verificable en vivo. Dossier completo, con alguna sección incompleta. Dossier incompleto o con secciones no verificables. No presenta dossier técnico.
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 (cierre) = cierre del Nivel 2 de CE021 (Ingeniería de Requerimientos): la arquitectura (U1) y el diseño detallado (U2) ya certificaron trazabilidad real acotada a su propio corte de unidad (Producto U1, Producto U2); esta unidad cierra el nivel con la consolidación entre unidades (criterio 1), los ADR formales (criterio 2), la trazabilidad completa hasta el requerimiento (criterio 4) y el dossier final (criterio 5). CE024-N1 (cierre) = cierre del Nivel 1 de CE024 (Calidad de Software): los atributos de calidad se usaron como insumo de diseño desde S1, sin calificarse — el criterio 3 de esta unidad es la primera vez que se califican con evidencia real. CG = Competencia General del sílabo de ADS. No es CE021 ni CE024 en 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 2. Subaspectos de la sustentación (Unidad 3)

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) — la misma exigencia de Unidad 1 y Unidad 2, ahora en la sustentación final del curso.

Subaspecto Qué observa en Unidad 3
1. Aporte individual Cada integrante demuestra al menos un ADR, una justificación de atributo de calidad, o un requerimiento trazado que formalizó.
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 los ADR y la matriz de trazabilidad desde S13.
5. MkDocs o equivalente Documentación de Unidad 3 publicada, navegable y alineada con ads-producto.md.
6. Pitch/demo ejecutiva El dossier técnico profesional completo, con apoyo visual (.pptx, Canva o equivalente) — no reemplaza la demo técnica de S15, la precede.

Para usar la rúbrica con IA, solicita:

Evalúa la sustentación y el producto (ads-producto.md o la sección 2 de la guía S15) usando la rúbrica de esta sección.
Para cada criterio selecciona la calificación obtenida: A=20, B=15, C=10, D=5.
Justifica brevemente cada nivel con evidencia concreta (ADR, atributos de calidad, trazabilidad, dossier).
Calcula la nota final con la fórmula: suma de (Peso / 100 × Puntos de la calificación obtenida), directamente sobre 20.
Indica 2 fortalezas y 2 recomendaciones.

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 3 en el sílabo de ADS; el sexto (Sustentación) corresponde a la sustentación exigida por el mismo sílabo (sesión 15, actividad 2).

Cierre ADS

El diseño final se considera completo cuando otra persona puede entender la arquitectura, ubicar componentes, relacionar decisiones con evidencias y explicar por qué la solución técnica es coherente con el producto implementado.