# 🎓 Tutorial Interactivo

Sistema de Tiendas V3.0

🏪 Bienvenido al Tutorial

Este tutorial interactivo te guiará a través de todas las funcionalidades del Sistema de Tiendas V3.0.

Aprenderás cómo:

- Ingresar y registrarse como cliente
- Escanear productos con la cámara
- Gestionar tu carrito de compras
- Finalizar compras
- Administrar el sistema (si eres administrador)

Selecciona un tema para comenzar:

👤 Ingreso al Sistema

El primer paso es ingresar con tu número de cédula o RUC.

¿Qué necesitas?

- Tu número de cédula (6-7 dígitos) o RUC (8-9 dígitos)
- Puedes incluir o no el guión separador
- El sistema elimina automáticamente espacios extra

Pasos:

1. Abre el navegador y ve a la URL del sistema
2. Ingresa tu número de cédula o RUC
3. Haz click en "Ingresar"

💡 Consejo: Si es tu primera vez, el sistema te pedirá completar un breve registro con tu nombre y ciudad.
📷 Escanear Productos

El scanner permite agregar productos rápidamente usando la cámara de tu dispositivo.

¿Cómo funciona?

1. Haz click en el botón "APRIETE EL BOTON PARA LEER EL CODIGO"
2. Autoriza el acceso a la cámara cuando el navegador lo solicite
3. Apunta la cámara al código de barras del producto
4. El sistema detectará el código en 1-2 segundos
5. Se mostrará una vista previa del producto

💡 Consejo: Asegúrate de tener buena iluminación y mantén el código de barras en posición horizontal a unos 15-20 cm de la cámara.

¿Si el scanner no funciona?

Usa el campo de entrada manual debajo del botón del scanner. Simplemente escribe el código de barras y haz click en "Buscar".

✅ El sistema detecta múltiples formatos: EAN-13, EAN-8, UPC, CODE-128, QR, y más.
🛒 Gestionar tu Carrito

El carrito muestra todos los productos que has agregado y te permite modificar cantidades antes de pagar.

Funcionalidades del carrito:

- Ver productos: Cada producto muestra imagen, nombre, precio unitario y subtotal
- Cambiar cantidad: Usa los botones + y - para ajustar la cantidad
- Eliminar producto: Haz click en el botón × para borrar un item
- Ver total: El total se actualiza automáticamente

Botones disponibles:

- Finalizar Compra: Confirma tu compra y la envía al sistema
- Vaciar Carrito: Elimina todos los productos de una vez
- Ver Última Compra: Revisa tu compra anterior

✅ El carrito se actualiza en tiempo real. No necesitas recargar la página.
⚙️ Panel de Administración

El panel de administración es donde gestiona todo el sistema.

¿Cómo acceder?

1. Ve a: `http://tu-dominio.com/admin/`
2. Ingresa tu usuario y contraseña
3. Haz click en "Ingresar"

Roles disponibles:

- Administrador: Acceso total a todos los módulos
- Comercial: Productos, promociones, mensajes, compras
- Colaborador: Solo lectura de productos y compras

⚠️ Importante: Cambia la contraseña por defecto después de la instalación inicial por razones de seguridad.
📦 Gestión de Productos

Aquí puedes agregar, editar y eliminar productos del catálogo.

Agregar un nuevo producto:

1. Haz click en "➕ Nuevo Producto"
2. Completa los campos:
   - Código de Barras: Escanea o escribe el código (usa el botón 📷)
   - Nombre: Nombre descriptivo del producto
   - Descripción: Detalles adicionales (opcional)
   - Precio: En guaraníes (se formatea automáticamente)
   - Stock: Cantidad disponible (opcional)
   - Categoría: Clasificación (opcional)
   - Imagen: Foto del producto (opcional pero recomendada)
   - Activo: Marca para que esté disponible para clientes
3. Haz click en "Guardar"

✅ Usa el botón de scanner para leer códigos de barras directamente del producto. ¡Es mucho más rápido!
🎁 Crear Promociones

Las promociones son ofertas que se muestran en el dashboard del cliente.

Pasos para crear una promoción:

1. Ve al módulo "Promociones"
2. Haz click en "Nueva Promoción"
3. Completa:
   - Título: Encabezado corto y llamativo
   - Descripción: Detalles de la oferta
   - Imagen: Foto de la promoción (opcional)
   - Activa: Marca para que sea visible a clientes
4. Haz click en "Guardar"

Ejemplo de promoción:

Título: ¡2x1 en Gaseosas! Descripción: Lleva 2 gaseosas de 2L y paga solo 1. Válido hasta fin de mes.
💡 Consejo: Las promociones rotan automáticamente cada 10 segundos en el dashboard del cliente.
Lección 1 de 7