Các hướng dẫn này ánh xạ khái niệm của ngành lên đối tượng nền tảng đang có (bouquet, line, gói, tài khoản đối tác, node, API). Đây là ánh xạ khái niệm, không phải tính năng riêng của ngành, và tài khoản đối tác là tài khoản uỷ quyền, không phải tenant tách biệt.
Ánh xạ khái niệm
Không có gì trong panel được gọi là cửa hàng hay nhà nhượng quyền. Bảng cho biết đối tượng nào đóng vai trò nào; các chương bên dưới thiết lập chúng theo thứ tự đó.
| Trong ngành của bạn | Trên nền tảng | Ở đâu trong panel |
|---|---|---|
| Kênh cửa hàng hoặc bộ sưu tập đào tạo | Bouquet: một tập kênh, phim hay series có tên mà một gói cấp quyền | Bouquets, từ Streams và Movies / Series |
| Kênh cửa hàng | Kênh trực tiếp: một luồng với nguồn, EPG và định dạng đầu ra | Streams → thêm live stream (URL nguồn hoặc RTMP push) |
| Video đào tạo và sản phẩm | Danh mục VOD: phim và series có mùa và tập, danh mục và metadata | Movies và Series, hoặc job ingest VOD |
| Màn hình cửa hàng hoặc quyền truy cập của nhân viên | Line: một quyền truy cập với gói, bouquet, hạn, giới hạn kết nối và đầu ra | Lines → thêm, hoặc mã kích hoạt, hoặc Reseller API |
| Tài khoản nhà nhượng quyền | Tài khoản đối tác (reseller): dashboard uỷ quyền có credit, quyền hạn và line riêng | Users → thêm reseller; Groups cho quyền hạn |
| Node khu vực | Node phát video: máy chủ biên enroll từ panel, một node mỗi cơ sở hay toà nhà | Servers → thêm node, cài qua SSH |
| Màn hình hoặc thiết bị trên mỗi line | Số kết nối tối đa của line: bao nhiêu thiết bị xem cùng lúc | Max connections của line |
Điều kiện tiên quyết
Những thứ cần có trước khi cài đặt.
- Một máy chủ ở trụ sở chính (Ubuntu 22.04 hoặc 24.04), bộ cài, và một máy chủ cho mỗi khu vực có nhiều cửa hàng và các cửa hàng truy cập được.
- Nội dung kênh cửa hàng (một bộ mã hoá hoặc nguồn phát lặp), các bản ghi hướng dẫn nhân viên mới và đào tạo sản phẩm, và các màn hình hoặc đầu phát media tại cửa hàng.
- Quyết định về cơ cấu nhượng quyền: khu vực nào có node, và ai ở mỗi nhà nhượng quyền quản lý các line.
Triển khai hạ tầng
Trụ sở chính trước, sau đó là các khu vực.
- Chạy bộ cài trên máy chủ trụ sở chính và đặt URL gốc phát thành địa chỉ mà các cửa hàng truy cập được, sau TLS.
- Thêm kênh cửa hàng trong Streams và các bản ghi đào tạo trong Movies, rồi kiểm tra trong web player.
- Đăng ký một node cho mỗi khu vực từ Servers; panel cài nó qua SSH, hoặc node tự đăng ký bằng mã dùng một lần, và định tuyến các cửa hàng của khu vực đó tới node.
- Tạo tài khoản đối tác cho nhóm nội dung ở trụ sở chính với quyền về danh mục và không có quyền về line của các cửa hàng.
Tổ chức nội dung
Kênh cửa hàng và thư viện đào tạo.
- Tạo một luồng trực tiếp cho kênh cửa hàng và đặt nó trong bouquet riêng.
- Tạo danh mục theo chủ đề và một series cho mỗi khoá đào tạo, mỗi bài học một tập; thêm một bouquet cho mỗi vai trò (nhân viên bán hàng, quản lý, nhân viên mới).
- Tạo một gói cho các màn hình cửa hàng và một gói cho mỗi vai trò, mỗi gói cấp các bouquet của nó và có thời gian truy cập làm thời hạn.
- Cấp cho nhà nhượng quyền các gói mà họ được bán lại cho cửa hàng và nhân viên của mình.
Cấu hình đối tác (reseller)
Mỗi nhà nhượng quyền một tài khoản đối tác.
- Tạo một nhóm với quyền giới hạn ở line, không được thay đổi danh mục.
- Thêm từng nhà nhượng quyền trong Users → add a reseller, với nhóm đó, các gói của họ và số dư credit.
- Nhà nhượng quyền có nhiều khu vực có thể thêm một sub-reseller cho mỗi khu vực, mỗi người có các cửa hàng riêng.
Cấu hình line cho cửa hàng và nhân viên
Một line cho mỗi màn hình và mỗi nhân viên.
- Tạo một line cho mỗi màn hình cửa hàng trong Lines → add với tên của cửa hàng và gói cửa hàng; nhà nhượng quyền làm tương tự cho các cửa hàng của mình.
- Đặt số kết nối tối đa bằng số màn hình trong cửa hàng, và bằng hai cho một nhân viên (tại cửa hàng và trên điện thoại).
- Gắn line của cửa hàng với địa chỉ của cửa hàng khi có địa chỉ cố định, để thông tin đăng nhập không dùng được ở nơi khác.
- Cấu hình player của màn hình một lần (M3U, Xtream Codes API hoặc địa chỉ web player) và giữ thông tin đăng nhập trong hồ sơ của cửa hàng.
Video đào tạo và sản phẩm
Thư viện cho nhân viên.
- Tải từng khoá đào tạo lên dưới dạng series và từng phim sản phẩm dưới dạng phim, hoặc nạp vào thư mục media gốc bằng tác vụ VOD ingest.
- Đặt các bản ghi vào bouquet của đúng vai trò thông qua danh mục của chúng.
- Kiểm tra mỗi vai trò thấy gì bằng một line thử trước khi mở thư viện cho các nhà nhượng quyền.
Kênh cửa hàng
Một kênh cho mọi màn hình.
- Thêm kênh cửa hàng dưới dạng luồng trực tiếp, do bộ mã hoá của trụ sở chính cấp qua RTMP hoặc một nguồn phát lặp.
- Bật catch-up cho các buổi đào tạo phát trực tiếp, và tải bản ghi lên thư viện sau đó.
- Các node ở khu vực lấy kênh một lần từ origin và phục vụ các cửa hàng của mình, nên đường truyền của cửa hàng không bị quá tải.
Hết hạn và gia hạn
Quyền truy cập đi theo cửa hàng hoặc hợp đồng.
- Một line hết hạn vào cuối thời hạn của gói; nhà nhượng quyền gia hạn nó bằng một gói hoặc một credit.
- Vô hiệu hoá line của cửa hàng đã đóng hoặc nhân viên đã nghỉ.
- Đăng ký hệ thống quản lý nhượng quyền hoặc nhân sự vào các webhook để thấy các line sắp hết hạn hoặc đã hết hạn.
Tích hợp với hệ thống nhượng quyền hoặc nhân sự
Hệ thống điều khiển line; player phát.
- Tạo khoá Reseller API cho hệ thống quản lý nhượng quyền hoặc nhân sự; nó gọi create_line, renew_line, enable_line và disable_line, với request id ở mỗi lệnh ghi.
- Dùng connector thương mại khi bạn tính phí nhà nhượng quyền cho dịch vụ; hệ thống khác dùng Reseller API và webhook.
- Không có đăng nhập một lần cho người xem: nhân viên đăng nhập vào player bằng thông tin của line của mình.
Lưu ý về bảo mật
Giữ mỗi cửa hàng trên line của riêng nó.
- Chạy panel sau reverse proxy có TLS và đặt TRUSTED_PROXIES để nhật ký kiểm toán và quy tắc IP thấy địa chỉ thật.
- Đăng nhập hai lớp cho mọi tài khoản trụ sở chính; nhà nhượng quyền nhận một nhóm quyền giới hạn ở line của chính họ.
- Giới hạn kết nối trên mỗi line, liên kết phát được ký và có hạn, và gắn địa chỉ cho các màn hình cửa hàng.
- Bật sao lưu cơ sở dữ liệu mã hoá kèm bản sao ngoài site, và dùng nhật ký kiểm toán để xem lại các thay đổi của line và danh mục.
Xử lý sự cố
Những kiểm tra đầu tiên thường gặp.
- Một màn hình cửa hàng bị đen: kiểm tra line của nó đang bật và chưa hết hạn, việc gắn địa chỉ, và giới hạn kết nối nếu một thiết bị thứ hai đang dùng line.
- Một khu vực bị giật: kiểm tra heartbeat của node khu vực và các cửa hàng có được định tuyến tới nó không.
- Nhà nhượng quyền không tạo được line: kiểm tra số dư credit, quyền của nhóm và các gói được gán cho họ.
- Nhật ký kiểm toán hiện địa chỉ của proxy: đặt TRUSTED_PROXIES thành proxy và khởi động lại panel.