Appearance
Complaint Module
Mục đích
Quản lý khiếu nại khách hàng từ lúc tạo, xem chi tiết, bổ sung giải trình đến xử lý/giải quyết. Đây là module case management chuyên biệt cho complaint workflow.
Quy mô
- 3 FE pages
- 11 FE components
- 1 GraphQL file
- 1 workflow nghiệp vụ chính
Actors & Permissions
| Nhóm chức năng | Quyền | Platforms |
|---|---|---|
| Complaint management | ITLeader, ITStaff, BranchPOS | Admin, CRM, POS |
Feature Groups
| Group | Mô tả | Pages |
|---|---|---|
| Complaint Overview | Danh sách khiếu nại, filter, mở dialog/detail | overview/Overview.tsx |
| Complaint Create | Tạo khiếu nại mới | create/Create.tsx |
| Complaint Detail & Resolve | Xem timeline, giải trình, bổ sung, xác nhận xử lý | detail/Detail.tsx + các dialog components |
Liên kết Modules
- crm — complaint có mặt trong customer workspace CRM
- user — complaint xuất hiện trong customer detail
- report — complaint report đọc dữ liệu complaint schedule
- settings — complaint setting và permission approver nằm ở settings
Backend Services
| Service | Vai trò |
|---|---|
| ecommerce-api | complaint_schedule_list/detail/approve/reject/resolve/supplement |
| controller (Hasura) | CRUD complaint tables và complaint report function |
Databases
| DB | Key tables |
|---|---|
| ecommerce | complaint_*, permission approver/resolver/branch, complaint report result |
Đặc điểm kiến trúc
- Module FE gọn nhưng dùng nhiều dialog chuyên biệt: reason, resolve, supplement, confirm, timeline.
- Navigation được bật cho cả Admin, CRM và POS, phản ánh complaint là workflow liên phòng ban.
- Phần xử lý business nằm nhiều ở backend actions hơn là ở FE page shell.
Deep Dives
- case-lifecycle — state machine complaint, branch permission, timeline/history và mutate guard drift