Te przewodniki odwzorowują pojęcia branży na obiekty, które platforma ma dziś (bukiety, linie, pakiety, konta partnerów, węzły, API). To odwzorowania koncepcyjne, a nie funkcje specyficzne dla branż, a konto partnera jest kontem delegowanym, a nie odizolowanym najemcą.
Odwzorowanie koncepcyjne
Nic w panelu nie nazywa się wydziałem, semestrem ani studentem. Tabela mówi, który obiekt pełni jaką rolę; kolejne rozdziały konfigurują je w tej kolejności.
| W Twojej branży | Na platformie | Gdzie w panelu |
|---|---|---|
| Konto wydziału lub katedry | Konto partnera (reseller): delegowany panel z kredytami, uprawnieniami i własnymi liniami | Users → dodaj resellera; Groups dla jego uprawnień |
| Kolekcja wydziału lub zestaw kanałów kampusu | Bukiet: nazwany zestaw kanałów, filmów lub seriali przyznawany przez pakiet | Bouquets, ze Streams oraz Movies / Series |
| Kanał kampusowy lub wydarzenie na żywo | Kanał na żywo: strumień ze źródłami, EPG i formatami wyjściowymi | Streams → dodaj strumień na żywo (adres źródła lub wysyłka RTMP) |
| Archiwum wykładów | Katalog VOD: filmy i seriale z sezonami i odcinkami, kategorie i metadane | Movies i Series lub zadanie pobierania VOD |
| Dostęp studenta lub pracownika | Linia: jeden dostęp z pakietem, bukietami, datą wygaśnięcia, limitem połączeń i wyjściami | Lines → dodaj, albo kody aktywacyjne, albo Reseller API |
| Koniec semestru lub zapisu | Data wygaśnięcia linii, odnawiana przez pakiet, kredyt lub API | Data wygaśnięcia linii i czas trwania pakietu |
| Węzeł kampusu lub akademika | Węzły streamingu: serwery brzegowe zarejestrowane z panelu, po jednym na lokalizację lub budynek | Servers → dodaj węzeł, instalowany przez SSH |
| Integracja z systemem informacji o studentach | Reseller API i webhooki: operacje panelu z Twojego własnego systemu | Klucze Reseller API i webhooki w panelu resellera |
Wymagania wstępne
Co mieć przed instalacją.
- Serwer na głównym kampusie (Ubuntu 22.04 lub 24.04) osiągalny z pozostałych kampusów i akademików, instalator oraz adres wewnętrzny lub domenę za Twoim reverse proxy.
- Sygnały kanałów kampusowych i nagrania wykładów (lub eksport z systemu rejestracji wykładów) oraz możliwość wywoływania API HTTP przez system informacji o studentach.
- Decyzję o strukturze: które wydziały dostają konto partnerskie, jak nazywane są serie wykładów i jak długo trwa pakiet semestralny.
Wdrożenie infrastruktury
Najpierw główny kampus, potem pozostałe lokalizacje.
- Uruchom instalator na serwerze głównego kampusu; umieść panel za reverse proxy uczelni i ustaw zaufane proxy, aby logi i reguły IP widziały prawdziwe adresy.
- Ustaw bazę odtwarzania na adres, pod którym studenci łączą się z kampusu i akademików.
- Zarejestruj węzeł na kampus i akademik w sekcji Serwery; panel instaluje go przez SSH i kieruje do niego widzów tej lokalizacji.
- Ustaw klucz licencji na serwerze; instytucja w domenie akademickiej może zamówić e-mailem bezpłatny klucz Professional programu edukacyjnego.
Organizacja treści
Kolekcje wydziałów i zestaw kanałów kampusu.
- Utwórz kategorie według wydziału i przedmiotu oraz jeden serial na kurs, z sezonem na semestr i jednym odcinkiem na wykład.
- Utwórz jeden bukiet na kolekcję wydziału, jeden dla kanałów kampusowych i jeden dla materiałów wspólnych, takich jak filmy wprowadzające.
- Utwórz pakiety dla studentów i pracowników: bukiety, których każdy potrzebuje, z semestrem jako czasem trwania, aby dostęp kończył się z semestrem, o ile nie zostanie odnowiony.
- Utwórz krótki pakiet próbny na dni otwarte lub dla studentów gościnnych.
Konfiguracja partnerów (resellerów)
Wydziały jako konta delegowane.
- Utwórz grupę z uprawnieniami do linii i własnego katalogu wydziału, bez dostępu do ustawień.
- Dodaj każdy wydział lub katedrę jako konto partnerskie (reseller) z tą grupą i jego pakietami; sub-resellerzy mogą odwzorować katedry w obrębie wydziału.
- Wydział widzi i zarządza tylko własnymi liniami; zespół centralny zachowuje pełny widok. To konto delegowane, a nie odizolowana instalacja.
Konfiguracja dostępu studentów
Jedna linia na studenta, z SIS.
- Utwórz klucz Reseller API dla systemu informacji o studentach i przechowuj go w sekretach tego systemu.
- Przy zapisie SIS wywołuje action=create_line z pakietem studenta i identyfikatorem żądania; czas trwania pakietu, czyli semestr, to okres dostępu.
- Ustaw maksymalną liczbę połączeń na liczbę urządzeń, których student może używać jednocześnie (zwykle dwa: telefon i laptop).
- Dla pracowników i pilotażu dodaj linie w sekcji Linie → dodaj i przekaż dane logowania.
Archiwa wykładów
Nagrania na żądanie.
- Prześlij każde nagranie jako źródło odcinka albo zaimportuj je zadaniem importu VOD; zachowaj tytuł kursu i krótki opis.
- Przypisz serial do bukietu wydziału, aby kurs widzieli tylko studenci, których pakiet go przyznaje.
- Sprawdź odtwarzanie linią testową każdego pakietu, aby potwierdzić, kto co widzi.
Kanały kampusowe i wydarzenia na żywo
Kanały na żywo dla kampusu.
- Dodaj sygnały kanałów kampusowych jako streamy na żywo w sekcji Streamy oraz źródło EPG dla przewodnika.
- Dodaj stream na żywo na salę wykładową lub wydarzenie, zasilany enkoderem sali przez RTMP, i włącz catch-up, aby spóźnieni widzowie mogli przewijać wstecz.
- Umieść każdy kanał we właściwym bukiecie; węzły w akademikach pobierają go raz z origin i obsługują studentów lokalnie.
Wygasanie i odnawianie
Semestr jako ważność linii.
- Linia wygasa z końcem okresu swojego pakietu; przy ponownym zapisie SIS wywołuje action=renew_line i dodawany jest kolejny okres.
- Gdy student rezygnuje lub kończy studia, SIS wywołuje action=disable_line.
- Zasubskrybuj webhooki w SIS, aby uzgadniać wygasające i wygasłe linie z jego rejestrami.
Integracja z systemem informacji o studentach
SIS steruje dostępem; odtwarzacz odtwarza.
- SIS tworzy, odnawia, włącza i wyłącza linie przez Reseller API z kluczem i identyfikatorem żądania.
- Nie ma logowania jednokrotnego dla widzów ani natywnej integracji z LMS lub SIS: student loguje się do odtwarzacza danymi linii, a strona kursu w LMS może prowadzić do odtwarzacza webowego.
- Używaj kluczy Admin API z flagą tylko do odczytu, listą dozwolonych IP i datą ważności dla wewnętrznych narzędzi raportowych.
Kwestie bezpieczeństwa
Ogranicz dostęp do studentów i pracowników.
- Trzymaj platformę w sieci kampusu lub za reverse proxy z TLS; ustaw TRUSTED_PROXIES na to proxy.
- Logowanie dwuskładnikowe dla każdego konta panelu i grupa uprawnień na rolę, aby wydział nie widział linii innego wydziału.
- Podpisane i wygasające linki odtwarzania, limit połączeń na linię oraz przypisanie do kraju lub adresu tam, gdzie to pomaga.
- Szyfrowane kopie zapasowe bazy z kopią zewnętrzną oraz dziennik audytu każdej zmiany linii i katalogu.
Rozwiązywanie problemów
Typowe pierwsze kontrole.
- Student nie widzi wykładów: sprawdź ważność linii, a następnie pakiet i bukiety, które przyznaje.
- Nowy student nie ma dostępu: sprawdź w logu wywołań Reseller API, czy wywołanie SIS się powiodło i czy identyfikator żądania jest nowy.
- Akademik buforuje wieczorem: sprawdź heartbeat jego węzła i czy widzowie są do niego kierowani.
- Dziennik audytu pokazuje adres proxy: ustaw TRUSTED_PROXIES na to proxy i zrestartuj panel.