GEOSTARK NOMINA - Parche v7.1
Consolidación de prestaciones sociales, historial salarial e intereses BCV

OBJETIVO
- Continuar la Fase 3 sobre prestaciones sociales.
- Dejar más auditable el control de capital, salario histórico, intereses y anticipos.
- Permitir operaciones por lote sin alterar corridas de nómina cerradas.

ARCHIVOS INCLUIDOS
- nomina_prestaciones.php
- nomina_prestaciones_master_helpers.php
- nomina_tasas_interes_bcv.php
- nomina_reporte_legal_trabajador.php
- nomina_prestaciones_auditoria.php
- SQL_OPCIONAL_V7_1_CONSOLIDAR_PRESTACIONES.sql
- SQL_VALIDACION_V7_1_PRESTACIONES.sql
- LEEME_V7_1_CONSOLIDACION_PRESTACIONES_20260516.txt

MEJORAS PRINCIPALES
1. Nueva pantalla: nomina_prestaciones_auditoria.php
   - Resume trabajadores con base pendiente.
   - Resume tasas BCV cargadas.
   - Muestra faltantes de tasas por mes.
   - Muestra eventos recientes.

2. nomina_prestaciones.php reforzado
   - Panel de estado Fase 3 v7.1.
   - Generación base pendiente para todos los trabajadores.
   - Generación de intereses pendientes para todos los trabajadores.
   - Acceso visible a Tasas BCV, Reporte Legal y Auditoría.

3. nomina_prestaciones_master_helpers.php reforzado
   - Registro de eventos base con snapshot salarial.
   - Registro de origen del evento.
   - Registro de usuario creador.
   - Funciones por lote para base e intereses.
   - Detección de meses sin tasas BCV.

4. Auditoría de eventos
   Cada evento nuevo puede guardar:
   - tasa BCV usada,
   - moneda del salario,
   - salario original,
   - fuente salarial,
   - snapshot_json,
   - origen_registro,
   - soporte_referencia,
   - created_by.

INSTALACIÓN
1. Hacer backup completo de base de datos y archivos.
2. Copiar los PHP del parche en la raíz /crud/.
3. Ejecutar SQL_OPCIONAL_V7_1_CONSOLIDAR_PRESTACIONES.sql si deseas crear/verificar tablas desde Workbench.
   - Si no lo ejecutas, los PHP también intentan crear/agregar estructura automáticamente.
4. Ejecutar SQL_VALIDACION_V7_1_PRESTACIONES.sql para revisar conteos.
5. Entrar a nomina_prestaciones.php.
6. Cargar tasas en nomina_tasas_interes_bcv.php.
7. Sincronizar historial salarial desde corridas cerradas.
8. Generar base/intereses en prueba.
9. Revisar nomina_prestaciones_auditoria.php y nomina_reporte_legal_trabajador.php.

NOTAS
- No se modifican corridas cerradas.
- No se recalcula nómina.
- No se borra histórico.
- No usa AS nuevo ni ON DUPLICATE KEY UPDATE.
- Compatible con MariaDB/MySQL.

PRUEBA RECOMENDADA
1. Base limpia o respaldo de prueba.
2. Ejecutar SQL V7.1 opcional.
3. Cerrar una corrida de nómina.
4. Sincronizar historial salarial.
5. Generar base de prestaciones para un trabajador.
6. Cargar tasa BCV del mes.
7. Generar intereses.
8. Ver reporte legal.
