# frozen_string_literal: true # lib_usos.rb — Registro de uso por individuo (P201/Fase3, D045 §11, ME-605 punto 5) # ============================================================================== # Trazabilidad de quién recibió qué key y cuándo — separado del dato de origen # (cuenta_origen, en lib_registro.rb) y separado de registro.json (estado actual) # para no mezclar "foto del ahora" con "historial acumulado". Append-only, # JSONL — mismo espíritu que un log de bitácora: se escribe, no se reescribe. # ============================================================================== require 'json' require 'time' require_relative 'lib_estado' module Nexxa module Usos LOG_FILE = Estado::USOS_LOG # fuente única de la ruta (P335/Fase 17) # Registro COMPLETO de lo que pasa con cada key (P337/Fase 1). Códigos estables (hay filas guardadas con ellos); # nexxa-web los traduce a palabras: EVENTOS = %w[dispensada liberada renovada pausada agotada revertida liberada-admin alta editada renombrada baja].freeze # motivo: lo que contestó el proveedor (pausada/agotada), qué cambió (editada) o el nombre anterior (renombrada). # hasta: hasta cuándo queda así (fin de la reserva o del bloqueo). Nunca valores de keys. def self.registrar(provider:, identificador:, individuo:, en: Time.now, evento: 'dispensada', motivo: nil, hasta: nil) linea = { 'provider' => provider, 'identificador' => identificador, 'individuo' => individuo, 'evento' => evento, 'en' => en.iso8601, 'motivo' => motivo, 'hasta' => hasta } Estado.usos_registrar(linea) end # Más reciente primero. Filtros opcionales; horas: solo la ventana de las últimas N horas def self.historial(provider: nil, identificador: nil, individuo: nil, evento: nil, horas: nil, limit: 100) Estado.usos_historial(provider: provider, identificador: identificador, individuo: individuo, evento: evento, desde: horas && (Time.now - (horas.to_f * 3600)), limit: limit) end # Lo que muestra el Dashboard (P337/Fase 1): cuántas keys en cada estado AHORA (todos los estados, también los # que están en 0: un número ausente se presta a interpretar) y qué pasó en las últimas N horas, en total y por key. # keys: Registro.todas_con_estado. eventos: inyectable (tests); por defecto, el registro de la ventana. def self.resumen(keys, horas: 24, eventos: nil) eventos ||= historial(horas: horas, limit: 1_000_000) contar = ->(lista) { EVENTOS.to_h { |e| [e, lista.count { |u| u['evento'] == e }] } } por_key = keys.map do |k| propios = eventos.select { |u| u['provider'] == k['provider'] && u['identificador'] == k['identificador'] } k.slice('provider', 'identificador', 'estado', 'hasta', 'por', 'motivo', 'ultimo_uso', 'ultimo_individuo') .merge('eventos' => contar.call(propios), 'ultimo_evento' => propios.first) end { 'horas' => horas, 'ahora' => Nexxa::Registro::ESTADOS.to_h { |e| [e, keys.count { |k| k['estado'] == e }] }, 'eventos' => contar.call(eventos), 'por_key' => por_key.sort_by { |k| [k['provider'].to_s, k['identificador'].to_s] } } end end end