# ADR 0002: Guardar el código de los envíos en PostgreSQL

## Contexto

Un envío es un archivo de código fuente de hasta 64 KB; la aplicación rechaza
los más grandes. Hay que conservarlo: el docente lo revisa, y un envío puede
volver a calificarse si se corrige un caso de prueba. Lo que no puede pasar
es que se pierda un envío que el estudiante vio como recibido, porque después
del cierre ya no puede enviarlo otra vez.

La facultad respalda la base de datos cada noche. No respalda ninguna otra
carpeta del servidor, y no tiene un servicio de almacenamiento de objetos.

**Escenario:** el servidor se reinicia sin aviso durante la última hora antes
de un cierre; se pierden 0 envíos confirmados al estudiante y quedan 0 envíos
registrados sin su código.

## Alternativas consideradas

### A. Una columna de texto en la tabla de envíos

- **Gana:** el registro del envío y su código se guardan en una sola
  transacción: después de un reinicio están los dos o no está ninguno. Entra
  en el respaldo que ya existe. No agrega ninguna pieza.
- **Cuesta:** la base de datos crece con cada envío. Con el tope de 64 KB y
  unos 50 000 envíos por semestre, son como máximo 3,2 GB por semestre. Las
  consultas que listan envíos tienen que cuidarse de no traer esa columna.

### B. Un archivo en el disco del servidor, con su ruta en la base de datos

- **Gana:** la base de datos se mantiene pequeña, y los archivos se pueden
  mirar con cualquier herramienta.
- **Cuesta:** son dos escrituras que no comparten transacción: un reinicio
  entre las dos deja una fila sin archivo o un archivo sin fila. La carpeta
  no está en el respaldo.
- **Por qué no:** no cumple el escenario sin construir un procedimiento que
  reconcilie filas y archivos, y sin conseguir un respaldo que hoy no existe.

### C. Almacenamiento de objetos

- **Gana:** crece sin un límite práctico y sirve bien archivos grandes.
- **Cuesta:** un servicio más que operar o que pagar, y la misma falta de
  transacción que B.
- **Por qué no:** los envíos son pequeños. Resuelve un problema de tamaño que
  no tenemos y trae el problema de consistencia que queremos evitar.

## Decisión

- **Alternativa elegida:** A

Vamos a guardar el código de cada envío en una columna de la tabla de envíos,
en la misma transacción que registra el envío. La API confirma al estudiante
solo después del `COMMIT`.

Los casos de prueba no entran en esta decisión: son archivos de hasta decenas
de megabytes que un docente sube pocas veces, y van en una carpeta del
servidor. Vamos a revisar la decisión si el tope de 64 KB deja de alcanzar,
por ejemplo si se aceptan proyectos de varios archivos.

## Estado

Aceptado

## Consecuencias

- **Buena:** un envío confirmado está completo y entra en el respaldo
  nocturno sin trabajo adicional.
- **Buena:** cualquier proceso que tenga acceso a la base de datos puede
  calificar un envío: no hace falta un disco compartido.
- **Mala:** la tabla de envíos crece sin parar. Hace falta una política para
  archivar los envíos de semestres pasados, y todavía no existe.
- **Mala:** el tope de 64 KB deja de ser un detalle de validación y pasa a
  ser una restricción de la arquitectura: subirlo cambia el tamaño de la base
  de datos y del respaldo.
- **Neutra:** la carpeta de casos de prueba queda fuera del respaldo
  nocturno; los docentes conservan sus propios archivos.
