Trung Tâm Quản Trị Hệ Thống & API / Webhook

Thiết Bị

{{ device_online }} Online {{ device_sos }} SOS {{ device_offline }} Off

Sự Cố SOS

{{ alert_new }} Mới {{ alert_processing }} Xử lý {{ alert_resolved }} Xong

Tọa Độ GPS

Hành trình GPS {{ location_sos }} điểm SOS

Khu Vực

Khu vực quản lý

Tài Khoản

Admin & Vận hành

Dung Lượng DB

PostgreSQL 15

Thao Tác Nhanh

Thông Tin Môi Trường Vận Hành

Hệ điều hành / Container: Linux / Docker

Nền tảng Framework: Django 6.1.2 (Python 3.14)

Cơ sở dữ liệu: PostgreSQL 15 (Alpine)

Kênh truyền Real-time: Server-Sent Events (SSE)

Thời gian máy chủ: {{ server_time }}

Console Chẩn Đoán

> Hệ thống sẵn sàng. Chọn lệnh để thực thi...

Sự Cố Gần Nhất ({{ recent_alerts|length }})

{% if recent_alerts %} {% endif %} Tải CSV

{% for log in recent_alerts %} {% empty %} {% endfor %}

Mã SOS	Thiết Bị	Trạng Thái	Thời Gian	Thao Tác
#SOS-{{ log.id }}	{{ log.device.device_name }}	{% if log.status == 'NEW' %} Mới {% elif log.status == 'PROCESSING' %} Đang xử lý {% else %} Đã xử lý {% endif %}	{{ log.created_at\|date:"H:i:s d/m" }}
Chưa có bản ghi sự cố nào.

Vuốt ngang để xem chi tiết

Bản Ghi Tọa Độ GPS Gần Nhất ({{ recent_locations|length }})

Auto Recorded

{% for loc in recent_locations %} {% empty %} {% endfor %}

Thiết Bị GPS / Phương Tiện	Tọa Độ	Tốc Độ	Thời Gian
{% if loc.is_sos_point %} {% else %} {% endif %} {{ loc.device.device_name }}	{{ loc.latitude\|floatformat:4 }}, {{ loc.longitude\|floatformat:4 }}	{{ loc.speed }} km/h	{{ loc.recorded_at\|date:"H:i:s d/m" }}
Chưa có dữ liệu tọa độ.

Vuốt ngang để xem chi tiết

Cổng Tiếp Nhận Webhook Uplink (IoT Ingestion Endpoint)

Tiếp nhận gói tin từ HC TECH Cloud, ChirpStack v4 Gateway hoặc các bộ cảm biến LoRaWAN

Đang hoạt động (Status 200 OK)

POST

Lọc Trùng Lặp (Deduplication)

Lưu cache event_id trong 24h. Tự động bỏ qua các gói tin bị gửi lặp lại.

Bảo Toàn Thứ Tự Thời Gian

Phân tích reported_at RFC 3339. Gói tin cũ đến sau không ghi đè tọa độ mới.

Phát SSE Thời Gian Thực

Bắn tín hiệu IOT_UPLINK tới toàn bộ Dashboard với độ trễ 0ms.

Live Monitor: Tiếp Nhận & Phân Tích Chuỗi JSON Webhook

REALTIME 0ms

Bắt và hiển thị trực tiếp 100% mọi chuỗi JSON gửi đến Webhook (kèm Headers, IP, trạng thái xác thực và phân tích các trường đo đạc) để admin kiểm tra tức thì.

Tổng nhận: 0

SOS: 0

Lỗi xác thực: 0

Tự cuộn lên đầu

Đang chờ nhận gói tin Webhook JSON...

Bất kỳ gói tin gửi từ Postman, cURL, Gateway ChirpStack, bộ nút nhấn hoặc bộ giả lập sẽ hiển thị trực tiếp tại đây cùng đầy đủ cấu trúc JSON để phân tích.

Xác Thực Webhook (Authorization: Bearer)

Bắt buộc bên phát (HC TECH IoT Platform, ChirpStack v4) phải gửi kèm Header Bearer token để bảo vệ Webhook

Đã Bật Xác Thực Bearer

Khóa Bearer Token hiện hành: Định dạng chuẩn: Authorization: Bearer <token>

BEARER

Token được lưu vĩnh viễn và có hiệu lực ngay lập tức (không cần restart máy chủ).

Cấu hình mẫu trên cổng phát (HC TECH Platform / ChirpStack Gateway):

Header Name : Authorization

Header Value: Bearer {{ webhook_bearer_token }}

* Tương thích ngược: Hệ thống cũng chấp nhận Header X-Webhook-Secret: {{ webhook_bearer_token }}

Trình Giả Lập Gói Tin Webhook (Simulator)

Interactive Payload

Chọn gói tin mẫu:

Nội dung JSON Payload:

Kết Quả Phản Hồi Từ Webhook

Chờ gửi gói tin...

// Kết quả trả về sau khi gửi gói tin sẽ xuất hiện tại đây...

Lưu ý khi thử nghiệm:

• Nếu event_id đã từng gửi trong 24 giờ, hệ thống sẽ trả về "status": "ignored_duplicate".

• Để gửi lại cùng một ID, bấm nút "Xóa Cache chống trùng" ở Tab Thao tác Cơ sở dữ liệu.

Cấu Hình Nền Tảng HC TECH IoT Cloud (OpenAPI v1.2.0)

Tích hợp API Gateway công khai: Bearer Auth, Rate Limiting, Telemetry Aggregation & Downlink

Spec: openapi.yaml (v1.2.0)

Môi trường Cloud:

IoT Public Base URL:

API Public Bearer Token:

Truy Vấn Telemetry Nâng Cao (Telemetry & Aggregated Explorer)

Truy xuất chuỗi thời gian hoặc dữ liệu tổng hợp theo chu kỳ giờ/ngày từ Cloud (Mục FR-11.12 & FR-11.13)

GET /telemetry GET /telemetry/aggregated

Thiết Bị Cần Tra:

Loại Truy Vấn:

Chỉ Số (Metric):

Chu Kỳ (Interval):

Khung Thời Gian:

Mốc Thời Gian	Thiết Bị	Chỉ Số	Giá Trị / TB	Min - Max	Số Mẫu	Trạng Thái Chốt (is_final)
Chọn tiêu chí và bấm "Thực Hiện Truy Vấn Telemetry" để tải dữ liệu từ Cloud hoặc cơ sở dữ liệu.

Vuốt ngang để xem đủ 7 cột dữ liệu

// Kết quả JSON từ HC TECH Cloud API sẽ xuất hiện tại đây...

Bộ Phát Lệnh Xuống Thiết Bị LoRaWAN (Downlink Command Dispatcher)

Tuân thủ chuẩn OpenAPI v1.2.0: Hỗ trợ cả lệnh chức năng (Form Command) và gói tin Hex thuần (Raw Hex Bytes F-Port)

POST /devices/{id}/commands (202 Accepted)

Chọn Thiết Bị Nhận Lệnh:

Chế Độ Phát Lệnh (Command Payload Mode):

Lệnh Mẫu Nhanh (Presets): Bấm để điền tự động tham số

Tên Lệnh (command.name):

Tham Số JSON (command.parameters):

Confirmed Downlink (Yêu cầu thiết bị phản hồi ACK) (Nếu bỏ chọn: Unconfirmed Downlink không cần ACK)

Hàng Đợi & Lịch Sử Vòng Đời Lệnh Downlink

Theo dõi trạng thái: queued (chờ phát) ➜ sent (đã gửi) ➜ delivered (đã nhận) / failed / cancelled

Mã Lệnh	Thiết Bị	Kiểu / Tên Lệnh	Payload / Chi Tiết	F-Port	Confirmed	Trạng Thái	Thời Gian	Thao Tác
Đang tải danh sách lệnh downlink...

Vuốt ngang để xem đủ 9 cột thông tin lệnh

HC TECH ADMIN

Thao Tác Nhanh

Thông Tin Môi Trường Vận Hành

Console Chẩn Đoán

Sự Cố Gần Nhất ({{ recent_alerts|length }})

Bản Ghi Tọa Độ GPS Gần Nhất ({{ recent_locations|length }})

Cổng Tiếp Nhận Webhook Uplink (IoT Ingestion Endpoint)

Live Monitor: Tiếp Nhận & Phân Tích Chuỗi JSON Webhook

Xác Thực Webhook (Authorization: Bearer)

Trình Giả Lập Gói Tin Webhook (Simulator)

Kết Quả Phản Hồi Từ Webhook

Cấu Hình Nền Tảng HC TECH IoT Cloud (OpenAPI v1.2.0)

Truy Vấn Telemetry Nâng Cao (Telemetry & Aggregated Explorer)

Bộ Phát Lệnh Xuống Thiết Bị LoRaWAN (Downlink Command Dispatcher)

Hàng Đợi & Lịch Sử Vòng Đời Lệnh Downlink

Thống Kê Bảng Dữ Liệu PostgreSQL

Dọn Dẹp Tọa Độ GPS Cũ (Optimize LocationHistory)

Dọn Dẹp Nhật Ký Sự Cố Cũ (Archive Alert Logs)

Xóa Toàn Bộ Lịch Sử Báo Động (Purge All Alerts)

Sao Lưu & Xuất Dữ Liệu (Data Export & Backup)

Trình Giả Lập Phát Cảnh Báo Khẩn Cấp (Live Emergency Broadcast Simulator)

Thực Thi Lệnh Kiểm Tra An Toàn (Safe Command Runner)

Xác nhận thao tác

Thao Tác Nhanh

Thông Tin Môi Trường Vận Hành

Console Chẩn Đoán

Sự Cố Gần Nhất ({{ recent_alerts|length }})

Bản Ghi Tọa Độ GPS Gần Nhất ({{ recent_locations|length }})

Cổng Tiếp Nhận Webhook Uplink (IoT Ingestion Endpoint)

Live Monitor: Tiếp Nhận & Phân Tích Chuỗi JSON Webhook

Xác Thực Webhook (Authorization: Bearer)

Trình Giả Lập Gói Tin Webhook (Simulator)

Kết Quả Phản Hồi Từ Webhook

Cấu Hình Nền Tảng HC TECH IoT Cloud (OpenAPI v1.2.0)

Truy Vấn Telemetry Nâng Cao (Telemetry & Aggregated Explorer)

Bộ Phát Lệnh Xuống Thiết Bị LoRaWAN (Downlink Command Dispatcher)

Hàng Đợi & Lịch Sử Vòng Đời Lệnh Downlink

Thống Kê Bảng Dữ Liệu PostgreSQL

Dọn Dẹp Tọa Độ GPS Cũ (Optimize LocationHistory)

Dọn Dẹp Nhật Ký Sự Cố Cũ (Archive Alert Logs)

Xóa Toàn Bộ Lịch Sử Báo Động (Purge All Alerts)

Sao Lưu & Xuất Dữ Liệu (Data Export & Backup)

Trình Giả Lập Phát Cảnh Báo Khẩn Cấp (Live Emergency Broadcast Simulator)

Thực Thi Lệnh Kiểm Tra An Toàn (Safe Command Runner)