Saltar a contenido

0032. Historial por usuario

Estado: Aceptado Fecha: 2026-10-29 Autor: Kevin Delgado Módulo(s) afectado(s): app/shared/auditoria/, tests/unit/shared/, tests/unit/core/

Contexto

El historial (ADR 0030) se lee de a limite eventos, del más reciente al más antiguo, y desde ADR 0031 se acota por fechas. El frontend ofrece filtrar por usuario, pero sólo podía hacerlo sobre los eventos ya recibidos. Con un historial largo, lo que hizo un usuario hace meses no aparecía sin bajar página tras página. La lista de usuarios para elegir salía también de esos eventos, así que quien no estaba en la primera página ni se podía elegir.

Decisión

  • GET /api/v1/auditoria acepta actor_user_id, opcional: deja sólo los eventos de ese usuario. Se combina con referencia_id, antes_de, limite, la cartera y el rango de fechas.
  • Es el id del usuario (el sub del token), no el username: el id no cambia.
  • GET /api/v1/auditoria/actores?referencia_tipo=…[&referencia_id=…][&desde=…][&hasta=…]:
  • devuelve quiénes hicieron movimientos en ese historial: [{actor_user_id, actor_username, movimientos}], del que más al que menos;
  • tiene los mismos permisos (ver con referencia_id, listar sin él), la misma cartera (ADR 0029) y el mismo rango que los eventos;
  • un tipo desconocido es 404, y desde que no es anterior a hasta, 422;
  • el nombre es el del último evento del usuario, porque el username se copia del token en cada evento (array_agg … ORDER BY id DESC).
  • Las dos operaciones validan el permiso según la consulta (SEGUN_LA_CONSULTA en test_permisos), no con requiere.

Alternativas descartadas

  • Filtrar por actor_username: un usuario puede cambiar su nombre de usuario en identidad, y sus eventos viejos quedarían fuera.
  • Tomar la lista de usuarios de identidad: trae a todos los usuarios de la empresa, también a los que nunca tocaron ese historial, y obliga a otra llamada.
  • Seguir filtrando en el frontend: el mismo problema que ADR 0031 resolvió para las fechas.

Consecuencias

  • Sin índice nuevo:
  • el filtro por usuario recorre el índice de ADR 0030 por id y descarta los de otros usuarios;
  • /actores agrupa los eventos del historial pedido.

Si los historiales crecen mucho, se puede sumar un índice con actor_user_id sin cambiar el contrato. - El contrato suma un parámetro opcional y una operación: los clientes actuales no cambian.