Appearance
✅ Checklist nghiệm thu & bàn giao
Trang này giúp đội Haravan kiểm tra từng bước trước khi nhận bàn giao hệ thống Helpdesk tại haravan.help.
- ✅ Tích chọn từng mục đã kiểm tra xong
- 📝 Ghi chú kết quả hoặc lỗi cho từng mục
- 💾 Tự lưu trên trình duyệt — mở lại vẫn còn
- 🔍 Lọc theo mức ưu tiên hoặc trạng thái
- 📋 Xuất báo cáo Markdown gửi cho team
Mức ưu tiên
- 🔴 P0 — Chặn nghiệm thu: Phải đạt 100% mới go-live.
- 🟡 P1 — Quan trọng: Nên xong trước go-live.
- 🔵 P2 — Bổ sung: Có thể làm sau go-live.
Tiến độ tổng thể0 / 115 (0%)
P0: 0/69P1: 0/38P2: 0/8
🌐 Cấu hình domain & hạ tầng
Domain, DNS, SSL và Frappe Cloud site phải sẵn sàng trước mọi bước khác.
0/9
P0Domain support.haravan.com trỏ DNS đúng về Frappe Cloud
P0SSL certificate hoạt động — truy cập https://support.haravan.com không báo lỗi bảo mật
P0Frappe Cloud site slug haravandesk.s.frappe.cloud chạy bình thường
P0Custom domain đã liên kết trong Frappe Cloud Dashboard > Sites > Domain
P0Truy cập support.haravan.com/login hiển thị trang đăng nhập
P0Truy cập support.haravan.com/helpdesk hiển thị portal khách hàng
P0Domain Freshdesk cũ trỏ về hotro.haravan.com để dự phòng
P1Gắn Google Analytics (GA4) — đã có mã tracking trên portal và trang login
P1GA4 đang nhận được dữ liệu realtime khi truy cập site
📧 Cấu hình email gửi & nhận
Email inbound (nhận), outbound (gửi), default sender phải hoạt động đúng.
0/10
P0Email Account mặc định (Default Outgoing) đã cấu hình — kiểm tra tại Setup > Email Account
P0Gửi email test từ hệ thống — khách hàng nhận được email
P0Email gửi đi hiển thị đúng tên người gửi và địa chỉ reply-to
P1Email Inbound (nhận vào) đã cấu hình — kiểm tra tại Setup > Email Account > Enable Incoming
P1Khách gửi email reply → hệ thống nhận và tạo comment vào đúng ticket
P1Email thông báo khi tạo ticket mới — khách nhận xác nhận tự động
P0Email thông báo khi agent trả lời — khách nhận email phản hồi
P1CC email hoạt động — thêm CC hợp lệ, người nhận CC nhận được email
P1Email không vào spam — kiểm tra SPF/DKIM/DMARC nếu dùng domain riêng
P2Nhập CC sai định dạng → hệ thống báo lỗi, không gửi sai
🔑 Cấu hình token & secret tích hợp
Tất cả token, API key, webhook phải được lưu đúng nơi (Site Config server-side), không lộ ra trình duyệt.
0/9
P0OAuth Haravan: client_id và client_secret đã nhập trong Site Config > haravan_account_login
P0Bitrix webhook: bitrix_webhook_url đã nhập trong Site Config
P1GitLab token: gitlab_token và gitlab_project_id đã nhập trong Site Config
P1AI (Gemini): gemini_api_key đã nhập trong Site Config
P0Social Login Key 'Login With Haravan' đã bật trong Frappe Desk
P0Helpdesk Integrations Settings: Bitrix bật, các field webhook/portal/timeout đã điền
P0Kiểm tra browser devtools — không thấy secret, token, webhook URL trong response
P1Chạy API diagnostics xác nhận oauth_configured=true, bitrix_configured=true
P1GA4 Measurement ID đã gắn đúng (nếu dùng server-side hoặc gtag)
📦 Migration dữ liệu từ Freshdesk
Kiểm tra dữ liệu đã được chuyển từ Freshdesk sang Helpdesk an toàn và đầy đủ.
0/5
P0Dữ liệu Customer (Tên, Email, Điện thoại, OrgID) đã được import đầy đủ
P0Dữ liệu Open Tickets từ Freshdesk đã được tạo mới trên Frappe Helpdesk
P1Ticket import có đầy đủ nội dung mô tả, attachment và lịch sử phản hồi
P2Ticket đã đóng trên Freshdesk được lưu trữ an toàn hoặc import dưới dạng Closed
P1Mapping đúng người phụ trách (assignee) đối với open tickets
🔐 Đăng nhập Haravan
Khách hàng dùng tài khoản Haravan để vào portal — không cần tạo mật khẩu riêng.
0/10
P0Trang login có nút 'Đăng nhập bằng Haravan' hiển thị rõ ràng
P0Bấm nút → chuyển đến accounts.haravan.com với redirect_uri đúng
P0Haravan Partner Dashboard: callback URL khớp chính xác https://haravan.help/api/method/login_with_haravan.oauth.login_via_haravan
P0Scope OAuth gồm: openid profile email org userinfo
P0Owner đăng nhập → vào portal Helpdesk (không vào Desk nội bộ)
P0Admin đăng nhập → vào portal Helpdesk
P0Staff đăng nhập → vào portal Helpdesk
P0Đăng nhập xong → Haravan Account Link có đúng email, user ID, org ID, org name
P1Đăng nhập thất bại → có thông báo lỗi rõ ràng, không trắng trang
P1Error Log ghi đủ thông tin lỗi để debug (thiếu email, sai redirect...)
👤 Tạo tài khoản tự động
Lần đầu đăng nhập, hệ thống tự tạo User, Contact, HD Customer, Haravan Account Link.
0/7
P0Email mới chưa có trong Frappe → đăng nhập → tạo User (website user)
P0Tự tạo Contact theo email
P0Tự tạo HD Customer theo tổ chức Haravan
P0Tự tạo Haravan Account Link (email, user ID, org ID)
P0Email đã có User → đăng nhập không tạo trùng, chỉ cập nhật mapping
P1Tài khoản thuộc 2 tổ chức → có HD Customer và Link cho cả 2 org
P1Multi-org: tạo ticket → chọn được đúng tổ chức
🎫 Tạo yêu cầu hỗ trợ (ticket)
Khách tạo ticket đúng form, đúng tổ chức, đính kèm được file.
0/7
P0Khách mở được trang tạo ticket sau khi đăng nhập
P0Form hiển thị đúng template (HD Ticket Template - Default)
P0Nhập tiêu đề + mô tả + chọn loại vấn đề → gửi → có mã ticket
P0Bỏ trống trường bắt buộc → báo lỗi rõ, không tạo ticket rỗng
P1Đính kèm ảnh/PDF → upload thành công → agent xem/tải được
P0Agent mở ticket → thấy đúng tiêu đề, nội dung, người gửi, tổ chức
P0Staff tạo ticket → chỉ thấy ticket của mình, không thấy của người khác
🔀 Phân tuyến & giao ticket cho đúng team
Đây là phần quan trọng nhất — ticket phải đến đúng phòng ban/team dựa trên segment, partner, shopplan.
0/18
P0Ticket tự gắn đúng HD Customer theo org người tạo
P0Org ID trên ticket khớp với Haravan org của khách
P0Khách SME (không có Bitrix evidence) → ticket vào team CS 60p
P0Khách Medium + shopplan Scale → ticket vào team Medium - Scale
P0Khách Medium + shopplan Grow → ticket vào team Medium - Grow
P0Khách có Partner service → ticket vào team Partner tương ứng
P0Service group = Ecom + có Bitrix evidence → ticket vào team Service Ecom
P0Service group = Ecom nhưng thiếu evidence → fallback về CS 60p (không route nhầm)
P0Bitrix không có dữ liệu hoặc timeout → ticket vẫn tạo, fallback CS 60p
P1Agent đã gán team thủ công → routing script không ghi đè
P1custom_haravan_routing_reason ghi rõ lý do route (Auto-routed / Fallback / Manual)
P0Assignment Rule ưu tiên: Partner (cao nhất) > Medium Scale (300) > Medium Grow (200) > CS 60p (100)
P0Ticket gán xong → agent nhận ToDo phân công
P1Round-robin: ticket chia đều giữa các agent trong cùng team
P1Multi-org: chọn org A → gắn customer org A; chọn org B → gắn customer org B
P1Product Suggestion: chọn gợi ý sản phẩm → ticket lưu đúng product_line, product_feature
P1Bitrix responsible: custom_responsible cập nhật khi Bitrix trả user active có email
P1Bitrix responsible inactive/thiếu email → không ghi sai, chỉ báo trạng thái
✉️ Xử lý & đóng ticket
Agent trả lời, đóng ticket — khách thấy trạng thái đúng trên portal.
0/6
P0Agent mở ticket → gửi phản hồi → phản hồi lưu trong timeline
P0Khách mở portal → thấy phản hồi mới từ agent
P0Agent chuyển trạng thái → đóng/resolved thành công
P0Khách mở portal → ticket hiển thị đã đóng
P1Lọc ticket theo trạng thái → ticket nằm đúng nhóm
P1Ghi chú nội bộ (internal note) → khách không thấy
🛡️ Phân quyền xem ticket
Owner/admin xem ticket cả tổ chức — staff chỉ xem ticket mình tạo.
0/6
P0Owner tạo ticket → admin cùng org thấy ticket đó trên portal
P0Admin tạo ticket → owner cùng org thấy ticket đó
P0Staff tạo ticket → chỉ staff đó thấy, không thấy ticket người khác
P1Agent nội bộ chỉ thấy ticket team mình (User Permission theo HD Team)
P1Manager thấy ticket tất cả team trong department
P0Admin hệ thống thấy tất cả ticket
🔌 Tích hợp Bitrix, GitLab, AI
Các hệ thống bên ngoài hoạt động đúng và bảo mật.
0/6
P1Agent bấm 'Xem hồ sơ khách hàng' → popup hiển thị dữ liệu Bitrix (công ty, segment, shopplan)
P2Popup Bitrix: bấm refresh → trạng thái rõ (cached / not_found / matched)
P1Popup Bitrix: bấm đồng bộ → customer/ticket cập nhật đúng
P2GitLab: tạo issue từ ticket → label, assignee prefill đúng theo Product Suggestion
P2AI phân tích (nếu bật): trả kết quả hữu ích, không mất nội dung ticket gốc
P2AI lỗi cấu hình → báo lỗi rõ ràng, không ảnh hưởng các tính năng khác
📋 Bàn giao quyền truy cập
Chuyển giao tài khoản, quyền quản trị cho đội Haravan.
0/7
P0Chuyển quyền Frappe Cloud site admin → Haravan
P0Chuyển quyền Frappe Desk admin (cấu hình Helpdesk, template, user)
P0Chuyển quyền Haravan Partner Dashboard (quản lý OAuth app)
P1Chuyển quyền GitHub repo (hoặc fork)
P1Chuyển quyền Bitrix webhook owner
P2Chuyển quyền GitLab project (nếu dùng)
P0Tạo tài khoản Helpdesk agent cho từng nhân viên CS
📖 Bàn giao vận hành & tài liệu
Đội Haravan nắm được cách cấu hình, test lại, và khi nào gọi kỹ thuật.
0/10
P0Hướng dẫn mở HD Ticket Template - Default để chỉnh form ticket
P1Hướng dẫn thêm/sửa HD Ticket Product Suggestion
P0Hướng dẫn thêm agent mới, gán Role Profile, User Permission
P0Hướng dẫn chạy smoke test 8 bước sau khi đổi cấu hình
P1Team đã đọc tài liệu Tổng quan dự án
P1Team đã đọc tài liệu Enrichment Routing (luồng phân tuyến)
P0Team biết danh sách 9 tình huống cần gọi đội kỹ thuật
P1Knowledge Base cho khách hàng đã publish (hướng dẫn đăng nhập, tạo ticket...)
P1Giao diện tiếng Việt đã override đúng (bản dịch CSV importable)
P0SOP bàn giao vận hành đã được review và ký nhận
🔒 Bảo mật & biên bản
Kiểm tra bảo mật cuối cùng và ký biên bản nghiệm thu.
0/5
P0Không lộ client secret trên trình duyệt, tài liệu, hoặc ticket
P0Không lộ Bitrix webhook URL/token trên trình duyệt
P2Ticket test đều có tiền tố [UAT] để dễ dọn dẹp
P0Biên bản nghiệm thu đã ký (đại diện Haravan + kỹ thuật + PM)
P0Danh sách lỗi còn mở và ngoại lệ đã thống nhất bằng văn bản
💾 Dữ liệu tự động lưu trên trình duyệt của bạn. Khi đổi máy hoặc xóa cache, dữ liệu sẽ bị mất — hãy xuất báo cáo để lưu lại.
Tài liệu tham chiếu
| Tài liệu | Dùng khi nào |
|---|---|
| Bản đồ User Story | Xem chi tiết câu chuyện người dùng |
| Checklist UAT chi tiết | Kịch bản test từng bước |
| Checklist bàn giao chi tiết | Bàn giao quyền, cấu hình, tích hợp |
| SOP vận hành | Quy trình hàng ngày, xử lý sự cố |
| Cấu hình Site Config | Chi tiết các key cấu hình token/secret |
| Luồng phân tuyến | Assignment rules, routing logic chi tiết |
| Phân quyền RBAC | Role profile, user permission |