PDV — ponto de venda
Onde: área administrativa, tela Cantina — PDV (pensada para tablet no balcão).
TODO: VALIDATE (posição exata no menu do sistema administrativo).
Quem pode usar: usuários com a permissão Cantina — PDV — normalmente o operador da cantina. O operador precisa estar vinculado a uma unidade escolar e a um cadastro de funcionário.
Para que serve
É a tela de venda da cantina. O operador busca o aluno, monta o carrinho com os itens do cardápio de hoje e finaliza — o valor é debitado da carteira do aluno na hora. Não há dinheiro em espécie nem máquina de cartão: quem abastece a carteira é a família, pelo portal.
Campos e áreas da tela
| Área | O que mostra |
|---|---|
| Buscar aluno (nome ou matrícula) | Campo grande de busca; a partir de 2 letras já lista até 10 alunos com nome, matrícula e saldo |
| Cartão do aluno selecionado | Nome, matrícula e o saldo atual — para o operador confirmar visualmente que é a pessoa certa |
| Cardápio de hoje | Botões com os produtos publicados hoje (nome e preço) — um toque adiciona ao carrinho |
| Carrinho | Itens escolhidos e o Total |
| Finalizar venda | Botão de conclusão (fica desabilitado sem aluno selecionado ou com o carrinho vazio) |
Passo a passo — registrar uma venda
- Digite o nome ou a matrícula do aluno e toque no aluno certo na lista.
- Confira nome e saldo no cartão que aparece.
- Toque nos produtos do cardápio para montar o carrinho.
- Toque em Finalizar venda.
- Deu certo: o carrinho esvazia e o saldo do aluno já aparece atualizado — a venda inteira (compra, itens e débito) é registrada de uma vez.
As recusas — e como diferenciá-las
A tela usa cores diferentes de propósito, para o operador nunca confundir os motivos:
| Recusa | Cor | Mensagem | O que fazer |
|---|---|---|---|
| Saldo insuficiente | Vermelho | "Saldo insuficiente. Saldo atual R$ X,XX." | Não há como insistir: peça à família que recarregue pelo portal. O saldo nunca fica negativo |
| Item bloqueado | Âmbar | "Um dos itens do carrinho está bloqueado para este aluno. A venda deste item não é permitida." | Retire o item do carrinho e venda o restante. O sistema não mostra o motivo — e o operador não deve perguntar |
| Conta bloqueada | Âmbar | "A conta deste aluno está bloqueada pelo financeiro." | Nenhuma venda é possível; oriente a família a procurar a secretaria |
| Falha de comunicação | Âmbar | "Falha de comunicação com o servidor. Tente de novo." | Repita a operação; se persistir, acione o suporte |
:::info Regra do sistema
- Saldo nunca negativo: o débito só acontece se o saldo cobre o total — a garantia é do próprio banco de dados, não da atenção do operador.
- Venda tudo-ou-nada: se qualquer coisa falhar no meio, nada é gravado — nunca fica débito sem compra registrada, nem compra sem débito.
- Isolamento por unidade: a busca só encontra alunos com carteira na unidade do operador. Aluno de outra unidade simplesmente não aparece.
- O bloqueio de item é uma escolha do responsável no portal e não tem motivo registrado — o motivo pode ser dado de saúde, e o sistema é construído para nem sequer armazená-lo.
- A identificação do aluno por reconhecimento no terminal está desligada nesta versão; a
busca manual por nome/matrícula é o caminho oficial.
TODO: VALIDATE(previsão de ativação da identificação por terminal).
:::
Problemas comuns
- "O aluno não aparece na busca" — ou ele pertence a outra unidade, ou ainda não tem carteira: a carteira é criada no primeiro acesso da família à Cantina no portal. Peça para a família acessar o Portal da família ao menos uma vez.
- "O produto não está nos botões do cardápio" — ele não foi publicado no cardápio de hoje; veja Produtos e cardápio do dia.
- "Finalizei e o saldo não mudou" — se apareceu recusa, a venda não aconteceu (leia a mensagem colorida). Venda concluída sempre atualiza o saldo na tela.