Auditoría — Resumen
El módulo de Auditoría de Zentto proporciona trazabilidad completa de todas las operaciones del sistema. Cada acción realizada por cualquier usuario queda registrada automáticamente, garantizando transparencia y cumplimiento normativo.
Características principales
Sección titulada «Características principales»- Bitácora automática: cada creación, modificación y eliminación queda registrada.
- Alertas inteligentes: notificaciones proactivas ante situaciones anómalas.
- Cumplimiento fiscal: registros fiscales, reportes de cierre y libros legales.
- No manipulable: los registros de auditoría no pueden ser editados ni eliminados.
Principios de diseño
Sección titulada «Principios de diseño»- Automático: no requiere acción del usuario. Todo se registra transparentemente.
- Inmutable: los registros de auditoría son de solo lectura.
- Completo: cada registro incluye quién, qué, cuándo y desde dónde.
- Consultable: búsqueda avanzada con filtros por usuario, módulo, acción y fecha.
Qué se registra
Sección titulada «Qué se registra»| Categoría | Ejemplos |
|---|---|
| Autenticación | Inicio/cierre de sesión, intentos fallidos, bloqueos |
| Datos maestros | Crear/editar clientes, productos, proveedores |
| Documentos | Facturas, notas de crédito, órdenes de compra |
| Inventario | Ajustes, transferencias, entradas, salidas |
| Configuración | Cambios en parámetros del sistema, permisos |
| Fiscal | Reportes Z, libros de ventas/compras, retenciones |
Integración con otros módulos
Sección titulada «Integración con otros módulos»La auditoría es transversal a todo el ERP. Cada módulo envía eventos automáticamente al sistema de auditoría sin intervención del desarrollador ni del usuario.
Secciones del módulo
Sección titulada «Secciones del módulo»| Sección | Descripción |
|---|---|
| Bitácora | Registro detallado de todas las acciones |
| Alertas | Notificaciones inteligentes automáticas |
| Fiscal | Registros y reportes de cumplimiento fiscal |
Flujo del usuario
Sección titulada «Flujo del usuario»Vista no técnica del proceso. Pensada para personal de operación, contabilidad, ventas o administración.
Editable en draw.io: descarga el SVG → en draw.io: File → Import from → Device → selecciona el SVG. Cada nodo queda editable.
Flujo técnico
Sección titulada «Flujo técnico»Vista técnica para desarrolladores: endpoints, stored procedures/funciones, tablas y servicios involucrados.
| Componente | Tipo | Ubicación |
|---|---|---|
/v1/audit/* | Routes Express | web/api/src/routes/audit/ |
usp_aud_AuditLog_Insert | Stored procedure (SP PG) | web/api/sqlweb-pg/includes/sp/ |
usp_aud_AuditLog_List | Stored procedure (SP PG) | web/api/sqlweb-pg/includes/sp/ |
usp_aud_Stats_Get | Stored procedure (SP PG) | web/api/sqlweb-pg/includes/sp/ |
aud.AuditLog | Tabla operativa | web/api/migrations/postgres/ |
aud.UserActivity | Tabla operativa | web/api/migrations/postgres/ |
aud.FiscalRecord | Tabla operativa | web/api/migrations/postgres/ |
audit-logger.ts | Middleware Express | web/api/src/middleware/ |
BitacoraListPage.tsx | Componente Frontend | web/modular-frontend/packages/module-auditoria/src/ |
Editable en draw.io: descarga el SVG → File → Import from → Device.