# ATAM reducido de Apachi

Recorrido de los escenarios del caso sobre el diseño del ADR 0001 (los
diagramas están en `context.md` y `containers.md`), con la tabla de la
semana 7.

- Sistema: Apachi
- Presenta: el equipo de Apachi
- Evalúa: la clase, en el repaso de la semana 8

## Objetivos del negocio

- Que ninguna agencia deje de recibir encomiendas, tampoco en campaña.
- Que el destinatario sepa dónde está su encomienda sin llamar a la agencia.
- Que una encomienda registrada no se pierda ni se entregue a otra persona.

## Enfoques de arquitectura

| Id | Enfoque | Dónde se ve |
|---|---|---|
| A1 | Cada agencia registra en un nodo local con su propio almacén | Contenedores: Nodo de agencia y Almacén de la agencia |
| A2 | El nodo envía a la central lo pendiente, con reintentos, cuando hay enlace | Contenedores: relación del Nodo de agencia con la API central |
| A3 | El comprobante y el SMS salen después, desde una tabla de pendientes | Contenedores: Trabajador de efectos |
| A4 | El código de seguimiento lleva el prefijo de la agencia y una parte aleatoria | ADR 0001, consecuencias |
| A5 | El nodo calcula el precio con una copia local de las tarifas | Contenedores: Almacén de la agencia |

## Escenarios

| Id | Escenario | Atributo | Origen |
|---|---|---|---|
| E1 | Sin enlace 2 h en campaña: el mostrador sigue registrando, 0 encomiendas perdidas, todo consultable en 10 min o menos al volver | disponibilidad | utility tree (A, A) |
| E2 | 40 consultas de seguimiento por segundo durante 2 h: p95 menor que 500 ms, errores menores que 0,5 % | rendimiento | utility tree (A, M) |
| E4 | 10 000 códigos probados en 1 h: 0 datos personales devueltos, alerta en 5 min o menos | seguridad | utility tree (A, M) |
| E5 | Una versión nueva del nodo se instala agencia por agencia durante 1 semana: la central rechaza 0 encomiendas de las agencias que aún tienen la versión anterior | modificabilidad | lluvia de ideas (4 votos) |

## Hallazgos

| Id | Tipo | Escenarios | Enfoques | Decisión | Atributos | Razonamiento |
|---|---|---|---|---|---|---|
| N1 | no riesgo | E1 | A1 | El nodo guarda la encomienda en su almacén antes de responder al mostrador | disponibilidad | Registrar no usa el enlace, la API central ni a los proveedores, así que la caída de 2 h no lo toca. Vale mientras la computadora de la agencia funcione |
| R1 | riesgo | E1 | A1, A2 | Hasta que se envía, la encomienda existe en un solo disco de la agencia | disponibilidad | Si el disco se daña durante las 2 h sin enlace, se pierden unas 80 encomiendas (40 por hora), y la medida pide 0 |
| S1 | punto de sensibilidad | E1 | A2 | Cada cuánto intenta el nodo enviar lo pendiente | disponibilidad | Al volver el enlace hay unas 80 encomiendas por enviar y 10 min para que se puedan consultar: si el nodo reintenta cada 15 min, la medida no se cumple aunque todo lo demás funcione |
| R2 | riesgo | E1 | A2 | El nodo reenvía lo que no recibió respuesta, y nadie decidió todavía cómo reconoce la central un envío repetido | disponibilidad | Un envío que llegó y cuya respuesta se perdió se repite: sin esa decisión, la misma encomienda queda registrada dos veces, con dos comprobantes |
| R3 | riesgo | E5 | A2 | Lo que el nodo envía a la central no lleva versión de formato | modificabilidad | Con 38 instalaciones que se actualizan una por una, durante días llegan envíos con dos formatos; si la central solo entiende el nuevo, rechaza los de las agencias que faltan |
| T1 | punto de trade-off | E1, E4 | A1, A5 | Qué datos se guardan en la agencia y por cuánto tiempo | disponibilidad, seguridad | Cuanto más guarda el nodo (tarifas, destinatarios, historial), más puede hacer sin enlace, y más datos personales quedan en 38 computadoras de mostrador |
| T2 | punto de trade-off | E1, E2 | A2 | La central recibe las encomiendas después de registradas, no al registrarlas | disponibilidad, rendimiento | Es lo que permite registrar sin enlace, y hace que una consulta de seguimiento por una encomienda recién registrada no encuentre nada. Los pedidos que no encuentran su código son otra población en la tabla de latencias |
| N2 | no riesgo | E4 | A4 | El código de seguimiento tiene una parte aleatoria y no sale de una secuencia | seguridad | Con códigos consecutivos, quien tiene uno acierta el siguiente al primer intento. Con una parte aleatoria de 8 caracteres entre 32 símbolos hay más de un billón de combinaciones por agencia, y 10 000 intentos no alcanzan |

## Temas de riesgo

| Tema | Riesgos | Objetivo del negocio que amenaza |
|---|---|---|
| El contrato entre el nodo y la central está sin decidir: qué pasa con un envío repetido y con un formato anterior | R2, R3 | Que una encomienda registrada no se pierda ni se entregue a otra persona |
