<!-- https://unlockos.io/ja/manual/shared-capacity-booking -->

# 共有型予約（コワーキング席予約）ヘルプ

## 概要

共有型予約とは、コワーキングスペースや共用ラウンジのように、複数のゲストが同じスペースを同時に利用する形式の予約機能です。1つのスペースに設定された「席数（共有キャパシティ）」の範囲内で、それぞれのゲストが必要な席数を選んで予約できます。

**専有型**（ホテルの客室など）との違いは以下のとおりです：

| 比較項目 | 専有型 | 共有型 |
|---------|--------|--------|
| 利用形態 | 1予約 = 1室を独占 | 複数予約が同じスペースを共有 |
| 空き表示 | 「N室あり」 | 「残りN席」 |
| 席数選択 | なし | [- N +] ステッパーで選択 |
| 料金計算 | 単価 × 泊数/時間 | 単価 × 席数 × 泊数/時間 |
| アクセスキー | 1予約につき1つ | 1予約につき1つ（席数に関わらず） |

---

## 詳細機能

## 機能1: 管理者設定 — 部屋タイプへの「共有型」設定

管理者が部屋タイプを作成・編集する際に、**専有型** または **共有型** を選択します。

### 設定手順

1. 管理画面の **予約管理** → **部屋タイプ管理** を開きます
2. **新規作成** をクリックするか、既存の部屋タイプの **鉛筆（編集）アイコン** をクリックします
3. フォームの **予約タイプ** セクションでラジオボタンを選択します：
   - **専有型** — 1予約で1部屋を独占（ホテル・会議室など）
   - **共有型** — 複数予約が同じスペースを共有（コワーキング・共用ラウンジなど）
4. **共有型** を選択すると、**共有キャパシティ（席数）** 入力欄が表示されます
5. このスペースで同時に利用できる最大席数を入力します（例：10）
6. **保存** をクリックします

> **バリデーション：** 共有型を選択した場合、共有キャパシティ（席数）の入力は必須です。入力しないと保存できません。

### 部屋タイプ一覧での表示

部屋タイプカードには、設定された予約タイプが色付きバッジで表示されます：

| バッジ | 色 | 意味 |
|-------|---|------|
| 共有型 | ティール | 共有型スペース |
| 専有型 | グレー | 専有型スペース |

また、「共有キャパシティ（席数）」列（共有型の場合）または「総室数」列（専有型の場合、**紐づく部屋数から自動算出**）に、それぞれの値が表示されます。

### 設定できる項目一覧（フォーム）

| 項目 | 説明 | 必須 |
|-----|------|------|
| 名前 | 部屋タイプの表示名（例：「コワーキングデスク」） | はい |
| 説明 | ゲスト向けの説明文 | いいえ |
| 定員 | 1スペースの定員人数 | はい |
| 予約タイプ | 専有型 / 共有型 | はい |
| 対象の部屋 | 専有型の場合のみ表示。この部屋タイプに紐づく部屋を選択。**総室数（同時予約可能数）は選択した部屋数から自動算出**され、手入力はありません | 専有型の場合はい |
| 共有キャパシティ（席数） | 共有型の場合のみ表示。同時利用可能な最大席数 | 共有型の場合はい |
| アメニティ | カンマ区切りでアメニティを入力 | いいえ |
| 並び順 | ゲスト向けカードの表示順序（数値が小さいほど先） | いいえ |
| 有効 / 無効 | ゲスト向け予約ページへの表示切り替え | — |

---

## 機能2: ゲスト予約画面 — 席数の選択と予約

ゲストが共有型スペースを予約する際のフローを説明します。予約画面は **RoomPlanStepView**（部屋・プラン選択画面）として実装されています。

### 日程選択

通常の宿泊予約と同様に、カレンダーでチェックイン日 → チェックアウト日の順に選択します。

### 部屋カードの表示

日程を選択すると、利用可能な部屋・プランのカードが表示されます。共有型スペースのカードは専有型と以下の点が異なります：

| 表示要素 | 専有型 | 共有型 |
|---------|--------|--------|
| 空き表示 | N rooms（N室あり） | 残りN席（例：「残り8席」） |
| 売り切れ時 | （カードが表示されない場合あり） | 「Sold out」と表示され、ステッパー・予約ボタンが無効化 |
| 席数選択 | 表示なし | [- N +] ステッパーを表示 |
| 価格表示 | 単価 | 単価 × 席数（複数席選択時は1席あたりの価格も表示） |

### 席数ステッパーの操作

1. カードに表示された **[-]** または **[+]** ボタンをクリックして席数を調整します
2. 最小値は 1 席です（1席未満には減らせません）
3. 最大値は残り席数です（残席を超えて増やせません）
4. 席数を変更すると、カード内の合計金額がリアルタイムで更新されます
5. 席数が確定したら **Reserve（予約する）** ボタンをクリックします

### 料金の表示例

1席あたり ¥3,000 のスペースで 3席を選択した場合：

- **大きく表示される金額**：¥9,000（合計）
- **小さく表示される補足**：(¥3,000/席)

### 予約後のアクセスキー

共有型スペースでも、1つの予約に対して **1つのアクセスキー（PINコードまたはQRコード）** が発行されます。席数が複数であっても、鍵の数は変わりません。チームで入室する場合は、発行されたアクセスコードをグループで共有してください。

---

## 機能3: 管理画面での予約確認

管理者は予約ダッシュボードの複数の場所で、共有型予約の席数情報を確認できます。

### 予約一覧 — ×N席バッジ

予約一覧タブの各予約カードで、席数が 2 以上の共有型予約にはステータスバッジの隣に **×N席** バッジ（ティールカラー）が表示されます。

例：3席予約した場合、ステータスバッジの右に「×3席」と表示されます。

席数が 1 の場合はバッジは表示されません（通常の専有型予約と見た目が同じになります）。

### 予約詳細ドロワー — 内訳・同時間帯予約・ピーク使用

共有型予約の詳細ドロワーを開くと、金額の下に **内訳セクション** が表示されます。

#### 内訳（料金の計算式）

```
N席 × ¥単価/泊（または /時間）
```

例：3席 × ¥3,000/泊 の予約では「3 seats × ¥3,000/泊」と表示されます。

#### 同時間帯の他予約

同じ部屋タイプの同時間帯に他の確定済み予約がある場合、その一覧が表示されます：

| 列 | 内容 |
|----|------|
| ゲスト名 | 同時間帯を予約している他のゲスト |
| 時間帯と席数 | 開始〜終了時刻 と ×N席 |

この一覧には現在表示中の予約自身は含まれません。同時間帯の予約が存在しない場合はこのセクションは表示されません。

#### ピーク使用

同時間帯の他予約一覧がある場合、一覧の下に **ピーク使用** が表示されます：

```
ピーク使用: N / 最大席数席 (HH:MM - HH:MM)
```

- **N**：同時間帯に重なる全予約の席数合計のピーク値
- **最大席数**：部屋タイプに設定された共有キャパシティ
- **HH:MM - HH:MM**：ピーク使用が発生する時間帯

表示例（共有キャパシティ 10席、自分の予約3席、他に5席の予約が重なる場合）：

- ピーク使用：8 / 10席（ピーク時間帯）→ **ティールカラー**で表示（余裕あり）
- ピーク使用：10 / 10席（満席） → **コーラルレッド（赤系）** に変わり満席を警告

---

## 機能4: カレンダー表示（共有型）

カレンダーの週表示・タイムライン表示では、共有型スペースの予約が専有型とは異なる方法で視覚化されます。

### 部屋タイプヘッダーの席数表示

共有型の部屋タイプヘッダー行には、設定された共有キャパシティが括弧付きで表示されます：

```
コワーキングデスク (10席)
```

専有型の部屋タイプには括弧内の表示はありません。

### タイムライン表示 — 段積みバー

タイムライン表示（時間軸）では、共有型スペースの行が同時間帯の予約数に応じて **縦に段積み** されます。

- 各予約が独立したバーとして時間軸上に並んで表示されます
- バーの右端（または内部）に **×N**（例：×3）というラベルが表示されます（席数が2以上の場合）
- 行の高さは同時間帯の最大予約数に合わせて自動的に拡張されます
- バーをクリックすると予約詳細ドロワーが開きます

専有型の予約は1行につき1バーのみ表示されます。

### 週表示 — 段積みバー

週表示（7日間 × 部屋行）でも、同様に共有型スペースの行が段積みされます。

- 同じ日に複数の共有型予約がある場合、縦に積み上げて表示されます
- 各バーに **×N**（例：×2）のラベルが表示されます（席数が2以上の場合）
- 行の高さは1週間で最も予約が集中する日の予約数に合わせて拡張されます
- バーは複数日をまたぐ宿泊予約にも対応しています

---

## よくある質問

### Q: 共有型と専有型は同じスペースに共存できますか？

いいえ。1つの部屋タイプは「専有型」または「共有型」のいずれかです。同じスペースに両方の予約タイプを設定するには、別々の部屋タイプを作成してください。

### Q: 共有型で「残りN席」はどう計算されますか？

共有キャパシティから、対象日時に既に確定している予約の席数合計（`quantity`）を差し引いた値が残席数として表示されます。

例：共有キャパシティ = 10席、確定済み予約の席数合計 = 3 → 残り7席

### Q: 満席（Sold out）のカードはどうなりますか？

席数ステッパーと **Reserve** ボタンが無効化されます。別の日程を選択するか、空きが出るまでお待ちください。

### Q: 5席予約しましたが、鍵は5本もらえますか？

いいえ。1つの予約に対して発行されるアクセスキーは1つです。グループで入室する場合は、その1つのコードをメンバーで共有してください。

### Q: 共有型の部屋タイプを専有型に変更できますか？

はい。管理者は編集フォームで予約タイプを変更できます。ただし、既存の予約には影響しません。変更後の新規予約から新しいタイプが適用されます。

### Q: キャンセルした場合、席数は戻りますか？

はい。予約がキャンセルされると、その予約に紐づいていた席数は自動的に解放されます。解放後は他のゲストが予約できるようになります。

### Q: 共有型の部屋タイプに複数のプランを設定できますか？

はい。専有型と同様に、複数の料金プランを紐付けることができます。それぞれのプランで席単価が異なる設定も可能です。

### Q: 管理者がダッシュボードから予約を作成する際も席数を指定できますか？

管理者が予約ドロワーから手動で予約を作成する場合は、現在は席数1での予約となります。複数席の手動予約はゲスト向け予約ページ（RoomPlanStepView）から行ってください。

### Q: ダッシュボードの予約カードに「×N席」バッジが表示されません

席数が1の予約にはバッジは表示されません。2席以上の共有型予約のみバッジが表示されます。

### Q: ピーク使用が赤く表示されました

共有キャパシティに達している（または超えようとしている）ことを示します。コーラルレッドはピーク使用が共有キャパシティと一致または超過していることを意味します。この状態では新規予約を受け付けられないため、既存予約のキャンセル待ちか、日程変更をご検討ください。

---

## 関連ページ

- [コワーキング貸し切り予約（まるごと貸し切り機能）](coworking-whole-space.md)
- [予約管理ダッシュボード（管理者向け）](booking.md)
- [ゲスト予約アプリ（ゲスト向け予約フロー）](reservation-guest.md)
- [予約設定フォーム（プラン・設定の作成）](reservation.md)
- [プラン一覧（料金プランの管理）](plan-list.md)
