> ## Documentation Index
> Fetch the complete documentation index at: https://docs.laportenard.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Mesa bloqueada

> Qué pasa cuando otra terminal tiene la mesa.

<Note>
  **Rol:** Cualquiera la ve. Solo `Gerente` puede usar `Tomar Control` para forzar la liberación.
</Note>

Solo una terminal a la vez puede editar una mesa. Si otra ya la tiene abierta, en tu plano la mesa aparece **bloqueada** — no puedes tocarla hasta que la otra terminal la libere. Es para evitar que dos meseros pisen los cambios uno del otro.

<Frame />

## Cómo se ve una mesa bloqueada

Una mesa que otra terminal está editando aparece:

* En color **ámbar** (en lugar de verde libre o naranja ocupada).
* Con el nombre del usuario que la tiene mostrado en la mesa.
* Si la tocas, vas a ver el aviso `Mesa Bloqueada` con el subtexto `La mesa [N] está siendo editada por [Usuario]`.

El bloqueo se libera automáticamente cuando esa terminal cierra la mesa — vuelves a verla disponible (verde) o ocupada (naranja).

## Qué hacer cuando encuentras una mesa bloqueada

<Steps>
  <Step title="Espera unos segundos">
    Si el otro mesero está terminando de editarla, el bloqueo se quita rápido. Refresca o vuelve a tocar la mesa para confirmar.
  </Step>

  <Step title="Pídele que libere la mesa">
    Si sabes quién está editando (el nombre aparece en la mesa), búscalo y pídele que cierre/salga.
  </Step>

  <Step title="Si es urgente, llama al gerente">
    Solo el gerente puede forzar el desbloqueo con `Tomar Control`.
  </Step>
</Steps>

## Tomar control (solo gerente)

Cuando una terminal queda colgada con una mesa bloqueada (alguien la dejó abierta y no responde, se quedó sin batería, perdió conexión), el gerente puede recuperarla.

<Steps>
  <Step title="Toca la mesa bloqueada">
    Aparece el aviso `Mesa Bloqueada` con dos botones: `OK` (cancelar) y `Tomar Control`.
  </Step>

  <Step title="Toca `Tomar Control`">
    Sirvo POS desconecta la otra terminal de esa mesa y te la transfiere.
  </Step>

  <Step title="Confirmación">
    La otra terminal va a ver el aviso `Mesa tomada` con el mensaje `Un gerente ha tomado el control de esta mesa` y se le quita acceso.
  </Step>
</Steps>

<Tip>
  `Tomar Control` queda registrado en la bitácora con el nombre del gerente, la mesa y la hora. Úsalo solo cuando sea necesario, no como atajo de rutina.
</Tip>

## Por qué existe el bloqueo

Sin el bloqueo, dos meseros podrían:

* Agregar items al mismo tiempo y duplicar pedidos en cocina.
* Anular un ítem que el otro acabó de cobrar.
* Pisar los cambios uno del otro al sincronizar.

El bloqueo evita esos conflictos haciendo que solo una terminal sea dueña de la mesa en cada momento.

## Comportamiento offline

Si tu terminal pierde conexión mientras estás editando una mesa, otras terminales SÍ pueden tomar la mesa después de un período de gracia (por defecto unos segundos). Cuando recuperes conexión, vas a ver un aviso de que la mesa fue tomada por otro y vas a perder tus cambios no enviados.

Por eso, **si vas a salir del local con la app abierta, cierra la mesa antes** para no quedar reteniéndola.

## Errores comunes

* **`Mesa Bloqueada` aparece pero no veo quién la tiene** — la otra terminal puede haber perdido conexión sin avisar al hub. Espera el período de gracia (≈ 45 segundos) y vuelve a intentar; el bloqueo debería liberarse solo.
* **Toqué `Tomar Control` pero no pasó nada** — tu rol no es gerente, o la conexión al hub falló. Confirma con un mensaje de error.
* **Veo la mesa libre pero al tocarla aparece bloqueada** — el indicador del plano puede tener segundos de retraso. Toca de nuevo o refresca.

## Relacionado

* [Plano de mesas](/user-guide/plano-mesas) — colores y estados de las mesas.
* [Sincronización](/user-guide/sincronizacion) — qué pasa cuando una terminal se desconecta.