Fluxo de caixa em simuladores de loja: como criar e testar

Projete um caixa com leitura de produtos, estados de pagamento, proteção das transações, retorno ao jogador e uma lista prática de casos extremos.

Seele Editorial TeamAtualizado 18 de novembro de 2026

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.

No balcão de um mercado de bairro original, uma pessoa no caixa registra os produtos enquanto um cliente espera com a cesta.
O caixa é o centro de um ciclo curto: receber os produtos, registrá-los, cobrar o pagamento e liberar o espaço.

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.

Uma pessoa no caixa confere um produto ao lado do leitor, com os itens registrados separados dos que ainda não foram lidos.
Separe os produtos registrados do restante da cesta para que o jogador identifique um item esquecido ou corrija uma leitura errada.

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.

Depois da compra, sacolas com alimentos e um recibo impresso ficam no caixa enquanto o cliente deixa a fila.
Uma venda finalizada encerra a transação atual e deixa o caixa pronto para o próximo cliente.

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.

SEELE AI

Transforme este guia em um projeto jogável.

Comece com um briefing claro e evolua sua ideia no Workspace da Seele AI.

Começar a criar