========================================================
  CONFIGURACION IMPRESORA TERMICA XP-80C - LOTUYO APP
  (Linux Mint / Ubuntu / Debian)
========================================================

CONTENIDO DEL PAQUETE
----------------------
- index.js          : Servidor local de impresion LoTuyo
- instalar.sh       : Instalador automatico
- desinstalar.sh    : Desinstalador
- INSTRUCCIONES.txt : Este archivo

NOTA: En Linux NO se necesita instalar un driver externo.
La impresora XP-80C funciona nativamente con CUPS.

--------------------------------------------------------
PASO 1: CONEXION FISICA
--------------------------------------------------------
1. Apaga la impresora.

2. Conecta el cable USB a un PUERTO TRASERO de la PC
   (si es PC de escritorio). Los puertos traseros van
   directo a la placa base y dan voltaje mas estable,
   evitando desconexiones aleatorias al imprimir.
   En laptops cualquier puerto funciona igual.

3. Conecta el cable de alimentacion.

4. Enciende la impresora.

5. Verifica que el papel termico de 80mm este bien insertado.

Linux Mint detecta la impresora automaticamente via USB.

--------------------------------------------------------
PASO 2: INSTALAR NODE.JS (solo si no lo tienes)
--------------------------------------------------------
Abre una terminal (Ctrl+Alt+T) y ejecuta:

  node --version

Si el comando no existe o la version es menor a v18:

  sudo apt update
  sudo apt install -y nodejs npm

Si la version sigue siendo antigua (< v18):

  curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
  sudo apt install -y nodejs

--------------------------------------------------------
PASO 3: INSTALAR EL SERVIDOR DE IMPRESION (UNA SOLA VEZ)
--------------------------------------------------------
1. Abre una terminal en la carpeta donde extrajiste el ZIP.
   (Clic derecho en la carpeta > "Abrir terminal aqui")

2. Ejecuta con permisos de administrador:

   sudo bash instalar.sh

   El script hara automaticamente:
   - Instalar CUPS si no lo tienes
   - Agregar permisos de impresora a tu usuario (grupo lp)
   - Detectar la URI USB y registrar la cola XP-80C en Raw
   - Instalar y activar el servidor como servicio del sistema

3. Cuando termine, cierra sesion y vuelve a entrar
   (o reinicia la PC) para que los permisos surtan efecto.

IMPORTANTE: Solo necesitas hacer esto UNA SOLA VEZ.
Desde ese momento el servidor se inicia automaticamente
cada vez que enciendas la PC.

--------------------------------------------------------
PASO 4: VERIFICAR QUE FUNCIONA
--------------------------------------------------------
Con el servidor instalado, entra a la app LoTuyo.
Ve a Ventas > abre el detalle de cualquier venta.
Presiona el boton "Imprimir". El ticket deberia salir
impreso en papel automaticamente (2 copias).

Para verificar que el servicio esta activo:
  systemctl status lotuyo-print

Para ver los logs del servidor en tiempo real:
  journalctl -u lotuyo-print -f

--------------------------------------------------------
SOLUCION DE PROBLEMAS
--------------------------------------------------------

"No se pudo conectar con el servidor de impresion"
  -> El servicio no esta corriendo.
     Revisa:   systemctl status lotuyo-print
     Reinicia: sudo systemctl restart lotuyo-print

"Error al enviar a impresora"
  -> La cola CUPS no esta configurada o la impresora
     no esta conectada/encendida.
     Verifica: lpstat -p XP-80C
     Si no aparece, detecta la URI y crea la cola:
       lpinfo -v | grep usb
       sudo lpadmin -p XP-80C -E -v <URI_que_aparece> -m raw

"Impresora imprime pero sale texto extrano o ilegible"
  -> La cola tiene un driver incorrecto (ej. HP, Epson).
     Linux a veces asigna automaticamente el driver de
     otra impresora que haya tenido la PC antes.
     Solucion: forzar modo Raw sobre la cola existente:
       sudo lpadmin -p XP-80C -m raw
     Luego prueba imprimir de nuevo desde la app.

"El ticket sale bien pero el texto se corta en los bordes"
  -> El ancho configurado es de 48 caracteres para papel
     de 80mm. Si el texto sigue cortandose, verifica que
     la cola este en modo Raw (ver error anterior).

--------------------------------------------------------
DESINSTALAR (si es necesario)
--------------------------------------------------------
  sudo bash desinstalar.sh

--------------------------------------------------------
DATOS TECNICOS
--------------------------------------------------------
- El servidor corre en: http://127.0.0.1:3001
- Imprime 2 copias por ticket (cliente + negocio)
- Ancho del ticket: 48 caracteres (papel 80mm)
- La cola CUPS debe estar en modo Raw (sin filtros)
- Solo funciona en la PC donde esta instalado
- Papel recomendado: termico 80mm x 80mm (rollo)
- Para soporte tecnico contactar al equipo de LoTuyo

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