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 şeye departman veya çalışan denmez. Tablo hangi nesnenin hangi rolü oynadığını söyler; aşağıdaki bölümler onları bu sırayla kurar.
| Sektörünüzde | Platformda | Panelde nerede |
|---|---|---|
| Departman eğitim koleksiyonu | Buket: bir paketin verdiği, adlandırılmış kanal, film veya dizi kümesi | Bouquets, Streams ve Movies / Series'ten |
| Eğitim materyalleri | VOD kataloğu: sezon ve bölümlü filmler ve diziler, kategoriler ve meta veri | Movies ve Series ya da VOD ingest işi |
| Çalışan 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 |
| Dahili eğitim oturumu | Canlı kanal: kaynakları, EPG'si ve çıkış formatları olan bir yayın | Streams → canlı yayın ekle (kaynak URL'si veya RTMP push) |
| İK veya LMS entegrasyonu | Reseller API ve webhook'lar: panelin işlemleri kendi sisteminizden | Bayinin panelindeki Reseller API anahtarları ve webhook'lar |
| Çalışan başına cihaz | Hattın en fazla bağlantısı: aynı anda kaç cihaz izleyebilir | Hattın en fazla bağlantısı |
Ön koşullar
Kurmadan önce nelere sahip olmalı.
- Ofislerden erişilebilen bir şirket sunucusu (Ubuntu 22.04 veya 24.04), kurulum aracı ve ters proxy'nizin arkasında dahili bir adres veya alan adı.
- Eğitim kayıtları, canlı oturumlar için oditoryumun kodlayıcısı ve İK veya LMS sisteminin bir HTTP API çağırabilmesi.
- Gizlilik kararı: hangi materyal hangi departman koleksiyonuna girer ve İK'dan ve eğitim ekibinden kim bir panel hesabı alır.
Altyapı dağıtımı
Önce genel merkez, sonra ofisler.
- Kurulum aracını genel merkez sunucusunda çalıştırın; paneli şirketin ters proxy'sinin arkasına koyun ve denetim günlüğünün gerçek adresleri görmesi için güvenilir proxy'leri ayarlayın.
- Oynatma tabanını dahili adrese ayarlayın; ağ dışındaki çalışanlar ona VPN veya proxy üzerinden ulaşır.
- Servers'tan ofis başına bir node kaydedin; panel onu SSH ile kurar ve o ofisin izleyicilerini ona yönlendirir.
- Eğitim ekibi için katalog yetkileri olan, çalışanların hatları için yetkisi olmayan bir bayi hesabı oluşturun.
İçerik organizasyonu
Departmana göre koleksiyonlar, dizi olarak kurslar.
- Konu başına kategoriler ve çok bölümlü kurs başına, oturum başına bir bölümle bir dizi oluşturun.
- Departman eğitim koleksiyonu başına bir buket ve herkesin gördüğü materyal için tüm personel buketi oluşturun.
- Rol başına bir paket oluşturun: o rolün ihtiyaç duyduğu buketler ve başkası değil; erişim süresi olarak uzun bir süreyle (örneğin bir yıl). Yenileme bir süre daha ekler ve sözleşme bittiğinde İK hattı devre dışı bırakır.
- Gizli koleksiyonları adlarında açıkça işaretleyin; bir hat yalnızca paketinin verdiği buketleri görür.
Ortak (bayi) yapılandırması
Eğitim ekibi ve bir grup için her iştirak.
- Eğitim ekibi için katalog yetkili bir grup ve İK için hat yetkili bir grup oluşturun.
- Eğitim ekibini ve İK'yı bu gruplarla bayi olarak ekleyin; dahili bir dağıtımda hiçbirinin krediye ihtiyacı yoktur.
- Kendi kütüphanesi olan bir iştirak kendi bayisini, kendi buketlerini ve kendi paketlerini alır.
Çalışan erişimi yapılandırması
İK'dan çalışan başına bir hat.
- İK sistemi için bir Reseller API anahtarı oluşturun ve İK sisteminin gizli bilgilerinde tutun.
- İşe alımda İK sistemi, rolün paketi ve bir istek kimliğiyle action=create_line çağırır (paketin süresi erişim süresidir); ayrılışta action=disable_line.
- En fazla bağlantıyı çalışanın kullanabileceği cihaz sayısına ayarlayın (genellikle iki: masa ve telefon).
- Bir pilot için Lines → ekle ile hat ekleyin ve kimlik bilgilerini birkaç çalışana verin.
Eğitim materyalleri
İsteğe bağlı kayıtlar.
- Her kaydı bir bölümün kaynağı olarak yükleyin veya VOD ingest işiyle içe alın; başlığı ve kısa bir açıklamayı tutun.
- Kaydı dizisi üzerinden doğru departman buketine bağlayın.
- Kimin neyi gördüğünü doğrulamak için her rolün bir test hattıyla oynatmayı kontrol edin.
Dahili eğitim oturumları
Canlı kanal olarak bir oturum.
- Oditoryumun kodlayıcısı için bir canlı yayın ekleyin (RTMP push); tüm personel buketine veya bir departmanınkine koyun.
- Geç katılanların geri sarabilmesi için catch-up'ı etkinleştirin ve kaydı sonradan kütüphaneye yükleyin.
- Ofislerdeki node'lar oturumu origin'den bir kez alır ve çalışanlarına yerelde hizmet verir.
Erişimin sona ermesi
Erişim sözleşmeyle biter.
- Bir hat, paketinin süresinin sonunda sona erer; sözleşme sürerken İK onu action=renew_line ile yeniler, sözleşme bittiğinde İK hattı devre dışı bırakır.
- Biten ve bitmek üzere olan hatları kendi kayıtlarıyla uzlaştırmak için İK sistemini webhook'lara abone edin.
- Geçici erişim için (yükleniciler, işe başlama haftası) ayrı bir paket yerine kısa bir bitiş tarihi kullanın.
İK veya bir LMS ile entegrasyon
Sistemler erişimi yönetir; oynatıcı oynatır.
- İK hatları Reseller API ile oluşturur, yeniler ve devre dışı bırakır; LMS bir ders sayfasından web oynatıcıya bağlantı verebilir.
- İzleyiciler için tek oturum açma yoktur: çalışan oynatıcıya sisteminizin verdiği hat kimlik bilgileriyle giriş yapar.
- Dahili raporlama araçları için salt okunur işaretli Admin API anahtarları kullanın.
Güvenlik değerlendirmeleri
Ağdan hatta gizlilik.
- Platformu iç ağda veya TLS'li ters proxy'nin arkasında tutun; TRUSTED_PROXIES'i buna göre ayarlayın.
- Her panel hesabı için iki adımlı giriş; İK'nın kataloğu değiştirememesi ve eğitim ekibinin hatları görememesi için yetki grupları.
- İmzalı ve süresi dolan oynatma bağlantıları, hat başına düşük bağlantı sınırı ve cihazlar sabit olduğunda adres bağlama.
- Site dışı kopyalı şifreli veritabanı yedekleri; hatlarda ve katalogdaki her değişiklik için denetim günlüğü.
Sorun giderme
Olağan ilk kontroller.
- Bir çalışan başka bir departmanın materyalini görüyor: hattın paketini ve verdiği buketleri kontrol edin.
- Yeni işe alınanın erişimi yok: İK çağrısının başarılı olduğunu (Reseller API çağrı günlüğü) ve hattın bitiş tarihini kontrol edin.
- Bir ofis canlı oturum sırasında takılıyor: ofis node'unun heartbeat'ini ve izleyicilerin ona yönlendirildiğini kontrol edin.
- Denetim günlüğü proxy'nin adresini gösteriyor: TRUSTED_PROXIES'i proxy'ye ayarlayın ve paneli yeniden başlatın.