# Salón y mesas

# Crear áreas (zonas del salón)

## ¿Qué es / para qué sirve?

Un **área** es una zona del local donde se agrupan las mesas (ej. "Salón
Principal", "Terraza", "Barra"). Toda mesa pertenece a un área, así que crea las
áreas **antes** que las mesas.

## Paso a paso

1. Ve a **Mesas → Áreas → Agregar**.
2. Completa los campos:
   - **Sucursal** (obligatorio): a qué local pertenece el área.
   - **Nombre del Área** (obligatorio): ej. "Terraza".
   - **Breve Descripción** (opcional).
   - **Cajero** (obligatorio): el usuario cajero responsable del área.
   - **Imagen del Área** (opcional): foto cuadrada (relación 1:1), hasta el tamaño
     permitido (jpeg/png/gif).
3. Marca, si aplican, las casillas de tipo de área:
   - **Privado**: el área es privada.
   - **Autoservicio**: zona de mostrador/barra de autoservicio.
   - **Habitación**: para pedidos de habitación (hotel). Al marcarla, se activa
     **Privado** automáticamente y aparece un **rango horario**.
4. Si marcaste **Habitación**, define **Hora de Inicio** y **Hora de
   Finalización** (opcional): los pedidos por el QR de la habitación solo se
   permiten en ese rango. Déjalas vacías para no restringir horario.
5. Guarda.

[CAPTURA: cuadro de área con Nombre, Sucursal, Cajero, Imagen y las casillas Privado/Autoservicio/Habitación]

## Quién puede crear, editar o eliminar áreas

Son **tres permisos separados**, que se marcan en **Configuración → Roles**:

| Permiso | Qué habilita |
|---|---|
| **Añadir Área** | crear áreas, tanto aquí como con el botón **+ Área** de la vista en planta |
| **Editar Área** | cambiar nombre, sucursal, cajero y tipo |
| **Eliminar Área** | borrar un área |

Quien no tenga *Añadir Área* **no ve el botón + Área** en la vista en planta. El rol
**Administrador** puede hacer las tres cosas siempre, sin marcarle nada.

> **Un área con cuentas abiertas no se puede eliminar**, aunque tengas el permiso.
> Borrar un área se lleva sus mesas, así que primero hay que cobrar o anular las
> cuentas de esas mesas.

Cada eliminación de área queda registrada en **Reportes → Logs**.

## Notas y avisos

> - El **Cajero** del área se actualiza según la **Sucursal** elegida.
> - En el listado, cada área muestra su **Tipo** (Habitación, Autoservicio,
>   Privada o Pública) y su sucursal.
> - Crea primero las áreas; luego asigna las [mesas](crear-mesas.md) a cada una.

PENDIENTE DE VERIFICAR: cómo se usa exactamente el QR de habitación y el rango
horario en la operación diaria.

# Crear y configurar mesas

## ¿Qué es / para qué sirve?

Las **mesas** son los puntos donde se atiende a los clientes. Cada mesa pertenece
a un **área** y a una **sucursal**. Aquí las creas y configuras.

## Paso a paso

1. Crea primero las [áreas](crear-areas.md).
2. Ve a **Mesas → Mesas → Agregar**.
3. Completa los campos:
   - **Sucursal** (obligatorio).
   - **Área** (obligatorio): se carga según la sucursal elegida.
   - **Nombre de la Mesa** (obligatorio): ej. "Mesa 1".
   - **Breve Descripción** (opcional): ej. "Cerca de la ventana".
   - **Número de Sillas** (obligatorio): capacidad de la mesa (por defecto 1).
   - **Marcador Bluetooth** (opcional): es solo un campo identificador de la mesa;
     **no requiere ningún equipo ni integración** (ver [Vipers](vipers.md)).
   - **Mesa Preseleccionada en el POS** (casilla): si la marcas, esa mesa queda
     elegida por defecto al abrir el POS en esa sucursal.
4. Guarda.

[CAPTURA: cuadro de mesa con Sucursal, Área, Nombre, Número de Sillas y Marcador Bluetooth]

## Listado y acciones

En **Mesas** ves todas con su **Sucursal**, **Área** y **Descripción**. Por cada
una puedes **Editar**, **Eliminar** o ver su **código QR** — según los permisos que
tenga tu rol.

## Quién puede crear, editar o eliminar mesas

Son **tres permisos separados**, que se marcan en **Configuración → Roles**:

| Permiso | Qué habilita |
|---|---|
| **Añadir Mesa** | crear mesas y guardar la distribución del salón |
| **Editar Mesa** | cambiar nombre, área, sillas y demás datos |
| **Eliminar Mesa** | borrar una mesa |

Quien no tenga el permiso **no ve el botón**: ni en el listado de Mesas ni en la
vista en planta. El rol **Administrador** puede hacer las tres cosas siempre, sin
necesidad de marcarle nada.

[CAPTURA: los tres permisos de mesas en la pantalla de Roles]

> **Una mesa con cuenta abierta no se puede eliminar**, aunque tengas el permiso.
> Primero hay que cobrar o anular esa cuenta. Es para que no se pierda una mesa que
> todavía tiene consumo cargado.

Cada eliminación queda registrada: quién la hizo, qué mesa y desde qué pantalla. Se
consulta en **Reportes → Logs**.

## Notas y avisos

> - Solo puede haber **una "Mesa Preseleccionada"** por sucursal; si ya existe,
>   la casilla aparece deshabilitada.
> - El **Área** depende de la **Sucursal**: si cambias la sucursal, vuelve a
>   elegir el área.
> - Estas mesas son las que el salonero ve en el
>   [plano de mesas](../manual-salonero/plano-de-mesas.md).

# Vipers (llamadores)

## ¿Qué es / para qué sirve?

Un **Viper** es un dispositivo (llamador/marcador) que se asocia a la operación
del salón. Se registra en el sistema para poder vincularlo con las mesas mediante
su marcador.

## Paso a paso

1. Ve a **Mesas → Vipers → Agregar**.
2. Completa:
   - **Sucursal** (obligatorio).
   - **Nombre del Viper** (obligatorio): ej. "Viper-001" o "Llamador Mesa 5".
3. Guarda.

[CAPTURA: cuadro "Añadir Viper" con Sucursal y Nombre]

## Listado y acciones

En **Vipers** ves cada dispositivo con su **Sucursal**. Por cada uno puedes
**Editar** o **Eliminar**.

## Relación con las mesas

El vínculo con una mesa se hace por el campo **Marcador Bluetooth** de la mesa
(ver [Crear y configurar mesas](crear-mesas.md)).

## Notas y avisos

> - Registra el Viper con un **nombre claro** para identificarlo fácilmente.

PENDIENTE DE VERIFICAR: el funcionamiento físico del Viper (cómo llama/identifica
la mesa) y el flujo completo de emparejamiento con el marcador Bluetooth, según el
hardware de tu negocio.

# Vipers (identificador de pedido)

## ¿Qué es / para qué sirve?

Un **Viper** es un **número/identificador** que se asocia a un pedido para
ubicarlo o reconocerlo (similar a un número de "espera" que se le entrega al
cliente). Es **totalmente manual**: **no se conecta a ningún equipo** ni hay
integración con hardware. Aquí registras los Vipers disponibles para luego
asignarlos a los pedidos.

## Paso a paso

1. Ve a **Mesas → Vipers → Agregar**.
2. Completa:
   - **Sucursal** (obligatorio).
   - **Nombre del Viper** (obligatorio): ej. "Viper 1", "V-05".
3. Guarda.

[CAPTURA: cuadro "Añadir Viper" con Sucursal y Nombre]

## Listado y acciones

En **Vipers** ves cada uno con su **Sucursal**. Puedes **Editar** o **Eliminar**.

## Uso en la venta

Al tomar un pedido, se le puede asignar un **Viper** para identificarlo. La
asignación es manual; el Viper solo sirve como **etiqueta de referencia** del
pedido.

## Notas y avisos

> - No requiere ningún dispositivo: es solo un identificador que tú asignas.
> - Registra nombres/números claros para reconocerlos fácil.