🇪🇸 Español
================================================================================
  SELGORITHM — SISTEMA DE PUNTO DE VENTA
  MANUAL DE USUARIO
  Versión 2026
================================================================================

--------------------------------------------------------------------------------
TABLA DE CONTENIDOS
--------------------------------------------------------------------------------
  1. Introducción y descripción general del sistema
  2. Beneficios clave
  3. Primeros pasos
  4. Funciones principales
     4.1  Entrada de productos y escaneo de códigos de barras
     4.2  Gestión del carrito de compras
     4.3  Pago y procesamiento de ventas
     4.4  Gestión de clientes (cuentas)
     4.5  Retención de pedidos
     4.6  Gestión de productos
     4.7  Sistema de códigos de tipo
     4.8  Tarjetas de fidelidad y puntos
     4.9  Informes
     4.10 Informe de beneficios
     4.11 Cancelación y corrección de ventas
     4.12 Informe de movimientos
     4.13 Módulo de finanzas y personal
     4.14 Lista de salida de almacén
     4.15 Importación / exportación de datos
     4.16 Impresión de recibos
     4.17 Impresión de etiquetas de código de barras
  5. Administración
     5.1  Gestión de usuarios
     5.2  Configuración y temas
  6. Atajos de teclado
  7. Seguridad de datos y copia de seguridad
  8. Notas técnicas

================================================================================
1. INTRODUCCIÓN Y DESCRIPCIÓN GENERAL DEL SISTEMA
================================================================================

Selgorithm es una aplicación de punto de venta (POS) profesional, compatible
con uso sin conexión, diseñada específicamente para librerías y negocios
minoristas. Construida sobre una interfaz web moderna que funciona localmente
en Windows, combina la flexibilidad de una interfaz de usuario basada en
navegador con la fiabilidad y velocidad de una aplicación de escritorio.

Selgorithm no requiere conexión a Internet para las operaciones diarias. Todos
los datos se almacenan localmente en una base de datos SQLite cifrada, lo que
garantiza que los datos de su negocio permanezcan privados y sean accesibles
de inmediato incluso sin conectividad de red.

La aplicación soporta 8 idiomas, 13 temas visuales y múltiples formatos de
moneda, lo que la hace adecuada tanto para operaciones nacionales como
internacionales.

================================================================================
2. BENEFICIOS CLAVE
================================================================================

  VELOCIDAD Y EFICIENCIA
  ———————————————————————
  El escaneo de código de barras completa una venta en segundos. Los atajos de
  teclado eliminan la necesidad de alcanzar el ratón en las horas pico, lo que
  reduce drásticamente el tiempo de transacción y la fatiga del cajero.

  PROPIEDAD DE DATOS
  ———————————————————
  Sus datos nunca salen de su dispositivo. Sin tarifas de suscripción, sin
  dependencia de la nube, sin riesgo de interrupción del servicio. Propiedad
  total de su historial de ventas, datos de clientes e inventario en todo
  momento.

  VISIBILIDAD DE BENEFICIOS
  ——————————————————————————
  El informe de beneficios integrado calcula el beneficio neto por día, semana,
  mes y año comparando los precios de venta con los costes de compra. Esto
  permite a los propietarios identificar períodos de alto margen y tomar
  decisiones de abastecimiento informadas.

  RELACIONES CON CLIENTES
  ————————————————————————
  El sistema de tarjetas de fidelidad y puntos fomenta la repetición de
  clientes. El seguimiento detallado de cuentas (ventas a crédito) ayuda a
  gestionar clientes de crédito y saldos pendientes de forma transparente.

  CONTROL DE ACCESO MULTIUSUARIO
  ————————————————————————————
  El acceso basado en roles (admin vs. personal) garantiza que los cajeros solo
  puedan realizar operaciones permitidas, mientras que los gerentes mantienen
  el control total sobre funciones sensibles como cancelaciones, informes y
  configuración.

  CONTROL DE INVENTARIO
  ——————————————————————
  Actualizaciones automáticas de stock en cada venta y cancelación. Las alertas
  de stock bajo evitan desabastecimientos en títulos populares. La lista de
  salida de almacén produce un PDF imprimible que muestra todos los artículos
  vendidos en cualquier rango de fechas.

================================================================================
3. PRIMEROS PASOS
================================================================================

  PRIMER INICIO
  ——————————————
  En el primer inicio, se le guiará a través de un asistente de configuración
  para configurar:
    - Nombre de la empresa y emoji de logotipo
    - Idioma y moneda predeterminados
    - Nombre de usuario y contraseña de administrador

  INICIO DE SESIÓN
  ————————————————
  Navegue a la página de inicio de sesión e introduzca sus credenciales. Utilice
  la opción "Recordarme" en dispositivos compartidos solo si es apropiado para
  su política de seguridad.

  COMPATIBILIDAD DE DISPOSITIVOS
  ————————————————————————————
  Selgorithm detecta automáticamente el tipo de dispositivo y carga un diseño
  optimizado:
    - Escritorio: Diseño completo de doble panel
    - Tableta: Diseño adaptado con navegación de cajón deslizante
    - Móvil: Interfaz compacta optimizada para toque

================================================================================
4. FUNCIONES PRINCIPALES
================================================================================

4.1  ENTRADA DE PRODUCTOS Y ESCANEO DE CÓDIGOS DE BARRAS
—————————————————————————————————————————————————————————
  Escanee un código de barras de producto usando un escáner USB o Bluetooth,
  o escriba el código de barras manualmente en el campo de entrada. El producto
  se recupera instantáneamente de la base de datos y se añade al carrito.

  BENEFICIO: El escaneo de código de barras elimina errores de entrada manual
  de precios y reduce el tiempo de transacción a menos de 2 segundos por
  artículo, incluso con grandes inventarios.

  - Presione F4 en cualquier momento para centrar el foco en el campo de
    entrada del código de barras.
  - Presione F3 para buscar productos por nombre cuando no haya código de
    barras disponible.


4.2  GESTIÓN DEL CARRITO DE COMPRAS
————————————————————————————————
  El carrito muestra todos los artículos escaneados con campos editables de
  cantidad, descuento y precio unitario. Haga clic en cualquier celda para
  editarla en línea.

  BENEFICIO: La edición del carrito en tiempo real permite a los cajeros aplicar
  descuentos personalizados, corregir cantidades y ajustar precios sin reiniciar
  la transacción.

  - Seleccione una fila y presione F2 para abrir el modal completo de edición
    de producto.
  - Use Ctrl+↓ / Ctrl+↑ para navegar entre filas del carrito desde el teclado.
  - Haga clic derecho en cualquier fila para las opciones del menú contextual
    (editar / eliminar).


4.3  PAGO Y PROCESAMIENTO DE VENTAS
————————————————————————————————
  Selgorithm soporta tres métodos de pago:

    EFECTIVO (F8)   — Pago inmediato en efectivo. Se reduce el stock, se
                       actualiza el contador de ingresos diarios.
    TARJETA (F9)    — Pago con tarjeta de crédito/débito. Mismo proceso que
                       efectivo.
    CRÉDITO (F6)    — Pago diferido asignado a una cuenta de cliente. Crea
                       automáticamente una entrada de deuda en el libro mayor
                       del cliente. Solo disponible cuando se ha seleccionado
                       un cliente.

  BENEFICIO: Las opciones de pago flexibles soportan todos los escenarios
  minoristas. Las ventas a crédito permiten la gestión formal de cuentas sin
  software de contabilidad externo.


4.4  GESTIÓN DE CLIENTES (CUENTAS)
———————————————————————————————
  Añada y gestione cuentas de clientes para el seguimiento de crédito. Cada
  cliente tiene un libro mayor que muestra todas las ventas a crédito, pagos
  y saldos.

  BENEFICIO: Reemplace los libros de contabilidad en papel con un registro
  digital buscable y siempre preciso del saldo pendiente y el historial de
  transacciones de cada cliente.

  - Renombrar o eliminar clientes desde el menú de configuración.
  - Las cuentas de clientes se integran directamente con las ventas a crédito.


4.5  RETENCIÓN DE PEDIDOS (F7)
—————————————————————————————
  Guarde un carrito parcialmente completado en la cola de retención mientras
  atiende a otro cliente. Los pedidos retenidos se listan en el panel derecho
  y pueden restaurarse en cualquier momento.

  BENEFICIO: Elimina las ventas perdidas debido a interrupciones de clientes.
  Los cajeros pueden manejar múltiples transacciones simultáneamente sin pérdida
  de datos.


4.6  GESTIÓN DE PRODUCTOS
——————————————————————————
  Cada registro de producto contiene:
    - Código de barras, título, editor
    - Precio de lista (precio de portada)
    - Descuento de compra (base de coste para cálculo de beneficios)
    - Descuento de revendedor
    - Descuento de cliente
    - Nivel de stock actual
    - Código de tipo (categoría)
    - Imagen de portada

  Haga clic derecho en cualquier producto escaneado para editar sus detalles.

  BENEFICIO: Los datos de productos centralizados garantizan precios coherentes
  en todas las transacciones. La integración del descuento de compra permite el
  seguimiento automático de beneficios sin entradas manuales de costes.


4.7  SISTEMA DE CÓDIGOS DE TIPO
—————————————————————————————
  Asigne códigos de tipo de 1 a 3 caracteres para categorizar productos
  (ej. R = Novela, T = Test/Estudio, C = Infantil). Cree códigos personalizados
  ilimitados con colores personalizados a través de Configuración → Gestionar
  códigos de tipo.

  BENEFICIO: Los códigos de tipo permiten listas de salida de almacén filtradas,
  lo que permite al personal de almacén ver solo las categorías de productos
  relevantes para su área de trabajo.


4.8  TARJETAS DE FIDELIDAD Y PUNTOS
————————————————————————————————
  Emita tarjetas de fidelidad físicas con números de tarjeta únicos. Los puntos
  se ganan automáticamente basándose en una tasa de ganancia configurable por
  compra. Vea los puntos totales y el historial de transacciones de cada cliente
  en el módulo de Finanzas.

  BENEFICIO: Los programas de fidelidad aumentan las tasas de recompra. El
  sistema de puntos automatizado no requiere seguimiento manual y se integra
  perfectamente con el procesamiento de ventas.


4.9  INFORMES — INFORME DE VENTAS POR RANGO DE FECHAS
——————————————————————————————————————————————————————
  Acceso a través de Informes → Informe por rango de fechas. Seleccione
  cualquier fecha de inicio y fin para generar una lista completa de ventas
  que incluye: fecha, código de barras, título, editor, cantidad, precio
  unitario, descuento, total, cliente y tipo de pago.

  BENEFICIO: Acceso instantáneo a datos de ventas históricos para cualquier
  período. Exporte a Excel para análisis adicional o integración contable.
  Imprima directamente desde el navegador para registros físicos.


4.10 INFORME DE BENEFICIOS
——————————————————————————
  Acceso a través de Informes → Informe de beneficios. Vea datos de beneficios
  agregados en cuatro escalas de tiempo: Diario, Semanal, Mensual, Anual.

  Cada fila muestra: Período | Cant. | Ingresos | Coste | Beneficio | Margen%
  Las tarjetas de resumen muestran ingresos totales, costes, beneficio neto
  y margen promedio.

  Beneficio = Ingresos − (Cant. × Precio de lista × (1 − Descuento de compra%))

  BENEFICIO: Datos de rentabilidad en tiempo real sin contable. Identifique
  qué períodos, temporadas o meses generan los márgenes más altos. Compare
  el rendimiento semanal para optimizar las decisiones de pedido y personal.


4.11 CANCELACIÓN Y CORRECCIÓN DE VENTAS
————————————————————————————————————
  CANCELAR: Busque una venta pasada por código de barras. Revise los detalles
  de la venta y confirme la cancelación. El registro cancelado se archiva, el
  stock se restaura automáticamente y los ingresos se ajustan.

  CORREGIR: Mueve los artículos de una venta pasada de vuelta al carrito activo
  para reajuste de precios o reescaneo antes de vender de nuevo a valores
  corregidos.

  BENEFICIO: Correcciones seguras para auditoría sin eliminación permanente de
  datos. Las ventas canceladas se conservan en un archivo separado para
  cumplimiento y revisión.


4.12 INFORME DE MOVIMIENTOS
—————————————————————————
  Acceso a través de Informes → Movimientos. Escanee o introduzca un código de
  barras para ver los últimos 7 días de actividad de ventas para ese producto
  específico, incluyendo la cantidad vendida por día.

  BENEFICIO: Identifique rápidamente el stock de alta rotación para priorizar
  el reabastecimiento antes de que se produzca una ruptura de stock.


4.13 MÓDULO DE FINANZAS Y PERSONAL
————————————————————————————————
  Acceso a través de Admin → Finanzas y Personal (/finans).

  Características:
    - Gestión de personal: añadir personal, rastrear horas de trabajo
      (soporte de horas extra)
    - Pagos de salario: registrar y rastrear el historial de pagos por empleado
    - Seguimiento de gastos: registrar gastos empresariales por categoría
    - Resumen financiero diario: ingresos, gastos, saldo neto
    - Cuentas de clientes: libro mayor completo de débito/crédito por cliente
    - Exportar datos financieros a Excel

  BENEFICIO: Una visión general financiera completa de pequeña empresa en una
  sola pantalla. No se necesita software de nómina o gastos separado para
  equipos pequeños.


4.14 LISTA DE SALIDA DE ALMACÉN (eksik-listesi)
——————————————————————————————————————————————
  Acceso a través de Admin → Lista faltante. Seleccione un rango de fechas y
  filtros de tipo de producto para generar un PDF imprimible que muestra todos
  los artículos vendidos (lista de salida/preparación de almacén).

  BENEFICIO: Proporciona al personal de almacén una lista de preparación clara
  filtrada por tipo directamente desde los datos de ventas, eliminando la
  preparación manual de listas y reduciendo los errores de cumplimiento.


4.15 IMPORTACIÓN / EXPORTACIÓN DE DATOS
————————————————————————————————————
  Acceso a través del menú Datos.

  EXPORTAR:
    - Lista de stock a Excel (.xlsx)
    - Informe de ventas a Excel para cualquier rango de fechas
    - Copia de seguridad completa de la base de datos (archivo .db)

  IMPORTAR:
    - Importación masiva de productos mediante plantilla Excel
    - El modo de vista previa muestra posibles problemas antes de aplicar
    - Restauración de base de datos desde copia de seguridad

  BENEFICIO: Integración perfecta con flujos de trabajo basados en Excel. La
  entrada masiva de productos reduce drásticamente el tiempo de configuración
  para nuevas tiendas. Las copias de seguridad regulares protegen contra la
  pérdida de datos.


4.16 IMPRESIÓN DE RECIBOS
——————————————————————————
  Configure su impresora de recibos térmica en Configuración → Ajustes de
  recibo. Los recibos incluyen nombre de empresa, subencabezado, carrito
  detallado, totales, resumen de descuento e información del cliente.

  BENEFICIO: Los recibos profesionales mejoran la confianza del cliente y
  proporcionan un registro físico de cada transacción para ambas partes.


4.17 IMPRESIÓN DE ETIQUETAS DE CÓDIGO DE BARRAS
——————————————————————————————————————————————
  Desde el modal de edición de producto, haga clic en el botón de impresión
  para abrir el diseñador de etiquetas de código de barras. Elija tamaño de
  etiqueta, cantidad y diseño. Imprima directamente a cualquier impresora
  conectada.

  BENEFICIO: La impresión de etiquetas en casa elimina la dependencia de
  etiquetas preimpresas y permite el reetiquetado inmediato cuando cambian
  los precios.

================================================================================
5. ADMINISTRACIÓN
================================================================================

5.1  GESTIÓN DE USUARIOS
——————————————————————
  Los usuarios administradores pueden crear, editar y eliminar cuentas de
  personal en /admin/users. Hay dos roles disponibles:

    ADMIN    — Acceso completo a todas las funciones, incluyendo informes,
               cancelaciones, gestión de usuarios y configuración.
    PERSONAL — Acceso solo a ventas, carrito, retenciones y selección de
               clientes.

  BENEFICIO: La separación de roles evita el acceso no autorizado a funciones
  sensibles como informes financieros y cancelaciones de ventas.


5.2  CONFIGURACIÓN Y TEMAS
——————————————————————————
  Acceso a través de Admin → Configuración.

    - Nombre de empresa y emoji de logotipo
    - Idioma de visualización (8 opciones)
    - Tema visual (13 opciones)
    - Símbolo de moneda
    - Umbral de alerta de stock bajo
    - Nombre de cliente predeterminado
    - Gestión de códigos de tipo

  BENEFICIO: La personalización completa garantiza que la interfaz refleje su
  marca y resulte familiar para su equipo desde el primer día.

================================================================================
6. ATAJOS DE TECLADO
================================================================================

  TECLA       ACCIÓN
  ——————————  ————————————————————————————————————————
  F1          Abrir referencia de atajos de teclado
  F2          Editar producto seleccionado (la fila del carrito debe estar
              seleccionada)
  F3          Abrir búsqueda de producto por nombre
  F4          Enfocar campo de entrada de código de barras (seleccionar todo)
  F5          Recargar página
  F6          Procesar venta a crédito
  F7          Retener pedido actual
  F8          Procesar venta en efectivo
  F9          Procesar venta con pago con tarjeta
  F11         Alternar modo pantalla completa
  Ctrl+↓      Mover selección a la siguiente fila del carrito
  Ctrl+↑      Mover selección a la fila anterior del carrito
  Enter       Confirmar código de barras / confirmar edición de celda
  Escape      Cancelar edición en línea / cerrar modal
  ↑ / ↓       Navegar dentro de celda editable

================================================================================
7. SEGURIDAD DE DATOS Y COPIA DE SEGURIDAD
================================================================================

  Todos los datos se almacenan localmente en:
    %LOCALAPPDATA%\Selgorithm_Web\

  Los secretos de sesión se generan automáticamente en el primer inicio y se
  almacenan localmente. No se transmiten datos a servidores externos.

  PROGRAMA DE COPIA DE SEGURIDAD RECOMENDADO:
    - Diariamente: Exportar copia de seguridad de base de datos a través de
      Datos → Copia de seguridad
    - Semanalmente: Copiar la carpeta Selgorithm_Web a una unidad externa o
      servicio de almacenamiento en la nube de su elección

  RESTAURAR: Use Datos → Restaurar base de datos para cargar un archivo de
  copia de seguridad anterior.

================================================================================
8. NOTAS TÉCNICAS
================================================================================

  - Funciona con Python 3.10+ con el framework web Flask
  - Base de datos: SQLite (archivo .db único, portátil)
  - Interfaz: WebView2 (integrado en Windows) renderizando un servidor web local
  - Sistema operativo mínimo: Windows 10 (64 bits)
  - No se requiere conexión a Internet para el funcionamiento
  - Operación multidispositivo posible en una red local
    (contacte a su revendedor)

================================================================================
  © 2026 Selgorithm. Todos los derechos reservados.
================================================================================