# Apachi: diagrama de contenedores

- Nivel: contenedores
- Sistema: Apachi

El diseño que queda después del ADR-0001: cada agencia registra en su propio
nodo y la central se entera después.

## Elementos

| Nombre | Tipo | Descripción | Tecnología |
|---|---|---|---|
| Encargado de agencia | persona | Atiende el mostrador: registra encomiendas, entrega la guía y entrega la encomienda a su destinatario | — |
| Destinatario | persona | Consulta el estado de su encomienda con el código de seguimiento y la recoge en la agencia de destino | — |
| Aplicación de mostrador | contenedor | Las pantallas de registro y de entrega; corre en el navegador de la computadora de la agencia | TypeScript y HTML, sin framework |
| Nodo de agencia | contenedor | Registra las encomiendas de su agencia, calcula el precio con su copia de las tarifas, genera el código de seguimiento y envía a la central lo que tiene pendiente | Node.js 26, node:http, en la computadora de la agencia |
| Almacén de la agencia | almacén de datos | Encomiendas registradas en la agencia, cuáles falta enviar a la central y la copia local de las tarifas | SQLite, en el disco cifrado de la computadora de la agencia |
| API central | contenedor | Recibe las encomiendas de los nodos, responde el seguimiento, publica las tarifas y anota los comprobantes y avisos por enviar | Node.js 26, node:http, en la nube |
| Página de seguimiento | contenedor | La página donde el destinatario escribe su código y ve el recorrido; corre en el navegador de su celular | TypeScript y HTML, sin framework |
| Trabajador de efectos | contenedor | Programa que toma los comprobantes y los avisos pendientes, los envía y reintenta los que fallaron | Node.js 26, proceso aparte de la API |
| Base de datos central | almacén de datos | Encomiendas de todas las agencias, su recorrido, las tarifas y los comprobantes y avisos pendientes | PostgreSQL 18 |
| Proveedor de facturación | sistema externo | Emite el comprobante electrónico de cada encomienda y devuelve su número | API REST del proveedor contratado |
| Proveedor de SMS | sistema externo | Entrega mensajes de texto a los celulares de los destinatarios | API REST del proveedor |

## Relaciones

| De | Hacia | Qué viaja | Protocolo |
|---|---|---|---|
| Encargado de agencia | Aplicación de mostrador | Registra encomiendas y entregas | Navegador web |
| Aplicación de mostrador | Nodo de agencia | Pide registrar una encomienda, cotizar un precio o anotar una entrega | HTTP, JSON, en la red de la agencia |
| Nodo de agencia | Almacén de la agencia | Guarda cada encomienda antes de responder al mostrador y marca las ya enviadas | SQL sobre un archivo local |
| Nodo de agencia | API central | Envía las encomiendas y entregas pendientes, y pide las tarifas vigentes | HTTPS, JSON, cuando hay enlace |
| Destinatario | Página de seguimiento | Consulta el estado de su encomienda con el código | Navegador web |
| Página de seguimiento | API central | Pide el recorrido de una encomienda por su código | HTTPS, JSON |
| API central | Base de datos central | Guarda encomiendas y recorridos, y consulta el seguimiento | Protocolo de PostgreSQL sobre TCP (SQL) |
| Trabajador de efectos | Base de datos central | Toma los comprobantes y avisos pendientes y anota los enviados | Protocolo de PostgreSQL sobre TCP (SQL) |
| Trabajador de efectos | Proveedor de facturación | Envía los datos de cada encomienda para emitir su comprobante | HTTPS, JSON |
| Trabajador de efectos | Proveedor de SMS | Envía el código de seguimiento y el aviso de llegada | HTTPS, JSON |
| Proveedor de SMS | Destinatario | Entrega el código de seguimiento y el aviso de llegada | SMS |
