Distribuidas - Producto de Unidad 1¶
Esta es la plantilla-ejemplo del producto de Unidad 1 de Desarrollo de Aplicaciones Distribuidas. La estructura (alcance de servicios, contrato REST, configuración por ambiente, arquitectura del sistema) es exigible a todos: servicio REST persistente, configuración externalizada por ambiente, registro y descubrimiento de servicios, punto único de acceso mediante Gateway, y distribución de tráfico entre instancias. El contenido de pagatu (nombres de microservicio, endpoints, puertos concretos) es el ejemplo real que muestra cómo se ve terminada — cada equipo reemplaza ese contenido por el de su propio dominio, declarado en su Brief técnico de S2, sin cambiar la estructura.
Producto¶
Sistema distribuido base funcional, configurable y preparado para múltiples instancias.
Implementa la base técnica del sistema distribuido: un servicio REST funcional, configuración centralizada, descubrimiento dinámico, acceso por Gateway y ejecución concurrente de instancias.
1. Alcance de servicios¶
Tabla 1. Alcance de servicios (ejemplo pagatu)
| Servicio | Rol | Sesión |
|---|---|---|
pagatu-config |
Config Server, configuración externalizada por ambiente. | S2 |
pagatu-eureka |
Registro y descubrimiento de servicios. | S3 |
pagatu-gateway |
Punto único de acceso y balanceo de carga. | S4 |
pagatu-catalogo-ms |
Microservicio guiado en clase, con dos recursos (categorías, productos) y dos instancias simultáneas. | S1, S3 |
pagatu-orden-ms |
Microservicio replicado como trabajo autónomo desde S1, migrado a Config Client y Eureka Client, con su propia ruta en el Gateway. | S1 (autónomo), S2-S4 (corregido para el cierre de unidad) |
2. Contrato REST¶
Todo el tráfico se resuelve a través de pagatu-gateway — ningún cliente externo llama directo a un puerto de instancia.
Tabla 2. Contrato REST de referencia
| Métodos | Endpoint | Propósito | Sesión relacionada |
|---|---|---|---|
GET, GET /{id}, POST, PUT, DELETE |
/api/v1/categorias |
CRUD completo de categorías. | S1 |
GET, GET /{id}, POST, PUT, DELETE |
/api/v1/productos |
CRUD completo de productos, con su categoría asociada. | S1 |
GET, GET /{id}, POST |
/api/v1/ordenes |
Listar, consultar y registrar órdenes (pagatu-orden-ms, trabajo autónomo). |
S1 (autónomo), ruta agregada en S4 |
3. Configuración por ambiente¶
Tabla 3. Puertos por componente y ambiente
| Componente | Puerto DEV | Puerto PROD (interno) | Puerto PROD (expuesto al host) |
|---|---|---|---|
pagatu-config |
18888 |
8888 |
28888 |
pagatu-eureka |
18761 |
8761 |
28761 (solo dashboard) |
pagatu-gateway |
18080 |
8080 |
28080 (único puerto de negocio) |
pagatu-catalogo-ms (2 instancias) |
8080 / 8081 |
8080 |
Sin exponer |
pagatu-orden-ms (2 instancias) |
8082 / 8083 |
8080 |
Sin exponer |
El prefijo 1 identifica DEV, el prefijo 2 identifica PROD expuesto — mismo criterio usado desde S2. En PROD, solo pagatu-gateway publica un puerto de negocio al host (28080); pagatu-config y pagatu-eureka exponen su puerto solo para revisión administrativa del equipo, no para tráfico de clientes reales.
4. Arquitectura del sistema distribuido base¶
Figura 1. Sistema distribuido base, Unidad I completa
flowchart TB
Cliente["Cliente externo"]
Gateway["pagatu-gateway<br/>punto único de acceso y balanceo, S4"]
Catalogo["pagatu-catalogo-ms<br/>2 instancias, S1"]
Orden["pagatu-orden-ms<br/>2 instancias, trabajo autónomo S1-S5"]
Eureka["pagatu-eureka<br/>registro y descubrimiento, S3"]
Config["pagatu-config<br/>configuración centralizada, S2"]
Repo[("config-repo")]
Cliente --> Gateway
Gateway -->|"lb://pagatu-catalogo-ms"| Catalogo
Gateway -->|"lb://pagatu-orden-ms"| Orden
Gateway -. descubre servicios .-> Eureka
Catalogo -. registra instancia .-> Eureka
Orden -. registra instancia .-> Eureka
Gateway -. carga configuración .-> Config
Catalogo -. carga configuración .-> Config
Orden -. carga configuración .-> Config
Config --> Repo
classDef done fill:#e8f5e9,stroke:#2e7d32,color:#111;
class Catalogo,Orden,Eureka,Config,Gateway done;
A diferencia del roadmap de S4 (donde pagatu-gateway era lo único nuevo del día), aquí los cinco componentes están en verde: la Unidad I completa un sistema donde ningún cliente externo conoce un puerto de instancia, ningún servicio tiene su configuración hardcodeada, y agregar o perder una instancia no requiere tocar nada fuera de pagatu-eureka.
5. Rúbrica de Evaluación¶
Tabla 4. Rúbrica de evaluación de la Unidad 1
| Criterio | Peso | CE / Nivel | A (20 pts) | B (15 pts) | C (10 pts) | D (5 pts) | Calificación obtenida |
|---|---|---|---|---|---|---|---|
| 1. Servicio REST funcional y persistente | 12% | CE023-N3 | Servicio ejecutable, persistente y documentado, verificado en vivo. | Servicio funcional, con documentación o persistencia parcial. | Servicio parcialmente funcional o sin persistencia verificable. | No presenta un servicio REST funcional. | |
| 2. Configuración externa por ambiente | 12% | CE023-N3 | Configuración externalizada, con diferencias reales y verificables entre DEV y PROD. | Configuración externalizada, con diferencias parciales entre ambientes. | Configuración parcialmente externa o sin diferencias claras. | No externaliza configuración. | |
| 3. Registro y descubrimiento de servicios operativo | 16% | CE023-N3 | Registro operativo, con instancias visibles y verificadas en el dashboard. | Registro operativo, con verificación parcial del dashboard. | Registro presente, sin verificación clara de instancias. | No evidencia registro de servicios. | |
| 4. Punto único de acceso mediante Gateway | 16% | CE023-N3 | Gateway operativo, con rutas hacia todos los servicios resueltas correctamente. | Gateway operativo, con al menos una ruta funcional. | Gateway definido, con rutas incompletas o con errores. | No evidencia Gateway funcional. | |
| 5. Distribución de tráfico entre instancias | 16% | CE023-N3 | Balanceo de carga verificado entre al menos dos instancias, con evidencia clara. | Balanceo verificado parcialmente o sobre una sola instancia. | Balanceo definido, sin verificación clara. | No evidencia balanceo de carga. | |
| 6. Evidencias de ejecución reproducible y documentación técnica básica | 8% | CE023-N3 | Evidencias completas, reproducibles por otra persona, con documentación clara. | Evidencias suficientes, con vacíos menores de documentación. | Evidencias parciales o poco reproducibles. | No presenta evidencias ni documentación. | |
| 7. 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.
CE023-N3 = Nivel 3 de la competencia CE023 (Programación). CG = Competencia General "Carácter y Aprendizaje Autónomo" del sílabo — no es CE023: los criterios 1-6 ya son la evidencia técnica, incluida su verificación en vivo; el criterio 7 verifica aporte individual y comunicación.
Tabla 5. Subaspectos de la sustentación (Unidad 1)
El criterio 7 se evalúa con los mismos 6 subaspectos de la sustentación integral del Proyecto Sello (u3-producto.md, Tabla 2) — exigibles desde esta primera sustentación de unidad, no solo en la sustentación final del curso.
| Subaspecto | Qué observa en Unidad 1 |
|---|---|
| 1. Aporte individual | Cada integrante demuestra lo que construyó (Tabla 2 de S5, preguntas de referencia). |
| 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 | Topics académicos configurados desde S2 (Guía del proyecto, sección 5), organización, commits y reproducibilidad del sistema base. |
| 5. MkDocs o equivalente | Documentación de Unidad 1 publicada, navegable y alineada con u1-producto.md. |
| 6. Pitch/demo ejecutiva | Introducción breve del sistema base y su avance (no reemplaza la demo técnica de la Tabla 3 de S5, la precede). |
Para usar la rúbrica con IA, solicita:
Evalúa la sustentación y el producto (u1-producto.md, adaptado al dominio propio del equipo) 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 (endpoints, dashboard de registro, logs de balanceo).
Para el criterio 7, verifica explícitamente los 6 subaspectos de la Tabla 5 (aporte individual, comunicación, presentación personal, repositorio, MkDocs, pitch/demo) antes de asignar el nivel.
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 para lo que sigue en Unidad II.
6. Trazabilidad y procedencia de la rúbrica¶
Los primeros seis criterios son cita literal de los criterios de evaluación del producto de la Unidad I en el sílabo de Desarrollo de Aplicaciones Distribuidas; el séptimo (Sustentación) corresponde a la sustentación exigida por el mismo sílabo (sesión 5, actividad 2).
Con la malla curricular: estos seis criterios son la base de la porción de plataforma distribuida del Nivel 3 de CE023 (Programación) — esa porción se completa recién al cierre de las 3 unidades del curso (seguridad, mensajería, consistencia e observabilidad en Unidad 2; validación end-to-end en Unidad 3, aquí solo se evalúa la base de Unidad 1). Junto con la plataforma móvil (MOV), ambas conforman el Nivel 3 completo de la competencia; la integración de las cinco plataformas (consola, escritorio, web, distribuido, móvil) ocurre recién en PI1, Ciclo 8. El criterio 7 (Sustentación) es transversal y no forma parte de la definición de la competencia.