Painel de salão

Painel de salão — posto de trabalho do hostess e do gerente dentro do Caixa. Abre com o botão «Salão» (🗺) no Caixa (POS) e expande em tela cheia. Há duas condições para a visibilidade do botão. A primeira é o papel: é preciso ter permissão de gerenciamento do salão; o Garçom que fez login no Caixa por PIN não verá o botão. A segunda é o interruptor «Chip do painel de salão» em «Aparência do POS»: para food service e hotel ele vem ativado por padrão, e para tipos de estabelecimento não restaurante (loja, salão de beleza, ponto de retirada, loja virtual, serviços, site institucional, blog, widgets) o painel vem desativado por padrão — ative o interruptor se ainda precisar dele. No próprio botão há um badge: quantas Reservas aguardam confirmação (as mesmas solicitações que aparecem na lista da aba «Reservas») e quantos chamados ativos existem.

O painel abre na aba «Reservas»; as demais abas são alternadas no cabeçalho. Pedidos, chamados e Reservas chegam por websocket — não é preciso atualizá-los manualmente. A lista de espera, «Dia» e «Tarefas» são lidos uma vez ao abrir o painel: são listas que mudam com menos frequência e não precisam de assinatura ao vivo.

O painel lembra que está aberto. Enquanto ele está na tela, o endereço do Caixa contém ?panel=hall, então atualizar a página (F5) mantém você no painel, em vez de voltar ao Caixa; após a atualização, o painel abre na aba padrão. O botão «Voltar» do navegador fecha o painel e retorna ao Caixa, e a partir do Caixa — abre o painel de novo: por exemplo, você acomodou um Hóspede em uma Mesa, aceitou o Pedido e com um clique voltou ao salão. Fechar o painel também continua sendo possível pelo ✕. O link do Caixa com o painel aberto pode ser adicionado aos favoritos: o painel só abrirá se o funcionário no Caixa puder ver o botão «Salão» (as mesmas duas condições acima).

No cabeçalho do painel há uma engrenagem de configurações — por ela abrem-se as configurações do layout do salão (inclusive as políticas de depósito de Reservas) e do widget de Reserva online.

«Agora»#

Uma tela com o estado do estabelecimento no minuto atual. Em blocos:

Clicar no bloco destaca os objetos correspondentes diretamente no layout do salão — é aí que está a diferença entre um dashboard e uma lista de números. Em uma Unidade com vários salões, há um seletor de salões acima do layout.

Blocos vazios são ocultados: em um café pequeno sem hotel e sem tarefas, a aba parece viva, e não uma tabela de zeros. Se está tudo tranquilo — é o que está escrito.

«Espera» — lista de espera#

Fila de Hóspedes para os quais não havia Mesa livre.

Registro na lista: nome, telefone, tamanho da companhia, quantos minutos prometeram esperar, comentário. O telefone é discado no mesmo formato de país usado nas Reservas, e o botão «Ligar» na linha da fila mostra o Número da mesma forma. Por padrão, são preenchidos companhia de duas pessoas e 15 minutos de espera.

Status: na fila → convidado → acomodado; terminais — não compareceu e removido (saiu por conta própria). Após o convite, corre um temporizador de não comparecimento de 10 minutos: a linha atrasada fica destacada em vermelho. Na linha há «Não compareceu», «Voltar para a fila» (remove o temporizador) e «Remover». Registros fechados não atrapalham na lista geral — eles são mostrados pelo interruptor «Histórico»; ficam armazenados por 12 horas, e no total por Unidade — até 200 registros.

Como convidar. São exatamente dois canais, e ambos são reais:

• Ligação — link tel: direto da linha, não é preciso configurar nada;
• Telegram — o botão aparece somente se o Hóspede já tiver uma conversa com o bot telegram dessa Unidade. O Telegram não permite que o bot escreva primeiro: enquanto o Hóspede não iniciar o diálogo, o chat simplesmente não existe. Não há simulações que pareçam funcionar aqui.

SMS e WhatsApp ainda não são suportados na lista de espera.

Acomodação. Quando uma Mesa fica livre, o painel sugere a companhia adequada: entre as que ainda estão na fila e cabem nessa Mesa, escolhe-se aquela para a qual sobrarão menos lugares vazios e, em caso de empate, a mais antiga. A dica aparece na aba «Agora» (e dura 10 minutos) — ou seja, quem vê é quem tem exatamente essa tela aberta. Na própria aba «Espera», para a companhia selecionada destaca-se a menor Mesa adequada. A acomodação cria uma Reserva comum e passa a Mesa para o Caixa — pelo mesmo caminho que a acomodação de uma Reserva a partir do layout.

O contador de pessoas em espera aparece na própria aba — o número ao lado do nome.

«Sala», «Reservas», «Chamados»#

Sala — planta viva do salão. Status das mesas: livre, ocupada, reservada; sobre eles, dois ícones-marcadores — 🔔 chamado de garçom e ✓ pedido pronto. O garçom vinculado à mesa aparece na própria planta — um círculo na cor dele com as iniciais no canto superior direito da mesa; passe o cursor sobre ele (no tablet — toque) e surge uma dica com o nome. Os garçons também aparecem assim na planta da aba «Agora». Um toque em uma mesa ocupada ou reservada abre o cartão: iniciar ou abrir pedido (com a lista dos pedidos já abertos da mesa — número, horário, valor), acomodar a reserva, vincular garçom à mesa (ou trocar/remover). Se houver várias reservas para a mesa hoje, o cartão mostra todas em lista por horário — a mais próxima primeiro, e é ela que o botão «Atender» oferece; na própria planta, o selo da mesa traz a reserva mais próxima e «+N», quantas mais há hoje. «Hoje» para a planta vai até o fim do dia e, a partir das 06:00, também abrange a noite até as 06:00 da manhã: uma reserva para 01:00 ou 04:00, criada à noite, aparece na sua mesa na hora — e também depois de transferida para outra mesa —, não só depois da meia-noite. Reservas de dias seguintes a planta não desenha, elas ficam na aba «Reservas». Um toque em uma mesa livre não abre o cartão — ele apenas envia a mesa para o caixa, para lançar o pedido direto. Trocar ou remover o garçom de uma mesa livre continua sendo possível: toque no ícone-círculo dele na mesa — abre-se o mesmo cartão já com a lista de garçons (ao lado — «Iniciar pedido»); o ícone funciona da mesma forma em uma mesa ocupada. Se a planta do salão ainda não foi desenhada, a aba mostra uma tela vazia com um link para o editor de planta. No hotel, o quarto na planta não é uma mesa: no cartão dele, em vez de «acomodar», há o botão «🛏️ Fazer check-in», que leva à janela de check-in do quarto na «Planta do salão» (conta do hóspede, status do quarto, cadastro do hóspede — mais detalhes em Reservas), e o quarto não tem a linha «garçom» — o quarto não é atendido por um garçom. Considera-se quarto o quarto ou a cama em um estabelecimento do tipo «Hotel»; em outros estabelecimentos, o «Quarto» na planta é um lugar comum, como uma mesa.

Reservas — as mesmas reservas da página da planta do salão, mas em formato de caixa: criação, edição, confirmação, vinculação de mesa, acomodação, conclusão, «não compareceu», cancelamento, abertura da conta de uma reserva acomodada e exibição das passadas. Na linha da reserva vê-se a janela em que a mesa fica reservada para o hóspede — por exemplo, «Hoje 11:00–13:00». O botão «✏️ Editar» abre o formulário ali mesmo na linha: é possível transferir data e horário, estender ou encurtar a reserva, mudar o número de hóspedes, a mesa, o nome, o telefone e o comentário. Se a mesa já estiver ocupada no novo horário, não será possível salvar; se a mesa tiver sido ocupada de outra tela no mesmo segundo e o servidor recusar, a linha volta aos valores anteriores e o painel informa que as alterações não foram salvas. O hóspede que deixou e-mail recebe uma mensagem sobre a transferência quando o horário muda. Vê-se de onde a reserva veio — do hóspede ou do painel administrativo —, e a ocupação aparece no próprio formulário: no horário escolhido, a mesa ocupada fica marcada como «· Ocupada» e não pode ser selecionada; em caso de sobreposição, o painel avisa «conflita com outra reserva para esta mesa» e não deixa criar; e quando todas as mesas estão ocupadas nessa janela, ele escreve «Não há mesas livres» (ainda assim é possível criar uma reserva sem mesa: a mesa será atribuída manualmente). O formulário não aceita horário que já passou. O campo de telefone do hóspede grava o número no formato em que ele é escrito no país da unidade — «+7 (912) 575-19-38»: o agrupamento é inserido automaticamente durante a digitação e, no campo vazio, aparece um exemplo de número do país. O número é exibido da mesma forma na linha da reserva e no cartão da mesa na planta. Nenhum dígito é alterado, e registros como «ramal 101» ou dois números separados por vírgula permanecem como digitados. Reservas não confirmadas aparecem como um número na aba — são exatamente as solicitações da lista. Uma solicitação cujo horário passou e que não foi confirmada sai da lista (ela aparece em «Mostrar passadas») e deixa de contar no número. Transferir o horário não cria uma nova reserva: altera-se o mesmo registro. No hotel, quartos e camas não são oferecidos no formulário de reserva nem na transferência — o quarto é reservado por diárias, no quadro de ocupação (Hotel); em uma reserva que já está em um quarto, em vez de «Acomodar» há «🛏️ Fazer check-in»: o botão abre na «Planta do salão» a janela padrão de check-in com o hóspede da reserva, em vez de apenas mudar o status.

Remoção automática em caso de não comparecimento. O botão «⏱ Remoção automática» no cabeçalho da aba abre a configuração ali mesmo: a caixa «Remover reserva se o hóspede não comparecer» e o prazo de espera após o início da reserva — de 5 a 240 minutos, padrão 15. Por padrão, o automático fica desligado: atrasar-se não é o mesmo que não comparecer, e remover a reserva de um hóspede real custa mais caro do que uma mesa vazia. Quando ele está ligado, a reserva confirmada mostra na linha uma contagem regressiva «⏱ será removida em N min» e, ao fim do prazo, a reserva vai para «não compareceu», a mesa fica livre de novo e o painel mostra um toast com o número da mesa. As reservas removidas pela máquina aparecem em «Mostrar passadas» com a marca «🤖 removida automaticamente». A remoção automática funciona mesmo com o caixa fechado — o servidor alcança as reservas vencidas. O que o automático não faz: não mexe em reservas com mais de um dia, não toca em hóspedes já acomodados nem em solicitações não aceitas e nunca remove uma reserva com depósito pago — essa é encerrada pelo funcionário com o botão «Não compareceram», porque, junto com o status, decide-se o destino do dinheiro do hóspede. Esse mesmo par de configurações existe no bloco «Jornada do hóspede» do log de registros: a regra é comum ao estabelecimento. Mais detalhes — Reservas de mesas.

Chamados — chamados de garçom que o hóspede envia pelo menu QR (ver Pedidos). Na linha — a mesa e há quantos minutos chamou (o hóspede não indica o motivo), ao lado o botão «Aceito» e o botão geral de som. Um chamado não aceito expira sozinho após 10 minutos. A mesma campainha é duplicada na seção «Pedidos».

«Dia» e «Tarefas»#

Dia — quem está no turno agora: o plano versus realizado de hoje por funcionário, dividido em «no turno», «em intervalo», «turno não fechado», «previstos», «encerraram» e «fora da escala», com atrasos e minutos efetivamente trabalhados. É também daqui que se registra a entrada e a saída pelo terminal de caixa compartilhado: o proprietário e o gerente registram qualquer pessoa sem PIN, os demais com o próprio PIN.

Um funcionário pode ter apenas um turno aberto, por isso uma saída esquecida (turno aberto há mais de 20 horas) é levada para o grupo «Turno não fechado»: a linha informa o dia do turno e, ao lado, o botão «Saiu», que o fecha. Enquanto o turno estiver pendente, o servidor não aceitará a entrada desse funcionário — e a aba dirá isso com palavras, com a data do turno pendente, e não com um erro genérico. Também é possível fechar um turno do mês passado que não aparece na lista da aba: o próprio botão será oferecido na recusa. Na vertical de hotelaria, um bloco de solicitações de hóspedes é adicionado à aba — a solicitação avança pela cadeia «aberta → em andamento → concluída» com um único botão.

Tarefas — versão compacta do quadro de tarefas do turno: adição rápida (já com prioridade), grupos «aberto / em andamento / concluído», marcação de conclusão e exclusão. O kanban completo com tags e prazos fica em uma página separada, cujo link está na própria aba. O número de tarefas abertas aparece na aba.

«Análise» — mapa de calor do salão#

Quais metros quadrados dão dinheiro. No topo, quatro indicadores do dia (faturamento, pedidos, ticket médio e quantas mesas estiveram ocupadas); abaixo deles, a planta do salão, colorida conforme a grandeza escolhida: faturamento, pedidos, ticket médio ou tempo de ocupação. Um toque na mesa abre um cartão com esses mesmos quatro números dela; em uma unidade com vários salões, colore-se o salão ativo, mas o cálculo abrange toda a unidade.

Duas limitações honestas:

• considera-se apenas o dia de hoje (dia civil, e não as últimas 24 horas) — a aba funciona com o cache de pedidos ao vivo, não há um backend separado por trás dela; períodos (semana, mês, faturamento por lugar) ainda não são suportados;
• mesa sem QR code vinculado é «sem dados», e não «faturamento zero»: os pedidos são vinculados à mesa por meio do código, e para uma mesa sem código não se pode fazer nenhuma afirmação sobre faturamento.

O que é necessário para começar#

• Acesso ao caixa. O Painel do salão não é um item separado da barra lateral: ele é aberto pelo botão «Salão» (🗺) dentro do Caixa (POS).
• Planta do salão desenhada — salões e mesas são criados na seção Planta do salão; o painel apenas os exibe.
• QR codes vinculados às mesas — sem o vínculo, a aba «Chamadas» ficará vazia e os pedidos não serão associados às mesas.
• Reservas ativadas — para a aba «Reservas» e as políticas de depósito (Reservas de mesas).
• Pedidos acumulados por mesa — o mapa de calor de faturamento e ticket médio é construído com base neles; com histórico vazio, ele fica vazio.

Limitações#

• O painel vive dentro do caixa — ele não tem endereço próprio nem item de menu.
• As atualizações chegam por websocket. Sem conexão, as abas não se atualizam sozinhas — os dados terão de ser atualizados manualmente.
• Não há linha do tempo de reservas por mesa nem motor de grade de lugares: os conflitos são visíveis, mas não há alocação automática.
• Não há status «hóspede chegou» nem lembretes automáticos N horas antes da reserva.
• O cancelamento automático da reserva em caso de não comparecimento vem desativado por padrão e é ativado pelo estabelecimento: «atrasou» ainda não é «não virá». Uma reserva com depósito pago nunca é cancelada pelo automático.
• A análise do salão calcula por mesa — pedidos para viagem e entrega o mapa de calor não mostra por definição.

Solução de problemas#

O botão «Salão» não aparece no caixa. A seção de mesas está desativada para o seu tipo de estabelecimento — ative-a na loja de aplicativos.

A aba «Chamadas» está vazia, embora os hóspedes chamem o garçom. Isso significa que o QR code não está vinculado à mesa: escaneie novamente o código da mesa desejada e o vínculo será transferido.

Não há mesas na planta. Verifique se o salão correto está selecionado — as mesas pertencem a um salão específico.

As reservas não aparecem. As reservas estão desativadas na unidade ou você está vendo outra unidade. Além disso, na planta só aparecem as reservas de hoje (à noite, também as da madrugada até 06:00): procure a reserva do dia seguinte na aba «Reservas».

O mapa de calor está vazio. Não há pedidos vinculados às mesas no período selecionado.

Seções relacionadas#

• Caixa (POS) — de onde o painel é aberto
• Planta do salão — editor da planta e vínculo dos QR codes das mesas
• Reservas de mesas — reservas, depósitos, status
• Pedidos — chamada do garçom e seu percurso
• Quadro de tarefas do turno — versão completa do quadro

Perguntas frequentes#

Qual é a diferença entre o Painel de salão e a seção «Planta do salão»?#

A «Planta do salão» é o editor: nele você desenha as mesas, os salões e vincula os QR codes a elas. O Painel de salão é o trabalho com base nessa planta ao longo do turno: acomodações, fila, chamadas, análise. Lista de espera e mapa de calor não existem na página do editor.

O hóspede pode entrar sozinho na lista de espera?#

Na lista de espera do Painel de salão — não: nessa fila o hóspede é colocado pelo hostess, que o convida por chamada ou mensagem. Mas na reserva online, quando o horário desejado já está ocupado, o hóspede pode tocar em «Avisar se vagar» — essas solicitações ficam no circuito de reservas e chegam ao hóspede automaticamente quando a janela vagar. Veja Reservas de mesas.

Por que a mesa aparece vazia na análise?#

Não há QR code vinculado à mesa. Os pedidos são associados à mesa justamente por meio do código, por isso sem ele não há dados da mesa — e o painel mostra honestamente «sem dados», e não zero.

É possível abrir o painel em um tablet separado na entrada?#

Sim — é parte do aplicativo de caixa, basta abrir o caixa no tablet do hostess e manter o painel expandido. Considere apenas as permissões: o botão «Salão» aparece para os papéis com acesso ao gerenciamento do salão, portanto o tablet deve funcionar com a conta do hostess ou do gerente, e não do garçom. E verifique o botão «Chip do painel de salão» em «Aparência do POS» — em tipos de estabelecimento não restaurantes ele vem desligado por padrão.

As chamadas de garçom são duplicadas em «Pedidos»?#

Sim, é o mesmo sinal: a campainha na seção «Pedidos» e a aba «Chamadas» mostram as mesmas chamadas ativas.