ルナ・オリパDEMO

連携の仕組みと進め方

このデモは、既存システムの「代役」をD1データベースで用意し、連携層が何を守るかを動く形にしたものです。本番では、代役の部分を貴社の既存の認証・コイン・抽選・在庫の処理に置き換えます。

① 新画面(貴社で制作済み)

  • HTML/CSS/JavaScript。デザインはそのまま
  • ブラウザ内保存の部分を、API呼び出しに差し替え
  • 購入ボタンごとに「操作キー」を付け、再送されても二重購入にならない
▼ JSON API(認証Cookie/操作キー付き)

② 連携層(今回の開発範囲・Laravel)

  • 会員認証の連携(既存のログイン状態を引き継ぎ)
  • コイン残高の取得・消費・付与(すべて台帳に記録)
  • オリパ商品・封入情報の取得
  • 購入トランザクション:在庫確認 → 抽選 → 在庫更新 → 課金 → 獲得記録を一括処理
  • 購入ログの保存、管理画面での閲覧・CSV出力
▼ 既存の処理を可能な限り再利用(API/DB/サービスクラス)

③ 既存システム(PHP/Laravel系)

  • 会員・認証、コイン残高、決済、抽選ロジック、在庫
  • APIが無い処理は、既存コードを壊さない薄いAPIを追加してご提案します

このデモが守っている4つのこと

リスクデモでの対策
二重購入操作キーのUNIQUE制約。同じ操作は何度届いても成立1回、結果は同じものを返す
過売り在庫確認とカード割当を同じトランザクションで実行。カードと購入は1対1のUNIQUE
二重付与台帳の付与IDにUNIQUE。同じ付与リクエストは1回だけ反映
残高の食い違い残高CHECK(0以上)+台帳に全増減を記録。管理画面の整合性チェックで常に検算

進め方(調査から本番公開まで)