Haravan Helpdesk — Bản đồ bàn giao

Ứng dụng Haravan Helpdesk là custom app Frappe đang chạy cho Haravan Helpdesk tại https://haravan.help. App phụ trách đăng nhập OAuth bằng Haravan Account, tạo/match User, liên kết Haravan org với HD Customer, và hỗ trợ agent đọc hồ sơ khách hàng từ Bitrix khi xử lý ticket.

Trạng thái hiện tại

Luồng OAuth là login-only. Callback đăng nhập chỉ lưu dữ liệu định danh tối thiểu (userid, email, orgid). Dữ liệu vận hành chi tiết như HSI, Shopplan, responsible, segment và Customer Profit/Profile được lấy server-side từ Bitrix theo nhu cầu agent, không gọi Haravan commerce API trong callback.

Đọc theo vai trò

Vai trò	Nên đọc trước	Mục tiêu
Developer tiếp quản app	Hiện trạng & lộ trình → Kiến trúc hệ thống → Triển khai production	Nắm ranh giới code, cách deploy và hướng mở rộng an toàn
Admin vận hành Haravan Helpdesk	Bắt đầu & cấu hình OAuth → Khắc phục sự cố → Sổ đăng ký Script	Quản lý config, script production và xử lý lỗi thường gặp
Team CS/Support Haravan	User, email & multi-org → Cấp quyền Portal/Desk → HD Ticket Product Suggestion	Hiểu user được tạo thế nào, cấp quyền đúng và cập nhật luật nghiệp vụ
Agent dùng Customer Profile	Data model haravan.help → Customer Profile API → Metajson, Bitrix & Customer Profit	Hiểu dữ liệu ticket/customer, Bitrix enrichment và popup agent
PM/UAT Haravan	Bộ tài liệu UAT & bàn giao → Checklist UAT → Checklist bàn giao	Chạy nghiệm thu theo user story mapping và ký nhận bàn giao vận hành

Luồng đọc khuyến nghị

1. Bàn giao nhanh

1.1. UAT và nghiệm thu với Haravan

3. Dữ liệu Helpdesk, Bitrix và agent workflow

4. Kiến trúc và tham chiếu

Giá trị cấu hình quan trọng

Hạng mục	Giá trị hiện tại
Public domain	`https://haravan.help`
Frappe Cloud site	`haravandesk.s.frappe.cloud`
OAuth callback path	`/api/method/login_with_haravan.oauth.login_via_haravan`
Public callback URL	`https://haravan.help/api/method/login_with_haravan.oauth.login_via_haravan`
Site Config key chính	`haravan_account_login`
Provider DocType name	`haravan_account`
Provider display name	`Login With Haravan`

Quy tắc bảo trì

Không sửa Frappe core hoặc Helpdesk core; mọi tùy biến nằm trong app login_with_haravan, Custom Fields, Server Script hoặc HD Form Script.
Giữ Social Login Key.redirect_url dạng path tương đối để Frappe tự dùng domain request hiện tại. Chỉ đặt haravan_account_login.redirect_uri khi thật sự cần ép domain.
Không đưa Bitrix webhook, Haravan client secret, GitLab token hoặc API key ra browser hay tài liệu public.
Trước khi ship code, chạy test local theo Triển khai production hoặc ./test_gate.sh nếu có.

Haravan Helpdesk — Bản đồ bàn giao ​

Đọc theo vai trò ​

Luồng đọc khuyến nghị ​

1. Bàn giao nhanh ​

1.1. UAT và nghiệm thu với Haravan ​

2. Login và phân quyền ​

3. Dữ liệu Helpdesk, Bitrix và agent workflow ​

4. Kiến trúc và tham chiếu ​

Giá trị cấu hình quan trọng ​

Quy tắc bảo trì ​