Luồng liên kết đa vai trò / đa site¶
Trang này không ứng với một trang cụ thể nào trong hệ thống quản trị — mục đích là nối các trang riêng lẻ đã viết ở các mục khác thành luồng đầu-cuối thực tế, đi qua nhiều tài khoản (chủ nhà → nhà thầu → admin) và cả 2 hệ thống (trang công khai dành cho người dùng + hệ thống quản trị nội bộ). Mọi tham chiếu tới trang bên hệ thống công khai là chữ thường, không phải link — 2 hệ thống có tài liệu riêng, xem tài liệu người dùng nếu cần chi tiết trang đó.
1. Lead → mở khóa bằng Credit¶
Chủ nhà (trang người dùng) Nhà thầu (trang người dùng) Admin (quản trị)
────────────────── ──────────────────── ───────────────────
Gửi yêu cầu dự án
│
▼ [Leads] trạng thái "Mới"
nút "Xác minh lead" — tuỳ
chọn, không bắt buộc để
nhà thầu thấy/mở khóa lead
│
▼
Thấy lead phù hợp dịch vụ/
khu vực mình ở dashboard,
bấm "Mở khóa" (trừ credit
theo bảng giá — xem
[Giá Credit Lead](credits.md))
│
▼ [Credits] tab "Giao dịch" —
giao dịch loại chi tiêu để
mở khóa lead xuất hiện
ngay, Người thực hiện = hệ
thống (không phải admin)
Xác minh (mục 1) và mở khóa (mục 2) là 2 hành động độc lập — lead chưa được admin xác minh vẫn mở khóa được bình thường nếu nhà thầu bấm; "Xác minh lead" chỉ là gắn cờ nội dung hợp lệ, không phải điều kiện chặn mở khóa (kiểm tra kỹ trên giao diện không thấy ràng buộc nào yêu cầu phải xác minh trước mới mở khóa được).
2. Nạp Credit qua QR¶
Nhà thầu (trang người dùng, Trung tâm Credit) Admin (trang quản trị, Credits)
─────────────────────────────────── ────────────────────────────
Bấm "Mua ngay" 1 gói
→ tạo đơn, hiện khung QR + "Nội dung CK"
(mã đối chiếu duy nhất cho đơn này)
Trang tự kiểm tra lại đơn mỗi 5 giây
(trạng thái ban đầu "Chờ xác nhận")
│
│ chủ nhà/nhà thầu chuyển khoản
│ thật ngoài hệ thống (ngân hàng)
▼
Tab "Đơn nạp QR" (mặc định lọc "Chờ
duyệt") — admin đối chiếu đúng "Nội
dung CK" + số tiền đã nhận, bấm
"Duyệt" hoặc "Từ chối" (bắt buộc
nhập lý do)
│
▼ (trong vòng ≤5 giây nhờ tự kiểm tra lại)
Khung QR tự đổi sang trạng thái "Đã xác
nhận" — credit được cộng vào số dư ngay,
tab "Giao dịch" hiện dòng loại nạp tiền
Điểm cần biết khi xử lý sự cố: nếu nhà thầu báo "đã chuyển khoản mà chưa thấy credit", việc đầu tiên kiểm tra là tab "Đơn nạp QR" ở trang quản trị còn đơn nào "Chờ duyệt" khớp đúng "Nội dung CK" không — hệ thống không tự động đối chiếu với ngân hàng, mọi lần xác nhận đều là thao tác tay của admin.
3. Duyệt AGOpro¶
Nhà thầu (trang người dùng) Admin (trang quản trị)
──────────────────── ───────────────────
Vào trang đăng ký AGOpro — điền form đăng ký
│
▼
[Chi tiết nhà thầu](contractors/detail.md)
tab Tổng quan — nút "Approve AGOpro"
(có bước xác nhận) CHỈ hiện khi nhà
thầu chưa từng được duyệt AGOpro
│
▼
Huy hiệu "AGOpro" hiện ngay trên hồ sơ công
khai + khung sửa hồ sơ ("Nâng cấp AGOpro"
biến mất, thay bằng huy hiệu đã có)
Cũng có thể duyệt từ Danh sách nhà thầu tab AGOpro — cùng một cơ chế, chỉ khác điểm bấm vào. Tab này chỉ liệt kê nhà thầu đã được duyệt hồ sơ cơ bản trước đó — nhà thầu mới đăng ký AGOpro nhưng chưa từng được duyệt hồ sơ sẽ không xuất hiện ở đây dù nút "Approve AGOpro" vẫn bấm được nếu vào thẳng trang chi tiết của nhà thầu đó (xem cảnh báo ở Chi tiết nhà thầu).
4. Business Tags (badge "AGOhome Trust", "Xuất VAT"...)¶
Nhà thầu (trang người dùng, khung sửa hồ sơ, tab nhãn) Admin (trang quản trị)
────────────────────────────────────────────────────── ───────────────────
Chọn nhãn muốn đăng ký
Đính kèm bằng chứng (ảnh/link)
│
▼
[Danh sách nhà thầu](contractors/index.md)
tab "Business Tags" — Duyệt
(có bước xác nhận) / Từ chối
(nhập lý do) / Thu hồi (nhập
lý do, cho nhãn đã duyệt
trước đó)
│
▼
Huy hiệu hiện trên hồ sơ công khai (ví dụ
"AGOhome Trust", "Phản hồi nhanh", "Xuất VAT")
5. Custom Pack¶
Nhà thầu (trang người dùng, khung sửa hồ sơ, tab Custom Pack) Admin (trang quản trị)
────────────────────────────────────────────────────────────── ───────────────────
Tạo/sửa 1 gói (giá riêng ngoài bảng giá
chuẩn) → về trạng thái "chờ duyệt" NGAY CẢ
KHI CHỈ SỬA 1 GÓI ĐÃ TỪNG ĐƯỢC DUYỆT
(thông báo: "Đã cập nhật — gói về trạng
thái chờ duyệt")
│
▼
[Custom Pack](custom-packs.md)
— Duyệt (có bước xác
nhận) / Từ chối (nhập
lý do)
│
▼
Gói hiển thị công khai trên hồ sơ nhà thầu
(chỉ khi đã được duyệt)
Hệ quả: nhà thầu sửa nhẹ 1 gói đang hiển thị công khai (đã duyệt) sẽ khiến gói đó biến mất khỏi hồ sơ công khai ngay lập tức cho tới khi admin duyệt lại — cần lưu ý khi nhà thầu báo "gói của tôi tự nhiên biến mất" mà họ không nhớ đã sửa gì.
6. Gallery (album/ảnh dự án)¶
Nhà thầu (trang người dùng, tạo album) Admin (trang quản trị)
───────────────────────────────────── ───────────────────
Tạo album (trạng thái chờ duyệt)
│
▼
[Gallery](gallery/index.md) — Duyệt
(2 bước xác nhận) / Ẩn / Từ chối
│
▼
Album hiện công khai trên hồ sơ nhà thầu +
tính vào số "Dự án" hiện ở
[Danh sách nhà thầu](contractors/index.md)
7. Reviews (đánh giá nhà thầu)¶
Chủ nhà (trang người dùng, sau khi dự án hoàn thành) Admin (trang quản trị)
────────────────────────────────────────── ───────────────────
Gửi đánh giá (số sao + nội dung, có thể
kèm điểm theo từng tiêu chí)
│
▼
[Reviews](reviews.md) — Duyệt (bấm 1
lần, không cần xác nhận lại) / Từ chối
(bắt buộc nhập lý do) / hoặc "Duyệt
tất cả đã chọn"
│
▼
Đánh giá hiện công khai trên hồ sơ nhà thầu,
tính vào điểm trung bình + số lượng đánh
giá hiện ở thẻ nhà thầu (danh bạ + hồ sơ)
8. Deal → Lead tự động (O2O)¶
Nhà thầu (trang người dùng, mục Deal) Khách (trang ưu đãi công khai) Admin (trang quản trị)
────────────────────────────────────── ──────────────────────── ───────────────────
Tạo ưu đãi (giảm giá/mã)
(hoặc admin tự tạo "ưu đãi nền tảng" —
xem [Danh sách ưu đãi](deals/index.md)
mục "Tạo deal mới", để trống Nhà thầu)
│
▼
[Danh sách ưu đãi](deals/index.md)
— Duyệt (nút đổi nhãn theo
trạng thái, xem mục "Nút
Duyệt/Khóa dùng chung một
cơ chế")
│
▼
Ưu đãi hiện công khai,
khách bấm đăng ký nhận mã
→ tự động tạo 1 **lead**
gắn với ưu đãi này
│
▼
[Leads](leads.md) — lead
mới có dòng "Yêu cầu từ
ưu đãi: ..."
│
▼
Nhà thầu mua lead này bằng credit
(giống luồng mục 1 — ưu đãi chỉ là
NGUỒN phát sinh lead, cơ chế mở khóa
credit không đổi)
│
▼
[Báo cáo O2O](deals/o2o-report.md)
đối soát: khách nhận mã →
thợ mua lead → credit thu
được, dùng tính hoa hồng
affiliate với nhãn hàng
9. Gán quyền Admin (điều kiện để đăng nhập được backoffice)¶
Admin hiện có (trang quản trị, Users) Người được cấp quyền
────────────────────────────────── ───────────────────────
Vào [Chi tiết user](users.md), chọn 1 nhóm
quyền admin ở ô "Quyền Admin", bấm "Gán"
(hoàn toàn tách biệt khỏi vai trò thông
thường của người dùng đó — chủ nhà/nhà
thầu/cả hai)
│
▼
Người này đăng nhập trang quản trị
bằng CHÍNH tài khoản email/mật khẩu đã
dùng ở trang người dùng — không phải
tài khoản riêng, không cần đổi vai
trò chủ nhà/nhà thầu/cả hai
10. Gap chưa hoàn thiện: Contractor Claim¶
Xem chi tiết nguyên nhân ở Duyệt claim hồ sơ — khác 9 luồng trên (đã đi trọn từ đầu tới cuối), luồng "nhà thầu nhận là chủ của 1 hồ sơ chưa có ai sở hữu" chưa từng được làm xong ở phần hệ thống xử lý phía sau — nên không có bước "Admin (trang quản trị)" nào để mô tả ở đây, chỉ có phần "Nhà thầu gửi yêu cầu nhận hồ sơ" hoạt động được, còn phần admin duyệt là tính năng còn thiếu, không phải lỗi giao diện.