Contacts phải có trước
hd_agents.contact_id và hd_conversations.contact_id là khoá ngoại
trỏ tới c_contacts. Wizard không tự kiểm tra điều kiện này — nếu
c_contacts chưa tồn tại, bước tạo quan hệ (relations) sẽ lỗi giữa
chừng. Cài module Contacts trước khi chạy Setup Wizard Helpdesk.
Quyền admin
Chỉ tài khoản có quyền quản trị (admin) mới chạy được wizard. Nếu không đủ quyền, trang báo lỗi “permission_denied” ngay khi mở.
Vào /helpdesk/setup (hoặc bấm vào mục Helpdesk trên sidebar nếu chưa cài — hệ thống sẽ điều hướng tới đây).
Màn hình hiển thị thống kê schema sắp tạo: số collection, số field, số relation. Bấm Start để bắt đầu.
Wizard khoá (lock) tiến trình setup — nếu một người khác cũng đang mở trang này, họ sẽ thấy trạng thái Locked kèm tên người đang chạy, và nút Reset để tự mở khoá nếu cần.
Bước Schema: tạo lần lượt các collection theo đúng thứ tự phụ thuộc khoá ngoại — bảng tra cứu (hd_working_hours, hd_labels, hd_teams, hd_sla_policies, hd_settings, hd_connections) trước, rồi hd_agents (→ c_contacts), hd_inboxes, hd_templates, hd_canned_responses, hd_conversations (→ c_contacts), hd_messages, các bảng junction M2M, hd_message_attachments, hd_automation_rules, hd_saved_views.
Bước Seed: chèn dữ liệu mặc định bắt buộc — 1 dòng hd_settings, 1 lịch làm việc mẫu (“Business Hours (Mon–Fri 9–18)”), 4 nhãn mặc định (Billing, Bug, Feature Request, Urgent). Có tuỳ chọn thêm dữ liệu mẫu (sample inbox, team, SLA policy demo) nếu muốn thử nhanh.
Bước Register Permissions (bước riêng của Helpdesk, chạy sau Seed): kiểm tra module helpdesk đã đăng ký trong hệ thống phân quyền của ODP (GET /app-permissions/modules) chưa. Bình thường bước này tự Skip.
Hoàn tất — sidebar admin xuất hiện mục Helpdesk.
Quay lại /helpdesk/setup sau khi đã cài, wizard tự so sánh schema hiện có với schema mới nhất và hiện một trong hai trạng thái:
Healthy → Reinstall
Schema đầy đủ, không thiếu gì. Nút hành động là Reinstall — chạy lại an toàn (idempotent), không tạo trùng.
Unhealthy → Repair
Wizard phát hiện thiếu collection/field/relation so với bản schema hiện tại (ví dụ sau khi nâng cấp module có thêm field mới) và hiện số lượng thiếu. Nút hành động đổi thành Repair — chỉ tạo phần đang thiếu, không đụng vào dữ liệu đã có.
hd_settings sau khi có schema