S05 - Evaluación de la Unidad I¶
1. Propósito de la evaluación¶
Esta sesión no enseña contenido nuevo: cierra la Unidad I de ADS. El sílabo (sesión 5) define dos actividades:
- Resolver la evaluación teórico-práctica de los temas de la Unidad I (sesiones 1 a 4).
- Presentar y sustentar la Arquitectura documentada mediante vistas arquitectónicas y principios de diseño aplicados.
Esta sesión evalúa únicamente el producto de ADS. La integración con el código real de BD2 y LP2 se verifica en la sesión 6 ("Primer corte integrado"), no aquí.
2. Producto evaluado¶
Del sílabo, el producto de la Unidad I es:
Arquitectura documentada con vistas de contexto, contenedores, componentes, principios de diseño aplicados y justificación del estilo arquitectónico elegido.
El producto completo — plantilla-ejemplo con el contenido de BomERP — vive en ads-producto.md: contexto técnico, atributos de calidad, vistas C1-C3, principios de diseño, ADR y trazabilidad técnica U1. La estructura es exigible a todos; el contenido de BomERP se reemplaza por el del propio proyecto de cada equipo.
Lo que acumulaste sesión por sesión¶
Este producto no se construye en S05: se ensambla con lo que cada sesión anterior ya te pidió sobre tu propio proyecto.
Tabla 1. De la sesión al documento final
| Sesión | Qué produjiste (tu propio proyecto) | Dónde queda en ads-producto.md |
|---|---|---|
| S1 | Mapa arquitectónico inicial: contexto, stakeholders, atributos de calidad priorizados y primeras decisiones técnicas. | 1. Contexto técnico y 2. Atributos de calidad |
| S2 | Vistas C1 (contexto), C2 (contenedores) y una primera versión de C3/C4 de tu propio sistema. | 3-4. Vistas C1, C2 |
| S3 | Evaluación de tus propios módulos contra SOLID, cohesión, acoplamiento, modularidad y abstracción, con al menos un hallazgo real. | 6. Principios de diseño aplicados |
| S4 | Comparación de estilos arquitectónicos contra tu propio proyecto, con trade-offs y la justificación formal del estilo elegido. | 5. Vista C3 (final) y 7. ADR iniciales |
| S5 (esta sesión) | Ensamblas todo lo anterior en un solo documento y lo sustentas. | El documento completo + sección 4 de esta guía |
Lo que sustentas en S05 es tu arquitectura: el estilo que tú elegiste en S4, justificado frente a alternativas, documentado con tus propias vistas C1-C3 y tus propios principios aplicados — no la de BomERP.
3. Evaluación teórico-práctica (S1-S4)¶
Cubre los cuatro temas dictados antes de esta sesión. El docente puede tomarla escrita, oral o mixta.
Tabla 2. Temario de la evaluación teórico-práctica
| Sesión | Tema | Qué puede evaluar el docente |
|---|---|---|
| S1 | Fundamentos de arquitectura de software | Rol de la arquitectura, stakeholders, atributos de calidad y su relación con los requerimientos. |
| S2 | Modelo C4 y vistas arquitectónicas | Diferencia entre C1, C2, C3 y C4; qué información pertenece a cada nivel y por qué la vista C3 del propio proyecto no expone el detalle hexagonal/capas de su módulo transaccional. |
| S3 | Diseño estructural y principios SOLID | Aplicación de SOLID, cohesión, acoplamiento, modularidad y abstracción sobre los módulos reales del propio proyecto (equivalentes a catalogo/ventas en el ejemplo BomERP). |
| S4 | Arquitecturas modernas | Monolito modular vs. microservicios vs. hexagonal vs. Clean Architecture, cuándo DDD orienta hacia hexagonal/Clean, los errores comunes de cada estilo, y qué es un ADR y por qué documentar una decisión arquitectónica. |
Preguntas de referencia (el docente puede formular equivalentes):
- ¿Por qué tu proyecto eligió su estilo arquitectónico (monolito modular, hexagonal u otro) y no alguna de las demás alternativas comparadas en S4?
- Un módulo pone
@Entityen su clase de dominio y la llama "hexagonal". ¿Por qué eso no es hexagonal? - Un método solo hace
repository.save(entidad)sin ninguna regla de negocio. ¿Por qué llamarlo "caso de uso" es incorrecto? - Aplica la prueba del papel y lápiz a una regla de negocio de tu propio módulo transaccional: ¿es una entidad o un caso de uso?
- ¿Qué gana un proyecto al verificar automáticamente los límites entre módulos, en vez de solo documentarlos como convención?
- ¿Qué cambiaría en tu vista C3 si tu módulo transaccional migrara a hexagonal? ¿Ese cambio afectaría tu vista C2?
- ¿Por qué un ADR debe registrar también las alternativas descartadas y no solo la decisión final?
4. Sustentación de la arquitectura¶
Tabla 3. Distribución de tiempo por integrante
| Momento | Tiempo | Propósito |
|---|---|---|
| Presentación técnica | 10 min | Explicar el producto (ads-producto.md), las decisiones tomadas y su justificación. |
| Preguntas individuales | 8 min | Verificar dominio y aporte propio, con base en la Tabla 2 y las decisiones de ads-producto.md. |
Tabla 4. Entregables obligatorios
| Entregable | Evidencia mínima | Criterio de aceptación |
|---|---|---|
| Producto de unidad | ads-producto.md completo |
Coherente con el sílabo y con el código real del proyecto |
| Sustentación individual | Preguntas y defensa por integrante (sección 3 y Tabla 2) | Autoría demostrada |
Secuencia sugerida de presentación (referencias a secciones de ads-producto.md):
- Presentar el dominio y el problema técnico (sección 1, Contexto técnico).
- Recorrer las vistas C1, C2 y C3 (secciones 3-5) explicando qué decisión arquitectónica sostiene cada una.
- Justificar el estilo elegido (monolito modular con capas internas) frente a las alternativas de S4, citando al menos un error común que se evitó.
- Mostrar los principios SOLID aplicados (sección 6, Principios de diseño) sobre código real de
catalogooventas, con verificación automática de límites en verde. - Cerrar con la trazabilidad técnica (sección 8) y los ADR previstos aún no formalizados (sección 7).
Criterios mínimos de aceptación:
- Las tres vistas (C1, C2, C3) son coherentes entre sí y con el código real del proyecto.
- El estilo arquitectónico elegido está justificado frente a al menos una alternativa de S4.
- Cada principio SOLID (sección 6 de
ads-producto.md) se sustenta con un ejemplo real, no solo con la definición, con verificación automática de límites en verde. - Cada integrante responde individualmente al menos una pregunta de la Tabla 2 o de
ads-producto.md.
5. Rúbrica de evaluación¶
La rúbrica (6 criterios: 5 cita literal del resultado de aprendizaje de la Unidad I + sustentación) vive en ads-producto.md, junto con la plantilla del producto. Úsala directamente desde ahí para calificar la sustentación de esta sesión — no se duplica aquí.