Cài đặt (Settings)

Cài đặt là bảng điều khiển trung tâm cho phiên bản EmberX của bạn. Được tổ chức thành 7 tab, một số tab chỉ hiển thị cho Admin và Super Admin.

Tab	Hiển thị cho
Chung (General)	Tất cả vai trò
Giao diện (Theme)	Tất cả vai trò
Phản hồi (Feedback)	Tất cả vai trò
Shop	Tất cả vai trò
Tích hợp (Integrations)	Admin, Super Admin
License	Admin, Super Admin
Hệ thống (System)	Admin, Super Admin

Tab 1 — Chung (General)

Ngôn Ngữ Giao Diện

Chuyển đổi ngôn ngữ giao diện dashboard quản trị giữa Tiếng Anh và Tiếng Việt. Cài đặt này được lưu theo trình duyệt và chỉ ảnh hưởng đến dashboard — không phải trang chat hoặc form phản hồi dành cho khách.

en — English (mặc định)
vi — Tiếng Việt

Tùy Chọn Chung

Trường	Mô tả
Tên Công ty	Tên hiển thị của tổ chức — xuất hiện trong email mời và header dashboard
Workspace ID	Định danh duy nhất cho deployment (ví dụ: `hotel-saigon`). Dùng cho định tuyến đa tenant và tham chiếu API
Múi giờ	Tất cả timestamps hội thoại và ngày báo cáo trong dashboard hiển thị theo múi giờ này. Được tải từ danh sách múi giờ IANA đầy đủ
Ngôn ngữ	Ngôn ngữ mặc định cấp hệ thống — dùng làm fallback cho dịch tự động và broadcasts đi
Division Khẩn cấp	Khi khách đánh dấu yêu cầu là khẩn cấp, yêu cầu đó tự động định tuyến đến Division này. Chọn “Không có” để tắt định tuyến khẩn cấp tự động

Nhấn Lưu để áp dụng. Thay đổi có hiệu lực ngay lập tức mà không cần tải lại trang.

Tab 2 — Giao Diện (Theme)

Bộ Tùy Chỉnh Giao Diện cho phép bạn kiểm soát toàn bộ giao diện trực quan của dashboard EmberX. Tất cả thay đổi được xem trước trực tiếp và lưu vào cơ sở dữ liệu — áp dụng cho tất cả trình duyệt và phiên đăng nhập.

Chế Độ Sáng / Tối / Hệ thống

Sử dụng bộ chuyển chế độ (góc trên bên phải tab Theme) để chuyển đổi:

Sáng (Light) — nền trắng, chữ tối
Tối (Dark) — nền tối, chữ sáng
Hệ thống (System) — tự động theo cài đặt hệ điều hành

Logo & Thương hiệu

Tải lên logo tùy chỉnh để thay thế logo EmberX mặc định trong sidebar:

Nhấn Tải lên Logo
Chọn file ảnh (PNG, JPG, SVG, WebP)
Công cụ cắt ảnh mở ra — điều chỉnh vùng cắt (tỷ lệ 16:9) rồi nhấn Áp dụng Cắt
Logo được tải lên và trang tự động tải lại để hiển thị

Để xóa logo hiện tại và quay về mặc định, nhấn nút × bên cạnh ảnh xem trước.

Bộ Màu Có Sẵn (Color Presets)

Chọn bộ màu hoàn chỉnh chỉ bằng một cú nhấp. Các preset tự động áp dụng màu phù hợp cho cả chế độ Sáng và Tối.

Preset	Đặc điểm
Zinc	Trung tính tối cổ điển — độ tương phản cao, phong cách tối giản (mặc định)
Slate	Tông xanh xám mát lạnh với điểm nhấn navy tinh tế
Sunset	Bảng màu cam/san hô ấm áp — năng động và thân thiện
Minimal	Điểm nhấn xanh dương trên nền trắng thuần — hiện đại và rộng rãi

Sau khi áp dụng preset, bạn vẫn có thể tinh chỉnh từng màu riêng lẻ bên dưới.

Bo Góc (Border Radius)

Kiểm soát mức độ bo góc của các phần tử UI (nút, thẻ, ô nhập liệu):

Tùy chọn	Giá trị	Hiệu ứng
None	`0rem`	Góc vuông sắc nét
SM	`0.25rem`	Bo góc rất nhẹ
MD	`0.375rem`	Bo góc nhẹ
LG	`0.5rem`	Bo góc tiêu chuẩn (mặc định preset)
XL	`0.625rem`	Bo góc rõ ràng
2XL	`0.75rem`	Bo góc nhiều hơn
Full	`1rem`	Dạng pill, bo tròn hoàn toàn

Tinh Chỉnh Màu Sắc

Tất cả màu được lưu dạng giá trị HSL và có thể tùy chỉnh riêng lẻ qua color picker. Màu được nhóm theo:

Màu Chính (Primary Colors)

Background — Nền trang
Foreground — Màu chữ chính
Primary — Màu thương hiệu (nút, liên kết, trạng thái active)
Primary Foreground — Chữ hiển thị trên bề mặt màu primary

Màu Phụ & Nhấn (Secondary & Accent)

Secondary / Secondary Foreground — Các phần tử UI phụ
Accent / Accent Foreground — Phần tử được làm nổi bật hoặc hover

Màu Component UI

Card / Card Foreground — Bề mặt thẻ và panel
Popover / Popover Foreground — Dropdown và tooltip
Muted / Muted Foreground — Nền phụ và chữ placeholder

Màu Tiện ích & Form

Border — Viền phân cách
Input — Màu viền ô nhập liệu
Ring — Vòng focus khi dùng bàn phím

Màu Trạng thái

Destructive / Destructive Foreground — Lỗi, xóa, cảnh báo

Màu Biểu đồ (Chart 1 – Chart 5) Năm màu riêng biệt dùng trong biểu đồ và đồ thị phân tích dashboard.

Màu Sidebar (8 biến) Kiểm soát chi tiết sidebar: nền, chữ, mục chính, mục active, nhấn, viền và vòng focus.

Lưu và Đặt lại

Một dấu chấm vàng nhấp nháy xuất hiện khi có thay đổi chưa lưu.
Nhấn Lưu để lưu tất cả thay đổi màu sắc và bo góc vào cơ sở dữ liệu.
Nhấn Đặt lại để hủy thay đổi chưa lưu và quay về trạng thái đã lưu lần cuối.

Tab 3 — Phản Hồi (Feedback)

Cấu hình định tuyến theo đánh giá sao để tự động gắn tag cho phản hồi đến dựa trên số sao mà khách chọn.

Mỗi đánh giá sao (1–5) có thể được ánh xạ với một Tag từ thư viện tag của bạn. Khi phản hồi được gửi với đánh giá đó, tag tương ứng tự động được áp dụng để lọc và báo cáo.

Đánh giá	Tag gợi ý
⭐ 1 sao	`urgent` hoặc `complaint`
⭐⭐ 2 sao	`needs-attention`
⭐⭐⭐ 3 sao	`follow-up`
⭐⭐⭐⭐ 4 sao	`satisfied`
⭐⭐⭐⭐⭐ 5 sao	`compliment` hoặc `vip`

Chọn “Không định tuyến” cho bất kỳ đánh giá nào để bỏ qua gắn tag.

Nhấn Lưu Định Tuyến để áp dụng. Tag phải được tạo trong module Phản Hồi trước khi xuất hiện ở đây.

Tab 4 — Shop

Cấu hình khả năng hiển thị shop và cài đặt tiền tệ cho danh mục sản phẩm.

Bật/Tắt Shop (Enable Shop)

Dùng công tắc Enable Shop để kiểm soát liệu khách có thấy menu và đặt hàng được không:

Trạng thái	Tác dụng
Bật (mặc định)	Nút menu và trang shop hiển thị với khách trong giao diện chat
Tắt	Nút menu và trang shop bị ẩn hoàn toàn khỏi khách

Tiền Tệ

EmberX hỗ trợ hai loại tiền tệ:

Tiền tệ	Ký hiệu	Sử dụng điển hình
USD	$	Triển khai quốc tế
VND	₫	Triển khai tại Việt Nam

Tỷ Giá Chuyển Đổi

Đặt tỷ giá dùng khi chuyển đổi giá. Ví dụ:

Chuyển từ USD sang VND với tỷ giá 25000 → sản phẩm giá $1,00 thành ₫25.000
Chuyển từ VND sang USD với tỷ giá 25000 → ₫25.000 thành $1,00

Hộp Thoại Chuyển Đổi Tiền Tệ

Khi bạn thay đổi tiền tệ, hộp thoại xác nhận xuất hiện với hai lựa chọn:

Tùy chọn	Hành vi
Chỉ chuyển đổi ký hiệu	Thay đổi ký hiệu hiển thị tiền tệ. Tất cả giá trị sản phẩm giữ nguyên số (ví dụ: 1,00 vẫn là 1,00)
Chuyển đổi và tính lại giá	Áp dụng tỷ giá cho tất cả giá sản phẩm trong cơ sở dữ liệu (cập nhật hàng loạt). Không thể tự động hoàn tác

Tab 5 — Tích Hợp (Chỉ Admin)

Cấu hình tích hợp dịch vụ bên thứ ba. Tất cả cài đặt được lưu trong cơ sở dữ liệu và có hiệu lực trong vòng 5 phút — không cần khởi động lại container, rebuild image hay server.

Google Cloud — Dịch Thuật

Dùng cho dịch tin nhắn tự động theo thời gian thực trong hội thoại.

Trường	Key	Mô tả
Project ID	`google.projectId`	ID project Google Cloud Platform của bạn
API Key	`google.apiKey`	API key cho Cloud Translation API. Nếu để trống, EmberX dùng `GOOGLE_APPLICATION_CREDENTIALS` từ môi trường (file service account)

Khi nào dùng API Key vs Service Account:

API Key — thiết lập đơn giản hơn, phù hợp với hầu hết triển khai
Service Account (GOOGLE_APPLICATION_CREDENTIALS) — bảo mật hơn, phù hợp với môi trường production có chính sách IAM nghiêm ngặt

Azure Cognitive Services — Nhận Diện Giọng Nói

Cho phép nhập liệu bằng giọng nói trong hội thoại cho các trình duyệt không hỗ trợ Web Speech API gốc (Firefox, một số trình duyệt di động).

Trường	Key	Mô tả
Subscription Key	`azure.speechKey`	Subscription key Azure Cognitive Services
Region	`azure.speechRegion`	Vùng datacenter Azure (ví dụ: `eastus`, `southeastasia`)

Khách có thể nhấn nút micro trong giao diện chat để đọc tin nhắn, Azure chuyển thành văn bản theo thời gian thực.

Email / SMTP

Dùng cho email mời nhân viên và email đặt lại mật khẩu. Ghi đè biến môi trường MAILTRAP_* nếu được cấu hình.

Trường	Key	Mặc định
SMTP Host	`email.smtpHost`	`smtp.mailtrap.io`
Port	`email.smtpPort`	`587`
Username	`email.smtpUser`	—
Password	`email.smtpPass`	—
From Address	`email.smtpFrom`	`noreply@lingo.local`

Các nhà cung cấp SMTP phổ biến: Gmail (smtp.gmail.com:587), SendGrid (smtp.sendgrid.net:587), Mailtrap, Amazon SES.

URL Ứng Dụng

Ghi đè URL công khai dùng trong email và kết nối WebSocket.

Trường	Key	Ghi đè
App URL	`app.url`	Biến môi trường `APP_URL`
Socket URL	`app.socketUrl`	Biến môi trường `SOCKET_URL`

Đặt App URL thành domain thực của bạn (ví dụ: https://hotel.example.com) để liên kết trong email mời được giải quyết đúng. Đặt Socket URL thành địa chỉ WebSocket server (ví dụ: https://hotel.example.com:8010).

Nhấn Lưu Cài Đặt Tích Hợp để áp dụng tất cả thay đổi cùng lúc.

Tab 6 — License (Chỉ Admin)

Hiển thị trạng thái license đầy đủ của deployment EmberX. Đây là màn hình chỉ đọc — không chỉnh sửa tại đây.

Chi Tiết License

Trường	Mô tả
License Key	Chuỗi key (ẩn một phần) dùng để nhận dạng cài đặt này
Trạng thái	Trạng thái license hiện tại (xem bảng bên dưới)
Tier	Gói license (ví dụ: `starter`, `pro`, `enterprise`)
Đã kích hoạt	Dấu tích xanh = đang active; dấu X xám = chưa kích hoạt

Các giá trị trạng thái License:

Trạng thái	Màu Badge	Ý nghĩa
`active`	🟢 Xanh	License hợp lệ và còn trong thời hạn
`expired`	🔴 Đỏ	Hết thời hạn — liên hệ support để gia hạn
`suspended`	⚪ Outline	Tạm thời bị tắt bởi máy chủ license
`revoked`	🔴 Đỏ	Bị thu hồi vĩnh viễn — liên hệ support
(unknown)	⚫ Xám	Chưa được kiểm tra hoặc trạng thái không có sẵn

Ngày Tháng Quan Trọng

Trường	Mô tả
Ngày Kích hoạt	Ngày và giờ license được kích hoạt lần đầu
Ngày Hết hạn	Ngày hết hạn license — sau ngày này trạng thái chuyển thành `expired`
Lần Kiểm tra Cuối	Lần cuối EmberX kết nối thành công với máy chủ license
Heartbeat Cuối	Heartbeat định kỳ cuối cùng được gửi (xác nhận instance đang online)

Giới Hạn Sử Dụng

Các giới hạn này được áp đặt bởi license. Vượt quá giới hạn sẽ hiển thị lỗi.

Chỉ số	Mô tả
Số Kênh (Phòng) Tối đa	Số lượng phòng Location active tối đa
Số Người dùng Tối đa	Số lượng tài khoản nhân viên tối đa
Số Mã QR Tối đa	Số lượng token Mã QR tối đa

Giá trị -1 hoặc 2.147.483.647 nghĩa là Không giới hạn.

Thông Tin Hệ Thống

Trường	Mô tả
Instance ID	UUID duy nhất nhận dạng cài đặt cụ thể này trên máy chủ license
Feature Flags	Danh sách tính năng tùy chọn được kích hoạt bởi license (ví dụ: `broadcast`, `analytics`)

Tab 7 — Hệ Thống (Chỉ Admin)

Chứa Thẻ Cập nhật Hệ thống để quản lý cập nhật phần mềm EmberX trực tiếp từ dashboard.

Kiểm Tra Cập Nhật

Nhấn Kiểm tra Cập nhật để truy vấn máy chủ release. Thẻ hiển thị:

Trường	Mô tả
Phiên bản Hiện tại	Phiên bản EmberX đang chạy
Phiên bản Mới nhất	Bản phát hành mới nhất hiện có
Ghi chú Phát hành	Tóm tắt những thay đổi trong phiên bản mới nhất

Nếu bạn đang dùng phiên bản mới nhất, dấu ✅ xanh xuất hiện bên cạnh số phiên bản.

Cập Nhật Nhỏ (Minor Update)

Khi có cập nhật nhỏ (ví dụ: 1.2.0 → 1.2.5):

Badge màu hổ phách ⚠️ xuất hiện với nhãn “Có bản cập nhật”
Nhấn Cập nhật để bắt đầu quá trình cập nhật
Dành cho: Admin và Super Admin

Cập Nhật Lớn (Major Update)

Khi có cập nhật lớn (ví dụ: 1.x → 2.0):

Badge đỏ 🛡️ xuất hiện với nhãn “Cập nhật Lớn”
Panel cảnh báo giải thích rằng cập nhật lớn có thể bao gồm thay đổi phá vỡ tương thích hoặc di chuyển dữ liệu
Super Admin phải bật toggle “Cho phép Nâng cấp Lớn” trước để mở khóa nút cập nhật
Sau khi bật, nhấn Nâng cấp Lớn yêu cầu xác nhận trước khi tiến hành
Dành cho: Chỉ Super Admin (Admin thấy thông báo liên hệ Super Admin)

Tóm Tắt Quyền Truy Cập

Hành động	Admin	Super Admin
Kiểm tra cập nhật	✅	✅
Áp dụng cập nhật nhỏ	✅	✅
Bật toggle nâng cấp lớn	❌	✅
Áp dụng cập nhật lớn	❌	✅