Manual do usuário

O Ceres é a plataforma de operação de restaurante da Neural Thinkers Lab. Ele registra a venda no balcão, emite comanda, leva o pedido até a cozinha, controla o cardápio, guarda as compras e as contas a pagar e consolida o resultado do período.

Este manual cobre o caminho comum. Para o detalhe de cada tela e cada campo, veja o manual completo.

Quem usa o sistema

O Ceres reconhece quatro papéis de equipe, e o menu muda conforme o seu:

• Administrador: enxerga o sistema inteiro, incluindo Números do mês e Configurações.
• Equipe: enxerga tudo, menos Números do mês e Configurações. Opera o balcão, a cozinha, as compras e as contas.
• Estagiário: vê o mesmo menu da Equipe, mas o Cardápio fica somente leitura ("Somente leitura: seu perfil não altera o cardápio.") e Carreiras é bloqueado.
• Cozinha: não recebe barra lateral nenhuma. Entra direto na fila da cozinha e só alcança Meu perfil; qualquer outro endereço devolve você para a cozinha.

Além desses, existe o cliente: quem tem cadastro de mensalista entra pelo mesmo endereço e cai na própria área, não no sistema. Está descrito no fim deste manual.

Quem define o papel de cada pessoa é o administrador, em Configurações.

Primeiro acesso

1. Abra ceres.ntlabs.dev. A página inicial é pública; o sistema fica atrás de Entrar.
2. Na tela de login você pode usar Google, GitHub, Meta, LinkedIn, Microsoft ou Banco do Brasil, e-mail e senha, ou entrar sem senha por Código WhatsApp ou Link por email.
3. Não existe cadastro na tela de login. Sua conta é criada por quem administra o restaurante.
4. Depois de entrar, o sistema confere seu papel e leva você ao lugar certo: o sistema com barra lateral, a fila da cozinha, ou a área do cliente.

Se aparecer "Não foi possível confirmar seu acesso agora. Tente novamente.", o sistema não conseguiu confirmar quem você é e prefere não adivinhar. Toque em Tentar novamente.

Quem guardou um atalho antigo para /gestao continua chegando: esses endereços são redirecionados para /sistema.

Como o sistema se organiza

A barra lateral agrupa as telas em quatro seções:

Meu perfil e Sair ficam fora dos grupos, no rodapé da barra lateral. O cabeçalho traz o nome da casa e o menu de acessibilidade, com tamanho de texto, alto contraste e VLibras.

O topo da barra lateral leva ao Painel. Ele ainda é uma tela de estrutura: mostra quatro cartões ("Faturamento do mês", "Despesas do mês", "Contas em atraso" e "Resultado") todos com um traço no lugar do número, e avisa que os valores virão da API. Quem quer número olha Números do mês.

Registrar uma venda

Vendas é a tela do balcão, e é um formulário só.

1. Digite o valor. Pressionar Enter já registra a venda.
2. Escolha a forma de pagamento: Crédito, Débito, PIX, Dinheiro, Mensalista ou Voucher.
3. Se escolher Mensalista, o cliente passa a ser obrigatório. Busque por código, telefone ou nome. O código é o caminho mais rápido, porque o cliente costuma saber o dele de cor.
4. O produto não é obrigatório: o relógio decide entre almoço e jantar. Toque em Trocar apenas no dia em que o relógio erra.
5. O botão principal muda de nome conforme o pagamento. Em dinheiro, PIX, mensalista ou voucher ele diz Registrar venda. Em crédito ou débito ele diz Cobrar na maquininha, porque o mesmo toque registra a venda e manda o valor para o terminal.

Depois de registrada, a venda aparece em Vendas de hoje, com o total por forma de pagamento. Venda não se apaga: uma venda cuja nota falhou continua sendo uma venda.

Ditar a venda

Acima do formulário há 🎤 Falar a venda. Você fala, toca em Conferir venda, revisa o que o sistema entendeu e toca em Usar estes dados. A voz apenas preenche valor, forma de pagamento e nome do cliente; quem registra continua sendo o botão da tela. Se o nome falado casa com mais de um cliente, o botão fica travado até você escolher.

A voz nunca liga nota fiscal. Se você falar em nota, a tela avisa que ouviu e o documento continua sendo escolhido à mão.

O reconhecimento de voz depende do navegador e não existe em todos. Quando não existe, a tela diz "Este navegador não reconhece voz. Use os botões." e o caminho manual segue inteiro.

Cobrar na maquininha

O bloco da maquininha só aparece para uma venda já registrada, e o valor nunca é digitado nele. Enquanto o cliente decide, a tela mostra "O valor já está na maquininha. O cliente escolhe crédito, débito ou PIX lá." e acompanha o resultado: Aguardando o cliente na maquininha, Pago, Recusado, Cancelado ou Expirou sem pagamento. Quando o pagamento sai pelo terminal, a forma de pagamento veio de lá e não foi digitada.

Se a maquininha não estiver configurada, o bloco simplesmente não aparece. Se a conversa com ela falhar, a tela diz "Não foi possível falar com a maquininha. Cobre nela e registre aqui depois."

Nota fiscal: leia antes de usar

Dentro de Vendas, o bloco recolhível Cliente e nota fiscal traz CPF ou CNPJ, nome do cliente, o interruptor Emitir nota fiscal, a escolha entre Pré-venda (sem nota), Cupom (NFC-e) e Nota (NF-e), informações adicionais e o campo de enviar o cupom por WhatsApp ou e-mail.

Hoje nenhum emissor está credenciado na SEFAZ. Marcar o interruptor tende a deixar a venda com nota pendente, e o campo de envio do cupom não tem efeito nenhum: não emite, não entrega e não avisa. A venda em si é registrada normalmente. Confirme com quem administra o restaurante antes de prometer cupom a um cliente.

Existem ainda duas telas fiscais fora do menu, alcançáveis só por endereço direto: a emissão avulsa de NFC-e e a inutilização de faixa de numeração, esta restrita ao administrador. Ambas têm efeito fiscal real e consomem número de série, então não são caminho de rotina.

Emitir comanda

Comanda é a emissão rápida de comanda e o registro de fiado. Ela é restrita à equipe; quem não faz parte vê "Acesso restrito à equipe."

1. Digite nome e valor no formato do exemplo da tela.
2. O sistema busca o preço por quilo do dia e mostra se está valendo o preço de Semana ou de Fim de semana. Há Recarregar preço sugerido quando preciso.
3. Escolha o cliente na busca. Se não encontrar, Não achei — cadastrar rápido abre um cadastro com nome, celular, e-mail e CPF. O botão de cadastrar só libera com o nome preenchido e o consentimento LGPD marcado.
4. Registrar comanda. O sistema calcula o peso a partir do valor e do preço por quilo.

O resultado mostra o número da comanda em destaque, com cliente, valor e peso, e três saídas: Imprimir via, Enviar e Nova comanda. Cliente sem contato cadastrado devolve "Cliente sem WhatsApp/e-mail cadastrado — nada a enviar".

A cozinha

Ficha do dia (a fila)

O item Ficha do dia do menu abre a fila de pedidos, que a tela identifica como Cozinha. Os pedidos chegam separados por estação, em duas abas: Grelha e Fria. Cada pedido mostra a mesa (ou Reposição, quando não veio de mesa) e há quantos minutos está esperando.

Toque em Aceitar quando pegar o pedido e em Pronto quando terminar. Se outra pessoa avançar o mesmo pedido antes, a tela avisa.

Sem conexão, a fila não finge estar em dia: ela diz "Sem conexão — fila desatualizada" e explica que pode ter entrado pedido novo que não aparece ali.

Ficha do dia (a ficha)

Dentro da fila há o link para a ficha propriamente dita, que também se chama Ficha do dia.

1. Fotografe a ficha preenchida à mão.
2. O sistema transcreve, e você confere e corrige os pratos, cuba por cuba e travessa por travessa. Todo campo é editável.
3. Confirmar salva a ficha. Os ingredientes são inferidos logo em seguida, num segundo passo, porque leva tempo.
4. A ficha vira um checklist: marque o que já tem em casa. Cada prato mostra "tudo em casa" ou quantos itens faltam.
5. Enviar lista de compras manda o que faltou. O resultado é dito por canal, e-mail e WhatsApp separadamente, nunca um "enviado" genérico.

Refazer a ficha de hoje recomeça o ciclo.

Grelhados

O garçom lança o pedido de grelhado. Informe a mesa, ajuste a quantidade de cada item nos botões de menos e mais, e escolha o ponto da carne entre MAL, PONTO e BEM nos itens que pedem ponto. Enviar pedido manda para a aba Grelha da cozinha.

Nesta tela também existe 🎤 Falar a comanda: você fala, toca em Conferir pedido, revisa o cartão que aparece e toca em Confirmar. Aqui, ao contrário da venda falada, o Confirmar cria o pedido de verdade e o anuncia na cozinha. Quando o anúncio falha, o pedido segue: "Pedido enviado. A cozinha vê na tela".

Reposição

"Toque no que acabou." Marque os itens e, se precisar, escreva no campo "Falta mais alguma coisa?". Enviar avisa a cozinha, e o envio é feito por estação. Se uma estação falhar e a outra não, a tela diz exatamente qual repetir. O aviso aparece na fila da cozinha como Reposição, sem mesa.

Cardápio

"Desligue o que acabou e ligue de volta quando voltar a ter." Cada item tem um interruptor que alterna entre No menu e Fora; um item desligado ganha também a marca Inativo na mesma linha. Remover pede confirmação na própria linha: "Remover de vez? Isso não volta."

O formulário do item tem nome, descrição, categoria, preço, a opção de mostrar ou não o preço no cardápio e a ordem dentro da categoria. Item sem preço preenchido aparece como "preço do dia".

Estagiário e cozinha veem o cardápio, mas não alteram.

Compras e contas

Compras

Registre a compra com fornecedor, categoria, valor, data e descrição. Tirar foto da nota guarda a imagem e tenta ler os campos; a leitura só preenche campo vazio e nunca sobrescreve o que você já digitou. Se a foto subir e a leitura não sair, a tela diz "Nota guardada. Não deu para ler os campos — preencha à mão." Isso não é erro. Há ainda a alternativa de colar um link.

Fornecedores

Cadastro de fornecedor com busca por CNPJ, que preenche o restante. Cada fornecedor tem o interruptor Ativo / Fora, e o desativado recebe a marca Inativo.

Contas

Contas a pagar, com dois totais no topo: Em atraso e Em aberto. A lista vem agrupada em ordem fixa: Atrasado, Vence hoje, Em dia e Pago. No grupo Vence hoje, cada conta traz a marca Hoje.

Marcar como paga pede confirmação com o nome e o valor. + Nova abre o formulário com fornecedor, categoria, valor, vencimento, número do documento e notas.

Saídas

Lançamentos que não passam pelo balcão, em um assistente de quatro passos:

1. Tipo (Saída ou Entrada) e valor. Há 📷 Escanear documento, que lê o papel e preenche valor, categoria, cliente ou fornecedor, forma de pagamento e data. Se a leitura falhar, a tela pede para digitar à mão.
2. Categoria, em grade de botões, filtrada pelo tipo escolhido.
3. Cliente ou fornecedor, forma de pagamento e data.
4. Resumo e Confirmar.

A receita do dia se lê em Vendas, não aqui.

Gestão

Mensalistas

O item Mensalistas do menu abre a tela que a vinheta chama de Fiado. Ela não lança fiado, lançar é escolher Mensalista na venda: ela mostra quem está devendo.

No topo, o total em Fiado em aberto; abaixo, a lista ordenada do maior saldo para o menor, com o valor, a quantidade de lançamentos e a data do último. Cada devedor mostra um de três estados: a marca Cobrado hoje, o aviso "Sem WhatsApp cadastrado", ou o botão Cobrar.

Cobrar pede confirmação e envia o lembrete por WhatsApp, um devedor por vez. Não existe cobrar todos. O resultado é explícito: ou "Lembrete enviado", ou "A cobrança foi registrada, mas o WhatsApp não foi entregue."

Produtos

Catálogo do que se vende, com preço por unidade ou por quilo e, opcionalmente, preço diferente no fim de semana, que vale sábado, domingo e feriado. A lista escreve o preço por extenso, como "por quilo" ou "por unidade", e mostra "sem preço cadastrado" quando não há.

Produto não se apaga: só Desativar e Reativar, porque as vendas já lançadas apontam para ele. O identificador do produto também não muda depois de criado.

Há uma seção recolhível Fiscal (avançado) com NCM, CFOP, CSOSN e tributos aproximados. Em branco, o produto herda o padrão da casa. O número de tributos é o do IBPT da atividade: peça à contabilidade em vez de estimar.

Números do mês

Restrito ao administrador. O item Números do mês do menu abre a tela que a própria página intitula BI. Quem não é administrador vê "Acesso restrito" e a explicação de que o resultado financeiro é só do proprietário.

Escolha o período em De e Até. O padrão vai do primeiro dia do mês até hoje. No topo, quatro indicadores: Faturamento, Despesa, Resultado e Margem. Sem faturamento no período, a margem aparece como um traço e nunca como zero, porque indefinida não é o mesmo que nula.

Abaixo vêm os gráficos: receita e despesa por mês, despesas por categoria, despesas por fornecedor e o comparativo de um ano contra o anterior, em receita e em despesa.

Carreiras

Restrito a administrador e equipe. Estagiário e cozinha veem "Acesso restrito" e a explicação de que a tela mostra dados pessoais de candidatos.

São duas abas. Em Vagas, cada vaga é Rascunho, Aberta ou Fechada, com as ações Publicar, Fechar e Reabrir. Vaga nova nasce rascunho. Fechar tira a vaga do site na hora e não apaga candidatura nenhuma.

Em Candidaturas, filtre por vaga e por etapa. As etapas são Recebida, Triagem, Entrevista, Aprovado, Reprovado e Desistiu. No detalhe do candidato há a anotação interna, que só a equipe vê, e o link do currículo, gerado na hora e com validade curta: documento com dados pessoais não se reencaminha.

Configurações

Restrito ao administrador. Lista a Equipe, com o papel de cada pessoa e o interruptor entre Ativo e Fora; quem está desativado recebe também a marca Inativo.

O sistema impede que o último administrador ativo se rebaixe ou se desative: "Você é o único admin ativo — promova outro membro antes de mudar seu papel ou se desativar."

Meu perfil e sair

Meu perfil fica no rodapé da barra lateral. Ali você edita o nome de exibição; e-mail e papel são apenas leitura. É também onde fica o botão Sair, e é a única tela de saída do sistema, o que importa no tablet compartilhado da cozinha.

A área do cliente

Quem é mensalista entra pelo mesmo login e cai na própria área, não no sistema.

No primeiro acesso, o sistema pede para completar o cadastro: nome completo, CPF, celular, e-mail opcional, os Dias habituais de segunda a sexta, uma restrição alimentar se houver, e a preferência de resumo entre Diário, Semanal, Só no fechamento e Nenhum. É preciso ler o texto de privacidade e marcar Li e concordo antes de Concluir. Se faltar o WhatsApp, a tela Confirme seu WhatsApp aparece antes, porque é por ele que os comprovantes chegam.

Na área, o cliente vê o próprio número de cliente, que serve para se identificar no caixa, as Comandas em aberto, o Saldo total e, em cada comanda, o botão Baixar comprovante. Sem nada em aberto, a tela diz que ele está em dia.

Sem conexão

O Ceres pode ser instalado como aplicativo no tablet da cozinha. Quando a rede cai no meio do serviço e uma tela não carrega, aparece "Você está sem conexão", com o aviso de que o Ceres volta assim que a conexão retornar.

As telas de operação avisam quando o que está na tela pode estar velho: a fila da cozinha, a reposição e os grelhados dizem "Sem conexão — lista desatualizada", em vez de mostrar uma lista vazia que pareceria "não há nada".

Quando uma tela não carrega

Nas telas de dinheiro, o Ceres nunca mostra lista vazia quando a busca falhou. Se o sistema não conseguiu carregar, ele diz o que deixou de saber: que não é possível saber quem está devendo agora, ou o que está vencendo, ou que o total do período não pode ser conferido. Uma tela vazia significa que não há nada; um aviso desses significa que o sistema não sabe. Não confunda os dois.

O mesmo vale para envio: quase toda ação que usa WhatsApp ou e-mail diz qual canal saiu e qual não saiu, em vez de um "enviado" genérico. "Enviada" nunca significou "chegou".

O que ainda não existe

Estas coisas aparecem em texto de apresentação, em títulos de tela ou em avisos dentro do produto, mas não estão implementadas hoje. Não conte com elas:

• Reservas e concierge conversacional: não há tela nenhuma no sistema.
• Emissão fiscal: sem emissor credenciado na SEFAZ, o interruptor de nota e o campo de envio do cupom não produzem nota nem cupom entregue.
• Certificados e o módulo de Estágio: a tela existe, mas está vazia, com o aviso de que a interface será construída quando o módulo correspondente estiver disponível.
• Painel: os quatro indicadores mostram um traço; os números do período estão em Números do mês.
• Marcar feriado na venda: o texto de ajuda de Produtos menciona que o operador marca o feriado na venda, mas não há esse controle na tela de Vendas.

O Ceres também atende hoje uma organização por instalação. Não trate os dados como separados por restaurante dentro de uma mesma instalação.

Seus dados

O Ceres guarda dado pessoal de cliente e de candidato a vaga. O cadastro rápido no balcão e o cadastro do mensalista só concluem com o consentimento marcado, o acesso a dados de candidato é limitado por papel, e o link de currículo é gerado na hora e expira. Os termos, a política de privacidade e o canal do encarregado de proteção de dados ficam em www.ntlabs.dev.