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 fakülte, dönem veya öğrenci 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 |
|---|---|---|
| Fakülte veya bölüm hesabı | Bayi hesabı (reseller): kredisi, yetkileri ve kendi hatları olan devredilmiş bir panel | Users → bayi ekle; yetkileri için Groups |
| Fakülte koleksiyonu veya kampüs kanal listesi | Buket: bir paketin verdiği, adlandırılmış kanal, film veya dizi kümesi | Bouquets, Streams ve Movies / Series'ten |
| Kampüs kanalı veya canlı etkinlik | Canlı kanal: kaynakları, EPG'si ve çıkış formatları olan bir yayın | Streams → canlı yayın ekle (kaynak URL'si veya RTMP push) |
| Ders 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 |
| Öğrenci veya personel 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 |
| Dönemin veya kaydın sonu | Hattın bitiş tarihi; bir paket, bir kredi veya API ile yenilenir | Hattın bitiş tarihi ve paketin süresi |
| Kampüs veya yurt node'u | Yayın node'ları: panelden kaydedilen edge sunucular, her site veya bina için bir tane | Servers → node ekle, SSH ile kurulur |
| Öğrenci bilgi sistemi 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ı.
- Diğer kampüslerden ve yurtlardan erişilebilen ana kampüste bir sunucu (Ubuntu 22.04 veya 24.04), kurulum aracı ve reverse proxy'nizin arkasında dahili bir adres veya alan adı.
- Kampüs kanal beslemeleri ve ders kayıtları (veya ders yakalama sisteminin dışa aktarımı) ve öğrenci bilgi sisteminin bir HTTP API çağırabilmesi.
- Yapı hakkında bir karar: hangi fakültelerin ortak hesabı alacağı, ders dizilerinin nasıl adlandırılacağı ve bir dönem paketinin ne kadar süreceği.
Altyapı dağıtımı
Önce ana kampüs, sonra diğer sahalar.
- Kurulum aracını ana kampüs sunucusunda çalıştırın; paneli üniversitenin reverse proxy'sinin arkasına koyun ve günlükler ile IP kuralları gerçek adresleri görsün diye güvenilir proxy'leri ayarlayın.
- Oynatma tabanını öğrencilerin kampüsten ve yurtlardan eriştiği adrese ayarlayın.
- Servers'tan kampüs ve yurt başına bir node kaydedin; panel onu SSH ile kurar ve o sahanın izleyicilerini ona yönlendirir.
- Lisans anahtarını sunucuda ayarlayın; akademik bir alan adına sahip bir kurum, eğitim programının ücretsiz Professional anahtarını e-postayla talep edebilir.
İçerik organizasyonu
Fakülte koleksiyonları ve kampüs kanal listesi.
- Fakülte ve ders başına kategoriler oluşturun ve kurs başına, dönem başına bir sezon ve ders başına bir bölümle bir dizi oluşturun.
- Fakülte koleksiyonu başına bir buket, kampüs kanalları için bir buket ve oryantasyon videoları gibi ortak malzeme için bir buket oluşturun.
- Öğrenciler ve personel için paketler oluşturun: her birinin ihtiyaç duyduğu buketler, süre olarak dönemle; böylece yenilenmedikçe erişim dönemle biter.
- Açık kapı günleri veya misafir öğrenciler için kısa bir deneme paketi oluşturun.
Ortak (bayi) yapılandırması
Devredilmiş hesap olarak fakülteler.
- Hatlar ve fakültenin kendi kataloğu için yetkisi olan, ayarlara erişimi olmayan bir grup oluşturun.
- Her fakülteyi veya bölümü o grup ve paketleriyle bir ortak hesabı (bayi) olarak ekleyin; alt bayiler bir fakülte içindeki bölümleri yansıtabilir.
- Bir fakülte yalnızca kendi hatlarını görür ve yönetir; merkez ekip tüm görünümü korur. Devredilmiş bir hesaptır, yalıtılmış bir kurulum değil.
Öğrenci erişimi yapılandırması
SIS'ten öğrenci başına bir hat.
- Öğrenci bilgi sistemi için bir Reseller API anahtarı oluşturun ve o sistemin gizli bilgileri arasında tutun.
- Kayıtta SIS, öğrencinin paketi ve bir istek kimliğiyle action=create_line çağırır; paketin süresi olan dönem, erişim süresidir.
- En fazla bağlantıyı bir öğrencinin aynı anda kullanabileceği cihaz sayısına (genellikle iki: telefon ve dizüstü) ayarlayın.
- Personel ve bir pilot için Lines → add'den hat ekleyin ve kimlik bilgilerini verin.
Ders arşivleri
İ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; kurs başlığını ve kısa bir açıklamayı tutun.
- Diziyi fakültenin buketine bağlayın; böylece kursu yalnızca paketi onu veren öğrenciler görür.
- Kimin neyi gördüğünü doğrulamak için her paketin bir test hattıyla oynatmayı kontrol edin.
Kampüs kanalları ve canlı etkinlikler
Kampüs için canlı kanallar.
- Kampüs kanal beslemelerini Streams altına canlı yayın olarak ve rehber için bir EPG kaynağı ekleyin.
- Ders salonu veya etkinlik başına, salonun kodlayıcısının RTMP ile beslediği bir canlı yayın ekleyin ve geç gelen izleyiciler geri sarabilsin diye catch-up'ı etkinleştirin.
- Her kanalı doğru buketin içine koyun; yurtlardaki node'lar onu origin'den bir kez alır ve öğrencilere yerel olarak hizmet verir.
Bitiş ve yenileme
Hattın geçerliliği olarak dönem.
- Bir hat paketinin dönemi sonunda sona erer; yeniden kayıtta SIS action=renew_line çağırır ve bir dönem daha eklenir.
- Bir öğrenci kaydını sildirdiğinde veya mezun olduğunda SIS action=disable_line çağırır.
- Süresi dolmak üzere olan ve dolmuş hatları kayıtlarıyla uzlaştırmak için SIS'i webhook'lara abone edin.
Öğrenci bilgi sistemiyle entegrasyon
SIS erişimi yönetir; oynatıcı oynatır.
- SIS, Reseller API üzerinden bir anahtar ve istek kimliğiyle hat oluşturur, yeniler, etkinleştirir ve devre dışı bırakır.
- İzleyiciler için tek oturum açma ve yerel LMS veya SIS entegrasyonu yoktur: öğrenci oynatıcıda hattın kimlik bilgileriyle oturum açar ve LMS'teki bir kurs sayfası web oynatıcıya bağlantı verebilir.
- Dahili raporlama araçları için salt okunur bayraklı, IP izin listeli ve bitiş tarihli Admin API anahtarları kullanın.
Güvenlik değerlendirmeleri
Erişimi öğrenciler ve personelle sınırlı tutun.
- Platformu kampüs ağında veya TLS'li reverse proxy'nin arkasında tutun; TRUSTED_PROXIES'i proxy'ye ayarlayın.
- Her panel hesabı için iki adımlı oturum açma ve rol başına bir yetki grubu; böylece bir fakülte başka bir fakültenin hatlarını göremez.
- İmzalı ve süresi dolan oynatma bağlantıları, hat başına bağlantı sınırı ve işe yaradığı yerde bir ülkeye veya adrese bağlama.
- 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.
- Bir öğrenci ders görmüyor: hattın bitiş tarihini, sonra paketi ve verdiği buketleri kontrol edin.
- Yeni bir öğrencinin erişimi yok: SIS çağrısının Reseller API çağrı günlüğünde başarılı olduğunu ve istek kimliğinin yeni olduğunu kontrol edin.
- Bir yurt akşamları takılıyor: 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.