Um fluxo de caixa funciona quando cada ação altera a transação de uma forma previsível. Modele-o como uma pequena máquina de estados: o cliente entra na fila, apresenta os produtos, o operador do caixa os registra ou corrige, o jogo calcula o total, o cliente paga e a transação é finalizada uma única vez antes de ele ir embora. Assim, seu simulador de loja oferece tarefas concretas e mantém consistentes o dinheiro, o estoque e o estado do cliente.

Defina os estados da transação
Comece com um registro de transação associado a uma visita de cliente. Ele pode conter um ID de transação, um ID de cliente, a lista de itens registrados, subtotal, forma de pagamento, valor recebido e status final. Mantenha a cesta do cliente separada desse registro: ela representa o que o cliente trouxe para o caixa, enquanto a transação representa o trabalho atual do operador. Essa distinção permite comparar os dois e detectar itens ausentes ou duplicados.
Uma sequência inicial útil é Queued → Scanning → AwaitingPayment → Paid → Finalized. Acrescente estados secundários explícitos, como Correction, PaymentFailed ou Cancelled, somente quando eles mudarem as ações disponíveis para o jogador. Defina as ações permitidas em cada estado. “Scanning” aceita um produto válido; “AwaitingPayment” aceita uma forma de pagamento; “Paid” pode avançar para “Finalized”; e “Finalized” não aceita novos pagamentos nem alterações nos produtos.
Limite as transições. Um evento de leitura deve identificar um produto e uma transação, verificar se ela ainda está em “Scanning”, acrescentar um único item e atualizar o subtotal exibido. Um evento de pagamento deve ser rejeitado antes de “AwaitingPayment”. O evento de finalização só deve ser aceito após um pagamento válido. Se o operador do caixa puder apertar um botão duas vezes, o segundo evento não deve adicionar dinheiro nem baixar o estoque novamente.
Associe o retorno do jogo às mudanças de estado. Uma leitura bem-sucedida pode tocar um som curto, exibir uma confirmação discreta e acrescentar o produto a uma lista visível. Se houver divergência, identifique o produto que precisa de atenção e preserve a transação para que o jogador possa corrigi-la. O jogador não deve precisar deduzir apenas pela animação se o jogo registrou uma ação.
Implemente a leitura e as correções
Para cada produto apresentado, compare seu ID com o item esperado na cesta do cliente. Em um design mais permissivo, um produto errado ainda pode ser registrado, mas deve haver um caminho claro para corrigi-lo. Em um design mais rigoroso, o caixa pode recusá-lo e pedir ao jogador que escolha o produto correto. Defina uma regra e ensine-a de forma consistente; misturar rejeições silenciosas com aceitações acidentais faz o caixa parecer pouco confiável.
Represente cada item registrado com um ID de produto, quantidade e cópia do preço. Essa cópia é importante se os preços da loja puderem mudar durante uma transação aberta: o caixa deve usar o preço que será cobrado do cliente de acordo com a regra escolhida para o jogo, em vez de ler um novo valor sem aviso no meio do processo. Se os preços nunca mudarem durante o pagamento em um protótipo simples, documente essa premissa e calcule o total a partir do catálogo de produtos.
As correções precisam ser ações explícitas. Uma anulação remove um item selecionado e recalcula o subtotal. Uma correção de quantidade altera o número de unidades e atualiza o total. Se o produto voltar fisicamente para a cesta ou para a esteira, mostre esse movimento com uma animação; se continuar registrado, indique onde ele foi colocado. Trate entradas repetidas com cuidado: um evento de tecla repetido não deve criar um segundo item, a menos que o jogador esteja realmente registrando outra unidade.

Use dados estáveis para o preço, o nome e a categoria dos produtos. A embalagem que aparece na tela não deve ser a fonte oficial dos dados da transação. A instância do item pode apontar para um produto do catálogo, enquanto a transação armazena os valores necessários para terminar de forma consistente. Isso facilita aceitar várias unidades do mesmo produto sem confundi-las com eventos de leitura duplicados.
Valide o pagamento e finalize uma vez
Quando a cesta estiver completa, avance para “AwaitingPayment” e mostre o valor devido. No pagamento em dinheiro, o jogo pode aceitar um valor entregue, rejeitar quantias abaixo do total e calcular o troco subtraindo o valor devido do valor recebido. O cartão pode ser processado imediatamente no protótipo ou exibir brevemente uma autorização pendente. Se falhar, volte a um estado em que o jogador possa tentar novamente ou escolher outra forma de pagamento. Essas são opções de design para seu jogo, não afirmações sobre o código interno de um título de referência.
Represente o dinheiro de maneira consistente. Armazene a moeda na menor unidade inteira usada pelo jogo, como centavos, em vez de somar repetidamente números decimais de ponto flutuante. Por exemplo, um total de 12,35 passa a ser 1.235 unidades. Verifique se o valor recebido e o total usam a mesma unidade e calcule o troco com subtração inteira. Isso evita que pequenos erros de arredondamento se acumulem em muitas compras.
A finalização deve ser um único ponto de confirmação. Depois que o pagamento for aprovado, marque a transação como “Paid”, atualize o estoque e a receita e, em seguida, marque-a como “Finalized”. O ideal é aplicar essas mudanças em conjunto: se o pagamento for aceito mas o estoque não for atualizado, ou se o cliente sair enquanto a receita é adicionada duas vezes, o estado do jogo fica inconsistente. Use o ID da transação como chave de idempotência: se a mesma solicitação de finalização chegar novamente, retorne o resultado anterior em vez de aplicar as mudanças mais uma vez.
Ao finalizar a transação, mostre o resultado com clareza: total pago, troco quando aplicável, recibo se o design incluir um e a saída do cliente. Depois, libere o caixa para a próxima pessoa. O cliente não deve ir embora enquanto o pagamento estiver pendente, e um novo cliente não deve assumir um caixa que ainda tenha uma transação inacabada.

Teste o caixa como um pequeno sistema
Teste primeiro o fluxo normal: um cliente chega com três produtos, cada um é registrado uma vez, o subtotal corresponde ao catálogo, o pagamento é aprovado, o estoque diminui uma vez, a receita aumenta uma vez e o cliente vai embora. Depois, teste os casos de falha separadamente. Experimente uma cesta vazia, um ID de produto desconhecido, um produto errado, a anulação após a leitura, a repetição de uma entrada de leitura, dinheiro insuficiente, um cartão cancelado e uma segunda solicitação de finalização.
Anote o resultado esperado para cada caso antes de executá-lo. Por exemplo, dinheiro insuficiente deve manter a transação sem pagamento, preservar os produtos registrados e permitir outra tentativa de pagamento. Um cartão cancelado não deve alterar estoque nem receita. Uma solicitação repetida de finalização deve retornar o recibo ou resultado já existente sem mudar os totais. Essas verificações encontram erros de estado que o fluxo normal sozinho não revela.
Para ajustar a sensação de jogo, regule separadamente o tempo de cada ação. A leitura pode ser rápida e responsiva; a confirmação do pagamento pode permanecer visível tempo suficiente para ser lida; colocar as compras nas sacolas pode ser opcional ou mais rápido quando a fila crescer. Só acrescente pressão por meio da paciência dos clientes ou do tamanho da fila depois que a transação básica estiver confiável. Se um cronômetro penalizar o jogador enquanto o retorno dos comandos não estiver claro, a mecânica parecerá injusta em vez de ágil.
A página oficial de Supermarket Simulator na Steam descreve a leitura de produtos e o pagamento em dinheiro ou cartão como parte da experiência no supermercado. Use esse ciclo geral como inspiração e tome suas próprias decisões sobre correções, segurança das transações, ritmo e feedback. Os recursos de criação de jogos documentados pela SEELE podem ajudar você a começar com um conceito descrito em linguagem natural, mas trate qualquer protótipo gerado como rascunho e confira o funcionamento do caixa por conta própria. Explore um ponto de partida para criar jogos com IA e desenvolver uma ideia original de simulador de loja.
Perguntas frequentes
Quais estados um fluxo de caixa deve ter?
Um fluxo pequeno pode usar “Queued”, “Scanning”, “AwaitingPayment”, “Paid” e “Finalized”. Acrescente estados de correção, falha de pagamento ou cancelamento quando eles permitirem uma ação diferente. Defina quais entradas são válidas em cada estado e rejeite eventos que cheguem cedo demais ou depois da finalização. Isso facilita depurar o caixa e impede que uma ação altere outras partes da venda.
Como calcular o troco em dinheiro?
Represente os preços em unidades inteiras menores, como centavos, some os valores dos itens e subtraia o total devido do valor recebido. Rejeite quantias abaixo do total. O uso de inteiros evita erros de arredondamento de ponto flutuante. Mantenha a formatação visível da moeda separada do valor armazenado para que a apresentação não altere a matemática da transação.
Como evitar cobrar o cliente duas vezes?
Atribua um ID estável a cada transação e torne a finalização idempotente. A primeira solicitação válida registra o pagamento e atualiza estoque e receita; as seguintes com o mesmo ID retornam o resultado registrado sem repetir as mudanças. Também desative a entrada de pagamento após o sucesso e rejeite transições a partir de “Finalized”.
O que fazer quando um pagamento com cartão falhar?
Mantenha a transação sem pagamento e preserve os produtos registrados. Mostre uma mensagem clara sobre a falha e permita uma nova tentativa ou outra forma de pagamento se o design oferecer essa opção. Não altere estoque nem receita e não deixe o cliente sair até o pagamento ser aprovado e a transação finalizada. Assim, o retorno visível permanece coerente com o estado interno do jogo.


