PARCHE MASTER NÓMINA GEOSTARK - 14/05/2026

Objetivo:
Llevar el motor de nómina a una base legal/parafiscal más robusta sin destruir lo que ya estaba funcionando.

Archivos principales modificados/agregados:
- nomina_legal_master.php              Nuevo motor de parámetros legales, topes, aportes patronales y auditoría.
- nomina_parametros_legales.php        Nueva pantalla para revisar/editar alícuotas, topes y vigencias.
- nomina_calcular_actualizado.php      Cálculo actualizado con IVSS, RPE, FAOV, INCES y Pensiones parametrizados.
- nomina_corrida_resumen.php           Resumen ahora muestra aportes patronales P-001 a P-005.
- nomina_aportes_patronales.php        Nuevo reporte especializado de parafiscales patronales.
- nomina_recibo.php                    Recibo muestra aportes patronales como información, sin descontarlos al trabajador.
- nomina_recibos_lote.php              Impresión masiva muestra total patronal informativo.
- nomina_reportes_common.php           Soporte para movimientos PATR y columnas maestras.
- index.php                            Menú con parámetros legales y aportes patronales.
- login.php                            Login con prepared statement y migración automática a password_hash.
- logout.php                           Cierre de sesión reforzado.
- nomina_calcular.php                  Redirige al cálculo actualizado para evitar usar el motor viejo.

Qué crea automáticamente al abrir cálculo/parámetros/reportes:
- Tabla nomina_parametros_legales.
- Tabla nomina_auditoria.
- Columnas nuevas en nomina_corridas: legal_snapshot, aprobada_at, pagada_at, cerrada_at, cerrada_por.
- Columnas nuevas en nomina_detalle: base_salario_normal, base_salario_integral, total_patronal.
- Conceptos legales PATR: P-001 IVSS, P-002 RPE, P-003 FAOV, P-004 INCES, P-005 Pensiones.
- Corrige el concepto B-002 de RPE trabajador a 0,5%.

Recomendación de prueba:
1) Hacer respaldo de carpeta y base de datos.
2) Copiar archivos del parche sobre la carpeta crud.
3) Entrar primero en nomina_parametros_legales.php para que se creen tablas/columnas/conceptos.
4) Revisar salario mínimo, riesgo IVSS y base mínima de pensiones.
5) Calcular una corrida de prueba en un período abierto.
6) Revisar nomina_corrida_resumen.php y nomina_aportes_patronales.php.
7) Verificar recibos individuales y lote.

Notas importantes:
- Los aportes patronales tipo PATR no reducen el neto del trabajador.
- Las tasas legales quedan congeladas en legal_snapshot de nomina_corridas al calcular la corrida.
- La Ley de Protección de Pensiones queda parametrizada para poder cambiar alícuota/base por vigencia.
- Este parche no implementa todavía el módulo completo de utilidades/liquidación final; deja la base lista para esa siguiente fase.
