KBChatMQ – Admin345

Trạng thái

Health: —

Brokers: — (OK: —)

Users: —

Rooms: —

Thêm MQTT Broker

Chọn nhà cung cấp

Chọn preset để tự điền host, port, path mặc định. Có thể chỉnh sửa sau. Custom = nhập thủ công.

Nhà cung cấp
HiveMQ, EMQX, mqtt.one, Mosquitto, v.v.

Connection Details

Thông tin kết nối từ Dashboard của nhà cung cấp

URL / Host
Địa chỉ broker, vd: xxx.s1.eu.hivemq.cloud hoặc cloud-intl.emqx.com

MQTT Port
1883 (mật mã) hoặc 8883 (TLS) WS Port
8083 (ws) hoặc 8884 (wss) WSS Port
Để trống = 8084 nếu WS=8083 WebSocket Path
Thường /mqtt

TLS MQTT URL: —

TLS WebSocket URL: —

Cluster Info

Thông tin từ HiveMQ Cloud → Cluster Info

Cluster ID
ID cluster, vd: 8f843f58db074130a55042fa07055ab9 Plan
Gói dịch vụ, vd: Serverless Provider
Tên nhà cung cấp (tự điền khi chọn preset)

Access Management

Tài khoản từ HiveMQ Cloud → Access Management → Credentials

Username
Bắt buộc với HiveMQ/EMQX Cloud, tùy chọn với public broker Password
Bắt buộc với HiveMQ/EMQX Cloud

Cấu hình sử dụng

Protocol dùng khi cấp phát
mqtt/mqtts = MQTT, ws/wss = WebSocket Loại kết nối mặc định (client)
Để trống = dùng protocol. VD: wss cho broker chỉ hỗ trợ WSS Type
primary = chính, backup = dự phòng Quota connections
Số kết nối tối đa (0 = không giới hạn) Quota topics
Số topic tối đa (0 = không giới hạn)

Tên broker
Tên hiển thị

Test kết nối

Chọn loại test theo protocol. Mặc định dùng cài đặt trong tab Cài đặt (mqtt/ws = HTTP, mqtts/wss = SSL).

Danh sách Brokers

Tên	Host	Type	Status	Quota	Test	Sửa / Xóa

Quy hoạch MQTT – Primary / Backup

Chọn broker chính (primary) và broker dự phòng (backup). Thứ tự ưu tiên khi cấp phát.

Broker chính (Primary)
Broker ưu tiên khi allocate

Thứ tự broker
Kéo thả để sắp xếp thứ tự ưu tiên (primary trước, backup sau)

Phân loại broker theo type

primary = chính, backup = dự phòng, both = vừa chính vừa backup. Sửa trong tab MQTT Brokers.

Tên	Host	Type	Status	Đặt type

Thêm user

UserId Tên hiển thị Email Password Nhóm Công ty

Danh sách user

UserId	Tên	Email	Nhóm	Công ty	Thao tác

Token của user:

Tên token Hết hạn (phút)

Tên	Token	Hết hạn	Thao tác

Thêm nhóm

Tên nhóm Quyền

Danh sách nhóm

ID	Tên	Quyền	Thành viên	Thao tác

Thêm công ty

Tên công ty

Danh sách công ty

ID	Tên	Thao tác

Quản lý license POS (fingerprint / seat)

Seat tạo khi POS gọi POST /api/license/activate; online theo POST /api/license/ping và cùng ngưỡng presence với Chat (presenceStaleMs). Hai máy cùng license vượt max seat → hiện cả hai dòng, cột cảnh báo đánh dấu bản nghi sao chép (kích hoạt sau).

Max seat mặc định (license mới)

Đăng ký license trên Hub (tùy chọn)

Giới hạn seat / ghi chú trước khi POS kích hoạt. Có thể bỏ qua — POS kích hoạt sẽ tự tạo bản ghi với max seat mặc định.

License ID Max seat Ghi chú Tạm khóa license

Registry license — cấp phép / chặn

Chặn: từ chối activate/ping mới cho license đó. Thu hồi seat riêng từng máy ở bảng dưới. Sửa max seat / ghi chú: dùng form phía trên rồi Lưu registry (nhập đúng License ID).

License ID	Max seat	Ghi chú	Cấp phép	Thao tác nhanh

Đã kích hoạt (seat)

Online	License	Chính sách	Duyệt server	Thiết bị / MAC	Hash	ĐK xong	Cảnh báo	Thu hồi	activationId	Thao tác

Quản lý Token

Token dùng cho X-Admin-Token khi gọi API. Tạo token mới để phân quyền.

Tên Role

Danh sách Token

Token	Tên	Role	Trạng thái	Thao tác

Backup & Restore

Sao lưu và khôi phục: user, nhóm, công ty, cấu hình, token, broker, bulletin... Lưu trong data/backup/.

Tạo backup

Danh sách backup

Khôi phục từ server

Chọn file backup trên server để ghi đè dữ liệu hiện tại. Sau khi restore cần khởi động lại server.

File backup

Khôi phục từ file tải lên

Chọn file backup-*.json đã tải về hoặc copy từ máy khác — nội dung được gửi lên API rồi restore (không lưu vào danh sách server trừ khi bạn tạo backup mới sau đó).

Thêm Device

Device đăng nhập bằng token. Dùng nút Xem/Copy để lấy token cho test-device.html.

UserId Tên Platform

Danh sách Device

Chat (tab Device) chỉ nhận room thiết bị nếu user là chủ hoặc có trong sharedUserIds trên bản ghi device. Lưu qua API PUT /api/admin/devices/:deviceId (body JSON { "sharedUserIds": ["userA", "userB"] }) — Hub sẽ đồng bộ memberIds room device_*.

Device ID	User	Tên	Platform	Hub presence	Token / Thao tác

KBChatMQ · Device control library

Thiết kế template IoT & màn điều khiển

Phân loại mô tả nhóm nghiệp vụ; sản phẩm mẫu là deviceType có thể triển khai (không phải thiết bị vật lý). Template user chỉ là bố cục UI ghép từ khối chức năng; hệ lớn / POS / drone gợi ý thêm kênh Chat (chatbot) khi systemChat.

Phân loại thiết bị mẫu

8 nhóm nghiệp vụ chuẩn (bán hàng, IoT độc lập, trung tâm, drone…).

Sản phẩm / dạng mẫu

Mỗi dòng: id dùng trong Chat · cờ dựng nhanh / +Chat. Cuộn để xem hết.

Thư viện chức năng (xem theo tab)

JSON catalog

Ghi data/device-control-catalog.json. Quyền manage_devices_all.

Studio — CRUD module, button, template mẫu (kéo thả)

Sửa trên bản làm việc (RAM), rồi Đưa vào ô JSON và Lưu server. Danh sách template mẫu (CRUD) luôn hiện dưới các tab — không phụ thuộc tab đang mở. Nút có thể kèm nhiều ô nhập — định nghĩa mảng params. Đồng bộ từ JSON nếu bạn sửa tay ô lớn.

Danh sách template mẫu `sampleTemplates`

CRUD trên bộ nhớ làm việc (giống bảng module / chức năng). Sửa hoặc đổi ô chọn → mở tab «Template mẫu — kéo thả» và nạp vào khối biên tập bên dưới.

#	id	Tên	deviceType	Widgets

id (unique) Nhãn hiển thị Loại widget Dạng hiển thị (display) Giá trị mặc định slider (%) Label widget command (toggle/slider/button/chat_input) min (slider) max (slider) step (slider) Automation (button — JSON các bước lệnh)

id	Nhãn	widget.type

id label mqttCommand category deviceTypes excludeDeviceTypes Loại description Automation — mảng bước params (JSON mảng — đa ô nhập) Hoặc 1 field (legacy): paramField

id	label	MQTT	params

Kho layout chung (Chat · admin)

Đồng bộ với Chat: tải bố cục member đã đăng, chỉnh trong studio (kéo thả), rồi Đưa vào ô JSON + Lưu server để làm giàu sampleTemplates. Mẫu đang sửa có thể đăng ngược lên kho layout (API admin — không cần mật khẩu user).

Tạo mẫu mới

Tên mẫu deviceType id (tuỳ chọn)

Biên tập template đang chọn

Nạp từ danh sách phía trên (bấm Sửa) hoặc chọn trực tiếp. Sau đó chỉnh tên / id / lưới và Lưu mẫu → ô JSON.

Template đang sửa

name id catalog

Thêm nhanh từ module Thêm nhanh từ chức năng

Kéo chip từ thư viện vào lưới 8 cột (như Cài đặt thiết bị trong Chat). Click ô để sửa nhãn / hàng cột. Chuột phải: đổi rộng, nhân bản. Nút «Lưu mẫu» đẩy vào ô JSON catalog.

Thư viện

Kéo vào khung bên phải →

Lưới mẫu

Template màn điều khiển (theo user)

Đây chỉ là bố cục giao diện (widgets + deviceType tham chiếu một dạng trong catalog) — không trỏ thẳng tới một thiết bị cụ thể; khi user áp dụng trong Chat thì mới gắn với deviceId. Thành phần cấu thành lấy từ chức năng / palette trong catalog. Mỗi user thường tối đa 2 template khi tự tạo trong Chat; admin có thể tạo thêm. User phải tồn tại.

Lọc userId

Template ID	User	Tên	deviceType	Widgets	Cập nhật

Tạo template mới

userId Tên deviceType

widgets (JSON mảng)

Sửa template đã chọn

Bấm «Sửa» ở bảng để nạp vào form dưới.

userId Tên deviceType

widgets (JSON)

Thêm Website (Visitor)

Visitor đăng nhập bằng token (không cần password). User phải tồn tại. Dùng nút Xem để copy token.

UserId Tên Domain

Danh sách Website (Visitor)

Website ID	User	Tên	Domain	Token	Thao tác

Cấp phát kết nối MQTT (JWT)

Đăng nhập user/pass → Hub cấp JWT (2 phút). Client dùng username=clientId, password=JWT để kết nối. User cần có mật khẩu (mục User).

User ID Password

—

Kiểm thử ổn định hệ thống

Chạy các bài test theo giao thức JWT: Login → MQTT connect → Hub room chat (plain JSON).

Khởi tạo (health, login JWT→bulletin) Bắt tay (login + MQTT connect JWT) Chat (room_general, plain JSON) 2 client (room_general, A→B) Cấp phát lại (login 2 lần) Backup MQTT (primary + backup) Load test (nhóm user) Tự dọn dẹp sau khi chạy

Số user Batch size

Bảng tin – Rooms

Room ID	Creator	Members

Debug – Bảng tin & Gói liên lạc

Xem bảng tin user, rooms và gói publish/receive từ client (chat gửi lên khi gửi/nhận tin).

Đăng nhập

Trạng thái

Thêm MQTT Broker

Chọn nhà cung cấp

Connection Details

Cluster Info

Access Management

Cấu hình sử dụng

Test kết nối

Danh sách Brokers

Quy hoạch MQTT – Primary / Backup

Phân loại broker theo type

Thêm user

Danh sách user

Token của user:

Thêm nhóm

Danh sách nhóm

Thêm công ty

Danh sách công ty

Quản lý license POS (fingerprint / seat)

Đăng ký license trên Hub (tùy chọn)

Registry license — cấp phép / chặn

Đã kích hoạt (seat)

Quản lý Token

Danh sách Token

Cài đặt chung

MQTT – Protocol test mặc định

Blocklist (chặn userId)

Liên kết trang chủ

Tab trang chủ

Heartbeat HTTP + presence (Chat / POS / Admin345)

Hub Aggregate + MQTT presence tap

Server Backup (broker phụ)

Backup & Restore

Tạo backup

Danh sách backup

Khôi phục từ server

Khôi phục từ file tải lên

Thêm Device

Danh sách Device

Phân loại thiết bị mẫu

Sản phẩm / dạng mẫu

Thư viện chức năng (xem theo tab)

JSON catalog

Studio — CRUD module, button, template mẫu (kéo thả)

Danh sách template mẫu sampleTemplates

Tạo mẫu mới

Biên tập template đang chọn

Thư viện

Lưới mẫu

Template màn điều khiển (theo user)

Tạo template mới

Sửa template đã chọn

Thư viện (catalog)

Lưới template user

Thêm Website (Visitor)

Danh sách Website (Visitor)

Cấp phát kết nối MQTT (JWT)

Kiểm thử ổn định hệ thống

Bảng tin – Rooms

Debug – Bảng tin & Gói liên lạc

Bảng tin (bulletins + rooms)

User online (presence)

Gói liên lạc (traffic)

Chỉnh thành phần mẫu

Chỉnh thành phần — template user

Danh sách template mẫu `sampleTemplates`