Saltar al contenido principal

TEC-001 — Caché Distribuido con Redis

· 3 min de lectura
Yovany Suárez Silva
Software Engineer - FullStack Developer

Implementación de la mejora TEC-001 (Caché Distribuido), dentro de 6.1 Rendimiento y Escalabilidad. El módulo pasa de un caché local a cada instancia a un caché distribuido compartido por todas, con el estado de sesión incluido y degradación automática a memoria.


📋 Alcance​

RFEntregable
RF-TEC-001-01Redis como caché distribuido de las consultas frecuentes (reportes, consumo y KPIs)
RF-TEC-001-02Estado de sesión distribuido: sesiones activas y blacklist de tokens invalidados
RF-TEC-001-03Invalidación del caché al cambiar los datos subyacentes
RF-TEC-001-04TTL configurable por tipo de consulta mediante variables de entorno

⚙️ Arquitectura​

CacheService conserva su interfaz pública (get, set, getOrSet, del, delByPrefix, clear) y pasa a ser una fachada sobre un backend intercambiable:

  • Redis (redis 4.7) cuando está habilitado y conecta. Serializa en JSON, usa SCAN —nunca KEYS— para invalidar por prefijo y antepone un prefijo global (ccf:) a todas las claves.
  • Memoria (el Map con TTL anterior) cuando Redis está deshabilitado, no conecta o falla en caliente. Una caída de Redis no tumba la aplicación: cada operación degrada al respaldo y deja un aviso en el log.

Ningún dominio cambió su forma de cachear: siguen inyectando CacheService.

🔐 Sesiones distribuidas (RF-02)​

SessionStoreService reemplaza el Map en memoria de AuthService por dos claves en el caché compartido: sesion:activa:{idUsuario} y sesion:invalidada:{idUsuario} (TTL = vigencia del JWT). El JWT sigue siendo stateless; lo que ahora se comparte entre instancias es el estado de sesión. Se añade GET /api/auths/sessions (Administrador) para listar las sesiones activas.

♻️ Invalidación al escribir (RF-03)​

Un interceptor global (CacheInvalidationInterceptor) y el decorador @InvalidaCache('reportes:') invalidan el caché después de que una escritura tiene éxito en los controladores de movimientos, solicitudes, productos, lotes/series, categorías, oficinas y presentaciones. Una petición fallida no borra el caché.

⏱️ TTL por tipo de consulta (RF-04)​

TipoVariableDefecto
reportesCACHE_TTL_REPORTES60 s
consumoCACHE_TTL_CONSUMO60 s
kpisCACHE_TTL_KPIS60 s
próximos a vencerCACHE_TTL_PROXIMOS_VENCER60 s
sesiónCACHE_TTL_SESION24 h
generalCACHE_TTL_SECONDS60 s

🔍 Observabilidad​

GET /api/cache/estado (Administrador) informa el backend activo, su disponibilidad, el prefijo y la tabla de TTL vigente. POST /api/cache/invalidar permite invalidar el caché de reportes a mano.

✅ Verificación​

  • 368 pruebas en 38 suites, 0 fallos; tsc y ESLint limpios.
  • Pruebas nuevas para constantes/TTL, backend en memoria, backend Redis (cliente simulado), fachada, sesiones, interceptor y una prueba de integración de DI que arranca el módulo sin Redis y confirma la degradación a memoria.
  • La prueba de integración destapó un bug real: cerrar un cliente Redis que nunca conectó lanzaba ClientClosedError; corregido comprobando isOpen antes de cerrar.

Limitación: con Redis caído, cada instancia invalida solo su propio respaldo en memoria (comportamiento equivalente al anterior).