# ATAM reducido de Yupana

Ejemplo lleno de la tabla del laboratorio (`atam-template.md`). La
arquitectura que se evalúa es la de `c4/`, con las decisiones de `adr/`; los
escenarios E1 a E3 están completos en `scenarios.md`.

- Sistema: Yupana
- Presenta: los dos jefes de práctica que mantienen Yupana
- Evalúa: un docente de Algoritmos y la administradora de los servidores de la facultad

## Objetivos del negocio

- El estudiante recibe el veredicto mientras todavía está trabajando en la tarea, también la noche del cierre.
- Un veredicto dice la verdad: nadie obtiene "aceptado" sin resolver la tarea, y nadie ve el código de otra persona.
- Ningún envío confirmado se pierde.
- Dos jefes de práctica a tiempo parcial pueden operar el sistema.

## Enfoques de arquitectura

| Id | Enfoque | Dónde se ve |
|---|---|---|
| A1 | Calificación asíncrona: una tabla de trabajos en PostgreSQL que los workers consultan cada 2 s (ADR 0003) | Contenedores: API → Base de datos ← Worker de calificación |
| A2 | Un sandbox nuevo por envío, sin red, con el sistema de archivos de solo lectura y límites de CPU, memoria y número de procesos | Contenedores: Worker de calificación |
| A3 | El envío, su código y su trabajo pendiente se guardan en una sola transacción (ADR 0002) | Componentes: Envíos → Base de datos |
| A4 | Todo en una máquina virtual de 4 núcleos: la API, 2 workers y PostgreSQL | arc42, sección 7 |
| A5 | Un solo usuario de PostgreSQL para la API, los workers y la sincronización | Contenedores: las tres flechas hacia Base de datos |
| A6 | Los casos de prueba en una carpeta del servidor que el worker monta dentro del sandbox | Contenedores: Worker de calificación → Carpeta de casos de prueba |

## Escenarios

| Id | Escenario | Atributo | Origen |
|---|---|---|---|
| E1 | 600 envíos en los 30 min antes de un cierre (20 por minuto, 12 s de calificación cada uno): confirmación en 1 s o menos (p95) y veredicto en 2 min o menos (p95) | rendimiento | utility tree (A, A) |
| E2 | Un programa intenta leer fuera de su carpeta, abrir una conexión y crear procesos sin límite: 0 bytes leídos, 0 conexiones, veredicto en 30 s o menos, 0 envíos ajenos afectados | seguridad | utility tree (A, A) |
| E3 | Un worker muere a mitad de una calificación: veredicto en 5 min o menos, 0 envíos perdidos, 0 con dos veredictos | disponibilidad | utility tree (A, A) |
| E6 | Un docente corrige un caso de prueba cuando ya hay 250 envíos: todos se recalifican en 60 min o menos y los envíos nuevos mantienen su veredicto en 2 min o menos (p95) | rendimiento | lluvia de ideas (4 votos) |
| E7 | Dos tareas cierran a la misma hora: 40 envíos por minuto durante 30 min, con veredicto en 2 min o menos (p95) | rendimiento | lluvia de ideas (2 votos) |

## Hallazgos

| Id | Tipo | Escenarios | Enfoques | Decisión | Atributos | Razonamiento |
|---|---|---|---|---|---|---|
| R1 | riesgo | E1, E7 | A1, A4 | Correr 2 workers, porque la máquina virtual tiene 4 núcleos | rendimiento | Con 12 s por envío, 2 workers califican 10 por minuto y llegan 20: al cierre quedan 300 pendientes y el último espera 30 min, contra una medida de 2 min. Para no acumular hacen falta 4 workers, que ocuparían los 4 núcleos (`queue-estimate.ts`) |
| S1 | punto de sensibilidad | E1, E7 | A1 | El número de workers y el límite de tiempo de cada tarea | rendimiento | La espera del veredicto depende del producto de los dos: envíos por minuto por segundos por envío, entre 60, da los workers que hacen falta. Duplicar el límite de tiempo de una tarea duplica los workers necesarios; E7 duplica las llegadas y tiene el mismo efecto |
| N1 | no riesgo | E1 | A1, A3 | Confirmar el envío con una transacción que inserta dos filas | rendimiento | La confirmación no espera a la calificación: cuesta dos escrituras pequeñas. Supuesto: la base de datos responde en decenas de milisegundos, lo normal mientras la máquina no esté saturada (ver R1) |
| N2 | no riesgo | E2 | A2 | Ejecutar cada programa sin red y con límites de CPU, memoria y número de procesos | seguridad | El programa no puede abrir conexiones ni agotar la máquina: al crear procesos sin límite choca con el tope y termina con error en ejecución. Supuesto: el aislamiento del kernel no tiene una falla conocida, lo que obliga a mantener el sistema operativo actualizado |
| R2 | riesgo | E2 | A5 | Los workers se conectan a la base de datos con el mismo usuario que la API | seguridad | El worker ejecuta código que no es nuestro. Si un programa escapa del sandbox, encuentra credenciales que leen el código de todos los envíos y cambian cualquier veredicto: el daño de una falla del sandbox no está acotado |
| R3 | riesgo | E2 | A6 | Montar en el sandbox la carpeta completa del caso de prueba, con la entrada y la salida esperada | seguridad | El programa puede leer la salida esperada e imprimirla: obtiene "aceptado" sin resolver la tarea, y la medida de 0 bytes leídos fuera de la carpeta del envío no se cumple |
| R4 | riesgo | E3 | A1 | Falta decidir qué pasa con un trabajo que un worker tomó y no terminó | disponibilidad | El worker marca el trabajo "en calificación" al tomarlo. Si muere, nadie lo devuelve a "pendiente": el envío queda sin veredicto para siempre, y el escenario pide 5 min |
| N3 | no riesgo | E3 | A3 | Guardar el código del envío en la misma transacción que su registro | disponibilidad | Un envío confirmado está completo en la base de datos aunque el worker muera: siempre se puede volver a calificar. Supuesto: el respaldo nocturno de la base de datos sigue funcionando |
| T1 | punto de trade-off | E1, E2 | A2 | Crear un sandbox nuevo para cada envío en vez de reutilizar uno | seguridad, rendimiento | Nada de un envío queda para el siguiente (seguridad), y cada envío paga el tiempo de crear y destruir el sandbox (rendimiento), que entra en los segundos por envío de S1 |
| T2 | punto de trade-off | E2, E3 | A1 | Cuántas veces se vuelve a intentar un trabajo abandonado (todavía sin decidir) | disponibilidad, seguridad | Más intentos recuperan más caídas pasajeras (E3). Pero un envío que mata al worker a propósito (E2) se ejecuta otra vez en cada intento y tumba un worker cada vez |
| R5 | riesgo | E6 | A1 | Atender los trabajos en orden de llegada, sin prioridades | rendimiento | Una recalificación mete 250 trabajos de golpe: a 10 por minuto son 25 min en los que todo envío nuevo espera detrás de ellos, contra una medida de 2 min |

## Temas de riesgo

| Tema | Riesgos | Objetivo del negocio que amenaza |
|---|---|---|
| La tabla de trabajos se adoptó como almacenamiento y nadie decidió sus reglas de cola: capacidad, trabajos abandonados y prioridades | R1, R4, R5 | El estudiante recibe el veredicto mientras todavía está trabajando en la tarea |
| El límite de confianza rodea al worker, y debería rodear al programa del estudiante | R2, R3 | Un veredicto dice la verdad, y nadie ve el código de otra persona |
