ALIANPOS V9.5.0 - REPORTES PANEL CENTRAL
========================================

ACTUALIZACIÓN RECOMENDADA
-------------------------
1. Realice respaldo de archivos y base de datos.
2. Descomprima ALIANPOS_V9_5_REPORTES_CENTRAL_OVERLAY_20260913.zip en la raíz de la instalación, conservando la estructura de carpetas.
3. Ejecute database/migrations/039_reportes_central.sql en la base de datos ALIANPOS.
4. Verifique que storage/logs sea escribible por PHP.
5. Verifique el correo del servidor: MAIL_DRIVER=mail y MAIL_FROM_ADDRESS con una dirección válida si se utilizará envío al contador.
6. Ingrese nuevamente al Panel Central y abra /central/reportes.

ENVÍO AUTOMÁTICO
----------------
El módulo incluye:

bin/reportes-contables.php

Configure un Cron Job para ejecutar el script cada 5 o 10 minutos. Ejemplo genérico:

*/5 * * * * /usr/local/bin/php /RUTA/ABSOLUTA/alianpos/bin/reportes-contables.php >/dev/null 2>&1

En cPanel utilice la ruta PHP CLI que muestre su servidor y la ruta absoluta real de la instalación.
El script respeta la hora/frecuencia definida en Reportes y evita repetir un período automático ya enviado correctamente.

PRUEBAS DESPUÉS DE INSTALAR
----------------------------
1. Abra /central/reportes.
2. Cambie entre Ventas, Cuentas por cobrar, Caja, Inventario, Gerenciales y Contables.
3. Filtre por una sucursal y por un rango de fechas conocido.
4. Exporte un reporte normal en PDF y Excel.
5. Exporte Paquete para contador en PDF y Excel.
6. Configure un correo del contador y realice un envío manual.
7. Si activa el envío automático, ejecute manualmente una vez el comando PHP del cron para confirmar que PHP CLI y el correo están disponibles.

MIGRACIÓN
---------
039_reportes_central.sql crea las tablas de configuración/historial, permisos del módulo e índices de consulta.

NO REEMPLAZAR
-------------
No elimine .env ni storage/uploads. El Overlay contiene únicamente archivos nuevos o modificados por esta versión.

VERSIÓN
-------
9.5.0
