# Qillqa: diagrama de contenedores

- Nivel: contenedores
- Sistema: Qillqa

La caja "Qillqa" del diagrama de contexto, abierta: lo que tiene que estar
corriendo o existir para que el sistema funcione. Las personas y los sistemas
externos son los mismos del diagrama de contexto.

## Elementos

| Nombre | Tipo | Descripción | Tecnología |
|---|---|---|---|
| Lector | persona | Estudiante o docente que busca libros, los reserva y renueva sus préstamos | — |
| Bibliotecario | persona | Atiende el mostrador: registra préstamos y devoluciones y entrega las reservas | — |
| Aplicación web | contenedor | Las páginas del catálogo, de "mis préstamos" y del mostrador; corre en el navegador de cada persona | TypeScript y HTML, sin framework |
| API | contenedor | Aplica las reglas de préstamo (quién puede llevarse qué, por cuántos días, cuántas renovaciones) y entrega los archivos de la aplicación web | Node.js 26, node:http |
| Avisos nocturnos | contenedor | Programa que corre una vez cada noche: busca los préstamos que vencen al día siguiente y manda un aviso por cada uno | Script de Node.js que lanza cron |
| Base de datos | almacén de datos | Libros, ejemplares, lectores, préstamos, reservas y avisos enviados | PostgreSQL 18 |
| Sistema de matrícula | sistema externo | Sistema de la universidad que dice quién está matriculado este semestre | API REST de la oficina de registro |
| Servidor de correo | sistema externo | Entrega los avisos en el correo institucional de cada lector | Servicio SMTP de la universidad |

## Relaciones

| De | Hacia | Qué viaja | Protocolo |
|---|---|---|---|
| Lector | Aplicación web | Busca libros, reserva y renueva sus préstamos | Navegador web |
| Bibliotecario | Aplicación web | Registra préstamos y devoluciones | Navegador web |
| Aplicación web | API | Pide búsquedas, reservas, préstamos y devoluciones | HTTPS, JSON |
| API | Base de datos | Lee el catálogo y escribe préstamos y reservas | Protocolo de PostgreSQL sobre TCP (SQL) |
| API | Sistema de matrícula | Pregunta si un código de estudiante está matriculado | HTTPS, JSON |
| Avisos nocturnos | Base de datos | Lee los préstamos que vencen mañana y anota cada aviso enviado | Protocolo de PostgreSQL sobre TCP (SQL) |
| Avisos nocturnos | Servidor de correo | Envía avisos de vencimiento y de reserva lista | SMTP |
| Servidor de correo | Lector | Entrega los avisos | Correo electrónico |
