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ę sesją, mieszkańcem ani wydziałem. 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 |
|---|---|---|
| Sesja rady lub kanał publiczny | 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 sesji i biblioteka szkoleń | Katalog VOD: filmy i seriale z sezonami i odcinkami, kategorie i metadane | Movies i Series lub zadanie pobierania VOD |
| Program publiczny lub kolekcja wydziału | Bukiet: nazwany zestaw kanałów, filmów lub seriali przyznawany przez pakiet | Bouquets, ze Streams oraz Movies / Series |
| Dostęp mieszkańca 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 |
| Ważność dostępu publicznego lub pracowniczego | Data wygaśnięcia linii, odnawiana przez pakiet, kredyt lub API | Data wygaśnięcia linii i czas trwania pakietu |
| Integracja z systemem rady | 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 w centrum danych instytucji (Ubuntu 22.04 lub 24.04), instalator i domenę za reverse proxy instytucji dla publicznego adresu.
- Enkoder lub mikser wideo sali obrad zdolny do pushu RTMP, nagrania minionych sesji i filmy szkoleniowe dla pracowników.
- Decyzję, co jest publiczne, a co wewnętrzne, jak długo trwa linia publiczna i którzy operatorzy dostaną konto w panelu.
Wdrożenie infrastruktury
Serwer zarządzający, potem ewentualne zdalne lokalizacje.
- Uruchom instalator na serwerze instytucji; umieść panel za reverse proxy z TLS i ustaw TRUSTED_PROXIES, aby dziennik audytu i reguły IP widziały prawdziwe adresy.
- Ustaw bazę odtwarzania na publiczny adres, pod którym łączą się mieszkańcy, oraz klucz licencji na serwerze.
- Zarejestruj węzeł w sekcji Serwery dla lokalizacji, która go potrzebuje, np. drugiego budynku z salą obrad; panel instaluje go przez SSH.
- Utwórz konto partnerskie (reseller) dla zespołu komunikacji z uprawnieniami do linii publicznych oraz jedno dla HR lub szkoleń dla linii pracowników.
Organizacja treści
Program publiczny i kolekcje wydziałów.
- Utwórz kategorie dla sesji, komisji i informacji publicznych oraz jeden serial na organ, z jednym odcinkiem na posiedzenie.
- Utwórz bukiet publiczny z kanałem sesji na żywo i archiwum oraz jeden bukiet na kolekcję szkoleń wydziału.
- Utwórz pakiet dla mieszkańców, który przyznaje tylko bukiet publiczny, z długim czasem trwania jako okresem dostępu.
- Utwórz pakiety dla pracowników, które dodają bukiety szkoleniowe i wewnętrzne do publicznego.
Konfiguracja partnerów (resellerów)
Zespoły, które wydają dostęp.
- Utwórz grupę z uprawnieniami tylko do linii, bez dostępu do katalogu i ustawień.
- Dodaj zespół komunikacji jako konto partnerskie z pakietem mieszkańców, a HR lub szkolenia z pakietami pracowników.
- Organ z kilkoma służbami może dać każdej własne konto partnerskie; to konto delegowane, a nie odizolowana instalacja.
Konfiguracja linii mieszkańców i pracowników
Linie publiczne i linie pracowników.
- Utwórz klucz Reseller API dla strony internetowej rady i przechowuj go w jej sekretach; gdy mieszkaniec prosi o dostęp, strona wywołuje action=create_line z pakietem publicznym i identyfikatorem żądania.
- Ustaw długą ważność linii publicznych i limit połączeń odpowiedni do oglądania w gospodarstwie domowym.
- Twórz linie pracowników na wydział z pakietami pracowniczymi, z systemu kadrowego rady przez API lub w sekcji Linie → dodaj.
- Przypisz linie pracowników do zakresu adresów instytucji, jeśli pozwala na to sieć.
Archiwum sesji i biblioteka szkoleń
Nagrania na żądanie.
- Dodaj każdą nagraną sesję jako odcinek serialu swojego organu, zaimportowany zadaniem importu VOD lub przesłany, z tytułem, datą i opisem.
- Umieść serial sesji w bukiecie publicznym, a bibliotekę szkoleń w bukietach wydziałów.
- Sprawdź odtwarzanie linią testową pakietu publicznego i jednego z pakietów pracowniczych, aby potwierdzić, kto co widzi.
Sesje na żywo
Sala obrad jako kanał na żywo.
- Dodaj stream na żywo z pushem RTMP z enkodera sali obrad i umieść go w bukiecie publicznym.
- Włącz catch-up, aby spóźnieni widzowie mogli przewijać wstecz, i dodaj wpis EPG lub tytuł, aby widzowie wiedzieli, które posiedzenie trwa.
- Przetestuj sygnał przed każdym posiedzeniem i trzymaj węzeł przy drugiej lokalizacji, jeśli też odbywają się tam sesje.
Wygasanie i odnawianie
Długie dla publiczności, powiązane z zatrudnieniem dla pracowników.
- Linia publiczna trwa tyle, ile czas trwania pakietu; przedłuż ją przez action=renew_line, gdy mieszkaniec poprosi ponownie.
- Linia pracownika jest odnawiana, dopóki osoba pracuje w instytucji, i wyłączana przez action=disable_line, gdy odchodzi.
- Zasubskrybuj webhooki w systemach rady, aby widzieć wygasające i wyłączone linie.
Integracja z systemami instytucji
Systemy sterują dostępem; odtwarzacz odtwarza.
- Strona internetowa i system kadrowy tworzą, odnawiają, włączają i wyłączają linie przez Reseller API z kluczem i identyfikatorem żądania.
- Nie ma logowania jednokrotnego dla widzów ani natywnej integracji z konkretnym produktem dla sektora publicznego: widzowie logują się do odtwarzacza danymi swojej linii.
- Używaj kluczy Admin API z flagą tylko do odczytu, listą dozwolonych IP i datą ważności dla narzędzi raportowych.
Kwestie bezpieczeństwa
Prowadzone przez instytucję, jawnie tam, gdzie powinno.
- Trzymaj platformę na infrastrukturze instytucji za reverse proxy z TLS oraz materiały publiczne i wewnętrzne w osobnych bukietach.
- Logowanie dwuskładnikowe dla każdego konta panelu i grupy uprawnień na zespół; reCAPTCHA lub Turnstile przy logowaniu, jeśli panel jest osiągalny z zewnątrz.
- Podpisane i wygasające linki odtwarzania, limit połączeń na linię i przypisanie do adresu dla linii pracowników.
- Szyfrowane kopie zapasowe bazy z kopią zewnętrzną oraz dziennik audytu każdej zmiany linii i katalogu.
Rozwiązywanie problemów
Typowe pierwsze kontrole.
- Mieszkaniec nie może oglądać: sprawdź ważność linii, czy jest włączona, oraz publiczny bukiet pakietu.
- Sesja nie startuje: sprawdź push enkodera do streamu i status streamu w panelu.
- Pracownicy nie widzą biblioteki szkoleń: sprawdź pakiet linii pracownika i bukiety, które przyznaje.
- Dziennik audytu pokazuje adres proxy: ustaw TRUSTED_PROXIES na to proxy i zrestartuj panel.