# Manual de Usuario y Administrador - Glado POS

Bienvenido a Glado POS, el sistema de punto de venta diseñado para gestionar tu heladería de forma eficiente. Este manual te guiará a través de la instalación, configuración y uso de todas las funcionalidades de la aplicación.

---

## 1. Instalación (Para Administradores)

Sigue estos pasos para instalar la aplicación en un hosting con cPanel y acceso a bases de datos MySQL.

**Requisitos:**
- Un plan de hosting con cPanel (o similar).
- Capacidad para crear bases de datos MySQL.
- Las credenciales de tu servicio de correo SMTP.
- Las credenciales de tu cuenta de Twilio (Account SID, Auth Token y un número de WhatsApp).

**Pasos de Instalación:**

1.  **Subir el Archivo:** Localiza el archivo `Glado.zip` y súbelo a tu hosting a través del "Administrador de Archivos" de cPanel. Súbelo al directorio donde deseas instalar la aplicación (por ejemplo, `public_html`).

2.  **Extraer el Contenido:** Haz clic derecho sobre el archivo `Glado.zip` y selecciona "Extract" (Extraer). Esto descomprimirá todos los archivos de la aplicación en el directorio actual.

3.  **Crear la Base de Datos:**
    - En cPanel, ve a la sección "Bases de datos MySQL".
    - Crea una nueva base de datos (ej. `glado_main`).
    - Crea un nuevo usuario de base de datos y asígnale una contraseña segura.
    - Añade el usuario a la base de datos y otórgale **todos los privilegios**.
    - Anota el nombre de la base de datos, el nombre de usuario y la contraseña.

4.  **Ejecutar el Instalador Web:**
    - Abre tu navegador y ve a la URL donde extrajiste los archivos, seguido de `/install.php` (ej. `https://tudominio.com/install.php`).
    - Verás un asistente de instalación de 4 pasos. Rellena toda la información solicitada con cuidado:
        - **Paso 1:** Las credenciales de la base de datos que acabas de crear.
        - **Paso 2:** Los datos para la cuenta de administrador principal y el nombre de tu primera sucursal. El email y teléfono que ingreses aquí se usarán para las pruebas de conexión.
        - **Paso 3:** Las credenciales de tu servidor de correo SMTP.
        - **Paso 4:** Tus credenciales de Twilio.
    - Haz clic en **"Verificar e Instalar"**. El sistema probará la conexión con todos los servicios y, si todo es correcto, instalará la aplicación.

5.  **¡MUY IMPORTANTE! Eliminar el Instalador:**
    - Una vez que la instalación se complete con éxito, vuelve al Administrador de Archivos y **elimina el archivo `install.php`**. Este es un paso de seguridad crucial para evitar que alguien más pueda sobreescribir tu instalación.

¡Listo! La aplicación está instalada y lista para usarse. Puedes acceder a ella desde tu dominio.

---

## 2. Manual del Administrador

Como administrador, tienes acceso a todas las funcionalidades de gestión y configuración del sistema.

### Dashboard
Al iniciar sesión, verás el dashboard principal con enlaces a todas las secciones administrativas:

- **Gestionar Usuarios:** Crear, ver y eliminar cuentas de usuario (tanto vendedores como otros administradores).
- **Gestionar Productos:** Añadir nuevos productos, editar sus precios, gestionar el stock y asignarlos a categorías.
- **Gestionar Proveedores:** Mantener una lista de tus proveedores con su información de contacto.
- **Gestionar Sucursales:** Registrar nuevas sucursales (requiere una instalación separada para cada una) y ver sus datos de conexión.
- **Trasladar Productos:** Mover stock de un producto entre dos sucursales registradas.
- **Reportes:**
    - **Reporte de Ventas:** Ver un desglose de ventas por cada vendedor. Puedes exportar este reporte a PDF.
    - **Top 5 Productos:** Ver un ranking de los productos más vendidos.
    - **Análisis de Temporada:** Un gráfico de barras que muestra las ventas totales por mes, ayudándote a identificar tendencias.
- **Gestionar Regalos:** Ver la lista de regalos configurables que los clientes pueden canjear con puntos.
- **Clientes Inactivos:** Ver una lista de clientes que no han comprado en los últimos 30 días y enviarles una promoción por WhatsApp con un solo clic.

---

## 3. Manual del Vendedor (POS)

Como vendedor, tu principal herramienta será el Punto de Venta (POS).

### Interfaz Principal
- **Área de Productos (Izquierda):** Aquí verás las categorías y los productos disponibles. Haz clic en un producto para añadirlo al carrito.
- **Área de Carrito (Derecha):** Aquí se construye la venta actual.

### Realizar una Venta
1.  **Añadir Productos:** Haz clic en los productos que el cliente desea comprar. Se añadirán a la lista del carrito.
2.  **Asignar Puntos al Cliente:** Si el cliente es parte del programa de lealtad, introduce su **número de teléfono** en el campo "Teléfono del Cliente". Si el cliente no existe, se creará uno nuevo automáticamente.
3.  **Aplicar Códigos:**
    - **Código de Referido:** Si un cliente nuevo fue referido por otro, introduce el código en el campo "Código de Referido" para que ambos reciban su recompensa.
    - **Código de Promoción:** Si hay una promoción activa, introduce el código en su campo y haz clic en "Aplicar" para ver el descuento en el total.
4.  **Seleccionar Método de Pago:** Elige si el cliente paga con Efectivo, Transferencia o Tarjeta.
5.  **Finalizar la Venta:** Haz clic en el botón **"Pagar"**. La venta se registrará, el stock se actualizará y los puntos se asignarán al cliente.

### Tareas y Cierre de Caja
- **Dashboard del Vendedor (debajo de los productos):**
    - **Ventas del Día:** Una tabla que resume todas las ventas que has realizado en el día.
    - **Tareas Pendientes:** Notificaciones automáticas que el sistema te pide gestionar (ej. notificar a un referente).
- **Cierre de Caja:** Al final del día, ve a la sección "Cierre de Caja" para ver un resumen de los totales por método de pago y registrar el cierre en el sistema.
