🎵 Botões em cada item da fila
▶
Chamar — chama o cantor para o microfone. O item muda para 🎤 Cantando.
▶
Abrir Youtube — aparece somente na música em andamento (🎤 Cantando); abre uma nova janela com a busca karaoke + música no YouTube.
✓
Cantou — aparece quando o cantor está no microfone; marca como cantado e libera o próximo.
↑
Subir — avança o cantor uma posição na fila.
↓
Descer — recua o cantor uma posição na fila.
↡
Ir para o final — move o cantor direto para o fim da fila.
🔀
Rotação justa — botão no topo da fila. Liga um modo em que quem cantou menos vezes na noite vem primeiro, para ninguém monopolizar o microfone. Desligado, vale a ordem de inscrição (e cada pessoa só pode ter 1 música na fila por vez). Alterne quando quiser — seus ajustes manuais (↑↓↡) seguem valendo como desempate. Com a rotação justa ligada, você pode deixar cada pessoa enfileirar mais de uma música (deixar a próxima engatilhada): use o seletor 👤 ao lado do botão 🔀 para definir o limite por pessoa (ou "sem limite") — a rotação continua intercalando com justiça.
↻
Trocar música — abre o catálogo para escolher outra música para esse cantor.
✕
Remover — retira o cantor da fila.
⭐
Pontuação da plateia — o badge ⭐ N mostra os pontos que o cantor recebeu (👍👏🤘⭐🥇, 1 cada). Quem pontua é a plateia autenticada; o KJ só acompanha.
📱 Modo totem (tablet na mesa)
🔑
Senha do totem — ao abrir a sala você define uma segunda senha, só para totens. Ela vale apenas naquela noite: entregue aos garçons sem medo, porque a sua senha de KJ (que abre, chama, remove e vê os relatórios) continua só com você. Precisa ser diferente da senha do dia — a do dia todo cliente conhece.
📱
Montar o totem — no tablet, abra a sala e, onde pede a senha do dia, digite a senha do totem. É a senha que decide: a do dia faz um celular comum, a do totem faz um totem. O tablet então pergunta em que mesa ele vai ficar — e pronto.
🪑
A mesa vem de graça — toda música pedida naquele tablet já entra com a comanda da mesa que você informou na montagem. Ninguém digita, ninguém erra, e ninguém lança música na conta de outra mesa.
👥
Cada pessoa é uma pessoa — no totem o cantor é identificado pelo nome, não pelo aparelho. Várias pessoas da mesma mesa entram na fila pelo mesmo tablet, e a rotação justa (🔀) conta cada uma separadamente. Xará na mesma noite conta como a mesma pessoa — peça o sobrenome se acontecer.
🔓
Sair do totem — botão na barra azul do próprio tablet, com a senha do totem. Fechar a sala também derruba todos os totens: na noite seguinte é preciso montar de novo (com a senha nova).
🔌 Integração com PDV / comanda
🔌
Gere uma chave de API para o sistema de PDV do estabelecimento ler a fila e cobrar por música cantada por mesa/comanda. A chave e o passo a passo de uso chegam por e-mail (o cadastrado da sala) — não ficam na tela.
🌐
IP do PDV (opcional): restrinja a chave ao IP de saída de Internet do estabelecimento (o IP público por onde o PDV acessa a web — não o 192.168.x local). Vários? Separe por vírgula. Vazio = aceita de qualquer rede.
💳 Fila do caixa
💳
Senha do caixa — ao abrir a sala você pode definir uma senha opcional só para o caixa. Quem entra com ela (pela mesma tela "Senha do dia") vê apenas uma tela só-leitura da fila por mesa/comanda — sem inscrever, mover ou pontuar nada. Serve para o pessoal do caixa cobrar por música cantada por mesa, sem depender de PDV.
🔎
Filtro por mesa — a tela lista tudo (quem já cantou primeiro) com mesa, cantor, música, horário e status. Digite uma mesa/comanda no filtro para ver só o que interessa àquela conta.
🔓
Sair — botão na barra âmbar do próprio aparelho. A senha do caixa vale só nesta noite (precisa ser diferente da senha do dia e da senha do totem); fechar a sala derruba o acesso.
🎛️ Controles da sessão
✅
Aceitando inscrições / ⛔ Inscrições fechadas — liga ou desliga novas inscrições de cantores.
🧹
Limpar cantados — remove da fila todos que já cantaram.
🔗
QR Sala — QR code da URL da sala para o KJ exibir, imprimir, compartilhar.
🔑
QR Acesso — QR code com a senha do dia embutida. Aparece quando a sala está aberta; compartilhe com os cantores.
⬇️
Baixar fila — abre o relatório da fila do momento: os números da noite (cantadas, cantores, espera, ritmo, pico) e a tabela completa (cantor, mesa, música, código, origem, pontuação, hora). Dali você 📋 Copia para colar no WhatsApp, ou baixa em CSV / PDF.
📊
Números — resumo da noite num toque: músicas cantadas, cantores, tempo médio de espera, horário de pico e ritmo. Os números sobrevivem mesmo que você limpe os cantados. Os relatórios, o painel do mês e o histórico fazem parte do pacote de gestão da sua sala.
📋
Histórico — sessões anteriores com o relatório completo daquela noite (cantadas, cantores, espera média, pico e ritmo) no topo, mais a lista de cantores, músicas, pontuação e horário. Cada sessão pode ser baixada em CSV ou impressa em PDF direto na lista. Cada noite fica guardada sob o dia em que a sala foi aberta — se a festa virar a madrugada, ela continua na data em que começou. No topo da lista, o 📅 Painel do mês junta todas as noites de um mês: volume e média por noite, comparativo noite a noite, ocupação por horário (quando o pessoal chega), músicas e artistas mais cantados e quem mais apareceu — com a taxa de retorno (quantos cantores voltaram em mais de uma noite). Os cantores são identificados pelo nome digitado, então homônimos contam como uma pessoa só e "Ana" e "Ana Maria" contam como duas; e o ranking de artistas só enxerga as músicas escolhidas no catálogo (nas origens Pasta pessoal e YouTube o texto é livre — o painel mostra a porcentagem).
📺
Modo TV — projeta a fila em tela cheia para exibir na TV do estabelecimento, com o 🏆 Top 5 da noite (mais pontuados pela plateia) no rodapé.
🌙
Fechar sala — encerra a sessão do dia e arquiva a fila.
💳
Assinar / renovar assinatura — no menu ⚙️ KJ, leva à tela de contratação (plano e sala já preenchidos). Você confirma com a senha do KJ e finaliza o pagamento seguro pelo Mercado Pago.
🔑
Trocar minha senha — no menu ⚙️ KJ (com você logado), o botão 🔑 Trocar minha senha muda a sua senha de login do KJ: informe a senha atual, a nova (mín. 6 caracteres) e confirme. É a senha fixa que abre os controles e a sala — não é a senha do dia (essa você define ao abrir a sala) nem a do totem. Depois de trocar, use a nova da próxima vez que entrar como KJ.