デバイス

Jonotには3種類のデバイスがあり、それぞれキューの運用フローで異なる役割を担います。すべてのデバイスは、デバイス上で生成されてAdminで入力される短時間有効なペアリングコードを使って、拠点（および任意でキュー）にペアリングされます。

デバイスの種類

キオスク

店舗の入口に設置されるタブレットです。お客様はキオスクを操作してキューに参加します。本番環境では通常、Jonotは利用可能な場合（現時点ではAndroid）にタブレット上で専用のネイティブアプリとしてキオスクを動作させます。ブラウザベースのキオスク配備も可能です。Android版では、キオスクはESC/POSプリンターに接続して物理的な整理券を発行できます。キオスクは特定のキューにペアリングされます。

画面：利用可能な場合は専用キオスクアプリ、またはそれ以外はhttps://kiosk.jonot.io

ディスプレイ

待合スペースに設置されるテレビやモニターで、現在どのチケット番号がどのデスクで呼び出されているか、何人のお客様が待っているか、次に呼び出される番号のプレビュー、そして直近の呼び出し履歴といったキューのライブ状況を表示します。新しい番号が呼ばれると音声案内が流れます。WebSocketを通じてリアルタイムに更新されます。

画面：https://display.jonot.io

デスク

次のお客様を呼び出す、対応を完了する、不在をスキップするといった操作に使われる、スタッフ向けのインターフェースです。利用可能な場合（現時点ではAndroid）は固定カウンター端末上の専用ネイティブアプリとして、またはPC・タブレットのブラウザ上で動作します。デスクは特定のキューにペアリングされます。スタッフ個人のJonotアカウントは不要で、デスクのセッション自体が認証情報になります。

画面：利用可能な場合は専用デスクアプリ、またはそれ以外はhttps://desk.jonot.io

ペアリングモデル

3種類のデバイスはすべて同じペアリングの手順を使用します。

1. 物理デバイス上で、該当するランタイムのペアリング画面を開きます。キオスクとデスクの場合、これは通常タブレット上の専用デバイスアプリです。ブラウザベースの構成では、代わりにhttps://kiosk.jonot.io/pair/またはhttps://desk.jonot.io/pair/を開くことができます。ディスプレイは現在https://display.jonot.io/pair/を使用します。デバイスは7文字のペアリングコード（例：K7M-4PQ）をリクエストし、画面に表示します。このコードは10分間有効です。
2. 組織マネージャーまたは拠点マネージャーがAdminでその拠点を開き、デバイスタブに移動してデバイスをペアリングをクリックし、デバイス画面に表示されたコードを入力します。
3. サーバーがデバイスを有効化し、DeviceSessionを作成して長期間有効なデバイストークンを発行します。デバイスは有効化を検知し、動作画面を開きます。プリンターが未設定の状態でペアリングされたAndroidキオスクは、まずプリンター設定画面にリダイレクトされます。

Adminにコードを入力する前にコードが期限切れになった場合は、デバイスのペアリング画面に戻って新しいコードをリクエストしてください。ブラウザベースの構成では、該当する/pairのURLに戻ることになります。古いコードは自動的に無効化されます。

DeviceSessionのライフサイクル

DeviceSessionはペアリング時に作成され、Adminで手動で無効化されるかセッションが期限切れになるまで維持されます。次の情報を持ちます。

• デバイスの種類（キオスク／ディスプレイ／デスク）
• 拠点の割り当て
• キューの割り当て（キオスク、デスク、ディスプレイ、任意）
• デスクの割り当て（ディスプレイのみ、任意 — 後述）
• 表示名（任意、例：「Desk 1」「Kiosk A」）
• 最終確認タイムスタンプ
• オンライン／オフライン状態

デバイスセッションを無効化するには、Admin → 拠点 → デバイスに移動し、対象のデバイスを見つけて無効化をクリックします。デバイスは次回のリクエスト時にロックアウトされます。

ディスプレイの割り当て

ディスプレイには2つの独立した割り当て軸があります — 表示するキューと、（任意で）フォーカスするデスクです。

キューの割り当てはボードのレイアウトを制御します。

• 単一キュー — 1つのキューが割り当てられている場合、ディスプレイはただいま対応中のヒーロー表示を先頭にした単一キューレイアウトを使用します。
• 複数キューボード — 2〜5個のキューが割り当てられている場合、ディスプレイはそれらを横並びに表示し、各カラムが独立してリアルタイムに更新されます。
• 拠点全体の表示（すべてのデスク） — キューが割り当てられていない場合、 ディスプレイは拠点全体のすべてのアクティブな呼び出しを表示します。

デスクへのリンクは、上記いずれかにさらに重ねられる任意のオーバーレイです。

• デスクにリンク — assignedDeskSessionIdを特定のデスクセッションに設定します。そのデスクがオンラインである間、ディスプレイはそのデスクが呼び出したチケットのみを、フォーカスした単一チケットビューで表示します。各デスクに専用画面がある場合に便利です。
• リンクなし — assignedDeskSessionIdがnullの場合。ディスプレイは上記のキュー割り当てに従います。

ディスプレイがデスクにリンクされていて、そのデスクが2分以上オフラインになった場合、ディスプレイは自動的に拠点ビューにフォールバックします。デスクが再接続すると、デスクリンクモードに戻ります。

運用担当者向けの手順はディスプレイのペアリングを、ボードレイアウトの詳細はディスプレイのカスタマイズを参照してください。

オフライン時の挙動

デバイスはJonot APIとのWebSocket接続を維持します。サーバーは各デバイスセッションのlastSeenAtを追跡します。デバイス一覧では、Adminは接続中のデバイスをオンラインと表示します。最終確認時刻がしきい値を超えると、ステータス列には代わりにどれくらい前に最後に確認されたかが表示されます。デバイスはネットワークが復旧すると自動的に再接続します — 手動での対応は不要です。

デスクの認証情報

デスクは、個人のユーザーアカウントではなく、ペアリング時に発行されたデバイストークンを使って認証されます。つまり、そのデバイスを使うスタッフであれば誰でもログインせずにデスクへアクセスできます。アクセスを制限するには、デバイスセッションを無効化し、許可されたデバイスとのみ再ペアリングしてください。