Ana sayfa
XtreamUIPro

Kurulum kılavuzu

Perakende ve Franchise Ağları kurulum kılavuzu

Platformu bir mağaza ağının video hizmeti olarak yapılandırın: ekranlarda bir mağaza kanalı, bir personel eğitim arşivi, franchise sahibi başına bir ortak hesabı ve bölge başına bir node.

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 mağaza veya franchise sahibi 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üzdePlatformdaPanelde nerede
Mağaza kanalı veya eğitim koleksiyonuBuket: bir paketin verdiği, adlandırılmış kanal, film veya dizi kümesiBouquets, Streams ve Movies / Series'ten
Mağaza kanalıCanlı kanal: kaynakları, EPG'si ve çıkış formatları olan bir yayınStreams → canlı yayın ekle (kaynak URL'si veya RTMP push)
Eğitim ve ürün videosuVOD kataloğu: sezon ve bölümlü filmler ve diziler, kategoriler ve meta veriMovies ve Series ya da VOD ingest işi
Mağaza ekranı veya personel erişimiHat: paketi, buketleri, bitiş tarihi, bağlantı sınırı ve çıkışlarıyla tek bir erişimLines → ekle, veya etkinleştirme kodları, veya Reseller API
Franchise sahibi hesabıBayi hesabı (reseller): kredisi, yetkileri ve kendi hatları olan devredilmiş bir panelUsers → bayi ekle; yetkileri için Groups
Bölgesel nodeYayın node'ları: panelden kaydedilen edge sunucular, her site veya bina için bir taneServers → node ekle, SSH ile kurulur
Hat başına ekran veya cihazHattın en fazla bağlantısı: aynı anda kaç cihaz izleyebilirHattın en fazla bağlantısı

Ön koşullar

Kurmadan önce nelere sahip olmalı.

  1. Bir merkez ofis sunucusu (Ubuntu 22.04 veya 24.04), kurulum aracı ve çok sayıda mağazası olan ve onlardan erişilebilen her bölge için bir sunucu.
  2. Mağaza kanalı içeriği (bir kodlayıcı veya döngülü bir kaynak), oryantasyon ve ürün eğitimi kayıtları ve mağazalardaki ekranlar veya medya oynatıcılar.
  3. Franchise yapısı hakkında bir karar: hangi bölgelerin node alacağı ve her franchise sahibinde hatları kimin yöneteceği.

Altyapı dağıtımı

Önce merkez ofis, sonra bölgeler.

  1. Kurulum aracını merkez ofis sunucusunda çalıştırın ve oynatma tabanı URL'sini mağazaların erişebildiği, TLS'li bir adrese ayarlayın.
  2. Mağaza kanalını Streams altına, eğitim kayıtlarını Movies altına ekleyin ve web oynatıcıda kontrol edin.
  3. Servers'tan bölge başına bir node kaydedin; panel onu SSH ile kurar veya node tek kullanımlık bir kodla kaydolur ve o bölgenin mağazalarını ona yönlendirir.
  4. Merkez ofisin içerik ekibi için katalog yetkileri olan ve mağazaların hatları için yetkisi olmayan bir ortak hesabı oluşturun.

İçerik organizasyonu

Mağaza kanalı ve eğitim arşivi.

  1. Mağaza kanalı için bir canlı yayın oluşturun ve kendi buketine koyun.
  2. Konu başına kategoriler ve eğitim kursu başına, ders başına bir bölümle bir dizi oluşturun; rol başına bir buket ekleyin (satış personeli, yöneticiler, yeni başlayanlar).
  3. Mağaza ekranları için bir paket ve rol başına bir paket oluşturun; her biri kendi buketlerini verir ve süre olarak erişim süresini taşır.
  4. Franchise sahiplerine, mağazalarına ve personeline yeniden satabilecekleri paketleri verin.

Ortak (bayi) yapılandırması

Franchise sahibi başına bir ortak hesabı.

  1. Yetkileri hatlarla sınırlı, katalog değişikliği olmayan bir grup oluşturun.
  2. Her franchise sahibini Users → add a reseller altında o grup, paketleri ve bir kredi bakiyesiyle ekleyin.
  3. Birden çok bölgesi olan bir franchise sahibi bölge başına bir alt bayi ekleyebilir; her birinin kendi mağazaları olur.

Mağaza ve personel hattı yapılandırması

Ekran başına ve çalışan başına bir hat.

  1. Mağaza ekranı başına, mağazanın adı ve mağaza paketiyle bir hat oluşturun (Lines → add); franchise sahibi kendi mağazaları için aynısını yapar.
  2. En fazla bağlantıyı mağazadaki ekran sayısına, bir çalışan için ise ikiye (satış alanı ve telefon) ayarlayın.
  3. Mağazanın sabit bir adresi varsa mağaza hattını o adrese bağlayın; böylece kimlik bilgileri başka yerde çalışmaz.
  4. Ekranın oynatıcısını bir kez yapılandırın (M3U, Xtream Codes API veya web oynatıcı adresi) ve kimlik bilgilerini mağazanın dosyasında tutun.

Eğitim ve ürün videosu

Personel için arşiv.

  1. Her eğitim kursunu dizi, her ürün filmini film olarak yükleyin ya da VOD ingest işiyle medya köküne içe alın.
  2. Kayıtları kategorileri aracılığıyla doğru rolün buketine koyun.
  3. Arşivi franchise sahiplerine açmadan önce her rolün ne gördüğünü bir test hattıyla kontrol edin.

Mağaza kanalı

Tüm ekranlar için tek bir kanal.

  1. Mağaza kanalını, merkez ofisin kodlayıcısının RTMP ile veya döngülü bir kaynağın beslediği canlı yayın olarak ekleyin.
  2. Canlı yayınlanan eğitim oturumları için catch-up'ı etkinleştirin ve sonra kaydı arşive yükleyin.
  3. Bölgelerdeki node'lar kanalı origin'den bir kez alır ve mağazalarına hizmet verir; böylece mağazaların bağlantıları doymaz.

Bitiş ve yenileme

Erişim mağazayı veya sözleşmeyi izler.

  1. Bir hat paketinin dönemi sonunda sona erer; franchise sahibi onu bir paket veya bir kredi ile yeniler.
  2. Kapanan bir mağazanın veya ayrılan bir çalışanın hattını devre dışı bırakın.
  3. Süresi dolmak üzere olan veya dolmuş hatları görmek için franchise yönetimi veya İK sistemini webhook'lara abone edin.

Franchise veya İK sistemleriyle entegrasyon

Sistemler hatları yönetir; oynatıcı oynatır.

  1. Franchise yönetimi veya İK sistemi için bir Reseller API anahtarı oluşturun; her yazma işleminde bir istek kimliğiyle create_line, renew_line, enable_line ve disable_line çağırır.
  2. Franchise sahiplerini hizmet için faturalandırıyorsanız bir ticaret konektörü kullanın; diğer tüm sistemler Reseller API ve webhook'ları kullanır.
  3. İzleyiciler için tek oturum açma yoktur: personel oynatıcıda hattının kimlik bilgileriyle oturum açar.

Güvenlik değerlendirmeleri

Her mağazayı kendi hatlarında tutun.

  1. Paneli TLS'li bir reverse proxy'nin arkasında sunun ve denetim günlüğü ile IP kuralları gerçek adresleri görsün diye TRUSTED_PROXIES'i ayarlayın.
  2. Her merkez ofis hesabı için iki adımlı oturum açma; franchise sahipleri yalnızca kendi hatlarıyla sınırlı bir yetki grubu alır.
  3. Hat başına bağlantı sınırı, imzalı ve süresi dolan oynatma bağlantıları ve mağaza ekranları için adrese bağlama.
  4. Site dışı kopyalı şifreli veritabanı yedeğini etkinleştirin ve hatların ve kataloğun değişikliklerini incelemek için denetim günlüğünü kullanın.

Sorun giderme

Olağan ilk kontroller.

  1. Bir mağaza ekranı siyah: hattının etkin olduğunu ve süresinin dolmadığını, adrese bağlamayı ve hattı ikinci bir cihaz kullanıyorsa bağlantı sınırını kontrol edin.
  2. Bir bölge takılıyor: bölgesel node'un heartbeat'ini ve mağazaların ona yönlendirildiğini kontrol edin.
  3. Bir franchise sahibi hat oluşturamıyor: kredi bakiyesini, grubunun yetkilerini ve kendisine atanan paketleri kontrol edin.
  4. Denetim günlüğü proxy'nin adresini gösteriyor: TRUSTED_PROXIES'i proxy'ye ayarlayın ve paneli yeniden başlatın.