🔄 Reconstrucción Integral del Módulo de Interpretación de Presencias

📋 Contexto Se ha reconstruido el módulo de interpretación de presencia del sistema RPS, ya que la lógica anterior no cubría todos los escenarios posibles de horarios y marcas de asistencia. Esta reconstrucción corrige inconsistencias en el cálculo de horas trabajadas, horas extra, tardanzas, ausencias y cruces de jornada, y de paso reorganiza las pantallas del módulo para mejorar la usabilidad. ⚙️ Cambios Implementados Funcionalidades Principales: Redefinición completa de la interpretación de horarios: cubre jornadas diurnas, nocturnas y mixtas; horarios flexibles, fijos y rotativos; y cruces de jornada (entrada un día, salida otro). Tratamiento revisado de casos especiales: horarios con tolerancias, jornadas parciales y horarios con descansos intermedios. Modificación total de la interpretación de marcas: entrada/salida, marcas múltiples, marcas incompletas y marcas duplicadas o fuera de rango. Manejo consistente de casos límite: marcas sin horario asignado, marcas fuera de jornada, y diferenciación entre marcas manuales y automáticas. Reprocesamiento de marcas históricas para garantizar consistencia en la información ya registrada. Reglas de cálculo revisadas para horas normales, horas extra, tardanzas y ausencias, alineadas con legislación laboral, parámetros de empresa y configuración de conceptos de nómina. Reorganización de pantallas del módulo de Presencias: registro de marcas, consulta de asistencias e interpretación/reproceso, con menos pasos operativos. Modificaciones Técnicas: Reescritura de la lógica central de interpretación de horarios: obtención del horario vigente por trabajador, determinación de la jornada efectiva por día, consideración de fechas de vigencia, cruces de día y excepciones por calendario. Rediseño completo del algoritmo de lectura de marcas: ordenamiento cronológico, asociación marca-horario, validación de consistencia, y control de reprocesos mediante flags y bitácoras. Refactorización de procedimientos PL/SQL, funciones de cálculo horario y paquetes de interpretación, separando responsabilidades entre lectura de marcas, interpretación y cálculo. Manejo de errores y trazabilidad mediante logs técnicos. Ajuste de rutas de navegación y permisos en las pantallas reubicadas — sin modificar reglas de negocio desde la interfaz, solo el consumo de la nueva lógica. Sistemas afectados: RPS y Autogestión RPS. 🎯 Impacto en el Sistema Este es un cambio de arquitectura central del módulo de Presencias — afecta procesos de interpretación de horarios y marcas, pantallas de mantenimiento y consulta, y procesos batch/reproceso. Requiere reprocesar información histórica de forma controlada. Módulos beneficiados: Presencias (RPS y Autogestión RPS) Cálculo de Nómina (horas normales, extras, tardanzas, ausencias) Reportes de Asistencia ✅ Beneficios Cobertura real de todos los escenarios: horarios rotativos, cruces de jornada, marcas incompletas y demás casos que antes generaban interpretaciones incorrectas. Cálculos más confiables: horas trabajadas, extras, tardanzas y ausencias con reglas revisadas y alineadas a la legislación vigente. Consistencia histórica: el reprocesamiento de marcas asegura que la información pasada también quede correctamente interpretada. Mejor experiencia operativa: pantallas reorganizadas con menos pasos para registrar, consultar y reprocesar asistencias. Base técnica más sólida: lógica separada por responsabilidades (lectura, interpretación, cálculo) que facilita mantenimiento futuro. 👥 Consideraciones para los Usuarios ✅ Para RRHH / Administradores: Las pantallas de Presencias fueron reubicadas dentro del menú del sistema — familiarízate con la nueva ubicación antes de tu próximo ciclo de nómina. Si detectas diferencias en cálculos de horas frente a períodos anteriores, verifica primero si corresponden a una corrección de un escenario que antes se interpretaba mal. ✅ Para Consultores Técnicos / Soporte: La lógica de interpretación fue completamente reescrita (PL/SQL, funciones y paquetes); cualquier personalización previa sobre el módulo de Presencias debe revisarse contra la nueva estructura. El reproceso de marcas históricas requiere ejecutarse de forma controlada — no es un cambio que se limite a marcas nuevas. ⚠️ Importante Este cambio requiere reprocesar información histórica de forma controlada — no apliques el cambio sin coordinar el reproceso con el equipo técnico. No se modifican reglas de negocio desde la interfaz de usuario; los ajustes de pantalla son de ubicación y flujo, no de lógica. Se recomienda documentación técnica obligatoria para soporte, dado el alcance del cambio en procesos batch y reproceso. 🎯 Mejores Prácticas Ejecuta pruebas de regresión sobre escenarios de horarios rotativos y cruces de jornada antes de dar por cerrada la migración en un cliente específico. Revisa la bitácora de reprocesos si un trabajador reporta una diferencia en su cálculo de horas tras la actualización — la traza técnica debería explicar el ajuste. Aprovecha la reorganización de pantallas para capacitar al equipo de RRHH en el nuevo flujo de registro y consulta de asistencias. ID de la Solicitud: 11124358403