これらのガイドは、業種の概念を、プラットフォームに現在あるオブジェクト（ブーケ、回線、パッケージ、パートナーアカウント、ノード、API）に対応づけるものです。概念上の対応づけであり、業種専用の機能ではありません。また、パートナーアカウントは委任アカウントであり、分離されたテナントではありません。
概念の対応づけ
パネルに契約や POP という名前のものはありません。どのオブジェクトがどの役割を担うかを表で示し、以降の章ではその順にセットアップします。
| あなたの業種では | プラットフォームでは | パネル内の場所 |
|---|---|---|
| リセラーまたは地域パートナーのアカウント | パートナーアカウント（リセラー）：クレジット、権限、専用回線を持つ委任ダッシュボード | Users → リセラーを追加。権限は Groups で設定 |
| チャンネルのティアまたはアドオンパック | ブーケ：パッケージが付与する、チャンネル・映画・シリーズの名前付きセット | Bouquets。Streams と Movies / Series から作成 |
| テレビチャンネル | ライブチャンネル：ソース、EPG、出力フォーマットを持つストリーム | Streams → ライブストリームを追加（ソース URL または RTMP プッシュ） |
| VOD ライブラリ | VOD カタログ：シーズンとエピソードを持つ映画とシリーズ、カテゴリ、メタデータ | Movies と Series、または VOD インジェストジョブ |
| 加入者のテレビアクセス | 回線：パッケージ、ブーケ、有効期限、接続数の上限、出力を持つ1件のアクセス | Lines → 追加、またはアクティベーションコード、または Reseller API |
| 請求期間の終了 | 回線の有効期限。パッケージ、クレジット、API で更新されます | 回線の有効期限とパッケージの期間 |
| 契約あたりの画面数 | 回線の最大接続数：同時に視聴できる端末の数 | 回線の最大接続数 |
| 課金・プロビジョニングとの連携 | Reseller API と Webhook：ご自身のシステムからパネルの操作を行う手段 | リセラーのダッシュボードにある Reseller API キーと Webhook |
| POP ノード | 配信ノード：パネルから登録するエッジサーバー。拠点または建物ごとに1台 | Servers → ノードを追加（SSH 経由でインストール） |
前提条件
インストール前に用意するもの。
- コアサイトのサーバー（Ubuntu 22.04 または 24.04）、インストーラー、加入者が到達できるドメインまたはアドレス、ノード用に各 POP のサーバー。
- ライセンス取得済みのチャンネルフィード、VOD ライブラリ、契約を管理している課金システム。
- ティア、請求期間の長さ、どのリセラーにパートナーアカウントを渡すかの決定。
インフラの導入
コアサイト、次に POP。
- コアサーバーでインストーラーを実行し、パネルをリバースプロキシの背後に置いて TRUSTED_PROXIES を設定し、ログと IP ルールが加入者の実際のアドレスを認識できるようにします。
- 再生のベースを加入者がアクセスする公開アドレスに設定し、サーバーにライセンスキーを設定します。
- Servers から POP ごとにノードを登録します。パネルが SSH でインストールするか、ノードがワンタイムコードで登録し、近くの加入者をそのノードへ振り分けます。
- サポートまたは課金チーム用に、回線の権限のみを持つパートナーアカウント（リセラー）を作成します。
コンテンツの整理
ティアとパックはブーケ。
- チャンネルを Streams に、VOD ライブラリを Movies と Series に、カテゴリと EPG ソースとともに追加します。
- 基本チャンネル構成、プレミアムチャンネル、VOD ライブラリのブーケを作成します。
- 契約ティアごとに、付与するブーケ、期間としての請求期間、クレジット価格を持つパッケージを 1 つ作成します。
- キャンペーンや新規顧客向けに、短い体験パッケージを作成します。
パートナー（リセラー）の設定
クレジットを持つリセラー。
- リセラー用に、自分の回線の権限を持ち、カタログや設定へのアクセスを許可しないグループを作成します。
- 各地域のリセラーを、そのグループ、販売できるパッケージ、クレジット残高を持つパートナーアカウントとして追加します。リセラーは最大 5 階層のサブリセラーを持てます。
- Webhook の credits.low と残りクレジット不足の通知が、販売が止まる前にリセラーへ補充を促します。
加入者回線の設定
契約ごとに 1 つの回線。
- 課金システムは、契約開始時にコネクター経由、または Reseller API の action=create_line をティアのパッケージとリクエスト ID を指定して呼び出し、回線を作成します。
- ティアごとの最大接続数、つまり世帯が同時に使える画面数を設定します。
- オファーが自社ネットワーク限定の場合は、回線を加入者のアドレス、国、または ISP に紐づけます。
- パイロット運用やサポート対応では、Lines → 追加 から回線を追加して認証情報を渡します。
VOD ライブラリ
オンデマンドのカタログ。
- 映画とシリーズをシーズンとエピソード付きで追加します。VOD 取り込みジョブで取り込むかアップロードし、ポスターと説明には TMDB のメタデータを使います。
- タイトルをティアやアドオンごとにブーケにまとめ、パッケージが契約に含まれるものをちょうど付与するようにします。
- ノードが VOD ファイルをキャッシュするため、人気のタイトルは加入者に近い POP から配信されます。
ライブチャンネル
チャンネル構成。
- ライセンス取得済みの各チャンネルをフィードとともに Streams に追加し、キャッチアップやタイムシフトは権利が許す場合のみ有効にします。
- アプリや端末が番組表を表示できるよう、EPG ソースを追加します。
- 各ノードはライブチャンネルをオリジンから 1 回だけ取得し、自分の加入者に分配します。
有効期限、更新、解約
請求期間が回線の有効期間になる。
- 回線はパッケージの期間の間有効です。課金システムが期間ごとに action=renew_line またはコネクターで更新します。
- 契約が失効または解約されると、課金システムが action=disable_line を呼び出し、再開時に回線を再び有効にします。
- 課金システムを Webhook に登録し、失効間近および失効済みの回線を自身の記録と突き合わせます。
課金システムとの連携
課金システムがアクセスを動かし、プレーヤーが再生する。
- 課金システム側にそのコネクター（WHMCS、Blesta、Odoo など）をインストールするか、自社システムからキーとリクエスト ID を使って Reseller API を呼び出します。
- 視聴者向けのシングルサインオンはありません。加入者は回線の認証情報でアプリや端末にログインします。課金システムは顧客エリアでそれを表示できます。
- レポートツールには、読み取り専用フラグ、IP 許可リスト、有効期限付きの Admin API キーを使います。
セキュリティ上の考慮事項
サービスを加入者のために保つ。
- パネルを TLS 付きのリバースプロキシの背後に置いて TRUSTED_PROXIES を設定し、ノードの管理トラフィックはプライベートネットワークに留めます。
- すべてのパネルアカウントに二要素認証を使い、サポートとリセラーには権限グループを設定し、ログインには reCAPTCHA または Turnstile を使います。
- 署名付きで期限のある再生リンク、契約ごとの同時接続数制限、適切な場合はアドレス・国・ISP への紐づけ。
- オフサイトコピー付きの暗号化データベースバックアップと、回線とクレジットのすべての変更を記録する監査ログ。
トラブルシューティング
最初に確認する一般的なポイント。
- 加入者にテレビが映らない：回線が有効で期限切れでないことを確認し、次に Reseller API の呼び出しログで課金システムの呼び出しを確認します。
- あるティアでチャンネルがない：そのティアのパッケージのブーケを確認します。
- ある POP でバッファリングする：そのノードのハートビートと、加入者がそのノードに振り分けられているかを確認します。
- リセラーが回線を作成できない：クレジットと、そのパッケージが販売を許可されたものかを確認します。