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/auditoriaaceptaactor_user_id, opcional: deja sólo los eventos de ese usuario. Se combina conreferencia_id,antes_de,limite, la cartera y el rango de fechas.- Es el
iddel usuario (elsubdel token), no elusername: 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 (
verconreferencia_id,listarsin él), la misma cartera (ADR 0029) y el mismo rango que los eventos; - un tipo desconocido es 404, y
desdeque no es anterior ahasta, 422; - el nombre es el del último evento del usuario, porque el
usernamese copia del token en cada evento (array_agg … ORDER BY id DESC). - Las dos operaciones validan el permiso según la consulta
(
SEGUN_LA_CONSULTAentest_permisos), no conrequiere.
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
idy descarta los de otros usuarios; /actoresagrupa 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.