# T Market POS Server

Servidor local para usar T Market POS en una o varias computadoras dentro de la misma red.

## Cambio v5.8.20 - impresion directa

- Impresion termica RAW directa a la cola de Windows mediante Cliente T Market.
- Seleccion de impresora independiente por cada PC y opcion de una o dos copias.
- Respaldo automatico con el cuadro de impresion del navegador si el puente o la impresora no estan disponibles.

## Instalar o actualizar servidor

En la computadora principal ejecuta:

`INSTALAR-O-ACTUALIZAR-SERVIDOR-SEGURO.bat`

El instalador actualiza el sistema sin borrar la base de datos existente. La base queda normalmente en:

`C:\TMarketPOS\data\tmarket.sqlite`

Antes de cambios importantes, genera o conserva un respaldo desde Administracion > Base de datos.

## Abrir el programa

Despues de instalar, abre el acceso directo:

`T Market POS`

Tambien puedes entrar desde el navegador en la computadora servidor:

`http://localhost:3030`

Para otras computadoras o la app Android, usa la URL que aparece en:

Administracion > Conectar

## Primer inicio

El usuario inicial es:

`Administrador`

Por seguridad, el sistema ya no permite trabajar con el PIN inicial `0000`. En el primer inicio pedira crear un PIN nuevo de administrador.

## Datos centralizados

El servidor centraliza:

- Productos e inventario.
- Ventas y descuento de stock.
- Movimientos de caja.
- Ajustes de inventario.
- Pedidos y recepciones de compra.
- Departamentos y proveedores.
- Cajeros, permisos y tareas.
- Configuracion administrativa.
- Cortes y reportes.

## Respaldos y mudanza de servidor

Para mover el sistema a otra PC:

1. En la PC actual genera respaldo desde Administracion > Base de datos.
2. Instala el servidor en la nueva PC.
3. En la nueva PC restaura el archivo de respaldo desde Administracion > Base de datos.
4. En los clientes o Android actualiza la URL/IP del servidor.

## Seguridad

- Los PIN se guardan cifrados.
- Tras varios intentos incorrectos, el usuario se bloquea temporalmente.
- Las licencias nuevas se validan por firma publica.
- Una licencia vencida bloquea nuevas ventas, pero permite entrar a administracion y generar respaldos.

## Notas

- La computadora servidor debe permanecer encendida mientras las cajas trabajen.
- Si Windows bloquea el acceso desde otra computadora, permite Node.js en el Firewall para redes privadas.
- No abras copias sueltas del HTML desde OneDrive si quieres datos compartidos; usa siempre la URL del servidor.

CAMBIO v5.8.19.32 - ARQUEO EN ENTRADAS Y SALIDAS DE CAJA

- Agrega opciones separadas para pedir arqueo al registrar entradas de efectivo y salidas/gastos.
- Cuando el arqueo esta activo, el modal de movimiento muestra conteo por billetes MXN, monedas MXN y dolares USD.
- El monto del movimiento se toma automaticamente del total arqueado.
- El ticket de entrada/salida muestra referencia de arqueo cuando aplica.

CAMBIO v5.8.19.31 - TICKETS DE ENTRADA, SALIDA Y RETIRO INTERNO

- Agrega opciones en Administracion > Configuracion > Manejo de caja para activar/desactivar tickets de entrada, salida/gasto y retiro interno.
- Cada ticket puede incluir firma de cajero y firma de recibio.
- Permite imprimir solo original u original y copia.
- La reimpresion manual queda disponible desde historial de movimientos y lista de retiros internos.

CAMBIO v5.8.19.30 - VERSION UNIFICADA Y PRUEBAS DE EVIDENCIAS

- Alinea servidor, instalador de cliente Windows y APK Android a la version 5.8.19.30.
- Mantiene el ajuste de corte de caja para ventas en efectivo netas.
- Confirma el plan de evidencias de tareas: imagenes fuera de SQLite, miniaturas, detalle bajo demanda y respaldo/restauracion de task-media.

CAMBIO v5.8.19.5 - VENTAS EN EFECTIVO NETAS EN CORTE

- En Manejo de caja, "Ventas efectivo MXN" muestra únicamente el efectivo aplicado al valor de las ventas.
- El efectivo bruto entregado por el cliente se conserva para auditoría, pero ya no se presenta como venta efectiva.
- El cambio entregado se descuenta antes de separar efectivo MXN y dólares aplicados a las ventas.
- Los cortes nuevos guardan ambos importes para que el historial conserve el cálculo exacto.

CAMBIO v5.8.19.4 - EVIDENCIAS DE TAREAS OPTIMIZADAS

- Las fotos de tareas se guardan fuera de SQLite en data/task-media.
- El navegador genera automáticamente una evidencia optimizada y una miniatura.
- Las listas de tareas ya no transportan imágenes completas; el detalle las carga bajo demanda.
- Se agregaron niveles por antigüedad: 0 a 15, 16 a 30, 31 a 180 y más de 180 días.
- La conservación y el manejo de originales se configuran desde Administración.
- Los respaldos manuales y diarios incluyen una carpeta asociada de task-media.
- La migración de evidencias antiguas verifica la escritura antes de retirar el contenido de SQLite.

CAMBIO v5.8.16.11 - DESBLOQUEO DE REVISION DE COMPRAS

- Agrega ruta administrativa para desbloquear una nota de compra revisada accidentalmente.
- En el detalle de nota recibida aparece "Desbloquear revisión" para administradores.
- El desbloqueo no mueve inventario; solo permite editar/revisar nuevamente y deja auditoría.

CAMBIO v5.8.16.10 - FILTRO DE PERIODO EN PEDIDOS

- Corrige el filtro Hoy/Ayer/periodo en pedidos para usar la fecha principal del pedido.
- Las recepciones o revisiones posteriores ya no hacen aparecer pedidos viejos en el filtro Hoy.
- Los borradores activos/pausados tambien respetan el filtro de periodo.

CAMBIO v5.8.16.9 - DESGLOSE DINERO EN CAJA

- Reordena la columna Dinero en caja para mostrar la formula operativa: ventas en efectivo/dolares + entradas - gastos - retiros internos.
- El mismo desglose aparece en el detalle de cortes guardados.

CAMBIO v5.8.16.8 - PREVIEW DE CORTE POR SERVIDOR

- Agrega `/api/cuts/preview` para calcular el corte final con datos completos de SQLite antes de guardar.
- La ventana de corte final muestra el resumen autoritativo del servidor y mantiene cálculo local solo como respaldo temporal.
- La comparación de terminales usa ventas por tarjeta, dejando transferencias separadas.

CAMBIO v5.8.16.7 - ESTADO MODULAR DIRECTO

- Agrega endpoints de estado por modulo: `/api/state/pos`, `/api/state/inventory`, `/api/state/customers`, `/api/state/purchases`, `/api/state/audit` y `/api/state/reports`.
- Mantiene `/api/state` para compatibilidad con clientes existentes.
- La sincronizacion automatica del navegador usa el modulo activo para reducir cargas grandes.
- Los endpoints modulares consultan directo sus datos, sin armar el estado completo del sistema.

CAMBIO v5.8.13.3 - SOPORTE Y MANUAL
- Se agrega MANUAL-RAPIDO-CLIENTE.md en el paquete.
- Se agrega public/manual-rapido-cliente.html para abrir/imprimir desde el sistema.
- En Administracion > Base de datos y respaldos > Diagnostico rapido se agrega paquete de soporte exportable y resumen de rendimiento.

CAMBIO v5.8.19.39 - AUDITORIA IA COMPACTA Y ORDENABLE

- Deja únicamente los indicadores Eventos sensibles, Alta, Crítica, Media y Pendientes.
- Elimina los indicadores y el cálculo de importes vigilados y excluidos.
- Permite ordenar la lista al pulsar cada cabecera, en sentido ascendente o descendente.

CAMBIO v5.8.19.40 - PANTALLA CLIENTE MANUAL Y CARRUSEL ESTABLE

- La pantalla cliente ya no se abre automáticamente al hacer clic en otras funciones.
- El botón inferior solo aparece cuando la función está activada en Configuración.
- Recuerda la carpeta de publicidad seleccionada y recupera sus archivos sin volver a elegirlos en cada sesión.
- Quita la etiqueta superior y evita que el carrusel quede detenido en una imagen o video.

CAMBIO v5.8.19.41 - VENTAS RAPIDAS Y AUDITORIA NOCTURNA

- Abre automáticamente la pantalla cliente una sola vez por arranque del servidor, después del primer inicio de sesión.
- Las sesiones posteriores conservan únicamente el botón manual inferior.
- La venta devuelve solo el comprobante y las existencias modificadas, sin reconstruir todo el estado del negocio.
- La revisión de productos sin movimiento se ejecuta en la hora nocturna con menor tráfico promedio de los últimos 30 días y espera tiempo inactivo del navegador.

CAMBIO v5.8.19.42 - FOTOS BAJO DEMANDA Y SINCRONIZACION EN REPOSO

- Las fotos de productos dejan de viajar incrustadas en cada estado y se cargan individualmente cuando son visibles.
- La sincronización automática espera 30 segundos reales sin clics ni teclado y reduce su frecuencia a dos minutos.
- Las respuestas parciales ya no reescriben repetidamente la caché offline.
- Conserva las imágenes originales en SQLite al editar productos que usan la nueva URL ligera.

CAMBIO v5.8.19.43 - ADMINISTRACION MODULAR

- Administración deja de descargar el estado completo de ventas, compras y movimientos al abrir.
- Carga un máximo de 120 reportes recientes y consulta el resto mediante filtros.
- Solo renderiza la pestaña visible: cortes, gráficas, sesiones, ventas, inventario o auditoría.
- Configuración, tareas, utilidades, respaldos y conexiones se preparan únicamente al abrir su módulo.





