GEOSTARK NOMINA - PARCHE V8.2 VACACIONES CALENDARIO
====================================================

Objetivo
--------
Mejora quirúrgica sobre Vacaciones v8.1. No toca la lógica ya validada de cálculo de días, salario histórico, tasa BCV, montos, auditoría ni bloqueo por fecha de ingreso.

Cambio principal
----------------
En la ventana "Registrar / controlar vacaciones", al seleccionar un trabajador y colocar la "Fecha inicio disfrute", el sistema ahora puede sugerir/llenar automáticamente la "Fecha fin disfrute" usando:

- días de disfrute a registrar;
- calendario laboral precargado en nomina_calendario_laboral;
- domingos como feriado laboral LOTTT;
- descansos del turno del trabajador;
- feriados laborales activos/aplicables a nómina.

La fecha sugerida es editable por RRHH.

Archivos incluidos
------------------
- nomina_vacaciones.php
- nomina_vacaciones_master_helpers.php
- nomina_vacaciones_auditoria.php
- SQL_VALIDACION_V8_2_VACACIONES_CALENDARIO.sql
- LEEME_V8_2_VACACIONES_CALENDARIO_20260517.txt

Instalación
-----------
Copiar los PHP en /crud/ reemplazando los actuales.
No requiere cambios de estructura SQL.

Prueba recomendada
------------------
1. Entrar a nomina_vacaciones.php.
2. Seleccionar un trabajador válido.
3. Colocar Fecha inicio disfrute.
4. Confirmar que Fecha fin disfrute se calcula automáticamente.
5. Cambiar días disfrute y confirmar que la fecha se recalcula.
6. Desmarcar "Calcular fecha fin automáticamente..." y ajustar manualmente si RRHH lo requiere.
7. Registrar un evento pequeño y ejecutar SQL_VALIDACION_V8_2_VACACIONES_CALENDARIO.sql.

Notas de auditoría
------------------
La sugerencia excluye días no hábiles de disfrute y muestra un resumen visible de días contados y excluidos. Esto ayuda a justificar por qué la fecha fin puede extenderse más allá de la cantidad nominal de días.
