Giao diện
Khám phá giao diện
Tổng quan các thành phần giao diện TKHQ — thanh trên, sidebar, dark mode, tìm kiếm và thông báo.
Topbar
Thanh trên cùng chứa các công cụ toàn cục:
- Logo TKHQ (trái) — click để về trang chủ
- Workspace switcher — dropdown tên workspace hiện tại, click để đổi hoặc tạo workspace mới
- TokenMeter — hiển thị token AI còn lại trong tháng (ví dụ:
1.750 / 5.000). Click để xem chi tiết consumption - Tìm kiếm (kính lúp) — tìm toàn hệ thống: tờ khai, lô hàng, đối tác, chứng từ
- Thông báo (chuông) — in-app notifications
- Avatar (phải) — menu profile, cài đặt, đăng xuất
Workspace switcher — cách dùng:
Workspace hiện tại hiển thị tên ở topbar. Click vào → dropdown liệt kê tất cả workspace bạn thuộc về → click tên để chuyển ngay. Dữ liệu toàn trang cập nhật theo workspace được chọn.
Sidebar
Thanh điều hướng bên trái — nhóm theo nghiệp vụ:
| Nhóm | Mục |
|---|---|
| Tờ khai | Danh sách, Tạo mới |
| Chứng từ | Upload, Danh sách |
| HS Code | Tra cứu, AI phân loại |
| Logistics | Lô hàng, Booking, Container, Checklist, Load Plan, Manifest |
| Thương mại | CRM Lead, Báo giá, Bảng giá |
| Tài chính | Debit Note, Công nợ AR/AP |
| Cài đặt | Workspace, Team, RBAC, Thông báo, Tích hợp |
Thu gọn sidebar
Click mũi tên « để thu sidebar về icon-only — tăng không gian làm việc. Click » để mở lại.
Dark mode
Chuyển dark/light mode bằng nút mặt trăng/mặt trời ở góc dưới sidebar.
- Light — mặc định, nền trắng
- Dark — nền tối, giảm mỏi mắt khi làm việc ban đêm
- System — tự động theo cài đặt hệ điều hành
Tùy chọn được lưu per-browser. Mỗi thiết bị nhớ lựa chọn riêng.

Tìm kiếm
Tìm kiếm toàn cục — truy cập bằng kính lúp trên topbar hoặc phím tắt Ctrl+K / Cmd+K.
Tìm được:
- Tờ khai (theo số tờ khai, tên hàng, MST)
- Lô hàng, Booking, Container (theo số hiệu)
- Đối tác (theo tên, MST)
- Chứng từ (theo tên file, nội dung trích xuất)
- Mã HS Code
Mẹo tìm kiếm:
- Gõ không dấu cũng tìm được ("to khai" → "tờ khai")
- Dùng prefix:
hs:để tìm mã HS,ship:để tìm lô hàng
Thông báo
In-app notifications — click chuông trên topbar để xem.
| Loại | Kênh | Ví dụ |
|---|---|---|
| DEM/DET sắp hết | In-app + Telegram | Container X còn 2 ngày DEM |
| Tờ khai được duyệt | In-app + Telegram | Tờ khai #12345 thông quan |
| Debit Note quá hạn | In-app + Telegram | DN-2026-0142 quá hạn 8 ngày |
| Quote được chấp nhận | In-app + Telegram | Báo giá #87 ACCEPTED |
Cài đặt thông báo
Bật/tắt từng loại thông báo tại /settings/notifications. Hỗ trợ Telegram Bot và Zalo OA.