Trang chủ
XtreamUIPro

Hướng dẫn thiết lập

Hướng dẫn thiết lập cho Chuỗi bán lẻ & Nhượng quyền

Cấu hình nền tảng làm dịch vụ video của một chuỗi cửa hàng: kênh cửa hàng trên màn hình, thư viện đào tạo nhân viên, một tài khoản đối tác cho mỗi nhà nhượng quyền và một node cho mỗi khu vực.

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ạnTrên nền tảngỞ đâu trong panel
Kênh cửa hàng hoặc bộ sưu tập đào tạoBouquet: một tập kênh, phim hay series có tên mà một gói cấp quyềnBouquets, từ Streams và Movies / Series
Kênh cửa hàngKênh trực tiếp: một luồng với nguồn, EPG và định dạng đầu raStreams → thêm live stream (URL nguồn hoặc RTMP push)
Video đào tạo và sản phẩmDanh mục VOD: phim và series có mùa và tập, danh mục và metadataMovies 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ênLine: một quyền truy cập với gói, bouquet, hạn, giới hạn kết nối và đầu raLines → thêm, hoặc mã kích hoạt, hoặc Reseller API
Tài khoản nhà nhượng quyềnTài khoản đối tác (reseller): dashboard uỷ quyền có credit, quyền hạn và line riêngUsers → thêm reseller; Groups cho quyền hạn
Node khu vựcNode 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 lineSố kết nối tối đa của line: bao nhiêu thiết bị xem cùng lúcMax connections của line

Điều kiện tiên quyết

Những thứ cần có trước khi cài đặt.

  1. 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.
  2. 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.
  3. 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.

  1. 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.
  2. 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.
  3. Đă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.
  4. 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.

  1. Tạo một luồng trực tiếp cho kênh cửa hàng và đặt nó trong bouquet riêng.
  2. 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).
  3. 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.
  4. 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.

  1. Tạo một nhóm với quyền giới hạn ở line, không được thay đổi danh mục.
  2. 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.
  3. 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.

  1. 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.
  2. Đặ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).
  3. 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.
  4. 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.

  1. 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.
  2. Đặt các bản ghi vào bouquet của đúng vai trò thông qua danh mục của chúng.
  3. 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.

  1. 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.
  2. 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 đó.
  3. 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.

  1. 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.
  2. Vô hiệu hoá line của cửa hàng đã đóng hoặc nhân viên đã nghỉ.
  3. Đă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.

  1. 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.
  2. 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.
  3. 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ó.

  1. 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.
  2. Đă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ọ.
  3. 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.
  4. 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.

  1. 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.
  2. 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.
  3. 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ọ.
  4. 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.