# ADR 0001: Las agencias registran encomiendas en un nodo local

## Contexto

Doce de las 38 agencias pierden el enlace a internet varias veces al mes, a
veces por horas. Hoy el mostrador es una página que habla con un monolito en
la nube: registrar una encomienda necesita, en serie, el enlace de la agencia
(99,2 % en esas doce), la API, PostgreSQL, el proveedor de facturación y el
de SMS. La cuenta da 98,5 %, y sin enlace no se registra nada: el encargado
llena la guía en papel y la digita después.

La empresa aceptó que el comprobante y el SMS lleguen después del registro.
El equipo son cinco personas y la nube ya está contratada.

**Escenario:** E1, el único (A, A) del utility tree: con el enlace de una agencia caído 2 horas en plena campaña, el mostrador sigue registrando, se pierden 0 encomiendas y el 100 % se puede consultar en 10 minutos o menos desde que el enlace vuelve.

## Alternativas consideradas

### A. No cambiar el diseño

- **Gana:** no hay nada que construir ni que operar; el seguimiento muestra siempre lo mismo que la base de datos central.
- **Cuesta:** sin enlace, la encomienda no tiene código de seguimiento hasta que alguien la digita, y en campaña la digitación se atrasa.
- **Por qué no:** no cumple E1: durante las 2 horas no se registra nada en el sistema.

### B. Efectos diferidos y un segundo enlace

- **Gana:** el comprobante y el SMS salen de una tabla de pendientes y dejan de estar en el camino; con un enlace 4G de respaldo de 97 %, registrar sube a 99,88 % si las caídas de los dos enlaces son independientes. El diseño sigue siendo un solo despliegue.
- **Cuesta:** un contrato mensual por agencia, y un proceso más (el que envía los pendientes).
- **Por qué no:** en esas agencias los dos enlaces dependen de la misma energía y, a veces, de la misma torre, así que sus caídas no son independientes. Mejora el promedio y no cumple E1, que describe justamente las 2 horas en que no hay ninguno.

### C. Un nodo local en cada agencia

- **Gana:** registrar necesita solo la computadora de la agencia; el enlace, la API central y los dos proveedores salen del camino del mostrador.
- **Cuesta:** 38 instalaciones que operar, consistencia eventual entre la agencia y la central, y datos personales fuera del centro de datos.

## Decisión

- **Alternativa elegida:** C

Vamos a instalar en cada agencia un nodo: un programa en la computadora del
mostrador, con su propio almacén en disco. El nodo registra la encomienda,
calcula el precio con su copia de las tarifas, genera el código de
seguimiento y responde al mostrador sin hablar con la central. Lo registrado
queda marcado como pendiente y el nodo lo envía a la API central cuando hay
enlace, las veces que haga falta. La central emite el comprobante y el SMS
después, desde su tabla de pendientes. Es la única alternativa en la que E1
no depende del enlace. Habría que revisarla si las doce agencias consiguen
un enlace que no se caiga por horas.

## Estado

Aceptado

## Consecuencias

- **Buena:** con el enlace caído, el mostrador sigue registrando y entrega la guía con su código. E1 se puede cumplir.
- **Buena:** un proveedor externo que no responde ya no detiene a ninguna agencia.
- **Mala:** el seguimiento es eventualmente consistente: una encomienda registrada sin enlace no existe para el destinatario hasta que el nodo la envía.
- **Mala:** un nodo sin enlace cobra con la última tarifa que recibió. Se acepta que vale el precio de la guía, y un cambio de tarifa se publica con días de anticipación.
- **Mala:** el nodo puede enviar la misma encomienda dos veces (envía, no recibe respuesta, reintenta). La central tiene que reconocerla por su código y no registrarla de nuevo.
- **Mala:** hasta que se envía, una encomienda existe en un solo disco. Si ese disco se daña, se pierde: es un riesgo abierto frente a las 0 encomiendas perdidas de E1.
- **Mala:** hay datos personales en 38 computadoras de mostrador y 38 instalaciones que actualizar. Durante una actualización conviven dos versiones del nodo, y la API central tiene que aceptar las dos.
- **Neutra:** el código de seguimiento ya no sale de una secuencia de la base de datos central: lleva el prefijo de la agencia y una parte aleatoria.
