📘 Manual del Usuario — SISTOCK IA

Sistema de gestión de stock y ventas con IA · PC + Celulares + Nube · Edición Julio 2026

🖥 PC pantalla completa 16:9 📱 Celulares 9:16 por la web ☁️ Base espejo en la nube 🤖 IA local + IA Internet

1. Qué es SISTOCK_IA y cómo está integrado

SISTOCK_IA es tu sistema de gestión de stock y ventas que funciona en tres lugares a la vez, siempre con los mismos datos:

En tu PC del negocio: el sistema completo, 100% local, con su propia base de datos y su propia Inteligencia Artificial (no necesita internet para trabajar).
En la nube (tu hosting): una copia espejo de la base de datos y el mismo sistema completo, en https://tumejoria.com/sistock/.
En los celulares: entran por la web de la nube y ven el sistema en formato vertical de celular, sin instalar nada y sin configurar redes ni firewall.

Figura 1 — Arquitectura general: PC, nube y celulares trabajando sobre los mismos datos.

Las reglas de oro de la integración

Si no hay internet, tu PC sigue trabajando normal. Los cambios se acumulan y al volver la conexión se ponen al día solos.
Los números (IDs) nunca chocan: lo que se crea en la PC recibe números terminados en 1 (1, 11, 21...) y lo que se crea en la nube, terminados en 2 (2, 12, 22...).
Conflictos: si la misma ficha se modificó en los dos lados, vale la última modificación.
En PC se ve en pantalla completa 16:9; en celulares en formato vertical 9:16 — automáticamente, sin configurar nada.

2. Inicio rápido en la PC

Doble click en INICIAR_SISTEMA.bat (en la carpeta del sistema). Arranca en orden: la base de datos, la IA local (se carga en tu placa de video), el servidor web y el servicio de sincronización con la nube.

Se abre solo el navegador en http://127.0.0.1:8080/login.html. Entrá con tu usuario principal o de empleado.

Para apagar todo: doble click en DETENER_SISTEMA.bat. Cierra IA, base de datos, servidor web y servicio de sincronización de forma ordenada.

💡 La IA puede tardar un minuto en cargar la primera vez. Si el asistente no contesta apenas iniciás, esperá un momento y volvé a intentar.

3. Uso diario en la PC

El menú principal muestra solo los botones que tu rol tiene permitidos. Los módulos principales:

Módulo	Para qué sirve
Venta Rápida / Venta Market / Venta por Cliente	Registrar ventas con lector de códigos, formas de pago, listas de precios y clientes.
Buscar Productos / Ingresar Producto	Consultar stock y precios; dar de alta productos, códigos de barra e imágenes.
Gestión de Precios	Actualizar precios individuales o por porcentaje, listados y precios especiales.
Clientes / Cuentas Corrientes	Fichas de clientes, deudas y pagos.
Gestión de Ventas Online	Clientes de la tienda web y sus pedidos (ver sección 7).
Reporte General / Listado de Ventas	Números del negocio: ventas, gastos, estadísticas.
Gestión Empleados / Horarios / Reconocimiento	Personal, permisos por rol, horarios y control de ingreso.
Configuración / Configuración Nube ☁️	Tablas, temas visuales, sonidos, y toda la parte de nube y sincronización.

ℹ️ En la PC las pantallas aprovechan el ancho completo del monitor (16:9): las grillas de botones suman columnas y los formularios se acomodan al espacio.

4. Uso desde celulares (versión web)

Los celulares siempre entran por la web — sin instalar aplicaciones, sin configurar la red del negocio, sin firewall:

📱 https://tumejoria.com/sistock/
Guardala en la pantalla de inicio del celular como acceso directo

Se entra con los mismos usuarios y contraseñas de la PC (se sincronizan solos).
Es el mismo sistema completo, con la misma estética — solo que en formato vertical 9:16 táctil.
Funciona desde cualquier lugar: el wifi del negocio, datos móviles, otra ciudad.
Lo que se hace en el celular (ventas, cambios, mensajes) viaja solo a la PC en segundos, y viceversa.
Funciona aunque la PC del negocio esté apagada: los datos quedan en la nube y se sincronizan cuando la PC vuelva a encenderse.

⚠️ Las funciones que dependen del hardware de la PC (lector de huellas, cámara del reconocimiento local, impresoras conectadas a la PC) actúan según el dispositivo desde el que entres. Las fotos de productos hoy viven en la PC (la sincronización de imágenes es una mejora futura).

5. La nube y la sincronización

Figura 2 — El ciclo de sincronización: empujar y traer, en lotes chicos, sin frenar el trabajo.

Los dos modos de operación

Modo	Cuándo usarlo	Qué hace
🔄 Sincronizada con la PC (normal)	El negocio tiene PC con el sistema.	La nube es espejo de la PC. Todo viaja en ambos sentidos. El asistente de los celulares lo responde la IA de tu PC.
☁️ Solo nube	Sucursal sin PC (solo celulares), o mientras instalás la PC.	La web trabaja independiente contra la base online. El asistente responde la IA de Internet. La PC pausa su sincronización.

El modo se elige en Configuración Nube → Modo de la nube y se aplica al guardar. Un caso útil: una sucursal arranca solo nube con celulares; cuando llega su PC, pasás a sincronizada y usás "Descargar desde la nube" en el Sincronizador — la PC queda con todo lo que la sucursal generó.

La pantalla del Sincronizador 🔄

Estado: tablas locales, cambios pendientes, última sincronización, servidor usado y si el servicio en segundo plano está 🟢 ACTIVO.
Paso 1 · Preparar: crea las libretas de cambios y los vigilantes en ambos lados (una sola vez; repetirlo no rompe nada).
Paso 2 · Carga inicial: Subir base completa (nube nueva) o Descargar desde la nube (PC nueva o restauración de respaldo).
Paso 3 · Sincronizar: normalmente no hace falta tocarlo — el servicio lo hace solo. Los botones son para forzar el momento.

💡 Failover automático: si cargás más de un servidor de nube (con prioridades 1, 2, 3...), cuando el principal no responde el sistema pasa solo al siguiente.

6. El Asistente IA: local, Internet y a distancia

El botón flotante 🤖 está en todas las pantallas. Debajo de cada respuesta vas a ver quién respondió:

🖥 IA local — respondió la IA de tu PC (el modelo corre en tu placa de video; privado y gratis).
🌐 IA Internet — respondió el servicio online (OpenRouter), el respaldo.

Figura 3 — Cómo decide el sistema qué IA responde en cada situación.

Cómo configurar la IA de Internet (OpenRouter) — una sola vez

Creá una cuenta en openrouter.ai y generá una API key (empieza con sk-or-...). Cargale crédito si vas a usar modelos pagos, o elegí modelos gratuitos.

En la PC: Menú → Configuración Nube → IA secundaria (OpenRouter). Pegá la key, dejá el modelo en openrouter/auto (elige solo el mejor disponible) y marcá habilitado. Guardá.

Tocá 🚀 DESPLEGAR SUITE EN EL HOSTING para que el respaldo también quede activo en la web. Listo.

ℹ️ El interruptor "Chat remoto habilitado" (en IA y sincronización) controla si tu PC atiende las consultas que llegan desde los celulares. La key se guarda cifrada.

El asistente también ve tu pantalla

En la PC, el botón 📸 del asistente captura la pantalla y el modelo local la analiza con visión: útil para consultar sobre un error o una pantalla que no entendés. Además el asistente busca primero en la documentación interna del sistema (búsqueda semántica) para responder con precisión.

7. Venta online: tienda con QR para tus clientes

Tus clientes compran desde el celular sin que tengas que configurar nada de redes: la tienda vive en tu hosting.

Figura 4 — El circuito completo de la venta online, de punta a punta (verificado: el pedido llega a la PC en segundos).

Puesta en marcha (como administrador)

Menú → Generar Entrada a Tienda. Al generar, el sistema crea la página de entrada con el QR apuntando a tu hosting y la publica automáticamente en la nube. Te muestra el enlace final (por ejemplo https://tumejoria.com/sistock/usuario6online.html).

Imprimí el QR (botón Descargar QR) y pegalo en el mostrador, o compartí el enlace por WhatsApp/redes.

En Gestión de Ventas Online habilitás clientes con usuario y contraseña (o dejás que entren como invitados), les asignás lista de precios, y ves y gestionás los pedidos que llegan (pendiente → procesando → enviado → completado).

Qué ve tu cliente

Escanea el QR → entra a la página con el nombre de tu negocio → elige entrar con su cuenta o como invitado.
Ve el catálogo con los precios de su lista asignada, arma el carrito y confirma el pedido con sus datos de contacto y entrega.
El pedido queda registrado al instante en la nube y baja a tu PC en segundos.

💡 La tienda funciona 24/7 aunque tu PC esté apagada: los pedidos esperan en la nube y entran a tu PC cuando la enciendas.

8. Configuración de Nube paso a paso

Menú → Configuración Nube ☁️ (solo administrador). Arriba de todo, la barra "Conexión actual" te dice si estás en la PC o en la nube y contra qué base estás trabajando.

El perfil de nube (uno por empresa o sucursal)

Campo	Qué va
Identificador / Nombre	Cómo llamás a este servidor (ej: `tumejoria`).
Dominio	Tu dominio del hosting (ej: `tumejoria.com`).
URL de la API	`https://TU-DOMINIO/sistock_api` — el motor de sincronización.
Token de la API	Se genera solo en el primer despliegue. Es la llave que autoriza a tu PC.
BD del hosting	Nombre, usuario y contraseña de la base MySQL creada en tu panel de hosting.
FTP	Servidor, usuario y contraseña FTP del hosting (para el auto-despliegue), y la carpeta de la app (normalmente `public_html/sistock`).
Prioridad	1 = principal. Si tenés varios servidores y se cae el 1, pasa solo al 2, al 3...
Modo de la nube	🔄 Sincronizada con la PC o ☁️ Solo nube (ver sección 5).

Los botones de prueba y el despliegue

🌐 Probar dominio / 📂 Probar FTP / 🔌 Probar API / 🗄 Probar BD de la nube: verificás cada pieza por separado, con mensajes claros.
☁️🚀 DESPLEGAR SUITE EN EL HOSTING: sube desde tu PC todo lo necesario — la API de sincronización y el sistema completo web — genera la configuración del hosting con las credenciales del perfil y verifica en vivo que todo responda. Se puede repetir cuando quieras (por ejemplo, tras una actualización del sistema).

ℹ️ Para dar de alta un hosting nuevo solo necesitás: un dominio con SSL, una base MySQL creada en el panel, y el acceso FTP. Cargás esos datos en un perfil y tocás Desplegar.

9. Chat interno entre usuarios

Chat grupal de toda la empresa y mensajes privados entre usuarios, desde Menú → Chat Interno.
Funciona entre PC y celulares: un empleado en el local y otro repartiendo pueden chatear normalmente.
Entre usuarios del mismo lado es instantáneo; cuando el mensaje cruza (PC ↔ celular) tarda el ciclo de sincronización: 5 a 15 segundos.
Para que un empleado aparezca en el chat, el administrador lo registra desde Gestionar Usuarios (sincronizar chat). El estado en línea/desconectado también se comparte entre entornos.

10. Seguridad del sistema

Credenciales cifradas: todas las contraseñas de configuración (base de datos, FTP, API keys) se guardan cifradas con AES-256. En la PC, la clave maestra vive fuera de la carpeta del sistema: si alguien copia la carpeta entera, no puede leer nada.
El hosting no expone secretos: las carpetas de configuración y librerías devuelven "prohibido" por web, y todo viaja por HTTPS.
Tu PC no recibe conexiones de afuera: escucha solo localmente; la sincronización son llamadas salientes seguras hacia tu hosting, autorizadas por un token secreto.
Contraseñas de usuarios: siempre guardadas con hash (nunca en texto plano), igual en PC y nube.
La clave de la IA de Internet queda en el servidor; jamás llega al navegador de un empleado o cliente.

11. Solución de problemas

Síntoma	Causa probable	Qué hacer
El asistente dice "no está disponible"	La IA local todavía está cargando, o el sistema no se inició completo.	Esperá un minuto. Si sigue, reiniciá con `DETENER_SISTEMA` + `INICIAR_SISTEMA`. Con OpenRouter habilitado, mientras tanto responde la 🌐 IA Internet.
Los cambios del celular no aparecen en la PC	El servicio de sincronización no está corriendo, o no hay internet en la PC.	Abrí el Sincronizador: si dice 🔴 detenido, iniciá el sistema con `INICIAR_SISTEMA.bat`. Verificá internet. Los cambios no se pierden: se ponen al día al reconectar.
La web dice "sin servidor de nube" o no carga	Hosting caído o SSL/dominio con problemas.	En Configuración Nube usá los botones de prueba (dominio, API, BD) para ver qué pieza falla. Si tenés otro servidor cargado, el failover pasa solo.
El asistente del celular tarda y responde 🌐	La PC del negocio está apagada o sin chat remoto.	Es el comportamiento esperado: respondió el respaldo. Encendé la PC o habilitá "Chat remoto" para que responda la IA local.
Un pedido online no llegó a la PC	PC apagada al momento del pedido.	El pedido está seguro en la nube; entra solo al encender la PC. Verificalo en Gestión de Ventas Online desde la web.
"Contraseña incorrecta" en la web con un usuario nuevo	El usuario recién creado en la PC todavía no viajó a la nube.	Esperá 10-20 segundos y reintentá. El Sincronizador muestra los pendientes.
Cambié un archivo y la web muestra el viejo	Caché de PHP del hosting.	Esperá unos segundos y recargá con Ctrl+F5 (o el equivalente del celular).

12. Datos técnicos de referencia

Componente	Detalle
Sistema en PC	`http://127.0.0.1:8080` — Apache dedicado, solo local.
Base local	MariaDB en el puerto 3306, datos en `base_datos\data`. IDs terminados en 1.
IA local	llama.cpp con Gemma (chat+visión, puerto 8090) y embeddings (8091); usa la GPU si hay.
Sistema web	`https://tumejoria.com/sistock/` — el mismo sistema, contra la BD espejo. IDs terminados en 2.
API de sincronización	`https://tumejoria.com/sistock_api/` — protegida por token.
Servicio de sync	`servicio_sync.php` — se inicia con el lanzador; registro en `logs_servidor\sync_servicio.log`.
Configuración cifrada	`config\*.ini.enc`; clave maestra en `C:\ProgramData\SistockIA\` (PC).
Fuente de la suite de nube	`nube_hosting\sistock_api\` (directorio portable; el botón Desplegar la sube).
Lanzadores	`INICIAR_SISTEMA.bat` / `DETENER_SISTEMA.bat`