キュー

キューとは、拠点内にある名前付きの待ち行列です。お客様がキューに参加すると、連番のチケットを受け取ります。デスクのスタッフはキューからチケットを1件ずつ呼び出します。ディスプレイ画面は呼び出しのたびに案内します。

キューの構成要素

各キューは次の要素を持ちます。

名前 — お客様とスタッフに表示される、人が読みやすいラベル（例：「Walk-ins」「Appointments」）。
スラッグ — お客様参加用URLで使われるURLセーフな識別子。キュー名から自動生成されます。
お客様参加用URL — お客様がこのキューに参加するためにアクセスする完全なURL：
```
https://customer.jonot.io/{org-slug}/{location-slug}/{queue-slug}/
```
このURLは、入口で提示するQRコードにもエンコードされています。
定員（任意） — 同時にWAITING状態でいられるチケットの最大数。キューが満員になると、新規参加の試みは「満員です」というメッセージで拒否されます。無制限にする場合は空欄のままにします。
想定対応時間 — 1人のお客様に対応するのにかかる標準的な分数（1〜1440）で、キューの作成・編集フォームで設定します。これは、キューが自身のペースを実測するのに十分な直近の履歴を持つまでの間、お客様の待ち時間の推定値の初期値として使われます（待ち時間の推定を参照）。

拠点あたり複数のキュー

1つの拠点はいくつでもキューを持てます。これにより、サービスごとに別々の受付列を並行して運用できます。例：

「一般診察」と「薬の受け取り」のキューを持つクリニック
「パスポート」と「身分証明書の更新」のキューを持つ行政窓口
「個人向け」と「法人向け」のキューを持つ銀行

各キューはそれぞれ独立した待ち行列を持ちます。デスクはペアリング時に特定のキューに紐づけられるため、「Walk-ins」を担当するデスクには「Appointments」のチケットは表示されません。

管理単位としてのキュー

キューは、デバイスとスタッフを組織する際の中心単位です。

キオスクはキューにペアリングされます — キオスクをタップしたお客様は、そのキューに参加します。
デスクはキューにペアリングされます — スタッフはそのキューからチケットを呼び出します。
ディスプレイは、拠点内のすべてのアクティブな呼び出し、特定のデスクのキューの呼び出し、または最大5つのキューをまとめたボードのいずれかを表示します。

キューの作成・管理は、Adminの拠点画面内にあるキュータブで行います。手順の詳細はキューの作成を参照してください。

定員

定員（キューの作成・編集フォームの最大待機数フィールド）を設定することで、キューで同時に待てるお客様の数を制限できます。定員に達すると：

お客様の参加フローに「満員です」というメッセージが表示されます。
キオスクには満員の状態が表示されます。
待機中のチケットが1件抜ける（呼び出される、キャンセルされる、移動する）まで、キューには参加できません。

定員はアトミックに適用されます — 全く同じタイミングで2人のお客様が参加を試みても、両方が定員を超えて押し込まれることはありません。無制限のキュー（デフォルト）にするにはフィールドを空欄のままにします。

キューのステータス

すべてのキューは、営業時間とは独立してスタッフが制御できる手動ステータスを持ちます。

アクティブ — 通常の状態です。お客様は参加でき、デスクはチケットを呼び出せます。
一時停止中 — 一時的に受付を止めます。新規参加は拒否されますが、すでに待っているお客様は順番を保持したままです。短い休憩や、これ以上人を入れる前に解消したい滞留がある場合に使います。
クローズ — 一時停止と同様に受付を止めますが、キューがいったん終了したことを示します。待機中のチケットはキャンセルされず保持されます。クローズしたキューを再開するのはAdminでの操作で、デスク側から自力で再開することはできません。

キューが一時停止またはクローズされている間、すでに待っているお客様にはチケット上にステータスバナーが表示され、参加を試みる人には一般的なエラーではなく状況に応じたメッセージで案内されます。一時停止のバナーは、順番が保持されておりキューがまもなく再開することをお客様に伝えるものです。クローズのバナーはより注意を促す内容です — チケットは保持されますが対応されない可能性があるため、スタッフに確認するようお客様に案内されます。

ステータスの設定方法：

Adminでは、組織マネージャーまたは拠点マネージャーがキューの編集フォームからステータス（Active／Paused／Closed）を設定します。
デスクでは、スタッフが1つの待ち行列を一時停止／待ち行列を再開ボタンでActiveとPausedを切り替えられます — デスクを離れずに一時的な休憩を取るための近道です。クローズ（およびクローズからの再開）はAdminで行います。

ステータスの変更は即座に反映され、接続中のすべてのデスク、ディスプレイ、お客様にリアルタイムで配信されます。

営業時間

拠点の営業時間は、その拠点のすべてのキューに対する時間ベースのゲートとして機能します。拠点が設定された営業時間外にある場合、参加の試みは「営業時間外です」というメッセージで拒否され、お客様向けのキュー選択画面には「クローズ中 — [時刻]に開始」という状態が表示されます。デスクとディスプレイには営業時間外のピルが表示されます。

営業時間はキューごとではなく拠点単位で、Admin → [拠点] → 営業時間で設定します。

タイムゾーン — IANAタイムゾーン（例： Europe/Helsinki）。すべての営業時間はこのタイムゾーンで、サマータイムを正しく考慮して評価されます。
週次スケジュール — 曜日ごとの開店・閉店の時間帯。時間帯が設定されていない曜日は終日クローズになります。1日に複数の時間帯を設定できます（例：昼休みをモデル化する場合：08:00〜12:00と13:00〜17:00）。
日をまたぐ営業時間 — 閉店時刻が深夜0時を過ぎる時間帯（例：金曜20:00〜翌2:00）もサポートされています。閉店時刻は通常の時計の値（02:00）で入力します。閉店時刻が開店時刻以前になる場合、エディタは自動的に翌日の時刻として扱い、閉店時刻フィールドの隣に翌日のヒントを表示します。

日付の例外設定

特定の日だけの例外（祝日、特別営業時間）は、営業時間エディタの日付の例外設定セクションで管理します。

クローズ設定 — 週次スケジュールに関係なく、特定の日を終日クローズとしてマークします（例：祝日）。
カスタム営業時間設定 — 特定の日について、週次スケジュールを別の時間帯のセットで置き換えます。ある日のクローズ設定は、前日からの日またぎの営業時間より優先されます。

例外設定は週次スケジュールの下に一覧表示され、いつでも追加・編集・削除できます。