ADR-005: modelo de lectura por eventos para stock y precio
Aceptado el 10/11/2026 por Andrés.
Contexto
p95 menor a 300 ms, picos 10x, 99.9% y no tumbar ERP ni WMS. Hoy cada lectura es una consulta al legado.
Opciones
| Opción | Problema |
|---|---|
| Cache con vencimiento delante del legado | Cada vencimiento vuelve a golpear al legado; una avalancha de fallos de cache en plena promo lo tumba igual |
| Réplica de lectura de la base del ERP | Acopla la capa al esquema del ERP; no cubre al WMS |
| Vista materializada alimentada por eventos | Consistencia eventual; hay que operar la alimentación |
Decisión
Vista materializada en Redis, actualizada por eventos de los adaptadores, con respaldo en la base del servicio y estado reconstruible desde tópicos compactados. Detalle en docs/to-be/05-modelo-de-lectura.md.
Qué se sacrifica
- El dato puede estar desactualizado unos segundos. Se declara (
asOf,stale) y se mide. - Más piezas: adaptadores, Kafka y Redis en la ruta de alimentación.
Por qué se acepta
La decisión que importa, prometer una unidad, no se toma con este dato sino con la reserva (ADR-003).