Plano de Piso y Mesas
El editor de Plano de Piso es un lienzo visual para organizar tus mesas. La página de Mesas es una vista de operaciones por mesa para detalles y acciones. Ambas pantallas trabajan sobre los mismos registros de mesas subyacentes.
Pisos
Los pisos agrupan mesas por ubicación física, por ejemplo "Salón Principal", "Entresuelo" o "Patio Exterior". Creas y gestionas pisos desde Configuración > Cafetería.
Cada cafetería necesita al menos un piso. Las mesas siempre se asignan a exactamente un piso. Puedes reordenar los pisos con los controles de mover hacia arriba y hacia abajo, y el piso superior se convierte en el predeterminado cuando se abre la pestaña de Plano de Piso. La página de Plano de Piso también ofrece una opción "Todos los pisos" que muestra cada mesa en una vista combinada.
Editor de Plano de Piso
El editor de Plano de Piso se representa en un lienzo de 1200 por 720 con una cuadrícula de 10 píxeles. Las mesas aparecen como formas en sus posiciones almacenadas. El editor admite dos modos de visualización:
| Modo | Úsalo para |
|---|---|
| 2D | Edición y organización. Arrastra mesas, añade o elimina, renombra. |
| 3D | Presentaciones y recorridos. El lienzo se inclina usando perspectiva CSS para producir una vista dimétrica estilo arquitecto. El arrastre está deshabilitado en modo 3D porque el mapeo del puntero es ambiguo en un lienzo inclinado. |
Añadir y Posicionar Mesas
- Abre Cafetería > Plano de Piso.
- Elige el piso objetivo de las opciones de piso en la parte superior.
- Haz clic en Añadir Mesa. Aparece una nueva mesa en el origen del lienzo con forma, tamaño y número de asientos predeterminados.
- Arrastra el cuerpo de la mesa a la posición deseada. La posición se guarda automáticamente cuando sueltas el botón del ratón.
- Repite para cada grupo de asientos.
Las posiciones se ajustan a una cuadrícula de 10 píxeles para que las mesas alineadas se sientan ordenadas sin requerir una colocación perfecta al píxel.
Propiedades de la Mesa
Cada mesa tiene los siguientes campos editables:
| Campo | Significado |
|---|---|
| Código | Identificador corto impreso en el QR y visible para el personal. Debe ser único dentro de tu cafetería. |
| Nombre de Visualización | Etiqueta más larga mostrada al personal, por ejemplo "Ventana 3" o "Cabina A". |
| Número de Asientos | Número de asientos en la mesa. El predeterminado es 2. |
| Forma | Una de: cuadrado, rectángulo horizontal, rectángulo vertical, redondo. |
| Tamaño | Entero de 1 a 10. Controla el tamaño de representación en el editor y en la vista 3D. |
| Piso | El piso al que pertenece esta mesa. Las mesas pueden moverse entre pisos editando este campo. |
| Estado | idle, in_use, o out_of_order. |
Estados de la Mesa
| Estado | Significado |
|---|---|
| idle | Sin sesión activa. Ningún cliente puede hacer un pedido hasta que se le asigne un asiento. |
| in_use | Un código de seguridad está activo. El cliente puede escanear el QR y hacer un pedido. |
| out_of_order | La mesa no está disponible. Aparece atenuada en el plano de piso y la página QR muestra un aviso de no disponible. Útil para mantenimiento o reparación de muebles. |
Asignar un Cliente
Para aceptar pedidos desde una mesa, el personal debe asignar un asiento al cliente. Asignar emite un código de seguridad y mueve la mesa al estado in_use.
- En la página de Mesas o desde el menú de acciones del Plano de Piso, selecciona la mesa.
- Haz clic en Asignar Cliente (también etiquetado como "Abrir Mesa").
- El sistema genera un código de seguridad de 6 dígitos y lo muestra.
- Entrega el código al cliente. Ellos lo ingresan después de escanear el QR.
El código se muestra en texto plano solo en el momento de la generación, y cuando un administrador abre el diálogo Mostrar Código para una mesa ya asignada. Se cifra en el servidor. El código expira después de una duración predeterminada y puede rotarse o restablecerse en cualquier momento.
Mostrar y Rotar el Código
- Mostrar Código. Muestra el código en texto plano actualmente almacenado para la mesa abierta. Útil cuando el cliente no captó el número la primera vez. Esta acción no rota el código y no invalida el QR anterior.
- Rotar QR. Genera un nuevo token QR para la mesa. La pegatina QR anterior se vuelve inválida. Usa esto cuando reimprimes la pegatina o cuando sospechas que el QR antiguo se ha compartido externamente.
Cerrar una Mesa
Cuando un cliente se va sin una cuenta pendiente, haz clic en Cerrar Mesa. El código de seguridad expira inmediatamente, la mesa vuelve a idle, y cualquier intento de escaneo posterior requiere una nueva asignación.
Si hay pedidos no pagados en la mesa, usa Liquidar Cuenta en su lugar. La liquidación cierra todos los pedidos abiertos con un método de pago elegido y luego devuelve la mesa a idle. Consulta la página de Pedidos para el flujo de liquidación.
Códigos QR
Cada mesa tiene un código QR que codifica la URL handy.cafe/{cafe-slug}/{table-code}. Un parámetro de consulta lleva el token QR que prueba que la pegatina es auténtica. Cuando el cliente escanea el QR:
- La página del menú resuelve el slug y el código de mesa contra la API en la nube.
- Si la mesa está en estado
in_use, se le pide al cliente el código de seguridad de 6 dígitos. - En una verificación exitosa, se emite un token de sesión y se almacena en una cookie y un token Bearer de respaldo. El respaldo Bearer existe porque iPhone Safari puede bloquear cookies de terceros en algunas configuraciones.
Genera el QR imprimible desde la página de Mesas. Cada mesa tiene una vista previa del QR que puedes guardar como SVG o PNG. Reimprime las pegatinas cada vez que rotas el token QR o cambias el slug.
Consejos para Diseñar un Plano de Piso
- Comienza mapeando el diseño real en el lienzo. Coloca la entrada cerca de un borde y trabaja hacia adentro. Esto facilita que el personal se oriente.
- Agrupa mesas por piso incluso si tu local tiene solo un nivel. "Salón" y "Terraza" como pisos separados te permite filtrar el panel de pedidos por área.
- Usa valores de Tamaño más grandes para cabinas que acomoden a cuatro o más personas y valores más pequeños para taburetes de barra.
- Marca las mesas como
out_of_ordercuando los muebles necesiten reparación para que los clientes no puedan hacer pedidos en ellas. No elimines el registro de la mesa a menos que el asiento se haya ido permanentemente.