CLICK2CHEF POS 0.3.6 - TPV PARA WINDOWS 10/11 x64 - 2026-10-31
=================================================================

No necesita .NET ni nada mas: todo va incluido.

0. INSTALAR (RECOMENDADO) O USAR LA CARPETA PORTABLE
   a) Instalador: ejecuta Click2Chef-POS-Setup.exe.
      - Se instala para el usuario de Windows, SIN pedir administrador, en
        %LOCALAPPDATA%\Click2Chef.POS, con acceso directo en el Escritorio y en Inicio.
      - Se actualiza solo: busca versiones nuevas al arrancar y cada 6 horas, las descarga
        en segundo plano y NUNCA se reinicia en mitad de una venta, con un cobro abierto ni
        con ventas sin subir. Ajustes > Acerca de: "Actualizar ahora" o "Al cerrar caja".
        Si cierras el TPV con una version descargada y todo subido, se instala al salir.
      - Desinstalar: Configuracion de Windows > Aplicaciones > Click2Chef POS. Las ventas, la
        caja y la clave de la base NO se borran (ver punto 5).
   b) Portable: copia la carpeta Click2Chef-POS-win-x64 al PC (p. ej. C:\Click2Chef-POS) y
      ejecuta Click2Chef.Pos.exe. Esta copia NO se actualiza sola.
   - Pasar de la portable al instalador: cierra la portable, instala con Setup.exe y listo:
     usa los mismos datos (ventas, caja, emparejamiento). No abras las dos a la vez.
   - Aun no esta firmada: Windows mostrara "Windows protegio su PC".
     Pulsa "Mas informacion" -> "Ejecutar de todas formas".
   - Arranca a pantalla completa. Para salir: Alt+F4.

1. VERSION
   La version se ve abajo en la barra lateral (v0.3.6) y en Ajustes > Acerca de.

2. URL DEL SERVIDOR (elige UNA forma)
   a) Desde la app (recomendado): en la pantalla de emparejamiento pulsa "Opciones avanzadas",
      escribe la direccion y pulsa "Guardar direccion". Se aplica al momento, sin reiniciar.
        - Red local: basta con IP y puerto, p. ej.  192.168.1.158:3000
          (sin esquema, una IP, "localhost", un nombre sin dominio o un puerto distinto de 443
          van por http://).
        - Servidor publico:  click2chef.es  (va por https://).
        - Si quieres forzar el esquema, escribelo delante: http://...  o  https://...
   b) Antes del primer arranque (solo portable): edita appsettings.json de la carpeta:
         "ServerBaseUrl": "http://192.168.1.158:3000"
   c) Con la app ya emparejada (la pantalla de emparejamiento ya no sale): edita o borra
         %LOCALAPPDATA%\Click2Chef\POS\server.json
      (este archivo, si existe, manda sobre appsettings.json). Reinicia la app despues.

   Comprobar la red ANTES de emparejar, desde el navegador de este PC:
         http://192.168.1.158:3000/api/health
   Debe responder un texto JSON con "db":{"ok":true...} (en local "redis" puede salir false,
   es normal). Si no carga:
     - el servidor tiene que estar arrancado y escuchando en la red (npx next start -p 3000
       ya escucha en todas las interfaces);
     - abre el puerto 3000 en el cortafuegos del equipo servidor (macOS: Ajustes > Red >
       Cortafuegos; Windows: Firewall de Windows Defender > Reglas de entrada > Puerto TCP 3000);
     - los dos equipos deben estar en la misma red (no en la red de invitados del router).

3. EMPAREJAR
   - En el panel web > Terminales, usa el codigo de 6 digitos del terminal (se gasta al usarlo;
     para repetir, genera uno nuevo en el panel).
   - Para pruebas usa SOLO el restaurante RESTAURANTE LA PRESA (no el restaurante real).

4. IMPRESORA
   - Instala el driver del fabricante y dejala como impresora de Windows.
   - En la app: Ajustes > Impresora > Windows, elige la impresora, papel 80 mm y pulsa
     "Imprimir prueba" (boton naranja arriba a la derecha de la tarjeta).
   - Tambien vale impresora de red (IP, puerto 9100).
   - TIPO DE IMPRESION (que elegir):
       * Texto ESC/POS: el de siempre y el mas rapido. Epson y compatibles.
       * Imagen ESC/POS: si en la prueba salen simbolos raros en lugar de acentos, n o EUR,
         o letras chinas. Sirve tambien con impresoras de red.
       * Controlador de Windows (grafico): si sale "casi nada", una linea o basura. Imprime
         con el controlador instalado: vale para CUALQUIER impresora con driver (Star TSP100,
         clones...). Solo con impresora de Windows (no de red).
   - ASISTENTE: tras "Imprimir prueba" la app pregunta "Se ha impreso bien?". Si contestas
     "No, salen simbolos o casi nada", propone el siguiente tipo (Texto -> Imagen ->
     Controlador de Windows) e imprime otra prueba. La vista previa de la derecha es lo
     que sale en papel con los tipos de imagen.
   - CAJON con "Controlador de Windows": la app manda el pulso aparte; si el cajon no abre,
     activa "Abrir cajon" / "Cash drawer" en las preferencias del controlador (Windows >
     Impresoras > Preferencias de impresion).
   - Opciones avanzadas (solo si lo pide soporte): tabla de caracteres, cancelar modo chino,
     columnas 32/42/48 (algunas de 80 mm solo imprimen 42), lineas antes del corte, pulso del
     cajon y tamano del QR. Abajo se ven los datos del controlador (v3/v4, RAW...).

5. DATOS LOCALES
   %LOCALAPPDATA%\Click2Chef\POS  (pos.db cifrada + pos.key). Estan FUERA de la carpeta de
   instalacion: sobreviven a instalar, actualizar y desinstalar. NO los borres si hay ventas
   pendientes de subir (se ven en la barra superior). Sin pos.key la base no se puede abrir.

6. ACTUALIZACIONES (soporte)
   - Origen por defecto: <servidor>/downloads/pos/ (el mismo servidor del emparejamiento).
   - Para cambiar de origen o de canal en un equipo, crea
         %LOCALAPPDATA%\Click2Chef\POS\updates.json
     con  { "feedUrl": "https://click2chef.es/downloads/pos/", "channel": "win" }
   - Si el servidor exige una version minima y este TPV es anterior, se avisa en rojo y se
     bloquean mesas, pedidos y clientes del servidor; la venta y la subida de ventas siguen.

7. NOVEDADES DE ESTA VERSION
   - Sin barras de desplazamiento: la carta se reparte en la pantalla. Las fichas de productos
     y las tarjetas de categorías se ajustan al espacio (en 1024×768, 1366×768, 1920×1080 y con
     cualquier escala), respetando el tamaño elegido (Compacto, Normal o Grande) y sin bajar del
     tamaño cómodo para el dedo. Si no caben, páginas con botones grandes ‹ › e indicador «1 / 3»;
     la página se recuerda al volver de una búsqueda o de otra pantalla y vuelve a la 1 al elegir
     otra categoría. Con la rueda del ratón también se pasa de página.
   - Las filas de categorías que no caben muestran flechas ‹ › en lugar de barra de desplazamiento.
     El teclado del buscador ya no tapa fichas: la carta se reparte en el espacio que deja.
   - Mesas: con muchas mesas (o mesas sin colocar en el panel) se ven en una rejilla que se ajusta a
     la pantalla, con páginas si hace falta; botón para elegir plano o rejilla (se recuerda en el
     puesto). El panel de la mesa deja siempre a la vista las acciones y «Cobrar».
   - Pedidos: tarjetas del mismo alto y las que caben en cada columna; el resto con ‹ 1 / 2 › en la
     cabecera de la columna. La columna de pedidos junto al ticket, igual.
   - Caja: el arqueo cabe entero; las cuentas sin cobrar tienen su pestaña. El resumen del turno se ve
     sin desplazar la pantalla (solo las listas largas se desplazan dentro de su tarjeta).
   - Ajustes por apartados: Impresora, Pantalla, Carta en la venta, Equipo y Acerca de. El aviso
     «Actualización lista» abre directamente Acerca de.
   - Selector de mesa y opciones de producto: usan el alto de la pantalla (más mesas y opciones sin
     desplazar).
