feat(nexxa): taxonomía cerrada de estados y registro completo de eventos (motivo, hasta, quién), /resumen y /usos filtrable; 2.0.0 (P337/F1)
Tests ADN / test (push) Canceled after 0s
Tests ADN / test (push) Canceled after 0s
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Co-Authored-By: GEMMA <noreply@gemma.dtic>
This commit is contained in:
co-authored by
Claude Opus 5.5
GEMMA
parent
08aa45117e
commit
82e56aad0e
@@ -16,23 +16,48 @@ module Nexxa
|
||||
module Usos
|
||||
LOG_FILE = Estado::USOS_LOG # fuente única de la ruta (P335/Fase 17)
|
||||
|
||||
# evento (P204/Fase3): 'dispensada' (reserva al entregar la key) o 'agotada'
|
||||
# (el consumidor reportó agotamiento real) — default compat con llamadas
|
||||
# previas a Fase3 (todas eran dispensas).
|
||||
def self.registrar(provider:, identificador:, individuo:, en: Time.now, evento: 'dispensada')
|
||||
# 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
|
||||
'en' => en.iso8601,
|
||||
'motivo' => motivo,
|
||||
'hasta' => hasta
|
||||
}
|
||||
Estado.usos_registrar(linea)
|
||||
end
|
||||
|
||||
# Historial más reciente primero, opcionalmente filtrado por key (Nexxa::Estado, P335/Fase 17)
|
||||
def self.historial(provider: nil, identificador: nil, limit: 50)
|
||||
Estado.usos_historial(provider: provider, identificador: identificador, limit: limit)
|
||||
# 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
|
||||
|
||||
Reference in New Issue
Block a user