これらのガイドは、業種の概念を、プラットフォームに現在あるオブジェクト（ブーケ、回線、パッケージ、パートナーアカウント、ノード、API）に対応づけるものです。概念上の対応づけであり、業種専用の機能ではありません。また、パートナーアカウントは委任アカウントであり、分離されたテナントではありません。
概念の対応づけ
パネルにチームや会員という名前のものはありません。どのオブジェクトがどの役割を担うかを表で示し、以降の章ではその順にセットアップします。
| あなたの業種では | プラットフォームでは | パネル内の場所 |
|---|---|---|
| 試合または練習のフィード | ライブチャンネル：ソース、EPG、出力フォーマットを持つストリーム | Streams → ライブストリームを追加（ソース URL または RTMP プッシュ） |
| 分析・リプレイライブラリ | VOD カタログ：シーズンとエピソードを持つ映画とシリーズ、カテゴリ、メタデータ | Movies と Series、または VOD インジェストジョブ |
| チームまたは大会のパッケージ | ブーケ：パッケージが付与する、チャンネル・映画・シリーズの名前付きセット | Bouquets。Streams と Movies / Series から作成 |
| 会員または家族のアクセス | 回線：パッケージ、ブーケ、有効期限、接続数の上限、出力を持つ1件のアクセス | Lines → 追加、またはアクティベーションコード、または Reseller API |
| シーズンまたは会員期間 | 回線の有効期限。パッケージ、クレジット、API で更新されます | 回線の有効期限とパッケージの期間 |
| チームまたはアカデミーのスタッフアカウント | パートナーアカウント（リセラー）：クレジット、権限、専用回線を持つ委任ダッシュボード | Users → リセラーを追加。権限は Groups で設定 |
| ショップまたはクラブ管理との連携 | Reseller API と Webhook：ご自身のシステムからパネルの操作を行う手段 | リセラーのダッシュボードにある Reseller API キーと Webhook |
前提条件
インストール前に用意するもの。
- 公開アドレスまたはドメインを持つサーバー（Ubuntu 22.04 または 24.04）と、配信予定の試合に十分なアップストリーム帯域。
- RTMP をプッシュできるグラウンドのカメラとエンコーダー、コーチがすでに保管している練習・分析ファイル。
- 誰に何を見せるかの決定。どのチームが資料を共有するか、どの試合を会員限定にするか、スタッフの誰にパネルアカウントを渡すか。
インフラの導入
まずアカデミー、試合日に必要ならノード。
- アカデミーのサーバーでインストーラーを実行し、パネルを TLS 付きのリバースプロキシの背後に置きます。信頼するプロキシを設定して、ログと IP ルールが視聴者の実際のアドレスを認識できるようにします。
- 再生のベース URL を視聴者がアクセスする公開アドレスに設定し、パネルが発行するリンクが自宅からも使えるようにします。
- 多くの家族が同じ試合を見る場合は、Servers からノードを登録します。パネルが SSH でインストールし、そこからライブチャンネルを分配します。
- コーチングスタッフ用に、カタログの権限があり、会員の回線の権限がないパートナーアカウント（リセラー）を作成します。
コンテンツの整理
チームとシーズンはカテゴリ、アクセスはブーケ。
- 年齢グループとシーズンごとにカテゴリを作成し、大会ごとに試合ごとに 1 エピソードのシリーズを作ります。
- チームごとの分析資料用ブーケ、ライブの試合チャンネル用のブーケ、アカデミー全体用のブーケを 1 つずつ作成します。
- 会員の種類ごとにパッケージを 1 つ作成します。付与するブーケ、期間としてのシーズン、スタッフが販売する場合はクレジット価格を設定します。
- ブーケにはそれが属するチームや大会の名前を付け、スタッフが家族にどのパッケージを渡すか分かるようにします。
パートナー（リセラー）の設定
クラブが望む場合、自分の会員を管理するスタッフ。
- コーチ用にカタログの権限を持つグループと、会員担当者用に回線の権限を持つグループを作成します。
- それぞれを該当するグループのリセラーとして追加します。会員資格をパネル経由で販売する場合のみ、担当者にクレジットを付与します。
- 独自の会員を持つサテライトアカデミーやサポーターズクラブには、専用のパートナーアカウントとパッケージを付与します。
会員と家族のアクセス設定
会員ごと、または家族ごとに 1 つの回線。
- ショップまたはクラブ管理システム用に Reseller API キーを作成し、そのシステムのシークレットに保管します。
- 登録時にシステムが会員資格のパッケージとリクエスト ID を指定して action=create_line を呼び出します。シーズンがパッケージの期間になります。
- 最大接続数を家族に必要なデバイスの数（通常は 3〜4 台）に設定し、1 つの会員資格が世帯を超えて共有されないようにします。
- 試合日の体験では、Lines → 追加 から体験パッケージで回線を追加するか、スタンドのサポーター用にアクティベーションコードを印刷します。
分析・リプレイライブラリ
試合と練習をオンデマンドで。
- 各試合や練習をエピソードのソースとしてアップロードするか、VOD 取り込みジョブで取り込みます。日付、対戦相手、チームをタイトルに入れておきます。
- 録画をシリーズ経由でチームのブーケに紐づけ、そのチームの回線だけに見えるようにします。
- 会員資格ごとのテスト用回線で再生を確認し、誰に何が見えるかを確かめます。
試合と練習のフィード
ピッチのカメラをライブチャンネルに。
- グラウンドのエンコーダー（RTMP プッシュ）ごとにライブストリームを追加し、試合日用のブーケに入れます。
- キャッチアップを有効にして、遅れて参加した家族が巻き戻せるようにし、試合終了後に録画をライブラリに追加します。
- 試合日が混雑するときは、ノードがチャンネルをオリジンから 1 回だけ取得し、振り分けられた視聴者に配信しているかを確認します。
会員資格の有効期限
アクセスはシーズンに連動する。
- 回線はパッケージの期間の終了時に失効します。次のシーズンの会費が支払われると、ショップが action=renew_line で更新します。
- ショップを Webhook に登録し、line.expiring でリマインダーを送り、line.expired で会員資格を終了します。
- シーズン途中で退会する選手は、ショップが action=disable_line で無効にします。回線は記録のために残されます。
ショップ・クラブソフトウェアとの連携
システムがアクセスを動かし、プレーヤーが再生する。
- コマース基盤（WooCommerce、Shopify など）のコネクターをショップ側にインストールし、購入で回線が作成され、支払いで更新されるようにします。
- クラブ管理やチケット販売システムは Reseller API と Webhook で接続します。そのためのネイティブコネクターはありません。
- 視聴者向けのシングルサインオンはありません。会員は、ショップから送られた回線の認証情報でプレーヤーにログインします。
セキュリティ上の考慮事項
チームの資料はチームだけに。
- パネルと再生のベース URL は TLS で提供し、TRUSTED_PROXIES をリバースプロキシに設定します。
- すべてのパネルアカウントに二要素認証を使い、会員担当者がカタログを変更できず、コーチが回線を見られないよう権限グループを設定します。
- 署名付きで期限のある再生リンク、回線ごとの同時接続数制限、職員回線の IP または国への紐づけ。
- オフサイトコピー付きの暗号化データベースバックアップと、回線とカタログのすべての変更を記録する監査ログ。
トラブルシューティング
最初に確認する一般的なポイント。
- 保護者にトップチームの分析が見える：回線のパッケージと、それが付与するブーケを確認します。
- 新しい会員が支払い後もアクセスできない：Reseller API の呼び出しログでショップのリクエストと、回線の有効期限を確認します。
- キックオフ時に試合フィードがカクつく：グラウンドのエンコーダーのアップロードと、ノードが視聴者に配信している場合はそのハートビートを確認します。
- 監査ログにプロキシのアドレスが表示される：TRUSTED_PROXIES をそのプロキシに設定し、パネルを再起動します。