======================================================================
 MONITOR DE VENTAS - Soft Restaurant 8
======================================================================

Este ZIP va PLANO: los archivos cuelgan de la raíz, sin una carpeta
delante.

  * Instalación NUEVA
        Descomprime en una carpeta dentro de C:\xampp\htdocs
        (por ejemplo "srmonitor"). Esa carpeta es el nombre de tu sitio.

  * ACTUALIZAR lo que ya tienes
        Descomprime ENCIMA de la carpeta del sitio. No se pisa tu
        configuracion.php ni tu ajustes.php: no vienen en el ZIP.

----------------------------------------------------------------------
 INSTALACIÓN (3 pasos)
----------------------------------------------------------------------
  1. Renombra el archivo (solo la primera vez)
         configuracion.example.php   ->   configuracion.php

  2. Arranca Apache desde el panel de XAMPP.

  3. Abre en el navegador:
         http://localhost/srmonitor/
     (si tu XAMPP usa otro puerto:  http://localhost:8888/srmonitor/)

     Se abrirá solo el panel de configuración. Escribe la carpeta donde
     están los archivos de Soft Restaurant, por ejemplo:

         C:\nationalsoft\SoftRestaurant8.0.0\DATOSSR
         \\PC-POS\DATOSSR          (si el POS es otra computadora)

     Pulsa Probar: debe encontrar las 9 tablas. Luego Guardar.

  Listo. El tablero queda funcionando y se refresca solo cada 15 s.

----------------------------------------------------------------------
 QUÉ HAY EN CADA CARPETA
----------------------------------------------------------------------
  index.php, api\, src\   El sitio web. Es lo único que se ve por HTTP.
  configuracion.php        Tus datos: carpeta, hora de apertura, MySQL.
  bin\                     Comandos de consola (ETL, esquema, diagnóstico).
  tools\                   Los mismos, para ejecutar con doble clic.
  sql\montar-base.sql      Script para crear la base de datos (opcional).

  Las carpetas bin, src, sql y tools NO se sirven por HTTP: cada una
  trae su .htaccess que bloquea el acceso, y los comandos además se
  niegan a ejecutarse si no vienen de la consola.

----------------------------------------------------------------------
 HERRAMIENTAS (doble clic, en tools\)
----------------------------------------------------------------------
  diagnostico.cmd           Revisa que se puedan leer los archivos del
                            punto de venta y muestra las ventas del día.
                            Úsalo primero si algo no cuadra.
  espejo.cmd                Copia los .dbf desde otra PC a esta. Solo si
                            el POS está en otra computadora y prefieres
                            trabajar con una copia local.

  Estas solo hacen falta si usas base de datos (ORIGEN = 'mysql'):
  sincronizar.cmd           Sube al MySQL los últimos días.
  sincronizar-completa.cmd  Sube todo el histórico (la primera vez).
  etl-watch.cmd             Sube cada minuto MIENTRAS la ventana siga
                            abierta. Se detiene cerrando la ventana o con
                            Ctrl+C. NO sobrevive a un reinicio.
  programar-sincronizacion.cmd
                            Registra una tarea de Windows que sube cada
                            minuto sin ventanas y SÍ vuelve tras reiniciar.
                            Para quitarla:  /quitar

----------------------------------------------------------------------
 CON BASE DE DATOS (opcional, para ver el tablero fuera del negocio)
----------------------------------------------------------------------
  1. Ejecuta  sql\montar-base.sql  en tu MySQL (local o en la nube).
     Viene en 6 pasos numerados y explicados.
  2. En configuracion.php pon  'ORIGEN' => 'mysql'  y los datos de
     conexión.
  3. Primera carga:  tools\sincronizar-completa.cmd
  4. Después:        tools\sincronizar.cmd  (o el botón del tablero)

----------------------------------------------------------------------
 QUÉ CUENTA COMO VENTA
----------------------------------------------------------------------
* Venta = cuenta CERRADA Y COBRADA. Las cuentas abiertas se muestran
  aparte y no suman al total del día.
* El día es la JORNADA DE NEGOCIO, no el del calendario: con apertura a
  las 7:00, lo que se cobre de madrugada cuenta para la jornada
  anterior. Se cambia desde el mismo panel del sitio.

----------------------------------------------------------------------
 SI EL SITIO NO CORRE EN LA PC DEL PUNTO DE VENTA
----------------------------------------------------------------------
Borra del servidor web las carpetas  bin\, sql\ y tools\  y deja solo
el sitio; copia esta misma carpeta completa en la PC del punto de venta
para usar ahí las herramientas. El sitio funciona igual: si le pides
sincronizar sin tener el ETL, te lo dice en pantalla.

----------------------------------------------------------------------
 SI ALGO FALLA
----------------------------------------------------------------------
* "No se encuentra ...cheques.dbf"  -> ruta equivocada o carpeta de red
  inaccesible. Corrígela con el ícono del título.
* Página en blanco o error 500      -> falta renombrar
  configuracion.example.php a configuracion.php, o Apache no tiene PHP 8.
* El tablero no muestra las ventas de hoy -> revisa la hora de apertura
  en el panel, y prueba el día anterior con el selector de fecha.
* Nada cuadra con Soft Restaurant   -> ejecuta tools\diagnostico.cmd y
  compara esos números con el Monitor de Ventas del punto de venta.

======================================================================