連携の仕組みと進め方
このデモは、既存システムの「代役」を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以上)+台帳に全増減を記録。管理画面の整合性チェックで常に検算 |
進め方(調査から本番公開まで)
- 調査:既存ソース・DB・認証方式を確認し、API化する範囲と除外項目を確定
- 連携層の実装:認証 → 残高 → 商品・封入 → 購入トランザクション → ログ・管理画面の順に、動く単位で納品
- 検証:同時購入テスト、再送テスト、整合性チェックの結果をレポート
- 公開:ステージング確認 → 本番反映 → 導入・更新手順書を納品