連結部屋（続き部屋）ヘルプ
概要
連結部屋（続き部屋）機能を使うと、A室・B室をそれぞれ個別の部屋として販売しながら、同時に「AB スイート」としてまとめて一括販売することができます。AB を予約すると A と B の在庫が同時に消化され、A 単独の予約が入ると AB も自動的に塞がります。逆方向も同様に機能します。
主なユースケース:
- ホテルの隣室を繋いでスイートルームとして販売したい
- 2部屋を結んで家族向けの大部屋プランを提供したい
- 個室 + リビングルームをセットで販売したい
iCal 連携（OTA 連携）について: 今リリースでは iCal 同期は未対応です。Airbnb などの OTA と連携している施設では、本機能を有効化しないでください。対応予定は Issue #1052 で追跡中です。
できること
| 機能 | 説明 |
|---|---|
| 連結部屋の作成 | 既存の物理部屋 2〜16 件を組み合わせた「続き部屋」を定義する |
| 在庫の自動連動 | AB を予約すると A・B 個別の在庫が同時に消化される |
| 自動ブロック | A 単独が予約されると AB が自動でブロックされる（逆も同様） |
| 名前・タイプの設定 | 連結部屋に独自の表示名と部屋タイプを設定できる |
| 編集・削除 | 連結部屋の設定はいつでも編集・削除できる（予約中は削除不可） |
| KEYVOX 鍵の自動発行 | 連結部屋に割り当てた 1 つの KEYVOX ユニットから鍵 1 本（PIN / QR）が自動発行される。全メンバ部屋のロックは KEYVOX 側でそのユニットにまとめておく |
設定手順
事前準備
連結部屋を作成する前に、以下を確認してください。
- 物理部屋が登録済みか確認する — 施設設定 → Rooms タブ → 部屋一覧 で、メンバにしたい部屋が存在することを確認します
- スイート用の部屋タイプを作成する — 施設設定 → Rooms タブ → 部屋タイプ で、「AB スイート」などの部屋タイプを先に作成しておきます（連結部屋作成フォームで選択します）
連結部屋の作成手順
メインアプリ上部メニューから 施設設定（歯車アイコン） を開きます
Rooms タブ（左から 4 番目）を選択します
連結部屋 サブタブ（5 番目のタブ）をクリックします
「+ 連結部屋を作成」 ボタンをクリックします
フォームに以下を入力します：
項目 説明 例 名前 予約画面・管理画面に表示される名前 AB Suite、ひろすイートタイプ あらかじめ作成しておいた部屋タイプを選択 スイートメンバ部屋 組み合わせる物理部屋をチェックボックスで選択（2〜16 件） 101号室、102号室「保存」 をクリックします
保存が完了すると、連結部屋一覧にテーブル行として表示されます。予約画面には A 室・B 室・AB（連結）の 3 室が並ぶようになります。
KEYVOX で鍵を発行する場合は、続けて次の「連結部屋へのロック割り当て」を行ってください。
連結部屋へのロック割り当て（KEYVOX 利用時は必須）
鍵は連結部屋自身に割り当てた KEYVOX ユニットから発行されます。メンバ部屋（A 室・B 室）にロックが割り当てられていても、連結部屋自身に割り当てが無いと鍵を発行できません。
- KEYVOX の管理画面で、A 室・B 室のロックをまとめた連結部屋用のユニットを用意します（1 つのユニットに全メンバ部屋のロックを紐づける）
- Rooms タブ → ロック割り当て サブタブを開きます
- 一覧から連結部屋の行（A 室・B 室ではなく AB 側）を選び、手順 1 のユニットを割り当てます
注意: 連結部屋自身にユニットが無い状態で予約が入ると、鍵を発行できないため予約は確定せず、自動的にキャンセル・全額返金となります（FATAL refund）。
連結部屋の編集
- 連結部屋タブの一覧から対象の行を見つけます
- 右端の 「編集」 ボタンをクリックします
- 名前・タイプ・メンバ部屋を変更して 「保存」 をクリックします
連結部屋の削除
- 連結部屋タブの一覧から対象の行を見つけます
- 右端の 「削除」 ボタンをクリックします
- 確認ダイアログで 「削除」 をクリックします
注意: アクティブな予約が紐づいている間は削除できません（409 エラーが表示されます）。既存予約をキャンセルしてから削除してください。
予約フロー（ゲスト視点）
連結部屋を作成すると、ゲスト向け予約画面に以下のように表示されます。
- 予約ページを開くと、A 室・B 室・AB（連結部屋）が別々の選択肢として並ぶ
- ゲストが AB を選択して予約を完了すると、A 室と B 室の両方の在庫が自動で消化される
- 別のゲストが A 室を個別予約しようとすると、AB は自動でブロックされ選択不可になる
- チェックイン時、KEYVOX が設定されていれば鍵 1 本（PIN コード / QR コード）が表示される。この 1 本で A 室・B 室の両方のロックを開けられる（部屋ごとに別々の鍵は出ない）
よくある質問
Q: アクティブな予約がある間に連結部屋を削除しようとするとどうなりますか？
削除がブロックされ、エラーが表示されます（409 Conflict）。連結部屋に紐づいている予約をすべてキャンセルしてから削除してください。メンバ部屋（A 室・B 室）自体は削除されず、そのまま残ります。
Q: KEYVOX の鍵は自動発行されますか？
はい。連結部屋の予約では、連結部屋自身に割り当てた KEYVOX ユニットから鍵が 1 本（PIN / QR）自動発行されます。ゲストに表示される鍵は 1 本で、ラベルは連結部屋の名前です。A 室と B 室のロックは KEYVOX 側でそのユニットにまとめてあるため、この 1 本で両方のドアを開けられます。部屋ごとに別々の鍵は表示されません。
重要: 連結部屋自身に KEYVOX ユニットが割り当てられていないと鍵を発行できません。その場合、予約は確定せず自動的にキャンセルされ全額返金となります（FATAL refund）。メンバ部屋（A 室・B 室）へのロック割り当てだけでは足りません。
Q: Airbnb（OTA）と iCal 連携している施設でも使えますか？
今リリースでは未対応です。 iCal 同期との組み合わせは現時点でサポートされていません。OTA 連携施設では本機能を有効化しないでください。iCal 対応は Issue #1052 で計画中です。
Q: 連結部屋自体をメンバ部屋として別の連結部屋に組み込めますか？
できません。連結部屋（composite）をメンバに指定しようとすると、選択肢に表示されません（DB トリガーでもブロックされます）。連結部屋はかならず物理部屋のみで構成してください。
Q: 異施設の部屋をメンバに追加できますか？
できません。メンバに選択できるのは同じ施設の物理部屋のみです。異施設の部屋を指定しようとすると、DB レベルでブロックされます。
Q: 連結部屋専用の料金プランはどこで設定しますか？
連結部屋を作成しただけでは料金プランは付与されません。予約管理 → プラン設定 から、連結部屋に対応する料金プランを別途作成・紐付けする必要があります。プランと連結部屋のマッピングは RoomPlanMappingEditor から行います。
プランのクイックリンク機能（Issue #1055）は Phase 2 で対応予定です。
Q: フロントデスクアプリから連結部屋の予約を操作できますか？
フロントデスクアプリでの連結部屋対応は Issue #1056 で計画中です。現時点ではメインアプリのカレンダー・予約一覧からご確認ください。
トラブルシューティング
「連結部屋をメンバ部屋として選択できない」
連結部屋はメンバ部屋として選択できません（composite-of-composite 禁止）。選択肢には物理部屋のみが表示されます。
「メンバ部屋の候補が表示されない」
選択可能な部屋が存在しない場合、フォームに「選択可能な部屋がありません」と表示されます。先に 部屋一覧 タブで物理部屋を登録してください。
「保存しようとしたらエラーになった」
- 名前が空欄 — 名前は必須です
- タイプが未選択 — タイプを選択してください
- メンバ部屋が 1 件以下 — 2 件以上の部屋を選択してください
- メンバ部屋が 17 件以上 — 16 件以下に絞ってください
「削除しようとしたら 409 エラーが出た」
その連結部屋に紐づくアクティブな予約が存在します。予約をすべてキャンセルしてから削除してください。
「KEYVOX 鍵が発行されない」
- 連結部屋自身に KEYVOX ユニットが割り当てられているか確認してください（メンバ部屋への割り当てだけでは発行されません）
- KEYVOX 側で、そのユニットに全メンバ部屋のロックがまとめられているか確認してください（まとまっていないと、鍵は出ても一部のドアが開きません）
- ロック割り当てタブ（Rooms → ロック割り当て）で割り当て状況を確認できます
- 鍵発行に問題が生じた場合は FATAL refund が発動し、予約がキャンセルされます