Auditoría
Cómo leer la bitácora: quién hizo qué, sobre qué registro, qué cambió y por qué falló; qué no se registra, y el historial de cada ficha.
La auditoría es el registro de cada acción que cambia algo en el sistema: un cobro, una anulación, un contrato emitido, un cliente editado, un permiso ajustado. Sirve para reconstruir qué pasó y quién decidió, sin tener que preguntar.
Se ve en dos lugares:
- Configuración → Auditoría — la bitácora completa, con filtros.
- La pestaña Historial de cada ficha — sólo lo que toca a ese registro (ver más abajo).
Los dos piden el permiso Ver la bitácora de auditoría. Quien no lo tiene no ve la pestaña.
Cómo se lee un evento
Cada fila cuenta la acción en una frase:
Johan Sierra anuló el cobro PAG-000044 · María Peña
- Quién — el nombre de quien actuó. Si la acción no tiene un usuario detrás, dice Sistema.
- Qué hizo — la acción de negocio: «cobró cuotas», «emitió el contrato de venta», «cambió el rol del usuario».
- Sobre qué — el registro por su número y, cuando lo tiene, su cliente. No un código interno: si el evento no guardó una referencia legible, la frase dice el módulo —«creó un registro de financiamientos»— y un inicio de sesión queda sólo como «inició sesión».
Debajo, el módulo y un resumen: cuántos campos cambiaron, «datos enviados» o «no se completó».
Las marcas
| Marca | Cuándo aparece |
|---|---|
| Crítico | Eliminaciones, anulaciones, rechazos, intentos fallidos de entrar y toda acción que necesitó PIN |
| No se completó | La acción se intentó y el sistema la rechazó |
| Con autorización | Se hizo con PIN de administrador |
El detalle
Al elegir un evento, el panel de la derecha muestra:
| Sección | Qué dice |
|---|---|
| Quién y cuándo | Usuario y su código, fecha y hora, dirección IP y dispositivo. Si hubo PIN, Autorizado por con el nombre de quien lo puso —que no siempre es quien hizo la acción— |
| Por qué no se completó | Sólo en los fallidos: el motivo tal como lo dio el sistema, por ejemplo qué dato faltaba |
| Qué cambió | En una modificación, cada campo que cambió con su valor antes y después. El resto del registro no se repite |
| Datos registrados | En una creación, lo que se guardó |
| Datos del registro eliminado | En una eliminación, cómo estaba justo antes de borrarse |
Los valores se muestran como se leen en pantalla: fechas, montos, Sí/No, y las relaciones por su nombre — «Género: Masculino → Femenino», «Notario: Lic. Pérez». Ese nombre se guarda en el momento del cambio: si mañana el catálogo cambia o el registro se borra, el evento sigue diciendo lo que era.
«Datos enviados» en vez de «Qué cambió»
Algunas modificaciones no guardan cómo estaba el registro antes. Ahí el detalle muestra lo que se mandó a guardar, y lo aclara: sin el «antes» no hay comparación posible.
Buscar en la bitácora
| Filtro | Cómo funciona |
|---|---|
| Buscar | Por nombre o código de usuario, por la frase de la acción, o por la referencia del registro («FIN-000012», «María Peña») |
| Módulo | Clientes, Financiamientos, Pagos, Unidades… |
| Acción | La lista completa de acciones con nombre: «Anuló el cobro», «Condonó la mora», «Emitió el contrato de venta» |
| Fecha | Hoy, ayer, últimos 7 o 30 días, o todo. Cuenta el día de República Dominicana: «hoy» va de medianoche a medianoche |
Abre en Hoy, con lo más reciente arriba.
Qué no se registra
- Consultar. Abrir una ficha, listar o descargar un PDF no deja evento.
- Marcar como leído: las alertas de la campana y las solicitudes de empleados vistas, y refrescar el panel administrativo.
- El PIN de administrador y el restablecimiento de contraseña: no pasan por esta bitácora; el uso del PIN queda en el registro de autorizaciones.
- Las vistas previas y los cálculos: la previa de un cobro, de un plan de pagos, de un abono a capital, del contrato o del cuadre diario. No cambian nada, y registrarlas llenaba la bitácora de ruido.
El historial de cada ficha
La pestaña Historial reúne lo que se hizo sobre un registro y sobre lo que le pertenece, con el mismo formato de la bitácora. Cada evento abre su detalle sin salir de la ficha.
| Dónde | Qué incluye |
|---|---|
| Cliente → pestaña Historial | El cliente, sus documentos, archivos y notas, sus citas y solicitudes de alquiler, y todo lo de sus ventas y contratos de alquiler |
| Financiamiento → pestaña Historial | La venta, sus cobros y anulaciones, moras, cargos, abonos a capital, plan de pagos, contrato y titulación |
| Contrato de alquiler → pestaña Historial | El contrato, sus rentas, depósito, cargos, moras y cambios de estado |
| Unidad → acción Historial en la tabla de unidades del proyecto | La unidad, las ventas o alquileres que la tomaron, sus solicitudes de alquiler y sus mantenimientos |
El historial arranca el 13 de septiembre de 2026
Los eventos anteriores siguen en Configuración → Auditoría, pero no están vinculados a ninguna ficha: la pestaña Historial sólo muestra lo ocurrido desde esa fecha. Esos eventos viejos tampoco tienen la frase de negocio ni las relaciones por nombre.
Lo que no hace todavía
- No se exporta. La bitácora se consulta en pantalla; no hay descarga.
- No se restaura desde acá. Un registro eliminado se recupera desde su propia pantalla, si ese tipo de registro lo permite.
Práctica. Cambiarle el teléfono a un cliente de prueba, abrir su pestaña Historial y ver el antes y el después. Después, en Configuración → Auditoría, filtrar por la acción Modificó el cliente y encontrar el mismo evento.