Tests ADN / test (push) Canceled after 0s
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Co-Authored-By: GEMMA <noreply@gemma.dtic>
73 lines
3.8 KiB
Ruby
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
|