METRO MARATHON 2027 · Pickup System
記念商品 受取システム 構成図
購入から受取までの流れ
購入者
海外ランナー
商品を購入
記念シューズ・アパレル
受取枠(Slot)を選択
満席の枠は選択不可
受取QRを受け取る
マイアカウント/メール
会場でQR受付
事前QRをセルフ端末が読取→即判定
呼び出し → 受取
番号+カウンター表示
各システムの役割(3者が連携)
Shopify
購入者が操作する画面(買う)
画面=Shopifyテーマ(Liquid+JSで我々のAPIを呼ぶ)
- ストアフロント(テーマ)
- 商品カタログ
- カート・決済・注文
- マイアカウント
- 注文確認メール
- 多言語(英/簡/繁)
受取管理サーバー
受取の頭脳(Shopifyに無い機能)
画面を持たない(API・データ・配信)
- 受取枠の在庫・上限管理
- QRコードの発行
- チェックイン管理
- 受取時間の判定
- 受付番号の採番・カウンター割当
- リアルタイム配信
会場設備
サーバーとつながる会場端末
画面=新規開発(Shopify外の独自View)
- KIOSK端末(QR読取)
- スタッフ端末
- 大型ディスプレイ
受取管理サーバーの中身(技術スタック)
規模感(前回3,100名 → 今回は目標+56%で概算4,800名前後・3日間・初日AM集中)はSupabase + Vercel で十分。AWS前提なら Vercel→ECS/Lambda、 Supabase→RDS+AppSync 等に読み替え可能です。
API層・ホスティング(Vercel / Next.js)
処理を動かす場所
- 受取API:枠・注文・チェックイン・呼び出し(JSONを返す)
- Shopify連携:Webhook受信(orders/create)+ Admin API
- 会場3画面(KIOSK/スタッフ/ディスプレイ)=唯一の画面描画
- QRトークンの生成
データ・リアルタイム・認証(Supabase)
状態の唯一の正(Single Source of Truth)
- Postgres:注文・受取枠・チェックイン・カウンター
- 枠の上限制御(原子的更新で超過を防止)
- Realtime:ディスプレイへ即時配信
- Auth:スタッフ端末のログイン
外部連携
つながる先
- Shopify(決済・注文・顧客)
- メール配信(QRを同梱)
- 会場端末(同一サーバーへ接続)
Shopify側の作り方:商品一覧・詳細・カートは既存のShopify画面のまま。 受取枠セレクタやQR表示は テーマ(Liquid+JS)から我々のAPIを呼んで描画 します (画面はShopifyが描画/我々はデータを返すAPI)。 本格的な管理画面アプリの開発は不要で、必要なのは注文取得のための薄いカスタムアプリ(Webhook+Admin API) のみ。 独自に画面そのものを作るのは会場端末だけです。
いつ・どのAPIが動くか(シチュエーション別)
APIはすべて受取管理サーバー。下記は本デモで実際に動いているエンドポイントと同一です。
| # | シチュエーション | 画面(どこで) | API(サーバー処理) | 内容 |
|---|---|---|---|---|
| 1 | 受取枠を表示 | Shopify(枠選択) | GET /api/slots | 各枠の残数を返す → 満席はグレーアウト |
| 2 | 注文を確定 | Shopify→サーバー(自動) | Webhook orders/create | 注文を保存+選択枠を +1(原子的に確定)+ QR発行 |
| 3 | QRを表示 | Shopify(Thank you/メール/マイページ) | GET /api/orders/:id | 発行済みQRを表示 |
| 4 | 受取枠を変更 | Shopify(マイページ) | POST /api/orders/:id/reschedule | 旧枠 -1・新枠 +1(空きが無ければ拒否) |
| 5 | 会場で受付 | 会場KIOSK | POST /api/checkin | 現在時刻×受取枠を判定 → 枠内は受付番号採番/枠外は案内 |
| 6 | 準備完了 | 会場スタッフ端末 | POST /api/orders/:id/ready | カウンター確定 → 呼び出し中へ |
| 7 | 呼び出し表示 | 大型ディスプレイ | Supabase Realtime | 受付番号+カウンターを即時描画 |
| 8 | 受渡完了 | 会場スタッフ端末 | POST /api/orders/:id/complete | 完了 → ディスプレイから消える |
初日AMの同時アクセス対策:受取枠の確定は Postgres の原子的更新(枠が空いている時だけ +1)で行うため、 同時に殺到しても超過予約は発生しません。前回の需要集中を仕組みで捌きます。
打ち合わせで確認したい点(要件定義ですり合わせ)
現時点で決め切らず、双方で握って進めたい項目です。
受取枠の押さえ方(A案/B案)
既定は A案:カートで枠を選び、注文成立時に確定(Shopifyで一般的)。 同時アクセスでも サーバーの原子的更新で超過予約を防止 します (本デモに実装済み:満席は自動グレーアウト+確定拒否)。B案:チェックアウト内で選択 は要件次第の拡張で 費用差は限定的。 まずAで進め、必要になれば拡張します。
枠(Slot)設計
- ☐枠の粒度(30分/15分 など)※現状デモは30分刻みの仮置き
- ☐1枠あたりの上限人数(来場者数×カウンター処理能力から逆算)
- ☐受取の営業時間・日別の配分(初日AMピークの厚み)
- ☐予約変更の締切・回数、キャンセル可否(前回はキャンセル不可)
受付・チェックイン
- ☐★受付方式【提案】事前QRを会場セルフ端末(iPad等・無人・複数台)が読取り即判定。紙・ピッキング不要。
- ☐枠外来場(早すぎ/遅刻)の扱い:案内のみ/空きあれば通す/当日枠へ振替
- ☐受付の猶予時間(開始何分前〜何分後まで受付可)
- ☐QRの二重利用・スクショ転用対策、本人確認・代理受取の要否
受け渡し・当日
- ☐カウンター割当ルール(商品種別で分ける/自動割当 など)
- ☐未受取(no-show)の扱い(後日発送/返金なし 等。前回は入金済)
- ☐会場でのサイズ交換・返品対応(前回はサイズ起因4.9%)
- ☐呼び出し後に来ない人の扱い(再呼び出し/スキップ)
会場設備
- ☐KIOSK端末(iPad等)の台数・調達担当
- ☐大型ディスプレイ・会場設営の調達担当
- ☐受取カウンター数(前回10)・当日の同時ピーク規模
体制・分担
- ☐Shopifyテーマ(デザイン構築)の担当分担(当社はサーバー+連携が主)
- ☐受取時間変更は顧客セルフ(RFP方針)で確定か
- ☐当日運営は範囲外(緊急連絡体制は保持)で合意
- ☐保守範囲・定例会議・連絡体制(RFP要求項目)
多言語・連携・オプション
- ☐多言語(英/簡/繁)の適用範囲(UI/メール/会場画面)
- ☐決済(海外カード・返金)・個人情報(越境データ・Privacy)
- ☐会員SSO:スコープ/オプション/別フェーズ
- ☐ロジ運用ベンダー(新/旧未定)連携・CS(Zendesk等)の範囲・前回の枠選択実装