Là một Admin, Tôi muốn quản lý danh sách người giới thiệu trong hệ thống, Để tôi có thể tạo, chỉnh sửa, xem và quản lý các tài khoản giới thiệu cùng số liệu hoạt động của họ.
Điều kiện tiên quyết (Pre-conditions)
- Admin đã đăng nhập thành công vào hệ thống quản trị.
Giao diện Danh sách Người giới thiệu
Màn hình chính hiển thị bảng quản lý với các tính năng:Cấu trúc bảng danh sách:
Thêm mới Người giới thiệu
- Admin nhấn nút Thêm mới ở góc trên bên phải
- Hiện Modal form nhập thông tin: Họ và tên, Email, Số điện thoại (Frontend không có trường nhập Mã giới thiệu).
- Admin điền thông tin và nhấn Lưu
- Hệ thống (Backend) tự động sinh Mã giới thiệu ngẫu nhiên (4 ký tự) dựa trên tên và lưu vào hệ thống.
- Validate thông tin → Tạo thành công → Thêm vào bảng danh sách (hiển thị Mã giới thiệu do BE trả về).
Yêu cầu trường thông tin:
Lưu ý về Mã giới thiệu: Mã giới thiệu sẽ do Backend tự động sinh (gồm các chữ cái đầu của tên viết hoa, loại bỏ dấu + bù thêm số ngẫu nhiên để đủ 4 ký tự. Ví dụ:Nguyễn Văn An→NVA0) và trả về sau khi tạo thành công. Frontend không cần gửi field này lên khi tạo mới. Mã này đảm bảo tính duy nhất (unique) trên toàn hệ thống.
Import danh sách bằng Excel
Cho phép Admin thêm hàng loạt người giới thiệu thông qua file Excel để tiết kiệm thời gian.-
Tải file mẫu (Download Template)
- Hệ thống cung cấp file Excel mẫu bao gồm các cột:
Họ và tên(Bắt buộc),Email(Bắt buộc),Số điện thoại(Bắt buộc). Không có cộtMã giới thiệu. - Có kèm theo ghi chú định dạng ở dòng tiêu đề (header).
- Hệ thống cung cấp file Excel mẫu bao gồm các cột:
-
Quy tắc Validate File
- Định dạng file:
.xlsx,.xls,.csv - Dung lượng tối đa: 5MB
- Ràng buộc dữ liệu từng dòng:
Họ và tên,Email,Số điện thoạivalidate định dạng tương tự như thêm mới thủ công.- Kiểm tra trùng lặp Email, SĐT trong chính file Excel.
- Kiểm tra trùng lặp Email, SĐT với dữ liệu hiện có trong hệ thống.
Mã giới thiệu: Backend sẽ tự động sinh cho từng dòng hợp lệ theo quy tắc giống như Thêm mới thủ công.
- Định dạng file:
-
Xử lý kết quả Import
- Sau khi tải file lên, hệ thống sẽ hiển thị Preview (xem trước) kết quả quét dữ liệu.
- Hiển thị số dòng Hợp lệ và số dòng Lỗi (kèm chi tiết mô tả lỗi của từng dòng, ví dụ: “Email sai định dạng”, “Trùng số điện thoại”).
- Cơ chế Import:
- Hệ thống chỉ Import các dòng Hợp lệ (Valid).
- Bỏ qua không Import các dòng Lỗi (Invalid).
- Hiển thị thông báo tổng kết sau khi hoàn tất:
Import thành công X bản ghi. Có Y bản ghi bị lỗi. - Cho phép Admin tải xuống danh sách các dòng lỗi (file Excel) để chỉnh sửa và Import lại sau.
Chỉnh sửa Người giới thiệu
- Cho phép chỉnh sửa tất cả các trường thông tin: Họ tên, Email, Số điện thoại, Mã giới thiệu
-
Quy tắc nghiệp vụ khi chỉnh sửa:
- Kiểm tra tính duy nhất (Unique) tương tự lúc thêm mới, ngoại trừ chính bản ghi đang sửa
- Nếu Mã giới thiệu bị thay đổi:
- Các Merchant cũ đã đăng ký bằng mã cũ vẫn giữ nguyên lịch sử và dữ liệu báo cáo
- Từ thời điểm thay đổi, Merchant mới chỉ có thể đăng ký bằng mã mới
- Tất cả các giới thiệu cũ sẽ luôn được tính cho người giới thiệu này bất kể mã có thay đổi
Xóa Người giới thiệu
Ràng buộc xóa:- Không bao giờ xóa vật lý người giới thiệu đã có Merchant liên kết
- Dữ liệu lịch sử phải luôn được bảo toàn cho mục đích báo cáo và thống kê
- Người giới thiệu bị ngừng hoạt động sẽ không thể tạo thêm giới thiệu mới
Xem danh sách Merchant được giới thiệu
- Tại mỗi dòng trong bảng danh sách, Admin nhấn nút Xem danh sách
- Hiện Modal/Danh sách chi tiết các Merchant đã được giới thiệu bởi người này
- Thông tin hiển thị:
- Tên Merchant
- Email Merchant
- Ngày đăng ký thành công
- Trạng thái tài khoản Merchant
- Nút xem chi tiết merchant (Link tới US-ADM-04)