# Yupana: diagrama de componentes de la API

- Nivel: componentes
- Sistema: Yupana
- Contenedor: API

El contenedor "API" del diagrama de contenedores, abierto: los módulos del
proceso que recibe los envíos. Alrededor quedan solo los contenedores, los
almacenes y los sistemas externos con los que algún componente habla
directamente. El worker de calificación no aparece: no habla con la API, sino
con la base de datos.

## Elementos

| Nombre | Tipo | Descripción | Tecnología |
|---|---|---|---|
| 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 |
| HTTP | componente | Router y handlers: convierte cada pedido en una llamada a un módulo, y cada resultado o error en una respuesta JSON | TypeScript sobre node:http |
| Sesiones | componente | Inicia sesión contra el proveedor de identidad y mantiene la sesión propia de Yupana, que dura 8 horas; dice quién hace cada pedido | Módulo de TypeScript; cookie firmada |
| Cursos | componente | Cursos, secciones y matriculados: responde si una persona es docente o estudiante de una sección | Módulo de TypeScript; SQL con pg |
| Tareas | componente | Las tareas con su enunciado, su cierre, sus límites de tiempo y memoria, y sus casos de prueba | Módulo de TypeScript; SQL con pg |
| Envíos | componente | Valida un envío (tamaño, lenguaje, tarea abierta), y guarda su código y su trabajo pendiente en una sola transacción | Módulo de TypeScript; SQL con pg |
| Veredictos | componente | Entrega el estado y el veredicto de un envío a quien lo hizo y a su docente | Módulo de TypeScript; SQL con pg |
| Lenguajes | componente | La tabla de lenguajes aceptados: extensión, cómo se compila y cómo se ejecuta cada uno. Los workers usan el mismo módulo | Módulo de TypeScript sin dependencias |
| 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 |

## Relaciones

| De | Hacia | Qué viaja | Protocolo |
|---|---|---|---|
| Aplicación web | HTTP | Pide tareas, manda envíos y pregunta por veredictos | HTTPS, JSON |
| HTTP | Sesiones | Pregunta quién hace el pedido | Llamada a función |
| HTTP | Tareas | Pide las tareas de una sección y publica las nuevas | Llamada a función |
| HTTP | Envíos | Entrega cada envío recibido | Llamada a función |
| HTTP | Veredictos | Pide el estado de un envío | Llamada a función |
| Sesiones | Proveedor de identidad | Canjea el código de inicio de sesión por la identidad de la persona | OpenID Connect sobre HTTPS |
| Sesiones | Cursos | Busca a la persona por su correo institucional | Llamada a función |
| Tareas | Cursos | Pregunta si la persona es docente de la sección | Llamada a función |
| Envíos | Cursos | Pregunta si la persona está matriculada en la sección de la tarea | Llamada a función |
| Envíos | Tareas | Pide el cierre y los límites de la tarea | Llamada a función |
| Envíos | Lenguajes | Pregunta si el lenguaje del archivo está aceptado | Llamada a función |
| Veredictos | Cursos | Pregunta si la persona puede ver el envío | Llamada a función |
| Cursos | Base de datos | Lee cursos, secciones y matriculados | Protocolo de PostgreSQL sobre TCP (SQL) |
| Tareas | Base de datos | Guarda las tareas y lee sus límites | Protocolo de PostgreSQL sobre TCP (SQL) |
| Tareas | Carpeta de casos de prueba | Escribe los archivos de cada caso de prueba | Sistema de archivos |
| Envíos | Base de datos | Guarda el envío, su código y su trabajo pendiente en una transacción | Protocolo de PostgreSQL sobre TCP (SQL) |
| Veredictos | Base de datos | Lee el estado y el veredicto de cada envío | Protocolo de PostgreSQL sobre TCP (SQL) |
