# ロッカー管理 ヘルプ ## 概要 ロッカー管理は、施設でKEYVOX連携スマートロッカーの短期レンタルサービスを運営するための管理画面です。ロッカーのサイズ・料金・割り当てスマートロックを「ロッカー設定」として定義し、ゲスト向けの予約URLを発行します。注文一覧では稼働状況をリアルタイムで確認でき、個別の注文詳細からアクセスコードの確認やキャンセル操作が行えます。 メインナビゲーションから **ロッカー管理** を選択するとロッカーダッシュボードが開きます。 --- ## ゲストの予約フロー（全体像） ゲストは施設から共有されたURLにアクセスし、次の4ステップで予約を完了します。 | ステップ | 画面 | 内容 | |---------|------|------| | 1 | サイズ選択 | 利用可能なサイズをKEYVOX在庫からリアルタイム表示 | | 2 | 期間・モード選択 | ボックスモードと利用日程を選択、料金が自動計算される | | 3 | 確認・決済 | ゲスト情報入力 → Stripe決済 | | 4 | 完了 | PINコード・QRコード・ボックス番号が表示される | --- ## 詳細機能 ## 機能1: ロッカーダッシュボード（注文一覧） ダッシュボードは `/locker` にあり、施設のロッカー注文を一覧表示します。 ### 統計バー 画面上部に3つの集計カードが表示されます： | カード | 説明 | |--------|------| | 利用中 | 現在利用中（`checked_in`）の注文件数 | | 本日の収益 | 本日作成された支払い済み注文の合計金額 | | 合計収益 | 表示期間内の支払い済み注文の合計金額 | ### ステータスフィルター | フィルター | 表示内容 | |-----------|---------| | 全て | ステータスに関わらずすべての注文 | | 確定済 | 予約確定済みで利用開始前の注文 | | 利用中 | 現在ロッカーを利用中の注文 | | 完了 | レンタル期間が終了した注文 | | キャンセル | キャンセルされた注文 | 「全て」表示時は各ステータスの件数バッジが表示されます。 ### 検索・日付フィルター - **テキスト検索**: ゲスト名・注文番号の一部を入力すると400ミリ秒のデバウンスを経て自動的に絞り込まれます - **日付範囲**: デフォルトは30日前〜90日後。DateRangePickerで期間を変更できます - **リセット**: すべてのフィルターをデフォルト状態に戻します ### 注文カードの表示項目 | 項目 | 説明 | |------|------| | ゲスト名 / メール | 予約したゲストの氏名またはメールアドレス | | ステータスバッジ | 現在のステータス | | 金額 | 注文の合計金額（未払いの場合は「未払」バッジが表示） | | サイズ | ロッカーのサイズと名称 | | レンタル期間 | 開始〜終了日時 | | 予約番号 | 内部の予約ID | | メール | ゲストのメールアドレス | 注文カードをクリックすると注文詳細ページに移動します。 --- ## 機能2: ロッカー設定一覧 ロッカーダッシュボード右上の **ロッカー設定** ボタン、またはサイドナビから `/locker/config` にアクセスします。 各設定カードには設定名・有効/無効ステータス・通貨が表示されます。 ### 操作ボタン | ボタン | 説明 | |--------|------| | URLコピーアイコン | ゲスト向けロッカー予約URLをクリップボードにコピー | | 編集アイコン | ロッカー設定編集フォームを開く | | 削除アイコン | 確認後にロッカー設定を削除 | > 注意：設定を削除すると以後そのURLでの新規予約は受け付けられなくなります。既存の注文には影響しません。 --- ## 機能3: ロッカー設定の作成・編集 設定一覧右上の **新規ロッカー設定** をクリック、または既存設定の編集アイコンをクリックするとフォームが開きます。 ### 基本項目 | 項目 | 説明 | 必須 | |------|------|------| | 設定名 | 管理用の名称（例:「1Fロッカー 2026年夏」） | 必須 | | 有効 / 無効 | ゲスト向け予約の受付可否を切り替えるトグル | — | | 説明 | 任意の補足説明 | 任意 | | 通貨 | JPY / USD / EUR から選択 | — | | タイムゾーン | 日付計算に使用するタイムゾーン（デフォルト: Asia/Tokyo） | — | ### KEYVOXデバイス連携（推奨） KEYVOXと連携している施設では、デバイス情報を自動取得してサイズ定義を自動入力できます。 1. **デバイス取得** ボタンをクリックします 2. KEYVOXに登録されたロッカーデバイスの一覧が表示されます 3. ドロップダウンからデバイスを選択すると、ボックスサイズ・ボックス番号が自動入力されます 4. 各サイズ行で料金のみ入力すれば設定が完了します > KEYVOXが未接続の場合やエラーが発生した場合は、右上の **手動入力に切替** ボタンで手動入力モードに切り替えられます。 ### サイズ定義 1つの設定に複数のサイズ（S / M / L / カスタム）を定義できます。各サイズ行に以下を入力します： | 項目 | 説明 | |------|------| | サイズ | S / M / L / カスタム から選択 | | 表示名 | ゲストに表示されるロッカー名称（例:「S（小）」） | | 長期日額 | 長期レンタルモード（出し入れ自由）の1日あたり料金 | | 一回預け日額 | 一回預けモード（1回開閉のみ）の1日あたり料金 | | KEYVOX Unit IDs | 手動入力時のみ。該当サイズのKEYVOXスマートロックIDをカンマ区切りで入力 | > **2つの料金について**: ゲストは予約時に「一回預け」（1回開閉のみ・安価）か「長期預け」（期間中出し入れ自由・通常料金）かを選択します。それぞれ異なる日額を設定してください。 - **サイズを追加** ボタンで行を追加できます - 行の削除は各行右下の削除ボタン（×）をクリックします ### 共有URL（編集モードのみ） 設定を保存後、ゲスト向けロッカー予約URLが表示されます： ``` https://locker.unlockos.io?configId=<設定ID> ``` **URLをコピー** ボタンをクリックするとクリップボードにコピーされます。このURLをゲストに共有することでロッカーの予約受付が可能になります。 ### 保存と移動 - **保存**: 設定を保存してロッカー設定一覧に戻ります - **キャンセル**: 変更を破棄してロッカー設定一覧に戻ります --- ## 機能4: 注文詳細 注文一覧のカードをクリックすると注文詳細ページ（`/locker/order/:id`）が開きます。 ### 表示セクション | セクション | 表示内容 | |-----------|---------| | ゲスト情報 | 名前・メールアドレス・電話番号 | | ロッカー情報 | 予約ID・サイズ・ボックス名・ボックス番号・ボックスモード・レンタル期間・備考 | | 決済情報 | 金額・決済状態（paid / unpaid） | | アクセスコード | PINコードと有効期限（発行済みの場合のみ） | | キャンセル情報 | キャンセル日時と理由（キャンセル済みの場合のみ） | | タイムスタンプ | 作成日時・更新日時 | ### キャンセル操作 注文が「完了」または「キャンセル済み」でない場合、**キャンセル** ボタンが表示されます。 1. **キャンセル** ボタンをクリックします 2. 確認ダイアログが表示されます 3. **キャンセルする** をクリックして確定します — この操作は取り消せません --- ## ロッカー運用の設定手順（ステップバイステップ） ### ステップ1: ロッカー設定を作成する **ロッカー設定** 一覧から **新規ロッカー設定** をクリックし、設定名・通貨・タイムゾーンを入力します。 ### ステップ2: KEYVOXデバイスを選択してサイズを定義する **KEYVOXから取得（推奨）:** 1. **デバイス取得** をクリックしてKEYVOXに登録されたデバイスを読み込みます 2. ドロップダウンからデバイスを選択するとボックスサイズ・番号が自動入力されます 3. 各サイズ行に「長期日額」と「一回預け日額」を入力します **手動入力（KEYVOXが未接続の場合）:** 1. **手動入力に切替** をクリックします 2. 各サイズ行にサイズ・表示名・両方の日額料金・KEYVOXスマートロックIDを入力します 3. **サイズを追加** で複数サイズを定義できます ### ステップ3: URLをゲストに共有する 設定を保存すると共有URLが生成されます。**URLをコピー** をクリックしてゲストにメール・Webサイト・QRコードなどで共有します。 --- ## よくある質問 ### Q: 料金はどのように計算されますか？ レンタル期間の日数 × ボックスモードに対応する日額料金で計算されます。ゲストが「一回預け」を選択した場合は一回預け日額、「長期預け」を選択した場合は長期日額が適用されます。 ### Q: 「一回預け」と「長期預け」の違いは何ですか？ | モード | 開閉 | 用途 | 料金 | |--------|------|------|------| | 一回預け（ボックスモード 1） | 1回のみ（取り出したら終了） | 短時間の荷物預け | 一回預け日額 × 日数 | | 長期預け（ボックスモード 2） | 期間中出し入れ自由 | 複数日にわたる保管 | 長期日額 × 日数 | ゲストは予約のステップ2でモードを選択します。 ### Q: PINコードはいつ発行されますか？ ゲストが予約を完了し、決済が確認された後に自動で発行されます。PINコードは注文詳細の「アクセスコード」セクションで確認できます。 ### Q: PINコードの有効期限はいつまでですか？ アクセスコードの有効期限は注文詳細の「アクセスコード」セクションに表示されます。通常はレンタル期間の終了時刻に設定されます。 ### Q: ロッカー設定を無効にするとどうなりますか？ 設定を無効にすると、そのURLでの新規予約は受け付けられなくなります。既存の注文には影響しません。 ### Q: キャンセルした注文の料金は返金されますか？ キャンセル操作はステータスを「キャンセル」に変更するだけです。返金処理はお使いの決済サービスに応じて別途行ってください。 ### Q: 同じ設定に複数のサイズを追加できますか？ はい。1つのロッカー設定にS・M・Lなど複数のサイズを定義できます。ゲストは予約時にサイズを選択します。 ### Q: KEYVOXデバイス取得でエラーが出る 施設にKEYVOX APIキーが設定されているか確認してください（**基本設定** → KEYVOX連携）。APIキーが正しく設定されていれば **手動入力に切替** を使用して設定を続けることもできます。 ### Q: ロッカーが表示されない・予約できない 以下を確認してください： 1. ロッカー設定が **有効** になっているか 2. サイズ定義にKEYVOX Unit IDが正しく入力されているか（手動モードの場合） 3. URLのconfigIdが正しい設定を参照しているか 4. 対象サイズの在庫（利用可能なボックス数）が0になっていないか --- ## 関連ページ - [鍵接続](lock-connection.md) - [プラン一覧（料金プランの管理）](plan-list.md) - [予約管理ダッシュボード](booking.md) --- 最終更新: 2026-03-31 - KEYVOXデバイス自動取得、ボックスモード（一回預け/長期預け）、二段階料金設定を追記