Files
dtic-DIIAA/servicios/nexxa/organismo/lib_usos.rb
T

73 lines
3.8 KiB
Ruby

# 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
# Qué significa cada evento en palabras: fuente ÚNICA para nexxa-web y GEMMA (viaja en /usos y /resumen)
TEXTOS = {
'dispensada' => 'entregada', 'liberada' => 'devuelta', 'renovada' => 'reserva renovada',
'pausada' => 'en pausa por límite del proveedor', 'agotada' => 'agotada (cuota)', 'revertida' => 'reporte deshecho',
'liberada-admin' => 'liberada por admin', 'alta' => 'dada de alta', 'editada' => 'editada',
'renombrada' => 'renombrada', 'baja' => 'dada de 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)
.map { |u| u.merge('texto' => TEXTOS.fetch(u['evento'], u['evento'])) }
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,
'textos' => TEXTOS,
'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