店舗シミュレーターのレジ処理を設計・テストする方法

スキャン、支払い状態、取引の整合性、プレイヤーへのフィードバックを備えたレジの流れを設計し、境界ケースを実践的なチェックリストで検証します。

Seele Editorial Team更新日 2026年11月18日

レジの各操作が取引を予測どおりに変化させると、会計の流れは安定します。小さな状態機械としてモデル化しましょう。客がレジに並び、商品を出し、店員がスキャンまたは修正し、ゲームが合計金額を計算し、客が支払い、取引を一度だけ確定してから客が帰ります。店舗シミュレーターに手応えのある作業を加えながら、金銭、在庫、客の状態を一貫して保てます。

オリジナルの近所の食料品店のレジで、客が買い物かごを持って待つなか、店員が商品をスキャンしている。
レジは短いゲームループの中心です。商品を受け取り、スキャンし、代金を受け取って、レーンを空けます。

取引の状態を定義する

まず、1回の来店にひもづく取引レコードを作ります。取引ID、客ID、スキャン済み明細の一覧、小計、支払い方法、受け取った金額、最終状態などを持たせられます。客の買い物かごはこのレコードと分けてください。かごはレジに持ってきた商品を表し、取引は店員の処理状況を表します。両者を比較できるので、商品漏れや重複に気づきやすくなります。

最初の状態遷移には Queued → Scanning → AwaitingPayment → Paid → Finalized が使えます。プレイヤーの操作内容が変わる場合にだけ、Correction、PaymentFailed、Cancelled などの状態を追加します。各状態で許可する操作を定義しましょう。「Scanning」では有効な商品を受け付け、「AwaitingPayment」では支払い方法を選べます。「Paid」から「Finalized」へ進み、「Finalized」では追加の支払いや商品変更を受け付けません。

状態遷移を限定します。スキャンイベントは商品と取引を特定し、取引がまだ「Scanning」であることを確認してから、明細を1つ追加し、画面の小計を更新します。「AwaitingPayment」より前の支払いイベントは拒否します。有効な支払いが終わった場合にだけ確定を認めます。店員がボタンを2回押せる場合、2回目のイベントで二重に入金したり在庫を減らしたりしてはいけません。

状態が変わるたびにゲーム内の反応を返します。スキャン成功時には短い音を鳴らし、控えめな確認表示を出し、見えるリストに商品を追加できます。不一致があれば対象商品を示し、プレイヤーが修正できるよう取引を維持します。アニメーションだけを頼りに、操作が反映されたかどうかをプレイヤーに推測させないでください。

スキャンと修正を実装する

商品を受け取るたびに、その商品IDを客の買い物かごから期待される商品と比較します。寛容なデザインなら、間違った商品をスキャンできても、明確な修正手段を用意します。厳しめのデザインでは、レジが拒否して正しい商品を選ぶよう求めます。ルールを1つ選び、一貫して伝えましょう。黙って拒否する場合と、誤って受け付ける場合が混在すると、レジが信頼できない印象になります。

スキャン済みの各明細には、商品ID、数量、価格のスナップショットを保存します。取引中に店頭価格が変わる可能性がある場合、このスナップショットが重要です。レジは、途中で黙って新しい価格を読み直すのではなく、ゲームで選んだルールに沿って客へ請求する価格を使います。会計中に価格が変わらないシンプルなプロトタイプなら、その前提を記録し、商品カタログから金額を計算します。

修正は明示的な操作にします。取り消し操作では選んだ明細を削除し、小計を再計算します。数量の修正では個数を変え、合計を更新します。商品を実際にかごやベルトへ戻すなら、その移動をアニメーションで示してください。スキャン済みのままなら、商品がどこへ移動したかを表示します。重複入力にも注意します。プレイヤーがもう1個スキャンする意図を示していない限り、同じキーイベントが繰り返されても明細を増やしてはいけません。

スキャナーの横で店員が食料品を再確認している。スキャン済みの商品と未スキャンの商品はきれいに分けられている。
スキャン済み商品を残りのかごと分けると、スキャン漏れや誤スキャンを見つけやすくなります。

価格、商品名、カテゴリには安定した商品データを使います。見た目のパッケージを取引の正確な情報源にしてはいけません。商品インスタンスはカタログの商品を参照し、取引は一貫して完了するために必要な値を保存できます。複数の同一商品にも対応しやすくなり、重複スキャンイベントとの混同も防げます。

支払いを検証して一度だけ確定する

かごの商品をすべて処理したら「AwaitingPayment」へ移り、請求額を表示します。現金払いでは、受取額を受け付け、合計未満の金額は拒否し、お釣りを受取額から請求額を引いて算出できます。カード払いは、プロトタイプ内ですぐに完了させても、短時間「承認待ち」と表示してもかまいません。失敗時は、再試行または別の方法を選べる状態へ戻します。これらはゲームの設計上の選択肢であり、参考作品の内部コードについての説明ではありません。

金額の表現を統一しましょう。小数点を含む浮動小数を何度も加算するのではなく、ゲームで使う最小の整数単位(たとえばセント)で保存します。12.35 の合計は 1,235 単位になります。受取額と合計が同じ単位であることを検証し、整数の減算でお釣りを計算します。これにより、購入を重ねたときに小さな丸め誤差が蓄積するのを防げます。

確定は1回だけ行うコミット地点にします。支払いに成功したら取引を「Paid」にし、在庫と売上を更新してから「Finalized」にします。これらの変更はできるだけまとめて行います。支払いを受け取ったのに在庫が更新されなかったり、客が帰るときに売上が二重に計上されたりすると、ゲームの状態に矛盾が生じます。取引IDを冪等性キーとして使い、同じ確定リクエストが再度届いたら、変更をもう一度適用するのではなく前回の結果を返します。

取引確定時には支払い合計、必要に応じたお釣り、デザインに含める場合はレシート、客が退店する様子を分かりやすく提示します。そのあとレジを次の客に引き渡します。支払い処理中に客を帰らせてはいけません。また、未完了の取引が残るレジを次の客に使わせてはいけません。

会計が終わり、袋詰めされた食料品と印刷済みレシートを残して、客がレーンから立ち去る。
売上が確定すると現在の取引が終了し、レジは次の客を迎えられる状態になります。

小さなシステムとしてレジをテストする

まず通常の流れを試します。3商品を持った客が到着し、各商品を1回ずつスキャンし、小計がカタログと一致して、支払いが成功します。在庫が1回だけ減り、売上が1回だけ増え、客が退出します。次に失敗ケースを個別にテストします。空のかご、未知の商品ID、商品間違い、スキャン後の取り消し、スキャン入力の重複、現金不足、カード支払いのキャンセル、2回目の確定リクエストを試してください。

各ケースを実行する前に、期待される結果を記録します。たとえば現金不足なら取引は未払いのままで、スキャン済みの商品を保ち、別の支払いを試せるようにします。カードがキャンセルされても在庫や売上を変えてはいけません。確定リクエストをもう一度受け取った場合は、合計を変えずに既存のレシートまたは結果を返します。こうしたチェックなら、通常の成功ルートだけでは見逃す状態の不具合を発見できます。

操作感を調整するときは、各アクションにかかる時間を個別に調整します。スキャンは素早く反応させ、支払い確認は読める長さだけ表示し、袋詰めは任意にするか、列が長いときに短縮できます。基本の取引が安定してから、客の忍耐度や列の長さによるプレッシャーを加えます。入力への反応が分かりにくいままタイマーで急かすと、テンポがよくなるのではなく、不公平な仕組みだと感じられます。

『Supermarket Simulator』のSteam公式ページでは、商品スキャンと現金またはカードでの支払いがスーパーマーケットのゲームプレイ要素として説明されています。この大まかなループを発想の参考にしながら、修正方法、取引の安全性、テンポ、フィードバックは自分で決めてください。SEELEが案内するゲーム制作機能は自然言語のゲームコンセプトから始める助けになりますが、生成プロトタイプは下書きとして扱い、レジの挙動は自分で確かめましょう。オリジナルの店舗シミュレーター案なら、AIゲーム制作の出発点を確認できます。

よくある質問

レジ処理にはどんな状態が必要ですか?

小さなフローなら「Queued」「Scanning」「AwaitingPayment」「Paid」「Finalized」を使えます。修正、支払い失敗、キャンセルを別の操作として扱う場合は、それぞれの状態を追加します。状態ごとに有効な入力を定義し、早すぎるイベントや確定後のイベントは拒否してください。レジのデバッグが容易になり、1つの操作が売上のほかの部分を変更するのを防げます。

現金のお釣りはどのように計算しますか?

価格はセントなどの整数の補助単位で表します。明細の合計を加算し、受取額から請求額を引いてお釣りを算出します。合計に届かない支払いは拒否します。整数を使えば浮動小数点の丸め誤差を避けられます。保存値とは別に表示用の通貨書式を使い、見た目の形式が取引計算を変えないようにしてください。

客への二重請求をどう防ぎますか?

各取引に固定IDを付け、確定処理を冪等にします。最初の有効なリクエストで支払いを記録し、在庫と売上を更新します。同じIDの後続リクエストには、変更を再適用せず記録済みの結果を返します。支払い成功後は入力を無効にし、「Finalized」からの状態遷移も拒否します。

カード支払いに失敗したときはどうしますか?

取引は未払いのままにし、スキャン済みの商品も保持します。失敗を明確に伝え、デザインで許可する場合はプレイヤーに再試行または別の支払い方法を選ばせます。支払いに成功して取引が確定するまでは在庫も売上も変えず、客も帰らせません。これにより画面のフィードバックをゲーム内部の状態と一致させられます。

SEELE AI

このガイドをプレイできる作品に。

作りたいものを明確にし、Seele AI ワークスペースで改善を重ねましょう。

制作を始める