Documentación técnica

Cómo funciona Mantel por dentro

Mantel es un solo sistema en vivo: lo que pasa en el punto de venta sube al servidor y de ahí baja al momento a cocina, a la comandera y a las demás cajas de esa sucursal. Si la red falla, nada se pierde ni se duplica: cada cambio queda guardado en el dispositivo y se pone al día solo al volver la conexión. Lo usas en nuestra nube o en tu propio servidor, con la información de tu negocio separada de la de cualquier otro.

Cómo funciona

Arquitectura

Mantel es un sistema híbrido. El piso del restaurante (punto de venta, pantallas de cocina, comandera y kiosko) funciona en el navegador; el punto de venta y cocina además mantienen una copia local en el equipo y pueden operar sin internet. Detrás, el servidor guarda la información oficial, y la misma aplicación corre tanto en nuestra nube como en una instalación en el servidor del propio cliente.

El punto de venta y cocina leen y escriben primero contra su copia local, así que la venta no depende de una ida y vuelta al servidor. Por un canal suben los cambios pendientes de forma confiable y sin duplicarlos; por el otro bajan los cambios en vivo, separados por sucursal. Son canales independientes: si la conexión en vivo se cae, la venta sigue.

Piso (en el navegador)

  • El punto de venta, las pantallas de cocina, la comandera y el kiosko funcionan en el navegador
  • Una sucursal puede tener varias cajas, kioskos y comanderas a la vez sobre la misma operación, cada dispositivo con su propio registro
  • El punto de venta y las pantallas de cocina guardan una copia local del catálogo y la configuración en el propio equipo
  • Cuando no hay internet, esos equipos guardan sus cambios en una fila de espera local
  • Su sesión queda activa para poder seguir operando sin conexión

Servidor (nube o tu servidor)

  • El servidor central guarda la información oficial, aislada por negocio
  • La misma aplicación funciona en nuestra nube o en el servidor del propio cliente
  • Refleja los cambios en vivo, en el momento, separados por sucursal
  • Cada negocio queda aislado: un negocio nunca ve los datos de otro

Sobre el rendimiento

El punto de venta opera contra su copia local: abrir una cuenta o cobrar no espera una ida y vuelta por internet, y mandar a cocina no lo bloquea (sin conexión, el cambio queda en la fila de espera local hasta reconectar). El servidor enruta los avisos en vivo y guarda el registro oficial, además de los reportes, el consolidado entre sucursales y los respaldos. No publicamos cifras de velocidad porque dependen del equipo y la red de cada instalación.

De un local a una cadena

Cada local tiene su propio servidor, y todos se conectan al mismo central: nuestra nube o un central tuyo. El inventario es de cada restaurante —sus existencias, sus movimientos, sus conteos—, mientras el menú y las recetas de cadena se administran una sola vez y bajan a todas las sucursales, con ajustes por local. Dentro de cada local conviven varias cajas, kioskos y comanderas sobre la misma operación. Y para quien compra centralizado, el CEDIS —pedidos y distribución— es la pieza que viene en camino.

Sin conexión

Nada se pierde ni se duplica

Esta es la mitad del sistema que aguanta los cortes de red. El punto de venta guarda cada cambio en el propio dispositivo: sigue tomando órdenes y cobrando aunque la conexión se caiga. En cuanto vuelve a ver a tu servidor, todo lo pendiente sube en orden, sin perder ni duplicar nada. Es el mismo flujo en vivo: esta subida garantiza; la bajada, el tiempo real, lo refleja en las pantallas.

Un solo sentido: del dispositivo hacia la base de datos. Los cambios pendientes se suben en grupo y reintentarlos es seguro: cada uno se aplica una sola vez o se reconoce como ya recibido. Nunca gana «el último que escribió» ni se sobrescriben ventas.

  1. 01

    Se guarda en el dispositivo

    Cada acción del punto de venta (abrir una cuenta, agregar un platillo, cobrar) se guarda primero en el propio dispositivo. La pantalla responde al instante y la venta no se detiene aunque no haya red.

  2. 02

    Se sube cuando hay conexión

    En cuanto el dispositivo vuelve a ver a tu servidor, los cambios pendientes suben en orden. Si la conexión se corta a medias, el envío se reintenta solo, sin perder nada.

  3. 03

    Nunca se duplica

    El servidor reconoce cada cambio por su identificador único: reenviar lo pendiente nunca cobra dos veces ni duplica una orden. La garantía es la misma con tu servidor en el local o en la nube.

  4. 04

    Todo queda enlazado

    Cuando una orden creada sin conexión se confirma en el servidor, el dispositivo la enlaza con su registro definitivo y con todo lo que se le agregó mientras estaba sin red.

El mismo sistema, dos mitades

Esta página describe la mitad que garantiza: nada se pierde ni se duplica cuando la red falla. La otra mitad es el tiempo real: el mismo cambio, ya guardado, baja del servidor a cocina, a la comandera y a las pantallas de la sucursal, al momento. Y la red que importa es la que te conecta con tu servidor: si está en tu local, el internet puede caerse y el piso completo sigue; si está en la nube, el punto de venta sigue cobrando sin internet y, al volver la conexión, cocina recibe de golpe lo pendiente y lo que cocina marcó sin red sube igual, sin perderse ni duplicarse.

Garantías

sin perder · sin duplicar
  • Las ventas no se pierden: quedan guardadas en el dispositivo hasta que el servidor confirma que las recibió.
  • Cada acción se aplica una sola vez, aunque se reintente: nunca se cobra ni se registra dos veces.
  • Si un cambio falla repetidamente, se marca para revisarlo y se sigue reintentando, sin frenar el resto de las ventas pendientes.

En vivo

Tiempo real

La otra mitad del mismo flujo: lo que la subida guarda, esta bajada lo refleja. Cuando alguien envía una comanda, cambia una mesa o ajusta un precio del menú, el servidor avisa al momento a las pantallas de esa sucursal: la comanda aparece en cocina, la cuenta se actualiza en la comandera de la mesa y el punto de venta se refresca sin recargar. Y desde fuera del local, cuando entras al panel ves el estado actual de tu operación, desde cualquier lugar.

El aviso no transporta los datos: avisa. Cada pantalla, al recibirlo, vuelve a pedir la información por HTTP y se pone al día. Por eso un aviso que no llega no pierde nada: el siguiente refresco trae el estado completo.

Qué se actualiza en vivo, por sucursal

Cambios del piso

órdenes · mesas · caja · menú · config

Cuando cambia una orden, una mesa, la caja, un precio o platillo del menú, una configuración o una reservación, el aviso llega al punto de venta y a la comandera de esa sucursal: el piso de mesas, la caja, el menú, los tickets y las reservas se refrescan solos, sin recargar.

Pantallas de cocina

comandas · estaciones

Al enviar a cocina, modificar un platillo o marcarlo listo, la comanda aparece o se actualiza al instante en las pantallas de cocina de esa sucursal, sin esperar.

Cómo se comporta

Cada sucursal solo ve lo suyo

Cada pantalla recibe únicamente los cambios de su propia sucursal. Un negocio o una sucursal nunca recibe el movimiento de otro.

El acceso lo define la sesión, no la pantalla

A qué sucursal se conecta cada pantalla se determina por la sesión que ya tiene permiso para esa sucursal, no por algo que la pantalla pueda pedir por su cuenta. Si no hay un acceso válido, la conexión se rechaza.

Refleja, no transporta

La venta viaja y se guarda por la subida, con sus propias garantías; el aviso en vivo solo refleja ese cambio en pantalla. Dos mitades del mismo sistema: si un aviso se pierde, el siguiente refresco trae el estado completo.

Si se interrumpe, no se detiene

La conexión en vivo suma, no es indispensable. Si se cae, las pantallas de cocina siguen refrescándose solas cada pocos segundos, la venta sigue guardándose por la subida y la conexión se restablece en cuanto puede.

Cada negocio queda aislado

La conexión en vivo se valida al abrirse y queda confinada a la sucursal autorizada. No hay forma de asomarse a la sucursal de otro negocio. Y como la bajada solo refleja, si se interrumpe la operación sigue su curso: la venta ya quedó garantizada por la subida y, al reconectar, las pantallas se ponen al día solas.

Datos

Aislamiento por negocio

La garantía es la misma en cualquier modalidad: los datos de un negocio nunca llegan a otro. Lo que cambia es cómo se logra ese aislamiento según dónde corra la plataforma.

Una plataforma · un carril por negocio

negocio-aaislado
negocio-baislado
negocio-caislado
Varios negocios conviven en la misma plataforma, pero cada uno opera en su propio carril: ninguna consulta cruza al carril de junto.
Nube

En la nube: aislamiento lógico

Varios negocios conviven en la misma plataforma, pero cada consulta queda acotada al negocio que la origina. La plataforma toma esa identidad de la sesión activa, no de lo que envíe quien hace la petición, y la aplica en todo lo que se lee y se guarda. Si una petición intenta tocar a otro negocio, se rechaza.

consultaacotada al negocio de la sesiónsolo tus datos
Tu servidor

En tu propio servidor: aislamiento físico

Cada cliente corre su propia instalación de la plataforma, con sus propios datos en su infraestructura. No hay convivencia con otros negocios: la separación es física, a nivel de servidor.

La misma garantía de acotar todo al negocio sigue presente, así que la confidencialidad se mantiene aunque en la práctica solo viva un negocio por instalación.

La protección de credenciales y el registro de acciones clave se detallan en Seguridad.

Ediciones

Edición: nube o tu propio servidor

Mantel se ofrece en dos ediciones de la misma aplicación. Lo que cambia es quién opera la infraestructura, no lo que hace el producto.

una sola aplicación · mismo código
Nube

En nuestra nube

Nosotros operamos los servidores, los respaldos y las actualizaciones. Tú entras desde el navegador y trabajas; no administras nada.

  • Listo para usar, sin instalar
  • Respaldos y actualizaciones por nuestra cuenta
  • Cada negocio aislado de los demás
Tu servidor

En tu propio servidor

La misma aplicación corre en tu infraestructura, pensada para empresas con su propio equipo de TI. Tus datos no salen de tu servidor.

  • Tus datos en tu propia infraestructura
  • Se entrega lista para instalar, con un asistente de primer uso
  • La operación y los respaldos corren por cuenta de tu equipo

Cada edición se entrega como tal: la edición en tu propio servidor es un paquete dedicado, instalado en tu infraestructura. No es un modo que se prenda o apague, y una instalación en tu servidor no se convierte en nuestra nube.

En cualquier edición, las apps del piso se conectan solas al servidor correcto —el de nuestra nube o el tuyo—, sin que tengas que configurar direcciones IP.

Controles

Seguridad

Los controles de seguridad de Mantel son los mismos sin importar dónde corra: en la nube o en el servidor del propio cliente. Lo que cambia entre una y otra opción es dónde viven tus datos y quién opera la infraestructura; el resto es idéntico. Listamos solo lo que el producto hace hoy.

hash

Contraseñas protegidas

Las contraseñas nunca se guardan tal cual: se almacenan protegidas de forma que no se pueden leer ni recuperar. Aplica igual en la nube y en tu propio servidor.

roles · sesiones

Accesos por permiso

Cada persona entra con su propia identidad y solo accede a lo que su rol permite. Las sesiones caducan, y los accesos de propósito acotado no sirven para entrar a todo lo demás.

rate-limit

Protección ante intentos fallidos

Si alguien intenta adivinar una contraseña o un PIN una y otra vez, el sistema lo bloquea de forma temporal y automática. Un atacante bloqueado ni siquiera llega a probar la contraseña.

cifradas

Credenciales de cada negocio, resguardadas

Las credenciales de los servicios que conecta cada cliente —el timbrado CFDI vía Facturapi, la pasarela de cobro— se guardan cifradas y se usan únicamente para las operaciones de ese mismo negocio.

aislamiento

Cada negocio, aislado

La información de cada negocio queda separada de la de los demás, y esa separación no se puede saltar desde la aplicación. Un negocio nunca ve los datos de otro.

solo-agregar

Registro de acciones clave

Las acciones importantes quedan registradas (quién, cuándo y sobre qué) en una bitácora que solo admite agregar, no editar ni borrar. Cada negocio ve únicamente la suya, con la retención que decida.

Dónde viven tus datos

El aislamiento entre negocios rige en las dos opciones. La diferencia es dónde reside la información.

Nube

En la nube

Los datos de tu negocio viven en la infraestructura de Mantel, aislados del resto de los negocios. Nosotros operamos los respaldos y la disponibilidad; tú no administras servidores.

Tu servidor

En tu propio servidor

Cada cliente corre su propia instancia con su propia información: los datos no salen de tu infraestructura. Tú administras el servidor, los respaldos y la red; nosotros entregamos la aplicación y sus actualizaciones.

Datos cifrados al viajar

cifrado en tránsito

Todas las apps (punto de venta, pantallas de cocina, comandera, kiosko y panel) se comunican de forma cifrada, de modo que la información viaja protegida por internet. Y solo aceptan conexiones de orígenes autorizados: en la nube, los dominios de Mantel; en tu propio servidor, la red interna de tu negocio.

Contacto técnico

¿Preguntas técnicas?

Escríbenos desde el formulario de contacto y te ponemos en contacto con alguien del equipo que pueda resolver las dudas de tu área de ingeniería.

arquitectura · despliegue en tu propio servidor · evaluación del producto