View Source

	Nghiệp vụ		IT
	Người lập	Người duyệt	Người lập	Người duyệt
Họ & Tên	Vũ Thị Mơ
Chức danh	BA
Tài khoản MS Team	movt2
Ngày soạn thảo/phê duyệt
Jira Link	https://jira.popplife.vn/browse/BPMKVH-2605

1. Card (Mô tả tính năng)

Là admin tôi muốn quản lý được thông tin các nhóm quyền được thực hiện các nhóm chức năng trong danh mục phân hệ

2. Confirmation/ Acceptance Criteria (Tiêu chí nghiệm thu)

Tôi muốn tìm kiếm được danh sách thông tin quản trị nhóm quyền bao gồm các thông tin::
- Tên nhóm quyền
Tôi muốn xem được danh sách nhóm quyền
Tôi muốn tạo mới/Sửa/Xem chi tiết được thông tin nhóm quyền bao gồm các thông tin
- Mã nhóm quyền
- Tên nhóm quyền
- Mô tả
- Nhân viên
- Lựa chọn/bỏ chọn các thao tác được phép phân quyền trong từng chức năng cho nhóm quyền đang thực hiện thao tác
  - Xem
  - Thêm mới
  - Sửa
  - Xóa
  - Nhập
  - Xuất
- Trạng thái
Tôi muốn chỉ thao tác tích chọn/bỏ tích chọn phân quyền khi đã thiết lập ở danh mục chức năng
Tôi muốn thêm mới/bỏ bớt một hoặc nhiều user vào nhóm quyền
Tôi muốn tìm kiếm, xem thông tin user khi thêm vào nhóm quyền bao gồm Mã nhân viên, Tên nhân viên, chức danh, Đơn vị/Công ty, Phòng ban
Tôi muốn người dùng tìm kiếm gần đúng được thông tin nhóm quyền bao gồm các thông tin mã nhóm quyền, tên nhóm quyền
Tôi muốn có thể thêm mới nhóm quyền từ việc copy một nhóm quyền sẵn có và cho phép sửa thông tin
Tôi muốn hệ thống cảnh báo trong trường hợp cập nhật trạng thái không hoạt động nhóm quyền đang được mapping với user
Tôi muốn người dùng export được thông tin quản trị nhóm quyền trên hệ thống theo thông tin tìm kiếm
Tôi muốn người dùng import được danh sách nhóm quyền vào hệ thống (Chưa bao gồm cấu hình)
Tôi muốn người dùng import được cấu hình của từng nhóm quyền vào hệ thống

3. Conversation (Mô tả chi tiết)

3.1 UIUX:

3.1.1. Danh sách nhóm quyền

3.1.2. Thêm mới nhóm quyền

BPM1- số hóa khối vận hành > 2605_User Story - Quản trị nhóm quyền (Nhóm quyền thao tác chức năng_Role) > image-2025-10-8_11-3-6.png

BPM1- số hóa khối vận hành > 2605_User Story - Quản trị nhóm quyền (Nhóm quyền thao tác chức năng_Role) > image-2025-10-6_8-32-13.png

BPM1- số hóa khối vận hành > 2605_User Story - Quản trị nhóm quyền (Nhóm quyền thao tác chức năng_Role) > image-2025-10-3_9-58-46.png

BPM1- số hóa khối vận hành > 2605_User Story - Quản trị nhóm quyền (Nhóm quyền thao tác chức năng_Role) > image-2025-10-3_13-41-6.png

BPM1- số hóa khối vận hành > 2605_User Story - Quản trị nhóm quyền (Nhóm quyền thao tác chức năng_Role) > image-2025-10-8_13-20-43.png

3.1.3. Chỉnh sửa nhóm quyền

BPM1- số hóa khối vận hành > 2605_User Story - Quản trị nhóm quyền (Nhóm quyền thao tác chức năng_Role) > image-2025-10-8_11-3-23.png

BPM1- số hóa khối vận hành > 2605_User Story - Quản trị nhóm quyền (Nhóm quyền thao tác chức năng_Role) > image-2025-10-6_8-32-41.png

3.1.3. Xem chi tiết nhóm quyền

BPM1- số hóa khối vận hành > 2605_User Story - Quản trị nhóm quyền (Nhóm quyền thao tác chức năng_Role) > image-2025-10-6_8-33-12.png

BPM1- số hóa khối vận hành > 2605_User Story - Quản trị nhóm quyền (Nhóm quyền thao tác chức năng_Role) > image-2025-10-3_13-43-18.png

3.2 Luồng:

STT	Bước	Mô tả

3.3 API Spec: <gắn link tài liệu mô tả API vào đây>

3.4 Mô tả các trường dữ liệu trên màn hình:

3.4.1. Mô tả màn hình Danh sách nhóm quyền

Màn hình quản lý thông tin nhóm quyền đường dẫn từ: Quản lý người dùng → Quản trị tài nguyên → Quản trị nhóm quyền

STT	Trường/ Nút chức năng	Kiểu dữ liệu	Mô tả
1	Tìm kiếm Tên nhóm quyền	Textbox	Cho phép tìm kiếm gần đúng theo tên nhóm quyền: Không phân biệt hoa thường Tìm kiếm gần đúng tên
2	STT	Grid- Number	Số thứ tự tự sinh tăng dần
3	Mã nhóm quyền	Grid- Text	Mã nhóm quyền
4	Tên nhóm quyền	Grid- Text	Tên nhóm quyền Gọi Popup Xem chi tiết nhóm quyền khi Click Tên nhóm quyền
5	Hoạt động	icon	Cho phép chọn trạng thái Hoạt động, Không hoạt động
6	Cấu hình	icon	Hiển thị thông tin chi tiết nhóm quyền Tab Cấu hình cho nhóm quyền
7	Nhân viên	icon	Hiển thị thông tin chi tiết nhóm quyền Tab Danh sách nhân viên
8	Xuất file excel	Button	Gọi popup export excel
9	Nhập file excel	Button	Gọi popup import excel
10	Thêm mới	Button	Gọi Popup thêm mới nhóm quyền
11	Sửa	Button	Gọi popup Chỉnh sửa nhóm quyền

3.4.2. Mô tả màn hình Thêm mới nhóm quyền

Popup tạo mới nhóm quyền được gọi khi người dùng chọn button Thêm mới tại màn hình Quản trị nhóm quyền

STT	Trường/ Nút chức năng	Kiểu dữ liệu	Điều kiện	Quy định	Mô tả
1	Thêm mới nhóm quyền	Label			Tên popup
Thông tin chung
2	Mã nhóm quyền	Textbox	Bắt buộc	Enable Ký tự được phép nhập: Chữ , Số, ký tự đặc biệt bao gồm . _ (Chấm và gạch dưới)	Nhập thông tin mã nhóm quyền
3	Tên nhóm quyền	Textbox	Bắt buộc	Enable Giới hạn ký tự: 500	Nhập thông tin tên nhóm quyền
4	Mô tả	Textbox	Không bắt buộc	Enable	Nhập thông tin mô tả
5	Trạng thái	Toggle	Bắt buộc	Mặc định: Hoạt động Enable	Cho phép chuyển trạng thái Hoạt động → Không hoạt động
Cấu hình
6	Tìm kiếm theo tên	Textbox	Cố định tiêu đề	Enable	Nhập thông tin tìm kiếm và load danh sách phân hệ, chức năng theo thông tin tìm kiếm
7	Danh sách phân hệ	Checkbox+ Tên phân hệ		Enable	Load theo danh sách phân hệ đang hoạt động Khi tích chọn phân hệ thì đồng thời tích chọn tất cả các hành động được phép cấu hình của các chức năng thuộc phân hệ đó
8	Danh sách chức năng	Checkbox+ Tên chức năng		Enable	Load theo danh sách chức năng đang hoạt động Khi tích chọn chức năng thì đồng thời tích chọn tất cả các hành động được phép cấu hình của các chức năng đó
9	Sao chép nhóm quyền	Button		Enable	Gọi popup chọn nhóm quyền muốn sao chép
10	Nhập file excel	Button		Enable	Gọi popup nhập file excel và import file mẫu
11	Xem	Checkbox	Cố định tiêu đề	Enable	Hiển thị checkbox tương ứng tại cột Xem ở những Chức năng, phân hệ đã được cấu hình Xem
12	Thêm	Checkbox	Cố định tiêu đề	Enable	Hiển thị checkbox tương ứng tại cột Thêm ở những Chức năng, phân hệ đã được cấu hình Thêm
13	Sửa	Checkbox	Cố định tiêu đề	Enable	Hiển thị checkbox tương ứng tại cột Sửa ở những Chức năng, phân hệ đã được cấu hình Sửa
14	Xóa	Checkbox	Cố định tiêu đề	Enable	Hiển thị checkbox tương ứng tại cột Xóa ở những Chức năng, phân hệ đã được cấu hình Xóa
15	Nhập	Checkbox	Cố định tiêu đề	Enable	Hiển thị checkbox tương ứng tại cột Nhập ở những Chức năng, phân hệ đã được cấu hình Nhập
16	Xuất	Checkbox	Cố định tiêu đề	Enable	Hiển thị checkbox tương ứng tại cột Xuất ở những Chức năng, phân hệ đã được cấu hình Xuất
Danh sách nhân viên
17	Nhân viên thuộc nhóm quyền	Label			Label các nhân viên thuộc nhóm quyền
18	Tìm kiếm theo tên	Textbox		Enable	Cho phép tìm kiếm gần đúng theo các cột thông tin dưới Grid
19	Tên đăng nhập	Text		Enable	Hiển thị tên đăng nhập của nhân viên
20	Tên nhân viên	Text		Enable	Hiển thị tên nhân viên
21	Phòng ban	Text		Enable	Thông tin phòng ban của nhân viên
22	Nhân vên chưa thuộc nhóm quyền	Label			Label các nhân viên chưa thuộc nhóm quyền, hiển thị grid nhân viên đang hoạt động và chưa thuộc nhóm quyền đang cấu hình
23	Tìm kiếm theo tên	Textbox		Enable	Cho phép tìm kiếm gần đúng theo các cột thông tin dưới Grid
24	Tên đăng nhập	Text		Enable	Hiển thị tên đăng nhập của nhân viên
25	Tên nhân viên	Text		Enable	Hiển thị tên nhân viên
26	Phòng ban	Text		Enable	Thông tin phòng ban của nhân viên
27	Mũi tên trái	Icon		Enable	Chuyển chức năng sang trái
28	Mũi tên phải	Icon		Enable	Chuyển chức năng sang phải
Hành động
29	Hủy	Button		Enable	Cho phép thoát khỏi popup thêm mới
30	Áp dụng	Button		Enable	Không thành công: Hệ thống chặn và cảnh báo trong trường hợp trùng mã nhóm quyền, hiển thị thông báo toast: " Thất bại- Trùng thông tin mã nhóm quyền" Thành công Hiển thị thông báo toast: '"Thành công- Thêm mới nhóm quyền thành công" Lưu thông tin nhóm quyền

3.4.3. Mô tả màn hình Chỉnh sửa nhóm quyền

Popup tạo mới nhóm quyền được gọi khi người dùng chọn button Sửa tại màn hình Quản trị nhóm quyền

STT	Trường/ Nút chức năng	Kiểu dữ liệu	Điều kiện	Quy định	Mô tả
1	Chỉnh sửa nhóm quyền	Label			Tên popup
Thông tin chung
2	Mã nhóm quyền	Textbox	Bắt buộc	Disable	Không được phép sửa thông tin mã nhóm quyền
3	Tên nhóm quyền	Textbox	Bắt buộc	Enable	Sửa thông tin tên nhóm quyền
4	Mô tả	Textbox	Không bắt buộc	Enable	Cập nhật thông tin mô tả
5	Trạng thái	Toggle	Bắt buộc	Enable	Cho phép chuyển trạng thái Hoạt động/Không hoạt động
Cấu hình
6	Tìm kiếm theo tên	Textbox	Cố định tiêu đề	Enable	Nhập thông tin tìm kiếm và load danh sách phân hệ, chức năng theo thông tin tìm kiếm
7	Danh sách phân hệ	Checkbox+ Tên phân hệ		Enable	Load theo danh sách phân hệ đang hoạt động Khi tích chọn phân hệ thì đồng thời tích chọn tất cả các hành động được phép cấu hình của các chức năng thuộc phân hệ đó
8	Danh sách chức năng	Checkbox+ Tên chức năng		Enable	Load theo danh sách chức năng đang hoạt động Khi tích chọn chức năng thì đồng thời tích chọn tất cả các hành động được phép cấu hình của các chức năng đó
9	Sao chép nhóm quyền	Button		Enable	Gọi popup chọn nhóm quyền muốn sao chép
10	Nhập file excel	Button		Enable	Gọi popup nhập file excel và import file mẫu
11	Xem	Checkbox	Cố định tiêu đề	Enable	Hiển thị checkbox tương ứng tại cột Xem ở những Chức năng, phân hệ đã được cấu hình Xem
12	Thêm	Checkbox	Cố định tiêu đề	Enable	Hiển thị checkbox tương ứng tại cột Thêm ở những Chức năng, phân hệ đã được cấu hình Thêm
13	Sửa	Checkbox	Cố định tiêu đề	Enable	Hiển thị checkbox tương ứng tại cột Sửa ở những Chức năng, phân hệ đã được cấu hình Sửa
14	Xóa	Checkbox	Cố định tiêu đề	Enable	Hiển thị checkbox tương ứng tại cột Xóa ở những Chức năng, phân hệ đã được cấu hình Xóa
15	Nhập	Checkbox	Cố định tiêu đề	Enable	Hiển thị checkbox tương ứng tại cột Nhập ở những Chức năng, phân hệ đã được cấu hình Nhập
16	Xuất	Checkbox	Cố định tiêu đề	Enable	Hiển thị checkbox tương ứng tại cột Xuất ở những Chức năng, phân hệ đã được cấu hình Xuất
Danh sách nhân viên
17	Nhân viên thuộc nhóm quyền	Label			Label các nhân viên thuộc nhóm quyền
18	Tìm kiếm theo tên	Textbox		Enable	Cho phép tìm kiếm gần đúng theo các cột thông tin dưới Grid
19	Tên đăng nhập	Text		Enable	Hiển thị tên đăng nhập của nhân viên
20	Tên nhân viên	Text		Enable	Hiển thị tên nhân viên
21	Phòng ban	Text		Enable	Thông tin phòng ban của nhân viên
22	Nhân vên chưa thuộc nhóm quyền	Label			Label các nhân viên chưa thuộc nhóm quyền, hiển thị grid nhân viên đang hoạt động và chưa thuộc nhóm quyền đang cấu hình
23	Tìm kiếm theo tên	Textbox		Enable	Cho phép tìm kiếm gần đúng theo các cột thông tin dưới Grid
24	Tên đăng nhập	Text		Enable	Hiển thị tên đăng nhập của nhân viên
25	Tên nhân viên	Text		Enable	Hiển thị tên nhân viên
26	Phòng ban	Text		Enable	Thông tin phòng ban của nhân viên
27	Mũi tên trái	Icon		Enable	Chuyển chức năng sang trái
28	Mũi tên phải	Icon		Enable	Chuyển chức năng sang phải
Hành động
29	Hủy	Button		Enable	Cho phép thoát khỏi popup thêm mới
30	Áp dụng	Button		Enable	Không thành công: Hệ thống chặn và cảnh báo trong trường hợp trùng mã nhóm quyền, hiển thị thông báo toast: " Thất bại- Trùng thông tin mã nhóm quyền" Hệ thống chặn và cảnh báo trong trường hợp chuyển trạng thái không hoạt động của nhóm quyền đang gắn vào user đang hoạt động: " Thất bại- Nhóm quyền đã được gán người dùng đang hoạt động!" Thành công Hiển thị thông báo toast: '"Thành công- Thêm mới nhóm quyền thành công" Lưu thông tin nhóm quyền

3.4.4. Mô tả màn hình Xem chi tiết nhóm quyền

Popup tạo mới nhóm quyền được gọi khi người dùng chọn button Xem tại màn hình Quản trị nhóm quyền

STT	Trường/ Nút chức năng	Kiểu dữ liệu	Điều kiện	Quy định	Mô tả
1	Xem chi tiết nhóm quyền	Label			Tên popup
Thông tin chung
2	Mã nhóm quyền	Textbox	Bắt buộc	Disable	Không được phép sửa thông tin mã nhóm quyền
3	Tên nhóm quyền	Textbox	Bắt buộcDisable	Disable	Sửa thông tin tên nhóm quyền
4	Mô tả	Textbox	Không bắt buộc	Disable	Cập nhật thông tin mô tả
5	Trạng thái	Combobox	Bắt buộc	Disable	Trạng thái: Hoạt động Tạm dừng
Cấu hình
6	Tìm kiếm theo tên	Textbox	Cố định tiêu đề	Enable	Nhập thông tin tìm kiếm và load danh sách phân hệ, chức năng theo thông tin tìm kiếm
7	Danh sách phân hệ	Checkbox+ Tên phân hệ		Disable
8	Danh sách chức năng	Checkbox+ Tên chức năng		Disable
9	Sao chép nhóm quyền	Button		Disable
	Nhập file excel	Button		Disable
10	Xem	Checkbox	Cố định tiêu đề	Disable	Hiển thị checkbox tương ứng tại cột Xem ở những Chức năng, phân hệ đã được cấu hình Xem
11	Thêm	Checkbox	Cố định tiêu đề	Disable	Hiển thị checkbox tương ứng tại cột Thêm ở những Chức năng, phân hệ đã được cấu hình Thêm
12	Sửa	Checkbox	Cố định tiêu đề	Disable	Hiển thị checkbox tương ứng tại cột Sửa ở những Chức năng, phân hệ đã được cấu hình Sửa
13	Xóa	Checkbox	Cố định tiêu đề	Disable	Hiển thị checkbox tương ứng tại cột Xóa ở những Chức năng, phân hệ đã được cấu hình Xóa
14	Nhập	Checkbox	Cố định tiêu đề	Disable	Hiển thị checkbox tương ứng tại cột Nhập ở những Chức năng, phân hệ đã được cấu hình Nhập
15	Xuất	Checkbox	Cố định tiêu đề	Disable	Hiển thị checkbox tương ứng tại cột Xuất ở những Chức năng, phân hệ đã được cấu hình Xuất
Danh sách nhân viên
16	Nhân viên thuộc nhóm quyền	Label			Label các nhân viên thuộc nhóm quyền
17	Tìm kiếm theo tên	Textbox		Disable	Cho phép tìm kiếm gần đúng theo các cột thông tin dưới Grid
18	Tên đăng nhập	Text		Disable	Hiển thị tên đăng nhập của nhân viên
19	Tên nhân viên	Text		Disable	Hiển thị tên nhân viên
20	Phòng ban	Text		Disable	Thông tin phòng ban của nhân viên
Hành động
21	Hủy	Button			Cho phép thoát khỏi popup thêm mới

3.4.6. Popup sao chép cấu hình của một nhóm quyền tương tự

Popup Sao chép phân quyền của một nhóm quyền được thực hiện khi người dùng click vào icon Sao chép trên màn hình cấu hình phân quyền

STT	Trường/ Nút chức năng	Kiểu dữ liệu	Điều kiện	Mô tả
1	Chọn nhóm quyền cần sao chép	Label		Tên popup
2	Nhóm quyền	Combobox	Bắt buộc	Load thông tin mã nhóm quyền- Tên nhóm quyền từ danh mục nhóm quyền theo trạng thái hoạt động
3	Hủy	Button		Thoát khỏi popup sao chép nhóm quyền
4	Xác nhận	Button		Hiển thị thông báo toast: :" Thành công- Sao chép nhóm quyền thành công" Hiển thị thông tin tích chọn của nhóm quyền đang thực hiện cấu hình tương ứng với cấu hình của nhóm quyền sao chép được chọn

3.4.8. Mô tả màn hình export

Popup xuất excel được hiển thị khi chọn Xuất file excel trên Quản trị nhóm quyền

STT	Trường/ Nút chức năng	Kiểu dữ liệu	Mô tả
1	Xuất danh sách nhóm quyền	Label	Tên popup
2	Chọn định dạng file	Label
3	Excel	Radio button	Mặc định chọn Excel
4	Chọn kiểu xuất file	Label
5	Tất cả nhóm quyền	Radio button	Mặc định chọn tất nhóm quyền Cho phép xuất tất cả các nhóm quyền trên file excel
6	Trên trang này	Radio button	Cho phép xuất các nhóm quyền trên trang hiển thị hiện tại
7	X phân hệ phù hợp với kết quả tìm kiếm hiện tại	Radio button	X là số lượng nhóm quyền của kết quả tìm kiếm Cho phép xuất tất cả các nhóm quyền phù hợp với tất cả tìm kiếm hiện tại

3.4.9. Mô tả màn hình Nhập file excel ( Quản trị nhóm quyền)

Popup nhập excel được hiển thị khi chọn Nhập file excel trên Quản trị nhóm quyền

STT	Trường/ Nút chức năng	Kiểu dữ liệu	Mô tả
1	Nhập file excel	Label	Tên popup
2	Tài liệu mẫu	Hyper link	Cho phép tải xuống file mẫu
3	Tài liệu đính kèm	Upload file	Cho phép upload file theo mẫu
4	Hủy	Button	Thoát khỏi popup import
5	Áp dụng	Button	Thất bại: Gọi pop-up trả lỗi khi import dữ liệu, file trả lỗi theo từng dòng Hiển thị thông báo: " Thất bại- Import danh sách nhóm quyền thất bại!" Thành công: Lưu thông tin import Hiển thị thông báo: " Thành công- Import danh sách nhóm quyền thành công!"

File excel mẫu bao gồm thông tin: Note: Khi import file, Trạng thái nhóm quyền mặc định là Hoạt động

STT	*Mã nhóm quyền ()**	*Tên nhóm quyền ()**	*Mô tả ()**
1

3.4.10. Mô tả màn hình Nhập file excel ( Cấu hình)

Tại màn hình Cấu hình ở giao diện Sửa và Xóa, cho phép gọi Popup Nhập file excel ( tương tự màn hình nhập excel tại Quản trị nhóm quyền) và import dữ liệu cấu hình theo file excel bao gồm:

STT	Danh sách chức năng	Xem	Thêm	Sửa	Xóa	Nhập	Xuất
1	( Hệ thống xuất ra từ Danh mục chức năng)

3.4.11. Pop-up trả lại lỗi khi import file dữ liệu

STT	Trường/ Nút chức năng	Kiểu dữ liệu	Mô tả
1	Nhập file excel	Label	Tên popup
2	Không thành công File excel bạn nhập chưa chính xác	Label	Thông tin thông báo
3	Danh mục các lỗi gặp phải	Label
4	Tải xuống	Button	Cho phép tải xuống file mẫu
5	Hủy	Button	Thoát khỏi popup import
6	Nhập lại	Button	Gọi pop-up Nhập file excel