小売・フランチャイズネットワーク向けセットアップガイド

概念の対応づけ

パネルに店舗やフランチャイジーという名前のものはありません。どのオブジェクトがどの役割を担うかを表で示し、以降の章ではその順にセットアップします。

1前提条件

インストール前に用意するもの。

1. 本部のサーバー（Ubuntu 22.04 または 24.04）、インストーラー、店舗が多く各店舗から到達できる地域ごとのサーバー。
2. 店舗チャンネルのコンテンツ（エンコーダーまたはループするソース）、オンボーディングと商品研修の録画、店舗のスクリーンまたはメディアプレーヤー。
3. フランチャイズ構造の決定。どの地域にノードを置くか、各フランチャイジーで誰が回線を管理するか。

2インフラの導入

まず本部、次に地域。

1. 本部のサーバーでインストーラーを実行し、再生のベース URL を、TLS の背後にある店舗から到達できるアドレスに設定します。
2. 店舗チャンネルを Streams に、研修録画を Movies に追加し、ウェブプレーヤーで確認します。
3. Servers から地域ごとにノードを登録します。パネルが SSH でインストールするか、ノードがワンタイムコードで登録し、その地域の店舗をノードへ振り分けます。
4. 本部のコンテンツチーム用に、カタログの権限があり、店舗の回線の権限がないパートナーアカウントを作成します。

3コンテンツの整理

店舗チャンネルと研修ライブラリ。

1. 店舗チャンネル用のライブストリームを作成し、専用のブーケに入れます。
2. トピックごとのカテゴリと、研修コースごとのシリーズ（レッスンごとに 1 エピソード）を作成し、役割（販売スタッフ、マネージャー、新入社員）ごとにブーケを 1 つ追加します。
3. 店舗スクリーン用のパッケージ 1 つと、役割ごとのパッケージを作成し、それぞれにブーケを付与してアクセス期間を期間として設定します。
4. フランチャイジーが店舗とスタッフに再販できるパッケージを渡します。

4パートナー（リセラー）の設定

フランチャイジーごとに 1 つのパートナーアカウント。

1. 権限を回線に限定し、カタログを変更できないグループを作成します。
2. Users → リセラーを追加 で各フランチャイジーを、そのグループ、パッケージ、クレジット残高とともに追加します。
3. 複数の地域を持つフランチャイジーは、地域ごとにサブリセラーを追加でき、それぞれが自分の店舗を持ちます。

5店舗とスタッフの回線設定

スクリーンごと、従業員ごとに回線。

1. Lines → 追加 で店舗スクリーンごとに、店舗名と店舗パッケージを指定して回線を作成します。フランチャイジーも自分の店舗について同様に行います。
2. 最大接続数は店舗内のスクリーンの数に、従業員は 2（売り場と電話）に設定します。
3. 店舗に固定アドレスがある場合は店舗の回線をそのアドレスに紐づけ、認証情報が他の場所で使えないようにします。
4. スクリーンのプレーヤーを一度だけ設定し（M3U、Xtream Codes API、またはウェブプレーヤーのアドレス）、認証情報は店舗のファイルに保管します。

6研修・商品動画

スタッフ向けライブラリ。

1. 研修コースごとにシリーズとして、商品映像を映画としてアップロードするか、VOD 取り込みジョブでメディアルートに取り込みます。
2. 録画を、そのカテゴリを通じて適切な役割のブーケに入れます。
3. ライブラリをフランチャイジーに公開する前に、テスト用回線で各役割に何が見えるかを確認します。

7店舗チャンネル

すべてのスクリーンに 1 つのチャンネル。

1. 店舗チャンネルをライブストリームとして追加します。ソースは本部のエンコーダーからの RTMP またはループするソースです。
2. ライブ配信する研修セッションにはキャッチアップを有効にし、その後に録画をライブラリにアップロードします。
3. 地域のノードはチャンネルをオリジンから 1 回だけ取得して店舗に配信するため、店舗の回線が飽和しません。

8有効期限と更新

アクセスは店舗または契約に連動する。

1. 回線はパッケージの期間の終了時に失効します。フランチャイジーはパッケージまたはクレジットで更新します。
2. 閉店した店舗や退職する従業員の回線は無効にします。
3. フランチャイズ管理または人事システムを Webhook に登録し、失効間近または失効済みの回線を把握します。

9フランチャイズ・人事システムとの連携

システムが回線を動かし、プレーヤーが再生する。

1. フランチャイズ管理・人事システム用に Reseller API キーを作成します。create_line、renew_line、enable_line、disable_line を呼び出し、書き込みのたびにリクエスト ID を付けます。
2. フランチャイジーにサービスを請求する場合はコマースコネクターを使います。それ以外のシステムは Reseller API と Webhook を使います。
3. 視聴者向けのシングルサインオンはありません。スタッフは回線の認証情報でプレーヤーにログインします。

10セキュリティ上の考慮事項

各店舗を自分の回線に留める。

1. パネルは TLS 付きのリバースプロキシの背後で提供し、TRUSTED_PROXIES を設定して、監査ログと IP ルールが実際のアドレスを認識できるようにします。
2. 本部のすべてのアカウントに二要素認証を使い、フランチャイジーには自分の回線に限定した権限グループを付与します。
3. 回線ごとの同時接続数制限、署名付きで期限のある再生リンク、店舗スクリーンのアドレス紐づけ。
4. オフサイトコピー付きの暗号化データベースバックアップを有効にし、監査ログで回線とカタログの変更を確認します。

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

最初に確認する一般的なポイント。

1. 店舗のスクリーンが真っ黒：回線が有効で期限切れでないこと、アドレスの紐づけ、2 台目のデバイスが回線を使っている場合は同時接続数制限を確認します。
2. ある地域でバッファリングする：地域ノードのハートビートと、店舗がそのノードに振り分けられているかを確認します。
3. フランチャイジーが回線を作成できない：クレジット残高、グループの権限、割り当てられたパッケージを確認します。
4. 監査ログにプロキシのアドレスが表示される：TRUSTED_PROXIES をそのプロキシに設定し、パネルを再起動します。