User Story: Tìm kiếm và lọc danh sách người dùng¶
1. Description¶
Là Admin, tôi muốn tìm kiếm và lọc danh sách người dùng theo các tiêu chí như vai trò, đơn vị trực thuộc, trạng thái tài khoản, để nhanh chóng tìm thấy người dùng cần quản lý trong hệ thống có nhiều tài khoản.
2. Acceptance Criteria¶
2.1 Happy Path¶
- GIVEN Admin đang ở màn hình Danh sách người dùng (SCR-SYS-10)
- WHEN màn hình được tải lần đầu
- THEN hệ thống hiển thị danh sách tất cả người dùng với các cột: họ tên, email, đơn vị trực thuộc, vai trò, trạng thái (active/inactive), đăng nhập lần cuối. Danh sách được phân trang
- GIVEN Admin đang xem danh sách người dùng
- WHEN Admin nhập từ khóa tìm kiếm (họ tên hoặc email) vào ô tìm kiếm
- THEN hệ thống lọc và hiển thị các người dùng có họ tên hoặc email khớp với từ khóa
- GIVEN Admin đang xem danh sách người dùng
- WHEN Admin chọn lọc theo vai trò (ví dụ: Manager, Data Owner, Approver, Staff, Admin)
- THEN hệ thống chỉ hiển thị người dùng có vai trò tương ứng
- GIVEN Admin đang xem danh sách người dùng
- WHEN Admin chọn lọc theo đơn vị trực thuộc
- THEN hệ thống chỉ hiển thị người dùng thuộc đơn vị đã chọn
2.2 Alternative Paths¶
- GIVEN Admin đã áp dụng bộ lọc (vai trò và đơn vị)
- WHEN Admin nhấn nút "Xóa bộ lọc" hoặc "Đặt lại"
- THEN hệ thống xóa tất cả bộ lọc và hiển thị lại toàn bộ danh sách người dùng
- GIVEN Admin đang xem danh sách người dùng
- WHEN Admin kết hợp nhiều bộ lọc cùng lúc (ví dụ: vai trò = Data Owner VÀ đơn vị = Sở KHCN)
- THEN hệ thống hiển thị người dùng thỏa mãn tất cả các điều kiện lọc
- GIVEN Admin đang xem danh sách người dùng
- WHEN Admin chọn lọc theo trạng thái tài khoản (active hoặc inactive)
- THEN hệ thống chỉ hiển thị người dùng có trạng thái tương ứng
2.3 Error Cases¶
- GIVEN Admin nhập từ khóa tìm kiếm nhưng không có kết quả nào khớp
- WHEN hệ thống thực hiện tìm kiếm
- THEN hệ thống hiển thị thông báo "Không tìm thấy người dùng nào phù hợp với tiêu chí tìm kiếm" và danh sách trống
- GIVEN hệ thống gặp lỗi khi tải danh sách người dùng
- WHEN Admin truy cập màn hình Danh sách người dùng
- THEN hệ thống hiển thị thông báo lỗi "Không thể tải danh sách người dùng, vui lòng thử lại"
3. Business Rules¶
- Danh sách người dùng hiển thị cả tài khoản pre-provisioned và auto-provisioned (tạo tự động qua SSO)
- Tìm kiếm hỗ trợ khớp một phần (partial match) trên họ tên và email
- Bộ lọc vai trò, đơn vị và trạng thái có thể kết hợp đồng thời (AND logic)
- Danh sách mặc định sắp xếp theo họ tên (A-Z)
- Hiển thị thông tin đăng nhập lần cuối để Admin theo dõi hoạt động người dùng
- Phân trang để xử lý danh sách lớn
4. Traceability¶
Feature: Feature EP-01-002: Quản lý người dùng
Related Use Cases:
Screens:
Business Flows:
- Không áp dụng
Business Entities:
Role Matrix:
Third-Party Integrations:
- Không áp dụng
5. Out of Scope¶
- Xuất danh sách người dùng ra file (Excel, CSV)
- Tìm kiếm nâng cao với nhiều điều kiện phức tạp
- Xem chi tiết lịch sử hoạt động của từng người dùng