<!-- https://unlockos.io/ja/manual/hourly-week-grid-admin -->

# 週間グリッド設定（施設オーナー・管理者向け）

## 概要

時間貸し（hourly）タイプの施設では、ゲストの予約画面に週間グリッドが標準で表示されます。本ページでは、グリッドの表示に影響する管理者向け設定項目を説明します。

---

## 詳細機能

## 機能1: 最低利用時間の設定

プランごとに **最低利用時間** を設定できます。設定値は以下の5段階です。

| 設定値 | 説明 |
|--------|------|
| 15分 | 15分以上の予約が必要 |
| 30分 | 30分以上の予約が必要 |
| 60分 | 60分以上の予約が必要 |
| 90分 | 90分以上の予約が必要 |
| 120分 | 120分以上の予約が必要 |

この設定はグリッドの **時間粒度（セルの高さ単位）** にも影響します。例えば最低利用時間が90分の場合、グリッドは30分または60分粒度で表示され、90分未満の終了セルはストライプ（淡色）で表示されてタップ不可となります。

設定場所: プラン編集画面 → 「時間貸し設定」セクション

## 機能2: 営業時間の設定（曜日別）

週間グリッドは施設の `BaseSettings`（基本設定）に登録された **曜日別の営業時間** を参照します。

- 曜日ごとに異なる開始・終了時刻を設定できます（例：土曜は10:00〜18:00、平日は9:00〜22:00）
- 営業時間外のセルはストライプ（斜線）で表示され、ゲストはタップできません

> **重要:** プラン個別の `business_hours` 設定は今後廃止される予定です。営業時間は施設の基本設定から一元管理してください。

設定場所: 施設設定 → 基本設定（BaseSettings）→ 営業時間

## 機能3: 予約リードタイム（旧称: 最短予約時間）の設定

ホスト側の設定画面では「**予約リードタイム (h)**」という項目があります。これは **何時間前までに予約が必要か**（advance booking notice）を示すもので、最短滞在時間とは異なります。

例: リードタイムを2に設定すると、2時間後以降の時間枠のみ予約可能になります（直前予約の防止）。

> **注意:** 「最短滞在時間」（minimum stay）とは別の概念です。滞在の長さに関する制約は「最低利用時間」で設定します。

設定場所: プラン編集画面 → 予約リードタイム (h)

## 機能4: time_slot_week_grid フラグ（v2 新機能・オプトイン）

`time_slot_week_grid` はタイムスロット型プランを週間グリッドで表示するオプトインフラグです。

| 項目 | 内容 |
|------|------|
| デフォルト | **オフ**（旧来のタイムスロット一覧が表示される） |
| 有効化対象 | タイムスロット型プランを持つ施設 |
| Sunset 日 | **2026-12-01**（以降デフォルトオン化予定） |
| フラグ変更 | サポートが対象施設に設定 |

**有効化を推奨する施設の目安:**
- タイムスロット型（午前の部・午後の部など）の予約が多い施設
- ゲストから「他の日の空き状況をまとめて見たい」という要望がある施設
- モバイルユーザーが主体で、スワイプ操作に慣れているゲスト層

有効化後はゲストの確認画面で各ティアが丸みのあるブロックとして7日分のグリッドに表示されます。

## 機能5: 時間帯別料金ティア内訳の自動表示（v2）

`hourly_rate_tiers` に時間帯別料金（午前・午後・深夜パックなど）を設定すると、ゲストの確認画面で自動的に **ティア別の内訳** が表示されます。管理者側に追加のトグルや設定は不要です。

- 内訳には `max_daily_fee`（1日料金上限）が正しく反映されます（v2 Phase A バグ修正済み）
- `hourly_rate_tiers` を設定していない場合は従来通りの単価×時間表示のみ

設定場所: プラン編集画面 → 時間貸し設定 → 時間帯別料金（hourly_rate_tiers）

> **深夜パック（ナイトパック）の料金が変わる可能性があります。** これまで、深夜パックを設定していても実際の課金計算では適用されていませんでした（設定画面のシミュレーションには反映されていたため、シミュレーションと請求額がズレていました）。現在は深夜パックが実際に適用されます。設定済みのプランは深夜帯の請求額が変わるため、[料金プラン設定](plan-form.md) のシミュレーションで再確認してください。

> **曜日・祝日の判定について。** 料金段階（`hourly_rate_tiers`）の「平日 / 週末 / 祝日」チェックボックスと「週末・祝日料金」は、**施設のタイムゾーンの日付**と**施設の所在国の祝日データ**から自動判定されます。日本時間の 0:00〜9:00 に始まる予約も正しい曜日で課金されます。詳しくは [料金プラン設定 — 曜日・祝日による料金の決まり方](plan-form.md) を参照してください。

## 機能6: 旧フラグ（hourly_time_bar）について

過去のバージョンでは `hourly_week_grid` フィーチャーフラグで週間グリッドを有効化する方式でした。現在は週間グリッドが **標準（デフォルトオン）** となっています。

- `hourly_week_grid` フラグ: **廃止済み**（設定しても無視されます）
- `hourly_time_bar` フラグ: 旧来のタイムバー（開始/終了ドロップダウン）画面に戻したい場合のみ使用します

> **いつ `hourly_time_bar` を使うか:** タイムバー形式の方がゲストに馴染みやすい施設、または週間グリッドへの移行を段階的に行いたい場合に限り有効化してください。

フラグの変更はサポートが行います。

---

## よくある質問

### Q: 週間グリッドを無効にして旧画面に戻せますか？

はい。サポートに `hourly_time_bar` フラグの有効化をご依頼ください。有効にすると、ゲストには旧来の開始/終了ドロップダウン形式が表示されます。

### Q: 土曜と平日で営業時間を変えるにはどうすればいいですか？

施設基本設定（BaseSettings）の営業時間で曜日ごとに開始・終了時刻を設定してください。週間グリッドは各曜日の設定を自動的に参照し、営業時間外のセルをストライプ表示します。

### Q: 最低利用時間を設定するとグリッドの見た目はどう変わりますか？

最低利用時間に満たない終了セルがストライプ（淡色）で表示され、ゲストはタップできなくなります。例えば90分が最低利用時間の場合、開始セルから数えて90分未満の範囲にある終了候補セルはすべてストライプ表示になります。

### Q: time_slot_week_grid をいつ有効化すべきですか？

タイムスロット型（午前の部・午後の部など）の予約が多く、ゲストが複数日の空き状況を一度に比較したいケースで UX 改善が期待できます。1日1タイムスロットしかない施設、または旧来のリスト形式でゲストが迷わず操作できている施設では、Sunset（2026-12-01）前に移行してもメリットが小さい場合があります。有効化はサポートへご依頼ください。

### Q: 「予約リードタイム」と「最低利用時間」の違いは何ですか？

| 設定 | 意味 | 例 |
|------|------|-----|
| 予約リードタイム (h) | 何時間前までに予約が必要か（事前予約通知時間） | 2 → 2時間後以降の枠のみ予約可 |
| 最低利用時間 | 1回の予約で最短何分必要か | 90 → 90分未満の予約不可 |

---

## 関連ページ

- [週間グリッドで時間を選んで予約する（ゲスト向け）](hourly-week-grid-guest.md)
- [プラン設定](plan-form.md)
- [基本設定](base-settings.md)
- [予約管理ダッシュボード](booking.md)
- [売止め](sales-blocks.md) - 時間帯・曜日を指定した売止めがグリッドのどのセルを塞ぐか
