S12 - Evaluación de la Unidad II¶
1. Propósito de la evaluación¶
Esta sesión no enseña contenido nuevo: cierra la Unidad II de Desarrollo de Aplicaciones Distribuidas. El sílabo (sesión 12) define dos actividades para esta evaluación:
- Resolver la evaluación teórico-práctica de los temas de la Unidad II (sesiones 6 a 11).
- Presentar y sustentar el Sistema distribuido seguro, resiliente, consistente, observable e integrado con cliente frontend.
Esta sesión no repite lo evaluado en S5: la Unidad I (servicio base, configuración, registro, Gateway y balanceo) ya quedó certificada; S12 evalúa exclusivamente lo que se construyó encima en S6-S11.
2. Producto evaluado¶
Del sílabo, el producto de la Unidad II es:
Fortalece el sistema distribuido incorporando atributos de calidad, integración frontend y evidencias técnicas de operación real.
El producto completo — plantilla-ejemplo con el contenido de pagatu — vive en u2-producto.md: comunicación resiliente, seguridad distribuida, mensajería asíncrona, consistencia distribuida, observabilidad e integración frontend. La estructura es exigible a todos; el contenido de pagatu se reemplaza por el del propio proyecto de cada equipo.
Lo que sustentas en S12 es tu propio sistema: las capacidades que tú construiste en S6-S11, sobre tu propio dominio — no el de pagatu. u2-producto.md (Tabla 1) muestra cómo cada sesión se ensambla en el sistema terminado usando el ejemplo del docente.
3. Evaluación teórico-práctica (S6-S11)¶
Cubre los seis temas dictados antes de esta sesión. El docente puede tomarla escrita, oral o mixta.
Tabla 1. Temario de la evaluación teórico-práctica
| Sesión | Tema | Qué puede evaluar el docente |
|---|---|---|
| S6 | Comunicación síncrona resiliente entre servicios | Comunicación declarativa por Feign (nombre lógico en Eureka, no dirección fija), timeout frente a Circuit Breaker, fallback, y por qué un fallo en un servicio no debe propagarse en cascada al resto del sistema. |
| S7 / S07b | Seguridad distribuida: JWT propio y su reemplazo por Keycloak | Autenticación, autorización, protección de rutas, por qué cada microservicio valida el token (no solo el Gateway), por qué pagatu-auth-ms se diseñó "listo para reemplazo" desde el inicio (mismos nombres de claim que Keycloak), qué cambia y qué no cambia en el Gateway y los microservicios al migrar a Keycloak (S07b), y por qué idCliente pasa de Long a String (sub). |
| S8 | Mensajería asíncrona entre servicios | Publicación y consumo de eventos, desacople entre productor y consumidor, y diferencia con una llamada síncrona (REST/Feign). |
| S9 | Consistencia distribuida en procesos de negocio | Entrega al menos una vez e idempotencia ante duplicados, el patrón Saga coreografiada, compensación de un paso ya confirmado, y por qué un proceso distribuido no puede usar una transacción ACID única entre servicios. |
| S10 | Observabilidad y diagnóstico de sistemas distribuidos | Logs, health checks (liveness/readiness), métricas, propagación del X-Trace-ID entre llamadas Feign, y para qué sirve correlacionar evidencia entre servicios distintos ante un fallo. |
| S11 | Integración con cliente frontend (Angular + Keycloak) | Authorization Code + PKCE y por qué una SPA no puede usar un flujo con contraseña directa, dónde vive el token en el navegador (memoria, nunca localStorage), por qué el cliente consume la API solo a través del Gateway, y cómo se protegen las rutas según el rol real emitido por Keycloak. |
Preguntas de referencia (el docente puede formular equivalentes):
- Si el servicio que llamas está caído, ¿qué evita que tu propio servicio también quede colgado esperando una respuesta que nunca llega?
- ¿Por qué no basta con proteger las rutas en el Gateway, y qué pasa si un microservicio recibe una petición directa sin pasar por él?
- ¿Qué gana tu sistema al comunicar dos servicios por eventos en vez de una llamada REST directa, y qué pierde (qué garantía ya no tienes)?
- Si tu proceso de negocio falla a la mitad, ¿cómo evitas que quede en un estado inconsistente, y qué significa que sea idempotente?
- ¿Qué evidencia concreta de tu panel de observabilidad te permitiría diagnosticar en qué servicio ocurrió una falla, sin revisar los logs uno por uno?
- ¿Por qué tu cliente frontend nunca debería conocer la dirección de una instancia de microservicio directamente?
pagatu-auth-msusó, desde el inicio, los mismos nombres de claim que después emitió Keycloak. Al migrar (S07b), ¿qué tuvo que cambiar en el Gateway y en los microservicios de negocio, y por qué esa lista es tan corta?
4. Sustentación del sistema¶
Tabla 3. Distribución de tiempo de la sustentación
| Momento | Tiempo | Quién | Propósito |
|---|---|---|---|
| Alcance del proyecto (diapositiva) | 2-3 min | Grupal | Qué hace el sistema, para quién, y su relación con el Proyecto Sello. |
| Arquitectura (diapositiva) | 2-3 min | Grupal | Componentes reales del sistema distribuido (Gateway, microservicios, Keycloak, Kafka) — diagrama simple: Cliente → Gateway → microservicios → Keycloak/Kafka. |
| Asignación de tareas (diapositiva) | 2-3 min | Grupal | Asignación por capacidad real: cada integrante dueño de al menos una capacidad verificable en vivo (resiliencia, seguridad, mensajería, consistencia, observabilidad o frontend). |
| Demo y sustentación | 3 min por integrante | Individual | Cada integrante ejecuta en vivo y sustenta la capacidad que construyó: fallo controlado, evento de Kafka, panel de observabilidad, o flujo desde el cliente frontend. |
| Preguntas | 3 min por integrante | Individual | Verificar dominio y aporte propio, con base en la Tabla 1. |
Tabla 4. Entregables obligatorios
| Entregable | Evidencia mínima | Criterio de aceptación |
|---|---|---|
| Producto de unidad | u2-producto.md, adaptado al dominio propio del equipo |
Coherente con el sílabo y con el código real ejecutable |
| Evidencia de resiliencia y seguridad | Fallo provocado con respuesta controlada; rutas protegidas verificadas en más de un microservicio | Trazabilidad verificable en vivo, no solo documentada |
| Evidencia de mensajería y consistencia | Evento publicado y consumido; caso de reprocesamiento sin duplicar el efecto | Verificable en logs o panel, no solo descrito |
| Evidencia de observabilidad y frontend | Panel de diagnóstico operativo; cliente consumiendo la API solo vía Gateway | Correlación real entre servicios, sesión protegida por rol |
| Repositorio y documentación | Topics académicos vigentes, documentación de Unidad 2 publicada en MkDocs o equivalente | Reproducible por otra persona desde el repositorio |
| Sustentación individual | Video pitch + defensa por integrante (sección 3), con los 7 subaspectos de la sustentación integral (Guía del proyecto, sección 6) | Autoría demostrada |
Secuencia sugerida de presentación (referencias a secciones de u2-producto.md):
- Abrir con un video pitch breve: qué capacidades nuevas tiene el sistema desde la Unidad I.
- Mostrar la comunicación resiliente: provocar la caída de una instancia y evidenciar el fallback.
- Mostrar la seguridad distribuida: un acceso permitido y uno denegado, en más de un microservicio.
- Publicar un evento de negocio y mostrar su consumo asíncrono en el servicio destino.
- Provocar un fallo a mitad de un proceso de negocio y mostrar la compensación o el reprocesamiento idempotente.
- Mostrar el panel de observabilidad correlacionando logs/métricas de al menos dos servicios.
- Ejecutar un flujo completo desde el cliente frontend, mostrando una ruta protegida por rol.
- Cerrar explicando al menos una decisión propia distinta a la del ejemplo
pagatu.
Criterios mínimos de aceptación:
- Al menos un fallo de comunicación se provoca en vivo y el sistema responde de forma controlada, no con una caída en cascada.
- La seguridad se verifica en más de un microservicio, no solo en el Gateway.
- Al menos un evento de negocio se publica y se consume de forma verificable.
- Al menos un caso de consistencia (compensación o idempotencia) se prueba con un fallo real, no solo se describe.
- El panel de observabilidad correlaciona evidencia de al menos dos servicios distintos.
- El cliente frontend consume la API completa a través del Gateway, con al menos una ruta protegida por rol.
- La sustentación cubre los 7 subaspectos de la sustentación integral, no solo el dominio técnico.
- Cada integrante responde individualmente al menos una pregunta de la Tabla 1.
5. Rúbrica de evaluación¶
La rúbrica (7 criterios: 6 cita literal de los criterios de evaluación del producto de la Unidad II en el sílabo de Desarrollo de Aplicaciones Distribuidas + sustentación) vive en u2-producto.md, junto con la plantilla del producto y su trazabilidad con la malla curricular (CE023 Nivel 3). Úsala directamente desde ahí para calificar la sustentación de esta sesión — no se duplica aquí.