<!-- https://unlockos.io/ja/manual/base-settings -->

# 基本設定 ヘルプ

## 概要

基本設定では、施設全体に適用される共通設定を管理します。通貨、税率、営業時間、チームメンバーなどの設定を行います。

![基本設定画面](https://unlockos.io/help/images/base-settings/main.ja.webp)

## 主な機能

- 施設名・通貨・タイムゾーン設定
- 各種アプリURL（施設スラッグ）の設定
- アプリURL一覧パネル（コピーボタン・QRコード付き）
- ショートURLポータル（`go.unlockos.io/{slug}`）
- 税率と税計算タイプの設定
- 営業時間の設定（曜日別・祝日対応）
- 特定日・シーズンの営業時間設定（区分の作成は「特定日」タブ）
- チームメンバー管理

---

## タブ

| タブ名 | 説明 |
|-------|------|
| 施設基本設定 | 施設の基本情報と営業時間を設定 |
| 特定日 | 売止めと特定日・シーズンの設定 |
| チーム | チームメンバーの招待と管理 |

---

## 施設基本設定タブ

### 施設情報

| 項目名 | 説明 | 必須 |
|-------|------|------|
| 施設名 | 施設の表示名 | はい |
| 各種アプリURL | 各アプリで利用する基本URL識別子（スラッグ） | いいえ |
| 施設概要 | 施設の概要説明（テキストまたはURL） | いいえ |
| 利用規定 | 施設の利用規定（テキストまたはURL） | いいえ |
| プライバシーポリシー | 施設のプライバシーポリシー（テキストまたはURL） | いいえ |

### 各種アプリURL（施設スラッグ）

置き配・予約・チェックインなど各アプリで利用する基本URL識別子です。

**URL形式:** `xxx.unlockos.io/{スラッグ}`

例: スラッグを `sakura-mansion` に設定すると、各アプリのURLは `xxx.unlockos.io/sakura-mansion/` の形式になります。

#### スラッグの設定規則

| 条件 | 説明 |
|------|------|
| 使用できる文字 | 英小文字（a〜z）、数字（0〜9）、ハイフン（-） |
| 最小文字数 | 3文字以上 |
| 形式 | 英小文字または数字で始まり、英小文字または数字で終わる |
| 一意性 | 他の施設と重複不可 |

入力中にリアルタイムで重複チェックが行われます。

- チェックマーク（✓）: 使用可能
- バツマーク（✗）: 既に使用されているか、形式が不正

#### スラッグとQRコードの関係

スラッグを設定すると、置き配管理の「QRコード」タブに表示される各部屋の登録QRコードが、スラッグベースのURL（`resident.unlockos.io/{スラッグ}/register?room=...`）を使用するように変わります。

スラッグを変更した場合、既存のQRコード（旧スラッグのURL）は無効になります。変更後は必ずQRコードを再印刷して居住者に配布してください。

> スラッグは施設作成時に自動生成されます。必要に応じて変更できますが、変更後は既存のQRコードが使えなくなるため、慎重に行ってください。

#### アプリURL一覧パネル

有効なスラッグ（3文字以上・重複なし）を入力すると、スラッグ入力欄の下に施設のアプリURL一覧パネルが表示されます。

| 項目 | URL形式 |
|------|---------|
| ショートURL（ポータル） | `go.unlockos.io/{slug}` |
| チェックイン | `checkin.unlockos.io/{slug}` |
| 予約 | `booking.unlockos.io/{slug}` |
| ロッカー | `locker.unlockos.io/{slug}` |
| 居住者登録 | `resident.unlockos.io/{slug}/register` |
| フロントデスク | `frontdesk.unlockos.io/{slug}` |

各URLの右にはコピーボタンがあります。クリックするとHTTPS形式の完全なURLがクリップボードにコピーされ、「コピー済み」の表示に切り替わります。

ショートURLには**QRコード**（120 × 120 px）も表示されます。ゲストがこのQRコードをスキャンすると `go.unlockos.io/{slug}` のポータルページに到達し、施設で有効な各アプリへのリンクが一覧表示されます。

> スラッグが空・3文字未満・使用済み・形式不正のいずれかの場合、パネルは非表示になります。

---

#### 施設情報フィールドの入力方式

施設概要・利用規定・プライバシーポリシーの各フィールドには、2つの入力方式があります。ラジオボタンで切り替えてください。

| 入力方式 | 説明 |
|---------|------|
| テキスト入力 | テキストエリアに直接文章を入力します |
| URL指定 | 外部ページのURLを入力します（例：自社ウェブサイトの規約ページ） |

入力方式を選択しない場合、そのフィールドは空のまま保存されます。これらの情報は予約や置き配（おきはい）などのゲスト向け画面で表示されます。

### 通貨・税金設定

| 項目名 | 説明 | 必須 |
|-------|------|------|
| 通貨選択 | 使用する通貨（JPY/USD/EUR） | はい |
| タイムゾーン | 施設のタイムゾーン（料金計算・曜日/祝日の判定・営業時間判定に使用） | はい |
| 税率 (%) | 適用する消費税率 | はい |
| 税金計算タイプ | 税金の計算方法を選択 | はい |

#### 税金計算タイプの選択肢

| 選択肢 | 説明 |
|-------|------|
| 外税 | 税抜価格に税金を追加して表示 |
| 内税 | 表示価格に税金を含む |
| 非課税 | 税金なし |

### 祝日設定

| 項目名 | 説明 | 必須 |
|-------|------|------|
| 祝日自動判定対応国コード | 祝日を自動判定する国（JP/US/DE） | いいえ |

> **料金プランの祝日料金はこの項目では制御されません。** 料金計算（祝日料金・祝前日料金・週末料金の選択）で使われる祝日判定は、**施設管理画面の「所在国」** を参照します。所在国が未設定の施設では祝日判定が行われず、祝日も通常の曜日として課金されます。曜日別料金の優先順位や設定方法は [料金プラン設定](plan-form.md) を参照してください。

---

### 営業時間設定

| 項目名 | 説明 | 必須 |
|-------|------|------|
| 24時間営業 | 有効にすると営業時間制限なし | いいえ |
| デフォルト平日営業時間 | 月〜金曜日の営業時間 | いいえ |
| デフォルト週末営業時間 | 土・日曜日の営業時間 | いいえ |

#### 個別の曜日設定

「個別の曜日設定を表示」をクリックすると、曜日ごとに異なる営業時間を設定できます。

| 項目名 | 説明 |
|-------|------|
| 日〜土 | 各曜日の営業時間（チェックで有効化） |

#### 祝日営業時間

| 項目名 | 説明 |
|-------|------|
| デフォルト営業時間を使用 | チェックするとデフォルト設定を適用 |
| 祝日営業開始時間 | 祝日の営業開始時刻 |
| 祝日営業終了時間 | 祝日の営業終了時刻 |

#### 特定日・シーズンの営業時間

営業時間セクションの中にあります。**設定 → 「特定日」タブ**で作成した区分ごとに、その期間だけの営業時間（または24時間営業）を設定できます。ここで新しい区分は作成できません（区分の作成は「特定日」タブの「特定日・シーズン」）。「夏季だけ22時まで」「お盆だけ24時間」といった運用を、季節ごとに手で書き換えずに済ませられます。

区分の営業時間は**曜日ごとの個別設定より優先**され、予約可能時間・営業時間外チェックインの可否・自動チェックアウト時刻に同時に反映されます。設定方法・優先順位・既存予約への影響は [季節の営業時間](seasonal-business-hours.md) を参照してください。

> **区分の作成場所と営業時間の保存場所は別です。** 区分そのものは「特定日」タブで作りますが、その営業時間は**この営業時間セクションの保存ボタン**で保存します（営業時間と同じデータを書くため）。施設ごとに段階的に有効化しているため、入力欄がまだ表示されない場合があります。

---

### 特定日・シーズン（「特定日」タブに移動しました）

ハイシーズン・お盆・大晦日など**施設独自の日付区分**を作成し、その期間だけ別の料金を適用する機能は、**設定 → 「特定日」タブ**に移動しました。以前はこの「営業時間」セクションのすぐ下にありましたが、区分の作成・編集はそちらで行ってください。

作成した区分は各料金プランにタブ（時間課金プランでは分単価の行）として現れ、祝日・週末・曜日より優先して適用されます。設定項目・制限事項・既存予約への影響は [特定日・シーズン](date-classes.md) を参照してください。

> 「特定日」タブには、この特定日・シーズンの上に**売止め**（[売止め](sales-blocks.md)）もあります。特定日・シーズンは「その日をいくらで売るか」、売止めは「その日を売るかどうか」を決めます。

---

### 営業時間外ポリシー

| 項目名 | 説明 | 必須 |
|-------|------|------|
| 営業時間外のポリシー | 営業時間外のチェックインを許可するかどうか | はい |

#### ポリシーの選択肢

| 選択肢 | 説明 |
|-------|------|
| 許可 | 営業時間外でもチェックイン可能 |
| 拒否 | 営業時間外はチェックイン不可 |

---

## チームタブ

### メンバー招待

| 項目名 | 説明 | 必須 |
|-------|------|------|
| メールアドレス | 招待するメンバーのメールアドレス | はい |
| 権限 | 付与する権限レベル | はい |

#### 権限レベル

| 権限 | 説明 |
|------|------|
| オーナー | 全ての操作が可能（設定変更、メンバー管理含む） |
| マネージャー | 日常業務の管理が可能 |
| スタッフ | チェックイン操作などの基本操作が可能 |
| 閲覧者 | データの閲覧のみ可能 |

### 招待一覧

| 項目名 | 説明 |
|-------|------|
| ステータス | 招待中/承認済み/キャンセル済み/期限切れ |
| 招待日 | 招待メールを送信した日時 |
| 期限 | 招待リンクの有効期限 |

---

## ボタン

| ボタン | 説明 |
|-------|------|
| 保存 | 設定を保存します |
| 招待を送信 | 入力したメールアドレスに招待メールを送信 |
| キャンセル | 招待をキャンセルします |
| 削除 | メンバーを施設から削除します |

---

---

## 部屋・ロックタブ

### ロック割り当て

「部屋・ロック」タブ内の **ロック割り当て** セクションでは、各部屋（またはロッカー）にKEYVOXロックデバイスを割り当てます。

#### 特徴

- **1つのロックを複数の部屋で共有できます。** 例えばコワーキングスペースの共用入口ロックを、すべてのブース部屋に割り当てることが可能です。
- 各部屋の行に1つのドロップダウンが表示されます。同じKEYVOX装置を複数の行で選択しても正しく保存されます。
- 部屋のロックを変更すると、他の部屋のドロップダウンにも即座に反映されます（自動再取得）。

#### 使い方

1. **基本設定** に移動し、**部屋・ロック** タブをクリックします。
2. **ロック割り当て** サブタブを選択します。
3. 各部屋の行で「ロック」列のドロップダウンをクリックし、割り当てるKEYVOX装置を選択します。
4. 選択と同時に保存が行われ、ステータスバッジが「割り当て済」に切り替わります。

> **注意:** ドロップダウンには「エントランス」として分類された装置は表示されません。エントランス装置の割り当ては「エントランス」タブで行ってください。

#### トラブルシューティング

| 症状 | 確認事項 |
|------|---------|
| ドロップダウンにロックが表示されない | まず「ロック接続」でKEYVOX装置を接続してください |
| 選択後にステータスが変わらない | 割り当て中はドロップダウンが一時的に無効になります。完了後に自動で更新されます |
| 同じロックを2部屋以上に設定できない | 最新バージョンでは複数部屋への同一ロック割り当てが正式サポートされています |

---

## よくある質問

### Q: 税率を変更すると既存のプランに影響しますか？
A: はい、基本設定の税率は全てのプランの料金計算に適用されます。

### Q: 営業時間外ポリシーを「拒否」にするとどうなりますか？
A: 営業時間外にチェックインしようとすると、エラーメッセージが表示されチェックインできません。

### Q: チームメンバーの権限を後から変更できますか？
A: 現在は一度招待した権限を変更することはできません。新しい権限で再招待してください。

### Q: 招待メールの有効期限はどのくらいですか？
A: 招待リンクは7日間有効です。期限が切れた場合は再度招待してください。

### Q: 各種アプリURLを設定しないとどうなりますか？
A: スラッグが未設定の場合、置き配管理の「QRコード」タブでQRコードが生成されません。置き配サービスを利用するには、スラッグの設定が必要です。

### Q: スラッグを変更すると既存の居住者はどうなりますか？
A: スラッグを変更すると、旧スラッグのURLで発行済みのQRコードや登録URLは無効になります。変更後は「QRコード」タブから新しいQRコードを印刷・配布してください。ただし、既に部屋登録済みの居住者は引き続きアプリを利用できます（再ログイン時は新URLからアクセスが必要です）。

### Q: スラッグに使えない文字を入力するとどうなりますか？
A: 入力フィールドが自動的に英小文字と数字・ハイフンのみに変換されます。大文字は小文字に変換され、その他の記号・スペースは除去されます。

### Q: 「このURLは既に使用されています」と表示されます
A: 入力したスラッグは他の施設で使用中です。別のスラッグを試してください。施設名から派生した一意の識別子（例: `your-building-2` のように数字を付加）が使いやすいです。

### Q: 同じKEYVOXロックを複数の部屋に割り当てられますか？
A: はい。例えば共用入口のロックを複数のブース部屋に割り当てることができます。各部屋のドロップダウンで同じ装置を選択してください。

### Q: ロック割り当てセクションに部屋が表示されません
A: 「部屋一覧」タブで部屋を先に作成してください。また、「有効」状態の部屋のみ表示されます。

### Q: 施設概要・利用規定・プライバシーポリシーはどこに表示されますか？
A: 予約確認画面や置き配（おきはい）のゲスト向け案内画面に表示されます。外部サイトに既に規約ページがある場合はURL指定、そうでない場合はテキスト入力をご利用ください。

### Q: 施設情報のテキストとURLはいつでも切り替えられますか？
A: はい、ラジオボタンで切り替えるといつでも変更できます。ただし、入力方式を切り替えると入力済みの内容は保持されませんのでご注意ください。

### Q: ショートURL（go.unlockos.io）とは何ですか？
A: `go.unlockos.io/{slug}` は、施設で有効な全アプリ（チェックイン・予約・ロッカーなど）を一つのページにまとめたポータルです。このURLをゲストに共有すると、該当するアプリへ自動的に案内されます。有効なアプリが1つのみの場合はそのアプリへ直接リダイレクトされます。

### Q: ショートURLのQRコードはどこで確認できますか？
A: このページのスラッグ入力欄の下に表示されるアプリURL一覧パネルに、`go.unlockos.io/{slug}` のQRコードが表示されます。印刷して施設入口などに掲示することができます。

### Q: facilityIdやconfigIdを含む旧URLは引き続き使えますか？
A: はい。クエリパラメータに `facilityId` や `configId` を含む旧URLは引き続き有効で、新しいスラッグベースのURLへ自動リダイレクトされます。すぐに置き換える必要はありません。

### Q: アプリURL一覧パネルが表示されません
A: パネルはスラッグが3文字以上かつ重複チェックが通過した場合のみ表示されます。スラッグ入力欄にチェックマーク（✓）が表示されているか確認してください。

### Q: 「特定日」タブが表示されません
A: `ui_settings_date_tab` フィーチャーフラグが対象施設でOFFになっています。施設ごとに有効化が必要なため、サポートに有効化をご依頼ください。有効化すると「特定日」タブに売止めと特定日・シーズンが表示されます。詳しくは [特定日・シーズン](date-classes.md) を参照してください。

---

## 関連ページ

- [ショートURLポータル](go-portal.md) - ゲストが go.unlockos.io を使ってアプリにアクセスする仕組み
- [置き配管理](okihai-manager.md) - 居住者登録用QRコードの発行
- [居住者向け置き配サービス](okihai-resident.md) - 居住者がアクセスするアプリ
- [特定日・シーズン](date-classes.md) - ハイシーズン等の日付区分と、プラン別のシーズン料金
- [売止め](sales-blocks.md) - 特定の日だけプランの販売を止める
- [季節の営業時間](seasonal-business-hours.md) - 区分ごとの営業時間（夏季延長・お盆24時間など）
- [料金プラン設定](plan-form.md) - 曜日・祝日による料金の決まり方（タイムゾーンと所在国の影響）
- プラン一覧
- チェックイン設定
- 権限設定
