Bu kılavuzlar bir sektörün kavramlarını platformun bugün sahip olduğu nesnelere (buketler, hatlar, paketler, bayi hesapları, node'lar, API) eşler. Bunlar kavramsal eşlemelerdir, sektöre özgü özellikler değildir ve bayi hesabı yalıtılmış bir kiracı değil, devredilmiş bir hesaptır.
Kavramsal eşleme
Panelde hiçbir şey program veya destekçi olarak adlandırılmaz. Tablo hangi nesnenin hangi rolü oynadığını gösterir; aşağıdaki bölümler onları bu sırayla kurar.
| Sektörünüzde | Platformda | Panelde nerede |
|---|---|---|
| Stüdyonun kanalı | Canlı kanal: kaynakları, EPG'si ve çıkış formatları olan bir yayın | Streams → canlı yayın ekle (kaynak URL'si veya RTMP push) |
| Program arşivi | VOD kataloğu: sezon ve bölümlü filmler ve diziler, kategoriler ve meta veri | Movies ve Series ya da VOD ingest işi |
| Abonelik kademesi | Buket: bir paketin verdiği, adlandırılmış kanal, film veya dizi kümesi | Bouquets, Streams ve Movies / Series'ten |
| Destekçi erişimi | Hat: paketi, buketleri, bitiş tarihi, bağlantı sınırı ve çıkışlarıyla tek bir erişim | Lines → ekle, veya etkinleştirme kodları, veya Reseller API |
| Faturalama dönemi | Hattın bitiş tarihi; bir paket, bir kredi veya API ile yenilenir | Hattın bitiş tarihi ve paketin süresi |
| Satış ortağı veya dağıtımcı hesabı | Bayi hesabı (reseller): kredisi, yetkileri ve kendi hatları olan devredilmiş bir panel | Users → bayi ekle; yetkileri için Groups |
| Mağaza veya üyelik entegrasyonu | Reseller API ve webhook'lar: panelin işlemleri kendi sisteminizden | Bayinin panelindeki Reseller API anahtarları ve webhook'lar |
Ön koşullar
Kurmadan önce nelere sahip olmalı.
- Herkese açık bir adresi veya alan adı olan ve beklediğiniz kitle için yeterli yukarı yönlü bant genişliğine sahip bir sunucu (Ubuntu 22.04 veya 24.04).
- Tamamlanmış bölümler, kanal için stüdyonun playout'u veya kodlayıcısı ve konektörü olan bir platformda bir mağaza ya da bir HTTP API çağırabilme imkânı.
- Kademeler ve satış ortakları hakkında bir karar: her aboneliğin neyi verdiği ve kimin satabileceği.
Altyapı dağıtımı
Önce tek bir sunucu, kitle büyüdükçe node'lar.
- Kurulum aracını yönetim sunucusunda çalıştırın ve paneli TLS'li bir reverse proxy'nin arkasına koyun; IP kuralları izleyicinin gerçek adresini görsün diye güvenilir proxy'leri ayarlayın.
- Oynatma tabanı URL'sini kitlenizin eriştiği herkese açık adrese ayarlayın.
- Çok sayıda destekçinin izlediği bir bölgede Servers'tan bir node kaydedin; panel onu SSH ile kurar ve o bölgenin izleyicilerini ona yönlendirir.
- Kataloğu veya destekçileri yöneten her çalışan için, kendi yetki grubuyla bir ortak hesabı (bayi) oluşturun.
İçerik organizasyonu
Diziler olarak programlar, buketler olarak kademeler.
- Tür başına kategoriler ve program başına bir dizi oluşturun; her yayın partisi için bir sezon, her video için bir bölüm olsun.
- Canlı kanal için bir buket, ücretsiz veya giriş içeriği için bir buket ve her üst kademe için bir buket oluşturun.
- Kademe başına, süresi faturalama dönemi olan bir paket, isterseniz yeni ziyaretçiler için bir deneme paketi ve satış ortakları için kredi cinsinden bir fiyat oluşturun.
- Eski bölümleri kendi kategorisinde tutun; böylece diziye dokunmadan kademeler arasında taşınabilirler.
Ortak (bayi) yapılandırması
Satış ortakları ve dağıtımcılar.
- Satış ortakları için yalnızca hat yetkileri olan bir grup oluşturun; böylece kataloğu değiştiremezler.
- Her satış ortağını o grupla ve bir kredi bakiyesiyle bayi olarak ekleyin; paket fiyatını stüdyo belirler.
- Alt satış ortakları olan bir dağıtımcı, kendi hesabının altında beş seviyeye kadar alt bayi oluşturabilir.
Destekçi erişimi yapılandırması
Destekçi başına bir hat.
- Mağazanızın konektörünü kurun (örneğin WooCommerce) ve Reseller API anahtarını ve her ürüne karşılık gelen paketi girin.
- Abonelikte konektör paket ve bir istek kimliğiyle create_line çağırır; faturalama dönemi paketin süresidir.
- En fazla bağlantıyı bir destekçinin kullanabileceği cihaz sayısına, genellikle iki veya üçe ayarlayın.
- Bir çekiliş veya lansman için etkinleştirme kodlarını toplu üretin ya da Lines → add'den deneme paketiyle hat ekleyin.
Program arşivi
İsteğe bağlı bölümler.
- Her bölümü kaynak olarak yükleyin veya VOD ingest işiyle içe alın; başlığı, sezonu, bölüm numarasını ve programın varsa TMDB metaverisini doldurun.
- Her diziyi onu izleyebilecek kademelerin buketlerine bağlayın.
- Bir yayını duyurmadan önce her kademenin bir test hattıyla oynatmayı kontrol edin.
Stüdyonun kanalı
Günün her saati bir kanal.
- Stüdyonun playout'u için bir canlı yayın ekleyin (RTMP push) ve kanalı içeren her kademenin buketlerine koyun.
- Destekçiler neyin yayında olduğunu görsün diye kanalın rehberini XMLTV olarak yükleyin ve tekrar izlemeye değer programlar için catch-up'ı etkinleştirin.
- Yayınlar arasında playout'u stüdyonun kendi zamanlanmış içeriğiyle çalışır tutun; panel yalnızca yayını aktarır.
Abonelik bitişi
Erişim ödemeyi izler.
- Bir hat paketinin dönemi sonunda sona erer; mağaza sonraki ödeme geldiğinde renew_line ile yeniler.
- Mağazayı, line.expiring'de hatırlatma göndermek ve line.expired'da destekçiyi alt kademeye indirmek için webhook'lara abone edin.
- İptal eden bir destekçiyi mağaza disable_line ile devre dışı bırakır ve hat daha sonra yeni bir hesap olmadan yenilenebilir.
Mağaza ile entegrasyon
Mağaza satar; oynatıcı oynatır.
- Konektör hatları siparişlerle uyumlu olarak oluşturur, yeniler ve devre dışı bırakır; diğer tüm mağazalar Reseller API ve webhook'ları kullanır.
- Satış ortakları kendi hatlarını panellerinde görür ve Reseller API bunu otomatikleştirmelerine olanak tanır.
- İzleyiciler için tek oturum açma yoktur: destekçiler oynatıcıda, mağazanın kendilerine gönderdiği hat kimlik bilgileriyle oturum açar.
Güvenlik değerlendirmeleri
Yalnızca sunucuyu değil, aboneliği koruyun.
- Paneli ve oynatma tabanı URL'sini TLS üzerinden sunun ve TRUSTED_PROXIES'i reverse proxy'nize ayarlayın.
- Her panel hesabı için iki adımlı oturum açma ve satış ortakları kataloğu değiştiremesin diye yetki grupları.
- İmzalı ve süresi dolan oynatma bağlantıları ile hat başına bağlantı sınırı; bir lisans bölgeselse hattı bir ülkeye bağlayın.
- Site dışı kopyalı şifreli veritabanı yedekleri ve hatların ve kataloğun her değişikliği için denetim günlüğü.
Sorun giderme
Olağan ilk kontroller.
- Yeni bir destekçi ödeme sonrası izleyemiyor: mağaza konektörünün Reseller API günlüğündeki çağrısını ve hattın bitiş tarihini kontrol edin.
- Bir destekçi üst kademenin içeriğini görüyor: hattın paketini ve verdiği buketleri kontrol edin.
- Kanal bir playout döngüsünün sonunda duruyor: kodlayıcının canlı yayına gönderimini ve yayının yoklama durumunu kontrol edin.
- Bir satış ortağının satışı görünmüyor: kredilerini ve kullandığı paketin grubuna ait olduğunu kontrol edin.