GEOSTARK NOMINA - PARCHE MASTER FASE 1
Fecha: 2026-05-14

Objetivo:
Convertir el motor de nomina en una base legal parametrizable para Venezuela, con calculo separado de deducciones del trabajador y aportes patronales, snapshot legal por corrida, reporte patronal y mejora inicial de seguridad de login.

Archivos incluidos:
- nomina_legal_master.php
- nomina_parametros_legales.php
- nomina_aportes_patronales.php
- nomina_calcular_actualizado.php
- nomina_corrida_resumen.php
- nomina_reportes_common.php
- nomina_recibo.php
- nomina_recibos_lote.php
- nomina_calcular.php
- index.php
- login.php
- logout.php
- LEEME_MASTER_NOMINA_20260514.txt

Cambios legales principales:
- RPE trabajador corregido a 0,5%.
- RPE patronal agregado a 2%.
- FAOV trabajador 1% conservado y FAOV patronal 2% agregado.
- IVSS trabajador 4% y patronal por riesgo agregado, con tope parametrizable.
- INCES patronal 2% agregado e INCES trabajador para utilidades creado como concepto legal disponible.
- Ley de Proteccion de Pensiones creada como aporte patronal parametrizable, alicuota inicial 9% y base minima USD parametrizable.
- Parametros legales guardados por vigencia desde/hasta.

Cambios de auditoria y trazabilidad:
- Nueva tabla nomina_parametros_legales.
- Nueva tabla nomina_auditoria.
- Snapshot legal guardado en nomina_corridas.legal_snapshot.
- Bases normal/integral y total patronal guardados en nomina_detalle.

Cambios de reportes:
- Resumen de corrida muestra P-001 a P-005.
- Recibo individual muestra aportes patronales como informativos, sin afectar neto del trabajador.
- Recibos por lote muestran total patronal informativo.
- Nuevo reporte: nomina_aportes_patronales.php.

Seguridad:
- login.php usa prepared statements.
- Passwords existentes en texto plano se aceptan una vez y se migran automaticamente a password_hash.
- session_regenerate_id(true) al iniciar sesion.
- logout.php destruye correctamente la sesion.

Validacion realizada:
- php -l sin errores sobre los archivos modificados/nuevos.
- Revision de referencias antiguas de calculo directo IVSS/RPE/FAOV en archivos activos del motor.

Pendiente fase 2:
- Utilidades completas.
- Liquidacion final completa.
- Flujo real APROBADA/PAGADA/CERRADA con reversos.
- CSRF y permisos granulares.
- Reportes oficiales IVSS/RPE/FAOV/INCES/Pensiones exportables.
