1. Funcionalidad Principal: Auditoría General

Se creó una nueva sección de "Auditoría" en la aplicación, diseñada para ser accedida por SuperAdmins.
Se implementó una página AuditoriaGeneralPage.tsx que actúa como un visor centralizado para el historial de cambios de múltiples entidades del sistema.
2. Backend:
Nuevo Controlador (AuditoriaController.cs): Centraliza los endpoints para obtener datos de las tablas de historial (_H).
Servicios y Repositorios Extendidos:
Se añadieron métodos GetHistorialAsync y ObtenerHistorialAsync a las capas de repositorio y servicio para cada una de las siguientes entidades, permitiendo consultar sus tablas _H con filtros:
Usuarios (gral_Usuarios_H)
Pagos de Distribuidores (cue_PagosDistribuidor_H)
Notas de Crédito/Débito (cue_CreditosDebitos_H)
Entradas/Salidas de Distribuidores (dist_EntradasSalidas_H)
Entradas/Salidas de Canillitas (dist_EntradasSalidasCanillas_H)
Novedades de Canillitas (dist_dtNovedadesCanillas_H)
Tipos de Pago (cue_dtTipopago_H)
Canillitas (Maestro) (dist_dtCanillas_H)
Distribuidores (Maestro) (dist_dtDistribuidores_H)
Empresas (Maestro) (dist_dtEmpresas_H)
Zonas (Maestro) (dist_dtZonas_H)
Otros Destinos (Maestro) (dist_dtOtrosDestinos_H)
Publicaciones (Maestro) (dist_dtPublicaciones_H)
Secciones de Publicación (dist_dtPubliSecciones_H)
Precios de Publicación (dist_Precios_H)
Recargos por Zona (dist_RecargoZona_H)
Porcentajes Pago Distribuidores (dist_PorcPago_H)
Porcentajes/Montos Canillita (dist_PorcMonPagoCanilla_H)
Control de Devoluciones (dist_dtCtrlDevoluciones_H)
Tipos de Bobina (bob_dtBobinas_H)
Estados de Bobina (bob_dtEstadosBobinas_H)
Plantas de Impresión (bob_dtPlantas_H)
Stock de Bobinas (bob_StockBobinas_H)
Tiradas (Registro Principal) (bob_RegTiradas_H)
Secciones de Tirada (bob_RegPublicaciones_H)
Cambios de Parada de Canillitas (dist_CambiosParadasCanillas_H)
Ajustes Manuales de Saldo (cue_SaldoAjustesHistorial)
DTOs de Historial: Se crearon DTOs específicos para cada tabla de historial (ej. UsuarioHistorialDto, PagoDistribuidorHistorialDto, etc.) para transferir los datos al frontend, incluyendo el nombre del usuario que realizó la modificación.
Corrección de Lógica de Saldos: Se revisó y corrigió la lógica de afectación de saldos en los servicios PagoDistribuidorService y NotaCreditoDebitoService para asegurar que los débitos y créditos se apliquen correctamente.
3. Frontend:
Nuevo Servicio (auditoriaService.ts): Contiene métodos para llamar a cada uno de los nuevos endpoints de auditoría del backend.
Nueva Página (AuditoriaGeneralPage.tsx):
Permite al SuperAdmin seleccionar el "Tipo de Entidad" a auditar desde un dropdown.
Ofrece filtros comunes (rango de fechas, usuario modificador, tipo de acción) y filtros específicos que aparecen dinámicamente según la entidad seleccionada.
Utiliza un DataGrid de Material-UI para mostrar el historial, con columnas que se adaptan dinámicamente al tipo de entidad consultada.
Nuevos DTOs en TypeScript: Se crearon las interfaces correspondientes a los DTOs de historial del backend.
Gestión de Permisos:
La sección de Auditoría en MainLayout.tsx y su ruta en AppRoutes.tsx están protegidas para ser visibles y accesibles solo por SuperAdmins.
Se añadió un permiso de ejemplo AU_GENERAL_VIEW para ser usado si se decide extender el acceso en el futuro.
Corrección de Errores Menores: Se solucionó el problema del "parpadeo" del selector de fecha en GestionarNovedadesCanillaPage al adoptar un patrón de carga de datos más controlado, similar a otras páginas funcionales.
This commit is contained in:
2025-06-12 19:36:21 -03:00
parent 437b1e8864
commit b04a3b99bf
145 changed files with 5033 additions and 1070 deletions

View File

@@ -10,6 +10,25 @@ import type { TipoPagoHistorialDto } from '../../models/dtos/Auditoria/TipoPagoH
import type { CanillaHistorialDto } from '../../models/dtos/Auditoria/CanillaHistorialDto';
import type { DistribuidorHistorialDto } from '../../models/dtos/Auditoria/DistribuidorHistorialDto';
import type { EmpresaHistorialDto } from '../../models/dtos/Auditoria/EmpresaHistorialDto';
import type { ZonaHistorialDto } from '../../models/dtos/Auditoria/ZonaHistorialDto';
import type { OtroDestinoHistorialDto } from '../../models/dtos/Auditoria/OtroDestinoHistorialDto';
import type { PublicacionHistorialDto } from '../../models/dtos/Auditoria/PublicacionHistorialDto';
import type { PubliSeccionHistorialDto } from '../../models/dtos/Auditoria/PubliSeccionHistorialDto';
import type { PrecioHistorialDto } from '../../models/dtos/Auditoria/PrecioHistorialDto';
import type { RecargoZonaHistorialDto } from '../../models/dtos/Auditoria/RecargoZonaHistorialDto';
import type { PorcPagoHistorialDto } from '../../models/dtos/Auditoria/PorcPagoHistorialDto';
import type { PorcMonCanillaHistorialDto } from '../../models/dtos/Auditoria/PorcMonCanillaHistorialDto';
import type { ControlDevolucionesHistorialDto } from '../../models/dtos/Auditoria/ControlDevolucionesHistorialDto';
import type { TipoBobinaHistorialDto } from '../../models/dtos/Auditoria/TipoBobinaHistorialDto';
import type { EstadoBobinaHistorialDto } from '../../models/dtos/Auditoria/EstadoBobinaHistorialDto';
import type { PlantaHistorialDto } from '../../models/dtos/Auditoria/PlantaHistorialDto';
import type { StockBobinaHistorialDto } from '../../models/dtos/Auditoria/StockBobinaHistorialDto';
import type { RegTiradaHistorialDto } from '../../models/dtos/Auditoria/RegTiradaHistorialDto';
import type { RegSeccionTiradaHistorialDto } from '../../models/dtos/Auditoria/RegSeccionTiradaHistorialDto';
import type { PerfilHistorialDto } from '../../models/dtos/Auditoria/PerfilHistorialDto';
import type { PermisoHistorialDto } from '../../models/dtos/Auditoria/PermisoHistorialDto';
import type { PermisosPerfilesHistorialDto } from '../../models/dtos/Auditoria/PermisosPerfilesHistorialDto';
import type { CambioParadaHistorialDto } from '../../models/dtos/Auditoria/CambioParadaHistorialDto';
interface HistorialParamsComunes {
fechaDesde?: string; // "yyyy-MM-dd"
@@ -18,6 +37,103 @@ interface HistorialParamsComunes {
tipoModificacion?: string; // Cambiado de tipoMod
}
interface HistorialCambiosParadaParams extends HistorialParamsComunes {
idCanillaAfectado?: number;
}
interface HistorialPermisosPerfilesParams extends HistorialParamsComunes {
idPerfilAfectado?: number;
idPermisoAfectado?: number;
}
interface HistorialPermisosMaestroParams extends HistorialParamsComunes { // << NUEVA INTERFAZ
idPermisoAfectado?: number;
}
interface HistorialPerfilesMaestroParams extends HistorialParamsComunes { // << NUEVA INTERFAZ
idPerfilAfectado?: number;
}
interface HistorialRegSeccionesTiradaParams extends HistorialParamsComunes {
idTiradaAfectada?: number; // ID de bob_RegPublicaciones
idPublicacionFiltro?: number;
idSeccionFiltro?: number;
idPlantaFiltro?: number;
fechaTiradaFiltro?: string;
}
interface HistorialRegTiradasParams extends HistorialParamsComunes {
idRegistroAfectado?: number;
idPublicacionFiltro?: number;
idPlantaFiltro?: number;
fechaTiradaFiltro?: string; // YYYY-MM-DD
}
interface HistorialStockBobinasParams extends HistorialParamsComunes {
idBobinaAfectada?: number;
idTipoBobinaFiltro?: number;
idPlantaFiltro?: number;
idEstadoBobinaFiltro?: number;
}
interface HistorialPlantasMaestroParams extends HistorialParamsComunes { // << NUEVA INTERFAZ
idPlantaAfectada?: number;
}
interface HistorialEstadosBobinaMaestroParams extends HistorialParamsComunes { // << NUEVA INTERFAZ
idEstadoBobinaAfectado?: number;
}
interface HistorialTiposBobinaMaestroParams extends HistorialParamsComunes { // << NUEVA INTERFAZ
idTipoBobinaAfectado?: number;
}
interface HistorialControlDevolucionesParams extends HistorialParamsComunes { // << NUEVA INTERFAZ
idControlAfectado?: number;
idEmpresaAfectada?: number;
fechaAfectada?: string; // yyyy-MM-dd
}
interface HistorialPorcMonCanillaMaestroParams extends HistorialParamsComunes { // << NUEVA INTERFAZ
idPorcMonAfectado?: number;
idPublicacionAfectada?: number;
idCanillaAfectada?: number;
}
interface HistorialPorcPagoDistMaestroParams extends HistorialParamsComunes { // << NUEVA INTERFAZ
idPorcentajeAfectado?: number;
idPublicacionAfectada?: number;
idDistribuidorAfectado?: number;
}
interface HistorialRecargosZonaMaestroParams extends HistorialParamsComunes { // << NUEVA INTERFAZ
idRecargoAfectado?: number;
idPublicacionAfectada?: number;
idZonaAfectada?: number;
}
interface HistorialPreciosMaestroParams extends HistorialParamsComunes { // << NUEVA INTERFAZ
idPrecioAfectado?: number;
idPublicacionAfectada?: number;
}
interface HistorialPubliSeccionesMaestroParams extends HistorialParamsComunes { // << NUEVA INTERFAZ
idSeccionAfectada?: number;
idPublicacionAfectada?: number; // Para filtrar por publicación si es necesario
}
interface HistorialPublicacionesMaestroParams extends HistorialParamsComunes { // << NUEVA INTERFAZ
idPublicacionAfectada?: number;
}
interface HistorialOtrosDestinosMaestroParams extends HistorialParamsComunes { // << NUEVA INTERFAZ
idOtroDestinoAfectado?: number;
}
interface HistorialZonasMaestroParams extends HistorialParamsComunes { // << NUEVA INTERFAZ
idZonaAfectada?: number;
}
interface HistorialEmpresasMaestroParams extends HistorialParamsComunes { // << NUEVA INTERFAZ
idEmpresaAfectada?: number;
}
@@ -173,6 +289,184 @@ const getHistorialEmpresasMaestro = async (params: HistorialEmpresasMaestroParam
return response.data;
};
const getHistorialZonasMaestro = async (params: HistorialZonasMaestroParams): Promise<ZonaHistorialDto[]> => {
const queryParams: any = { ...params };
if (params.idUsuarioModificador) queryParams.idUsuarioModifico = params.idUsuarioModificador;
delete queryParams.idUsuarioModificador;
const response = await apiClient.get<ZonaHistorialDto[]>('/auditoria/zonas-maestro', { params: queryParams });
return response.data;
};
const getHistorialOtrosDestinosMaestro = async (params: HistorialOtrosDestinosMaestroParams): Promise<OtroDestinoHistorialDto[]> => {
const queryParams: any = { ...params };
if (params.idUsuarioModificador) queryParams.idUsuarioModifico = params.idUsuarioModificador;
delete queryParams.idUsuarioModificador;
const response = await apiClient.get<OtroDestinoHistorialDto[]>('/auditoria/otros-destinos-maestro', { params: queryParams });
return response.data;
};
const getHistorialPublicacionesMaestro = async (params: HistorialPublicacionesMaestroParams): Promise<PublicacionHistorialDto[]> => {
const queryParams: any = { ...params };
if (params.idUsuarioModificador) queryParams.idUsuarioModifico = params.idUsuarioModificador;
delete queryParams.idUsuarioModificador;
const response = await apiClient.get<PublicacionHistorialDto[]>('/auditoria/publicaciones-maestro', { params: queryParams });
return response.data;
};
const getHistorialPubliSeccionesMaestro = async (params: HistorialPubliSeccionesMaestroParams): Promise<PubliSeccionHistorialDto[]> => {
const queryParams: any = { ...params };
if (params.idUsuarioModificador) queryParams.idUsuarioModifico = params.idUsuarioModificador;
delete queryParams.idUsuarioModificador;
// Pasar los nuevos filtros si están presentes
if (params.idPublicacionAfectada) queryParams.idPublicacionAfectada = params.idPublicacionAfectada;
const response = await apiClient.get<PubliSeccionHistorialDto[]>('/auditoria/publi-secciones-maestro', { params: queryParams });
return response.data;
};
const getHistorialPreciosMaestro = async (params: HistorialPreciosMaestroParams): Promise<PrecioHistorialDto[]> => {
const queryParams: any = { ...params };
if (params.idUsuarioModificador) queryParams.idUsuarioModifico = params.idUsuarioModificador;
delete queryParams.idUsuarioModificador;
if (params.idPublicacionAfectada) queryParams.idPublicacionAfectada = params.idPublicacionAfectada;
const response = await apiClient.get<PrecioHistorialDto[]>('/auditoria/precios-publicacion-maestro', { params: queryParams });
return response.data;
};
const getHistorialRecargosZonaMaestro = async (params: HistorialRecargosZonaMaestroParams): Promise<RecargoZonaHistorialDto[]> => {
const queryParams: any = { ...params };
if (params.idUsuarioModificador) queryParams.idUsuarioModifico = params.idUsuarioModificador;
delete queryParams.idUsuarioModificador;
if (params.idPublicacionAfectada) queryParams.idPublicacionAfectada = params.idPublicacionAfectada;
if (params.idZonaAfectada) queryParams.idZonaAfectada = params.idZonaAfectada;
const response = await apiClient.get<RecargoZonaHistorialDto[]>('/auditoria/recargos-zona-maestro', { params: queryParams });
return response.data;
};
const getHistorialPorcPagoDistMaestro = async (params: HistorialPorcPagoDistMaestroParams): Promise<PorcPagoHistorialDto[]> => {
const queryParams: any = { ...params };
if (params.idUsuarioModificador) queryParams.idUsuarioModifico = params.idUsuarioModificador;
delete queryParams.idUsuarioModificador;
if (params.idPublicacionAfectada) queryParams.idPublicacionAfectada = params.idPublicacionAfectada;
if (params.idDistribuidorAfectado) queryParams.idDistribuidorAfectado = params.idDistribuidorAfectado;
const response = await apiClient.get<PorcPagoHistorialDto[]>('/auditoria/porc-pago-dist-maestro', { params: queryParams });
return response.data;
};
const getHistorialPorcMonCanillaMaestro = async (params: HistorialPorcMonCanillaMaestroParams): Promise<PorcMonCanillaHistorialDto[]> => {
const queryParams: any = { ...params };
if (params.idUsuarioModificador) queryParams.idUsuarioModifico = params.idUsuarioModificador;
delete queryParams.idUsuarioModificador;
if (params.idPublicacionAfectada) queryParams.idPublicacionAfectada = params.idPublicacionAfectada;
if (params.idCanillaAfectada) queryParams.idCanillaAfectada = params.idCanillaAfectada;
const response = await apiClient.get<PorcMonCanillaHistorialDto[]>('/auditoria/porc-mon-canilla-maestro', { params: queryParams });
return response.data;
};
const getHistorialControlDevoluciones = async (params: HistorialControlDevolucionesParams): Promise<ControlDevolucionesHistorialDto[]> => {
const queryParams: any = { ...params };
if (params.idUsuarioModificador) queryParams.idUsuarioModifico = params.idUsuarioModificador;
delete queryParams.idUsuarioModificador;
if (params.idEmpresaAfectada) queryParams.idEmpresaAfectada = params.idEmpresaAfectada;
if (params.fechaAfectada) queryParams.fechaAfectada = params.fechaAfectada;
const response = await apiClient.get<ControlDevolucionesHistorialDto[]>('/auditoria/control-devoluciones-maestro', { params: queryParams });
return response.data;
};
const getHistorialTiposBobinaMaestro = async (params: HistorialTiposBobinaMaestroParams): Promise<TipoBobinaHistorialDto[]> => {
const queryParams: any = { ...params };
if (params.idUsuarioModificador) queryParams.idUsuarioModifico = params.idUsuarioModificador;
delete queryParams.idUsuarioModificador;
const response = await apiClient.get<TipoBobinaHistorialDto[]>('/auditoria/tipos-bobina-maestro', { params: queryParams });
return response.data;
};
const getHistorialEstadosBobinaMaestro = async (params: HistorialEstadosBobinaMaestroParams): Promise<EstadoBobinaHistorialDto[]> => {
const queryParams: any = { ...params };
if (params.idUsuarioModificador) queryParams.idUsuarioModifico = params.idUsuarioModificador;
delete queryParams.idUsuarioModificador;
const response = await apiClient.get<EstadoBobinaHistorialDto[]>('/auditoria/estados-bobina-maestro', { params: queryParams });
return response.data;
};
const getHistorialPlantasMaestro = async (params: HistorialPlantasMaestroParams): Promise<PlantaHistorialDto[]> => {
const queryParams: any = { ...params };
if (params.idUsuarioModificador) queryParams.idUsuarioModifico = params.idUsuarioModificador;
delete queryParams.idUsuarioModificador;
const response = await apiClient.get<PlantaHistorialDto[]>('/auditoria/plantas-impresion-maestro', { params: queryParams });
return response.data;
};
const getHistorialStockBobinas = async (params: HistorialStockBobinasParams): Promise<StockBobinaHistorialDto[]> => {
const queryParams: any = { ...params };
const response = await apiClient.get<StockBobinaHistorialDto[]>('/auditoria/stock-bobinas-maestro', { params: queryParams });
return response.data;
};
const getHistorialRegTiradas = async (params: HistorialRegTiradasParams): Promise<RegTiradaHistorialDto[]> => {
const queryParams: any = { ...params };
const response = await apiClient.get<RegTiradaHistorialDto[]>('/auditoria/reg-tiradas-maestro', { params: queryParams });
return response.data;
};
const getHistorialRegSeccionesTirada = async (params: HistorialRegSeccionesTiradaParams): Promise<RegSeccionTiradaHistorialDto[]> => {
const queryParams: any = { ...params };
// ... (mapeo de idUsuarioModificador)
const response = await apiClient.get<RegSeccionTiradaHistorialDto[]>('/auditoria/reg-secciones-tirada-maestro', { params: queryParams });
return response.data;
};
const getHistorialPerfilesMaestro = async (params: HistorialPerfilesMaestroParams): Promise<PerfilHistorialDto[]> => {
const queryParams: any = { ...params };
if (params.idUsuarioModificador) queryParams.idUsuarioModifico = params.idUsuarioModificador;
delete queryParams.idUsuarioModificador;
const response = await apiClient.get<PerfilHistorialDto[]>('/auditoria/perfiles-maestro', { params: queryParams });
return response.data;
};
const getHistorialPermisosMaestro = async (params: HistorialPermisosMaestroParams): Promise<PermisoHistorialDto[]> => {
const queryParams: any = { ...params };
if (params.idUsuarioModificador) queryParams.idUsuarioModifico = params.idUsuarioModificador;
delete queryParams.idUsuarioModificador;
const response = await apiClient.get<PermisoHistorialDto[]>('/auditoria/permisos-maestro', { params: queryParams });
return response.data;
};
const getHistorialPermisosPerfiles = async (params: HistorialPermisosPerfilesParams): Promise<PermisosPerfilesHistorialDto[]> => {
const queryParams: any = { ...params };
// ... mapeo de idUsuarioModificador ...
const response = await apiClient.get<PermisosPerfilesHistorialDto[]>('/auditoria/permisos-perfiles-historial', { params: queryParams });
return response.data;
};
const getHistorialCambiosParada = async (params: HistorialCambiosParadaParams): Promise<CambioParadaHistorialDto[]> => {
const queryParams: any = { ...params };
if (params.idUsuarioModificador) queryParams.idUsuarioModifico = params.idUsuarioModificador;
delete queryParams.idUsuarioModificador;
const response = await apiClient.get<CambioParadaHistorialDto[]>('/auditoria/cambios-parada-canilla', { params: queryParams });
return response.data;
};
const auditoriaService = {
getHistorialUsuarios,
getHistorialPagosDistribuidor,
@@ -185,6 +479,25 @@ const auditoriaService = {
getHistorialCanillitasMaestro,
getHistorialDistribuidoresMaestro,
getHistorialEmpresasMaestro,
getHistorialZonasMaestro,
getHistorialOtrosDestinosMaestro,
getHistorialPublicacionesMaestro,
getHistorialPubliSeccionesMaestro,
getHistorialPreciosMaestro,
getHistorialRecargosZonaMaestro,
getHistorialPorcPagoDistMaestro,
getHistorialPorcMonCanillaMaestro,
getHistorialControlDevoluciones,
getHistorialTiposBobinaMaestro,
getHistorialEstadosBobinaMaestro,
getHistorialPlantasMaestro,
getHistorialStockBobinas,
getHistorialRegTiradas,
getHistorialRegSeccionesTirada,
getHistorialPerfilesMaestro,
getHistorialPermisosMaestro,
getHistorialPermisosPerfiles,
getHistorialCambiosParada,
};
export default auditoriaService;