========================================================================
🚀 V+PUNTOS - MANUAL DE INSTALACION DEL PUENTE
========================================================================

Este programa conecta tu sistema Saint Enterprise con la plataforma 
de lealtad V+Puntos en la nube. Sincroniza las ventas en tiempo real 
para otorgar y reintegrar puntos a tus clientes.

------------------------------------------------------------------------
📂 ARCHIVOS NECESARIOS
------------------------------------------------------------------------
Para que el puente funcione, deben estar en la misma carpeta:

1. bridge.exe (El motor principal del puente)
2. config.ini (Archivo de configuracion tecnica)
3. configurar_inicio.bat (Utilidad para inicio automatico)

------------------------------------------------------------------------
🛠️ CONFIGURACION PASO A PASO
------------------------------------------------------------------------

1. CONFIGURAR LA CONEXION A SAINT:
   Abre el archivo "config.ini" con el Bloc de Notas. Veras una 
   estructura como esta, que debes adaptar a tu servidor:

   [sqlserver]
   server = Nombre de Servidor      ; Nombre del servidor SQL
   database = Nombre                ; Nombre de la base de datos
   trusted_connection = no          ; "yes" para Windows Auth, "no" para usuario SQL (No por defecto)
   uid = sa                         ; Usuario de la base de datos
   pwd = TuPasswordAqui             ; Clave de la base de datos
   encrypt = yes                    ; Encriptacion de conexion (yes por defecto)
   trust_server_certificate = yes   ; Confianza de certificado (yes por defecto)
   connection_timeout = 15          ; Tiempo de espera de conexion (15 por defecto)

   [loyalty]
   reward_rate = 0.05               ; Porcentaje (0.05 = 5% de la compra)

2. EJECUTAR POR PRIMERA VEZ:
   Haz doble clic en "bridge.exe". Veras una ventana negra (consola) 
   que indicara si la conexion fue exitosa y la tasa oficial del dia.

   *** IMPORTANTE ***
   No cierres esta ventana. El puente debe estar abierto para que 
   los puntos se carguen al instante. Si se cierra, no se sumaran puntos.

------------------------------------------------------------------------
🕒 INICIO AUTOMATICO CON WINDOWS
------------------------------------------------------------------------
Para evitar abrir el programa manualmente cada vez que reinicies:

1. Haz clic derecho sobre el archivo "configurar_inicio.bat".
2. Selecciona "Ejecutar como administrador".
3. Veras un mensaje de confirmacion. Esto creara un acceso directo
   en la carpeta de Inicio de Windows.

------------------------------------------------------------------------
💡 LOGICA DE V+PUNTOS
------------------------------------------------------------------------
- COMPRAS: El cliente gana puntos sobre el monto pagado con DINERO REAL.
- DEVOLUCIONES: El sistema le resta los puntos que habia ganado y le 
  DEVUELVE (reintegra) los puntos que el cliente gasto en esa factura.
- TASA BCV: El sistema se actualiza solo a las 9:00 AM cada dia.

------------------------------------------------------------------------
❌ SOLUCION DE PROBLEMAS
------------------------------------------------------------------------
- SQL ERROR: Verifica server, database, usuario y clave en config.ini.
- NO SUMA PUNTOS: Verifica que la cedula este bien escrita en Saint.
- VENTANA SE CIERRA: Revisa tu conexion a internet o el Firewall.

------------------------------------------------------------------------
Desarrollado para la red de comercios V+Puntos.
========================================================================
