GEOSTARK NÓMINA MASTER v7
Prestaciones sociales con historial salarial real e intereses BCV

ARCHIVOS INCLUIDOS
- nomina_prestaciones.php
- nomina_prestaciones_master_helpers.php
- nomina_tasas_interes_bcv.php
- nomina_reporte_legal_trabajador.php
- SQL_OPCIONAL_V7_PRESTACIONES_TASAS_INTERESES.sql
- SQL_VALIDACION_V7_PRESTACIONES.sql

QUÉ AGREGA
1. Tabla de tasas de interés BCV para prestaciones:
   nomina_tasas_interes_bcv

2. Historial salarial real desde corridas cerradas/pagadas:
   nomina_salario_historial

3. Registro mensual de intereses de prestaciones:
   nomina_prestaciones_intereses

4. Pantalla para cargar tasas BCV:
   nomina_tasas_interes_bcv.php

5. Reporte legal por trabajador:
   nomina_reporte_legal_trabajador.php

6. Prestaciones ahora permite:
   - sincronizar historial salarial desde corridas cerradas;
   - registrar anticipos de prestaciones con soporte;
   - generar intereses mensuales usando tasa BCV;
   - consultar saldo legal estimado por trabajador.

INSTALACIÓN
1. Respaldar base de datos y carpeta actual.
2. Copiar los PHP en la raíz /crud/.
3. Abrir nomina_prestaciones.php para que cree tablas automáticamente.
4. Opcionalmente ejecutar SQL_OPCIONAL_V7_PRESTACIONES_TASAS_INTERESES.sql desde Workbench.
5. Entrar a nomina_tasas_interes_bcv.php y cargar las tasas mensuales BCV.
6. En nomina_prestaciones.php, pulsar “Sincronizar historial salarial desde corridas cerradas”.
7. Seleccionar un trabajador y probar “Generar intereses pendientes”.
8. Revisar nomina_reporte_legal_trabajador.php.

NOTAS IMPORTANTES
- Esta fase no modifica corridas de nómina cerradas.
- No borra eventos anteriores.
- No usa sintaxis incompatible con MariaDB como alias en INSERT/UPDATE.
- Si faltan tasas mensuales BCV, el sistema lo informa y omite esos meses.
- El método por defecto para intereses es PROMEDIO_ACTIVA_PASIVA, pero también quedan disponibles PASIVA y ACTIVA para criterio legal/contable.

PRUEBA RECOMENDADA
1. Cargar una tasa para 2026-05.
2. Seleccionar un trabajador con eventos de prestaciones.
3. Generar intereses hasta 2026-05-31.
4. Confirmar que aparece un registro en nomina_prestaciones_intereses.
5. Abrir el reporte legal del trabajador.
