# ADR 0001: Calificar cada envío dentro del pedido HTTP

## Contexto

Yupana empieza como piloto en una sección de Programación 1, con 40
estudiantes. Lo construyen y lo mantienen dos jefes de práctica a tiempo
parcial, y corre en una máquina virtual de la facultad con 4 núcleos. Las
tareas del piloto son programas pequeños: compilar una solución y ejecutarla
contra sus casos de prueba tarda unos 2 s. Todavía no sabemos si otros cursos
lo van a adoptar ni qué tan pesadas serán sus tareas.

Hay que decidir dónde y cuándo se califica un envío: es la decisión que le da
forma al resto del sistema.

**Escenario:** en la última hora antes de un cierre, los 40 estudiantes de la
sección envían hasta 5 soluciones por minuto, de unos 2 s de calificación
cada una; el estudiante ve su veredicto en 10 s o menos en el 95 % de los
envíos.

## Alternativas consideradas

### A. Calificar dentro del pedido HTTP

- **Gana:** es lo más simple de construir y de operar: un solo proceso y
  ningún estado intermedio. El estudiante recibe el veredicto en la misma
  respuesta.
- **Cuesta:** el pedido dura lo que dure la calificación; el proceso que
  atiende a todos es también el que compila y ejecuta código de estudiantes;
  y la capacidad de calificar es la de esa máquina, compartida con todo lo
  demás.

### B. Tabla de trabajos en PostgreSQL y un worker aparte

- **Gana:** la API responde apenas guarda el envío; el código de los
  estudiantes sale del proceso de la API; se pueden agregar workers.
- **Cuesta:** un proceso más que desplegar y vigilar, un estado "pendiente"
  que hay que mostrar, y la aplicación web tiene que volver a preguntar por el
  veredicto.
- **Por qué no:** con 5 envíos por minuto de 2 s resuelve un problema que el
  piloto no tiene, y cada pieza adicional la operan dos personas a tiempo
  parcial.

### C. Broker de mensajes y workers

- **Gana:** lo mismo que B, y además el broker entrega cada trabajo a un
  worker sin que nadie pregunte.
- **Cuesta:** lo mismo que B, más un broker que instalar, vigilar y
  respaldar.
- **Por qué no:** las mismas razones que B, con un costo de operación mayor.

## Decisión

- **Alternativa elegida:** A

Vamos a compilar y ejecutar cada envío dentro del pedido HTTP que lo recibe,
con un límite de 10 s por envío. Con 5 envíos por minuto de unos 2 s, el
servidor pasa calificando 10 s de cada 60: el escenario se cumple con margen.

Vamos a revisar esta decisión si Yupana pasa a usarse en más de una sección,
si aparecen tareas que tarden más de 5 s en calificarse, o cuando termine el
piloto, lo que ocurra primero.

## Estado

Reemplazado por el ADR 0003

## Consecuencias

- **Buena:** el piloto arranca con un proceso y una base de datos, sin
  infraestructura nueva.
- **Buena:** no existe el estado "pendiente": un envío tiene veredicto o no
  existe, y la aplicación web no necesita volver a preguntar.
- **Mala:** los envíos se califican en la misma máquina y al mismo tiempo que
  se atienden los demás pedidos. Una tanda de envíos pesados vuelve lenta toda
  la aplicación, y no hay forma de limitar cuántos se califican a la vez sin
  hacer esperar a quien envía.
- **Mala:** el código de los estudiantes se ejecuta como proceso hijo del
  proceso que tiene las credenciales de la base de datos.
- **Neutra:** si el navegador corta la conexión antes de la respuesta, el
  estudiante tiene que buscar el veredicto en su lista de envíos.
