# Decisiones de cache

Una fila por cada respuesta que el sistema da. Se llena **antes** de programar:
si una celda no se puede llenar, esa respuesta todavía no puede ir a la cache.

| Respuesta | ¿Va a la cache? ¿Por qué? | Clave | TTL | Qué la invalida | Cuán vieja puede llegar a estar y quién lo nota | Con la cache vacía o caída |
|---|---|---|---|---|---|---|
| | | | | | | |
| | | | | | | |
| | | | | | | |

Cómo llenar cada columna:

- **Respuesta.** El endpoint o la consulta, con sus parámetros: `GET /products/:id`.
- **¿Va a la cache? ¿Por qué?** Sí o no, con el dato que lo justifica: cuántas
  veces se lee por cada vez que cambia, cuánto cuesta calcularla (medido) y si
  tolera estar vieja. "No" también es una decisión, y se escribe.
- **Clave.** Con el prefijo y con todo lo que hace que dos respuestas sean
  distintas (el id, los filtros). Si dos pedidos distintos producen la misma
  clave, uno de los dos va a recibir la respuesta del otro.
- **TTL.** Un número con su unidad, y de dónde sale: cuánto retraso tolera el
  negocio para ese dato, no "lo que se suele poner".
- **Qué la invalida.** Cada escritura que cambia esa respuesta, con el lugar
  del código donde ocurre. Si la lista es larga o no se puede completar, el
  TTL es la única garantía y tiene que ser corto.
- **Cuán vieja puede llegar a estar y quién lo nota.** El peor caso: si falla
  una invalidación, el dato viejo dura hasta que vence el TTL. Digan qué ve el
  usuario mientras tanto y si eso es aceptable.
- **Con la cache vacía o caída.** Qué pasa con la latencia y con la carga del
  origen justo después de reiniciar Redis, y mientras Redis no responde.
  ¿El origen aguanta? Con un número medido.

## Ejemplo: Qhatu

| Respuesta | ¿Va a la cache? ¿Por qué? | Clave | TTL | Qué la invalida | Cuán vieja puede llegar a estar y quién lo nota | Con la cache vacía o caída |
|---|---|---|---|---|---|---|
| `GET /products` | Sí. Es lo más pedido y lo más caro: suma todos los movimientos de stock | `w11:products` | 5 s | Una venta o un cambio de precio de cualquier producto (`sell` y `setPrice` en `src/service.ts`) | 5 s si se pierde una invalidación: alguien ve un stock que ya bajó. La venta misma no usa la cache, así que no se vende de más | Vacía: un solo recálculo si se usa single-flight. Caída: cada pedido va a PostgreSQL |
| `GET /products/:id` | Sí. Diez productos concentran la mayoría de las visitas | `w11:product:<id>` | 30 s ± 10 % | Una venta o un cambio de precio de ese producto | 30 s: un precio o un stock viejo en pantalla | Igual que la lista, repartido entre muchas claves |
| `GET /products/:id` de un id que no existe | Sí, como "no existe" | `w11:product:<id>` | 5 s | Nada (hoy no se crean productos); si se crearan, crear uno tendría que borrarla | 5 s: un producto recién creado aparece como inexistente | Cada pregunta llega a PostgreSQL |
| `POST /products/:id/sales` | No. Es una escritura y decide con el stock real | — | — | — | — | No depende de la cache |
