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ăn hộ hay cư dâ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 |
|---|---|---|
| Tài khoản người quản lý bất động sả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 |
| Danh sách kênh | 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 hoặc kênh thông tin | 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 chào mừng và thông báo | 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 |
| Quyền truy cập của căn hộ | 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 |
| Thời hạn thuê hoặc cư trú | Ngày hết hạn của line, gia hạn bằng gói, credit hay API | Ngày hết hạn của line và thời lượng của gói |
| Node của toà nhà | 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 |
Đ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ủ cho công ty quản lý (Ubuntu 22.04 hoặc 24.04), bộ cài, và một máy chủ cho mỗi toà nhà có thể truy cập mạng của cư dân.
- Các luồng kênh mà cộng đồng được phép truyền lại (URL pull hoặc RTMP), thông báo và video chào mừng của công ty quản lý, và các thiết bị của cư dân (set-top box, smart TV có ứng dụng player, hoặc trình duyệt).
- Quyết định về các loại hộ (tiêu chuẩn, người cao tuổi, sinh viên), và ai trong công ty quản lý mở và gia hạn các line.
Triển khai hạ tầng
Máy chủ trung tâm, sau đó mỗi toà nhà một node.
- Chạy bộ cài trên máy chủ trung tâm và đặt URL gốc phát thành địa chỉ mà các toà nhà truy cập được.
- Thêm các luồng kênh trong Streams và các thông báo trong Movies, rồi kiểm tra trong web player.
- Đăng ký một node cho mỗi toà nhà 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ư dân của toà đó tới node.
- Thêm người quản lý bất động sản trong Users → add a reseller, với một nhóm cho phép thao tác với line và không được thay đổi danh mục.
Tổ chức nội dung
Danh sách kênh theo loại hộ.
- Tạo một bouquet cho mỗi danh sách kênh từ các kênh của từng loại hộ, và một bouquet cho thông tin của công ty quản lý.
- Thêm bouquet thông tin vào mọi gói để mỗi cư dân nhận được thông báo.
- Tạo một gói cho mỗi loại hộ với các bouquet của nó và thời hạn khớp với hợp đồng thuê hoặc thời gian cư trú.
- Sắp xếp thứ tự các kênh và gắn logo để menu trên TV dễ đọc.
Cấu hình đối tác (reseller)
Người quản lý bất động sản là một tài khoản được uỷ quyền.
- Tạo một nhóm với quyền giới hạn ở line, không truy cập danh mục hay máy chủ.
- Thêm từng người quản lý bất động sản dưới dạng reseller với nhóm đó, các gói cho các hộ của họ và số dư credit.
- Người quản lý nhiều toà nhà có thể thêm một sub-reseller cho mỗi toà, mỗi người có các hộ và credit riêng.
Cấu hình căn hộ (line)
Một line cho mỗi căn hộ, đặt tên theo số căn hộ.
- Tạo một line cho mỗi căn hộ trong Lines → add, với số căn hộ làm tên và gói của loại hộ đó.
- Đặt số kết nối tối đa bằng số TV trong hộ.
- Dùng mã kích hoạt thay cho mật khẩu khi cư dân nên nhập một mã ngắn trên thiết bị.
- Cấu hình thiết bị một lần (Xtream Codes API hoặc M3U với thông tin đăng nhập của line, hoặc cổng MAG hay Enigma2); thông tin đăng nhập ở lại với căn hộ cho đến khi line được cấp thông tin mới.
Video chào mừng và thông báo
Video của công ty quản lý theo yêu cầu.
- Tải lên video chào mừng, nội quy chung cư và hướng dẫn bảo trì dưới dạng phim, với một danh mục cho mỗi chủ đề.
- Đặt chúng vào bouquet thông tin để mọi gói đều có.
- Thay một video từ panel khi thông tin thay đổi; cư dân thấy phiên bản mới ngay lập tức.
Kênh và kênh thông tin
Danh sách kênh và kênh thông báo dưới dạng luồng trực tiếp.
- Thêm từng kênh có bản quyền trong Streams cùng luồng của nó, và một nguồn EPG để lịch trên TV hiển thị các chương trình.
- Thêm kênh thông tin dưới dạng luồng trực tiếp, do bộ mã hoá cấp qua RTMP hoặc một nguồn phát lặp, và đặt nó vào bouquet thông tin.
- Giữ các kênh có giới hạn lãnh thổ trong những bouquet mà chỉ các gói phù hợp mới cấp.
Chuyển đến, chuyển đi và hết hạn
Thời gian cư trú là hiệu lực của line.
- Một line hết hạn vào cuối thời hạn của gói; gia hạn bằng gói hoặc một credit cho mỗi kỳ thuê mới.
- Khi cư dân rời đi, vô hiệu hoá line; cư dân tiếp theo bật lại với thông tin đăng nhập mới, nên không có gì còn lại với hộ cũ.
- Đăng ký hệ thống nhà ở hoặc người quản lý 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à ở hoặc thanh toán
Hệ thống mở quyền truy cập; player phát.
- Tạo khoá Reseller API cho hệ thống nhà ở hoặc thanh toán; nó gọi create_line, renew_line, enable_line và disable_line, và gửi request id với mỗi lệnh ghi.
- Dùng connector thương mại khi cư dân mua thêm gói trực tuyến; 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: cư dân đăng nhập vào player bằng thông tin của line.
Lưu ý về bảo mật
Giữ dịch vụ bên trong cộng đồng.
- 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 quản lý; người quản lý bất động sản nhận một nhóm quyền giới hạn ở line.
- 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ỉ khi thiết bị có địa chỉ cố định.
- Bật sao lưu cơ sở dữ liệu mã hoá kèm bản sao ngoài site; thông tin đăng nhập của các line nằm trong đó.
Xử lý sự cố
Những kiểm tra đầu tiên thường gặp.
- Một căn hộ không có truyền hình: kiểm tra line của nó đang bật và chưa hết hạn, sau đó kiểm tra thông tin đăng nhập của thiết bị và địa chỉ phát.
- Một toà nhà bị giật vào buổi tối: kiểm tra heartbeat của node toà nhà và cư dân của toà có được định tuyến tới nó không.
- Một kênh thiếu ở một loại hộ: kiểm tra các bouquet của gói đó.
- Người quản lý không tạo được line: kiểm tra số dư credit của reseller, quyền của nhóm và các gói được gán cho họ.