# Admin345 — Hướng dẫn sử dụng cơ bản

## Truy cập

- Mở trình duyệt: `https://<domain>/admin345/` (hoặc `http://<host>:<port>/admin345/`).
- URL cũ `/mqttadmin/` vẫn hoạt động (cùng giao diện).

## Đăng nhập

1. Lấy **token quản trị** từ tab **Token Admin** (sau khi đã có quyền) hoặc từ file cấu hình server ban đầu.
2. Dán token vào ô đăng nhập → **Đăng nhập**.
3. Token gửi kèm header `X-Admin-Token` cho mọi API `/api/admin/*`.

## Các tab chính

| Tab | Chức năng |
|-----|-----------|
| Tổng quan | Trạng thái hệ thống, broker |
| MQTT Brokers | Thêm/sửa broker, kiểm tra kết nối, primary/backup |
| Quy hoạch MQTT | Thứ tự broker, JWT Hub, aggregate (nâng cao) |
| User | Tạo user, mật khẩu, công ty, blocklist |
| Nhóm / Công ty | Gom nhóm user, tenant |
| Token Admin | Tạo token API user; token admin |
| Cài đặt | Trang chủ: hiện link Chat, Admin345, docs; JWT; backup |
| Backup | Sao lưu / khôi phục dữ liệu JSON |

## Visitor & Website

- Tạo **website** + token để nhúng widget visitor.
- User (member) cần có **companyIds** nếu muốn tin visitor vào room công ty (theo nghiệp vụ đã cấu hình).

## Device

- Tab liên quan thiết bị: tạo device, **deviceToken** để `login-device` từ ứng dụng thiết bị.

## Lỗi thường gặp

- **401 / Invalid token**: token admin sai hoặc hết hạn — tạo lại trong Token Admin.
- **User chưa có mật khẩu**: vào User → đặt mật khẩu trước khi đăng nhập chat bằng user/pass.