# Yupana: diagrama de contenedores

- Nivel: contenedores
- Sistema: Yupana

La caja "Yupana" del diagrama de contexto, abierta: lo que tiene que estar
corriendo o existir para que un envío llegue a tener veredicto. El diagrama
no dice en qué máquinas corre cada cosa (eso está en la sección 7 de
`../arc42.md`). Las decisiones que le dieron esta forma están en `../adr/`.

## Elementos

| Nombre | Tipo | Descripción | Tecnología |
|---|---|---|---|
| Estudiante | persona | Envía sus soluciones a las tareas de programación y revisa el veredicto de cada envío | — |
| Docente | persona | Publica las tareas con sus casos de prueba y revisa los envíos de su sección | — |
| Aplicación web | contenedor | Las páginas de tareas, de envío y de veredictos; corre en el navegador de cada persona | TypeScript y HTML, sin framework |
| API | contenedor | Recibe cada envío, lo guarda y lo deja pendiente de calificar; entrega tareas y veredictos; mantiene las sesiones | Node.js 26, node:http |
| Worker de calificación | contenedor | Toma un envío pendiente, lo compila y lo ejecuta contra cada caso de prueba dentro de un sandbox, y anota el veredicto. Corren dos procesos iguales | Node.js 26; el sandbox usa los namespaces y cgroups de Linux |
| Sincronización de matrícula | contenedor | Programa que corre cada madrugada: trae la lista de matriculados de cada sección y actualiza quién puede enviar a qué tarea | Script de Node.js que lanza cron |
| Base de datos | almacén de datos | Cursos, secciones, matriculados, tareas, envíos con su código fuente, la tabla de trabajos pendientes y los veredictos | PostgreSQL 18 |
| Carpeta de casos de prueba | almacén de datos | Los archivos de entrada y de salida esperada de cada tarea, que los estudiantes no deben ver | Carpeta en el disco del servidor |
| Proveedor de identidad | sistema externo | Servicio de la universidad que comprueba la cuenta institucional de estudiantes y docentes | OpenID Connect sobre HTTPS |
| Sistema de matrícula | sistema externo | Sistema de la universidad que dice quién está matriculado en cada curso y sección | API REST de la oficina de registro |

## Relaciones

| De | Hacia | Qué viaja | Protocolo |
|---|---|---|---|
| Estudiante | Aplicación web | Envía soluciones y consulta sus veredictos | Navegador web |
| Docente | Aplicación web | Publica tareas y casos de prueba, y revisa los envíos | Navegador web |
| Estudiante | Proveedor de identidad | Ingresa su cuenta institucional | Navegador web |
| Docente | Proveedor de identidad | Ingresa su cuenta institucional | Navegador web |
| Aplicación web | API | Pide tareas, manda envíos y pregunta cada 3 s por el veredicto de un envío pendiente | HTTPS, JSON |
| API | Proveedor de identidad | Canjea el código de inicio de sesión por la identidad de la persona | OpenID Connect sobre HTTPS |
| API | Base de datos | Guarda envíos y trabajos pendientes; lee tareas, matriculados y veredictos | Protocolo de PostgreSQL sobre TCP (SQL) |
| API | Carpeta de casos de prueba | Escribe los casos de prueba que sube un docente | Sistema de archivos |
| Worker de calificación | Base de datos | Pregunta cada 2 s por el siguiente trabajo pendiente, lo toma y anota el veredicto | Protocolo de PostgreSQL sobre TCP (SQL) |
| Worker de calificación | Carpeta de casos de prueba | Lee la entrada y la salida esperada de cada caso | Sistema de archivos, solo lectura |
| Sincronización de matrícula | Sistema de matrícula | Pide la lista de matriculados de cada sección | HTTPS, JSON |
| Sincronización de matrícula | Base de datos | Actualiza los matriculados de cada sección | Protocolo de PostgreSQL sobre TCP (SQL) |
