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-2603

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

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

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

Tôi muốn xem được danh sách chức năng bao gồm các thông tin:
- Ứng dụng
- Tên chức năng (Chức năng app)
- Mã chức năng
- Đường dẫn
Tôi muốn tạo mới/Sửa/Xóa/Xem chi tiết được thông tin danh mục chức năng trên hệ thống bao gồm các thông tin:
- Chọn ứng dụng ( Các ứng dụng phát triển trên nền tảng)
- Tên chức năng (Chức năng app)
- Mã chức năng
- Đường dẫn
- Mô tả
Tôi muốn chọn được nhiều bản ghi và xóa đồng thời trên danh sách
Tôi muốn hệ thống yêu cầu Xác nhận khi xóa chức năng
Tôi muốn hệ thống cảnh báo và chặn trong trường hợp Thêm mới/Sửa trùng mã chức năng, trùng đường dẫn
Tôi muốn hệ thống cảnh báo và chặn trong trường hợp chức năng Sửa/xóa đang được phân quyền cho một nhóm quyền đang active
Tôi muốn người dùng được thiết lập các tính năng cho phép cấu hình động theo nhóm quyền (chức danh)
- Xem
- Thêm
- Sửa
- Xóa
- Nhập
- Xuất
Tôi muốn tìm kiếm gần đúng thông tin chức năng theo các thông tin
- Tên chức năng
Tôi muốn người dung export được thông tin Danh sách chức năng trên hệ thống theo các lựa chọn:
- Định dạng tải file excel
- Chọn kiểu xuất file
  - Tất cả chức năng
  - Danh sách chức năng đã tìm kiếm
  - Danh sách chức năng trên trang

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

3.1 UIUX: BPM – Figma

3.1.1. Danh mục chức năng

BPM1- số hóa khối vận hành > 2603_User Story - Danh mục chức năng > image-2025-9-30_14-19-4.png

3.1.2. Thêm mới chức năng

BPM1- số hóa khối vận hành > 2603_User Story - Danh mục chức năng > image-2025-10-3_14-19-2.png

3.1.3. Sửa chức năng

BPM1- số hóa khối vận hành > 2603_User Story - Danh mục chức năng > image-2025-10-3_14-19-31.png

BPM1- số hóa khối vận hành > 2603_User Story - Danh mục chức năng > image-2025-10-8_15-52-16.png

Cảnh báo sửa lựa chọn hành động của chức năng đã được cấu hình

3.1.4. Xem chi tiết chức năng

BPM1- số hóa khối vận hành > 2603_User Story - Danh mục chức năng > Xem chức năng.png

3.2 Luồng:

3.2.1. Tìm kiếm chức năng

3.2.2. Thêm mới chức năng

3.2.3. Chỉnh sửa chức năng

3.2.4. Xem chức năng

BPM1- số hóa khối vận hành > 2603_User Story - Danh mục chức năng > image-2025-10-9_15-18-5.png

3.2.5. Xóa chức năng

3.2.6. Xuất file excel

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àn hình Danh mục chức năng

Màn hình danh sách chức năng để quản lý các chức năng sử dụng để phân quyền cho các nhóm Role: Quản lý người dùng -> Quản trị tài nguyên →Danh mục chức năng

STT	Trường/ Nút chức năng	Kiểu dữ liệu	Mô tả
1	Danh mục chức năng	Label
2	Quản trị tài nguyên> Danh mục chức năng	Hyperlink	Khi thao tác chọn Quản trị tài nguyên trên màn, quay lại màn hình cho phép chọn các danh mục thuộc phân hệ Quản trị tài nguyên
3	Checkbox	Button	Cho phép chọn tất cả bản ghi trên trang, một hoặc nhiều các bản ghi, trên danh sách, khi chọn checkbox hiển thị thông tin số lượng bản ghi đang chọn và icon xóa: Đang chọn x: Trong đó x là số lượng bản ghi đang được chọn Xóa: Cho phép xóa thông tin các bản ghi đang được chọn Khi chọn nhiều bản ghi, hiển thị icon không cho chọn các button sửa, xóa tại từng bản ghi và button thêm mới, xuất excel Ẩn checkbox tại các bản ghi với trường hợp bản ghi đó đã được cấu hình Xem, Thêm,... tại một nhóm quyền hoặc một người dùng đang active
4	Đang chọn x	Text	Hiển thị số lượng bản ghi được tích chọn trên màn hình
5	Xóa	Button	Hiển thị khi có bản ghi được tích chọn trên màn hình Chọn xóa gọi popup Xác nhận
6	Ứng dụng	Combobox	Cho phép nhập tìm kiếm và load thông tin nền tảng tương ứng trong combobox
7	Tìm kiếm tên chức năng	Text	Cho phép tìm kiếm gần đúng theo tên chức năng: Không phân biệt hoa thường Tìm kiếm gần đúng tên
8	STT	Grid- number	Số thứ tự tự sinh tăng dần
9	Tên chức năng	Grid- Text	Hiển thị thông tin tên chức năng Click mở popup Xem thông tin chi tiết chức năng
10	Mã chức năng	Grid- Text	Hiển thị thông tin mã chức năng
11	Đường dẫn	Grid- Text	Hiển thị thông tin đường dẫn
12	Trạng thái	Icon	Cho phép chuyển trạng thái trên danh sách Hệ thống cảnh báo đã sử dụng trong trường hợp chuyển trạng thái không hoạt động của một chức năng đã được cấu hình trong một nhóm quyền, người dùng
13	Thêm mới	Button	Gọi popup Thêm mới Danh sách chức năng
14	Sửa	Button	Gọi popup Sửa danh sách chức năng
15	Xóa	Button	Gọi popup Xác nhận
16	Xuất file excel	Button	Gọi popup Xuất file excel
	Hiển thị	Droplist	Cho phép chọn số lượng bản ghi hiển thị trên trang
	Trang	Button	Hiển thị trang và cho phép chọn trang chuyển tiếp

3.4.2. Mô tả Popup Thêm mới chức năng

Popup thêm mới chức năng hiển thị khi người dùng click button Thêm mới trên danh sách

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 chức năng	Label	Bắt buộc		Tên popup
2	Ứng dụng	Combobox	Bắt buộc	Enable	Cho phép nhập tìm kiếm và load thông tin nền tảng tương ứng trong combobox
3	Tên chức năng	Textbox	Bắt buộc	Enable	Nhập tên chức năng
4	Mã chức năng	Textbox	Bắt buộc	Enable	Nhập mã chức năng
5	Đường dẫn	Textbox	Bắt buộc	Enable	Nhập đường dẫn
6	Trạng thái	icon	Bắt buộc	Enable	Mặc định hoạt động
7	Lựa chọn hành động	Label	Bắt buộc		Các hành động được thực hiện cấu hình của mỗi chức năng
8	Xem	Toggle	Không bắt buộc	Enable	Cho phép chọn cho phép cấu hình hoặc không cho phép cấu hình
9	Thêm	toggle	Không bắt buộc	Enable	Cho phép chọn cho phép cấu hình hoặc không cho phép cấu hình
10	Sửa	toggle	Không bắt buộc	Enable	Cho phép chọn cho phép cấu hình hoặc không cho phép cấu hình
11	Xóa	toggle	Không bắt buộc	Enable	Cho phép chọn cho phép cấu hình hoặc không cho phép cấu hình
12	Nhập	toggle	Không bắt buộc	Enable	Cho phép chọn cho phép cấu hình hoặc không cho phép cấu hình
13	Xuất	toggle	Không bắt buộc	Enable	Cho phép chọn cho phép cấu hình hoặc không cho phép cấu hình
14	Mô tả	Text	Không bắt buộc	Enable	Nhập thông tin mô tả
15	Áp dụng	Button			Hệ thống Cảnh báo và chặn trong trường hợp Thêm mới trùng thông tin với một chức năng khác: Thông tin: Mã chức năng, Tên chức năng hoặc Đường dẫn Hành động: Cảnh báo trùng thông tin và không cho hoàn thành tạo mới chức năng Hoàn thành và lưu thông tin tạo mới thành công, hiển thị thông báo toast: " Thành công- Thêm mới chức năng thành công)
16	Hủy	Button			Chức năng cho phép người dùng thoát khỏi Pop-up

3.4.3. Mô tả Popup Sửa chức năng

Popup Sửa chức năng hiển thị khi người dùng Sửa chức năng trên danh sách

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 chức năng	Label	Bắt buộc		Tên popup
2	Ứng dụng	Combobox	Bắt buộc	Enable	Cho phép nhập tìm kiếm và load thông tin nền tảng tương ứng trong combobox
3	Tên chức năng	Textbox	Bắt buộc	Enable	Sửa tên chức năng
4	Mã chức năng	Textbox	Bắt buộc		Sửa mã chức năng
5	Đường dẫn	Textbox	Bắt buộc	Enable	Sửa đường dẫn
6	Trạng thái	icon	Bắt buộc	Enable	Cho phép chọn hoạt động hoặc Không hoạt động
7	Lựa chọn hành động	Label	Bắt buộc		Các hành động được thực hiện cấu hình của mỗi chức năng
8	Xem	toggle	Không bắt buộc	Enable	Cho phép chọn cho phép cấu hình hoặc không cho phép cấu hình
9	Thêm	toggle	Không bắt buộc	Enable	Cho phép chọn cho phép cấu hình hoặc không cho phép cấu hình
10	Sửa	toggle	Không bắt buộc	Enable	Cho phép chọn cho phép cấu hình hoặc không cho phép cấu hình
11	Xóa	toggle	Không bắt buộc	Enable	Cho phép chọn cho phép cấu hình hoặc không cho phép cấu hình
12	Nhập	toggle	Không bắt buộc	Enable	Cho phép chọn cho phép cấu hình hoặc không cho phép cấu hình
13	Xuất	toggle	Không bắt buộc	Enable	Cho phép chọn cho phép cấu hình hoặc không cho phép cấu hình
14	Mô tả	Text	Không bắt buộc	Enable	Nhập thông tin mô tả
15	Áp dụng	Button			Hệ thống cảnh báo và chặn trong các trường hợp: Hệ thống Cảnh báo và chặn trong trường hợp Cập nhật trùng thông tin với một chức năng khác: Thông tin: Mã chức năng, Tên chức năng hoặc Đường dẫn Hành động: cảnh báo trùng thông tin Hệ thống Cảnh báo trường hợp cập nhật Chức năng bỏ bớt các hành động đã được cấu hình hành động (Xem, Thêm,..) trong một nhóm quyền, người dùng đang ở trạng thái active; VD: Chức năng Quản lý nhóm quyền được thiết lập hành động: Xem, Thêm. Nhóm quyền Giám đốc được cấu hình cho phép Xem, Thêm. Cập nhật chức năng Quản lý nhóm quyền bỏ Xem => Hệ thống gọi popup cảnh báo đã sử dụng Cảnh báo và chặn Cập nhật trạng thái không hoạt động của chức năng đã sử dụng trong một nhóm quyền => Cảnh báo đã sử dụng và chặn Cập nhật thành công Cập nhật thông tin chỉnh sửa thành công, hiển thị thông báo toast: " Thành công- Chỉnh sửa chức năng thành công)
16	Hủy	Button			Chức năng cho phép người dùng thoát khỏi Pop-up

3.4.4. Mô tả Popup Xem chức năng

Gọi popup khi click vào tên chức năng tại danh sách chức năng

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 chức năng	Label	Bắt buộc		Tên popup
2	Ứng dụng	Combobox	Bắt buộc	Disable
3	Tên chức năng	Textbox	Bắt buộc	Disable
4	Mã chức năng	Textbox	Bắt buộc	Disable
5	Đường dẫn	Textbox	Bắt buộc	Disable
6	Lựa chọn hành động	Label	Bắt buộc
7	Xem	toggle	Không bắt buộc	Disable
8	Thêm	toggle	Không bắt buộc	Disable
9	Sửa	toggle	Không bắt buộc	Disable
10	Xóa	toggle	Không bắt buộc	Disable
11	Nhập	toggle	Không bắt buộc	Disable
12	Xuất	toggle	Không bắt buộc	Disable
13	Mô tả	Text	Không bắt buộc	Disable
14	Hủy	Button			Chức năng cho phép người dùng thoát khỏi Pop-up

3.4.5. Mô tả Popup Xác nhận Xóa

Popup Xác nhận hiển thị khi người dùng thực hiện Xóa 1 hoặc nhiều bản ghi đồng thời trên danh sách

STT	Trường/ Nút chức năng	Kiểu dữ liệu	Điều kiện	Quy định	Mô tả
Pop-up xác nhận xóa
1	Bạn có chắc chắn muốn Xóa chức năng đã chọn?	Label			Nội dung cảnh báo
2	Hủy	Button			Chức năng cho phép người dùng thoát khỏi Pop-up xác nhận xóa
3	Tôi chắc chắn	Button			Chức năng cho phép người dùng xóa chức năng đã chọn. Hệ thống Cảnh báo và chặn trường hợp Xóa Chức năng đã được cấu hình hành động đã được cấu hình hành động (Xem, Thêm,..) trong một nhóm quyền, người dùng đang active=> Gọi popup Cảnh báo đã sử dụng Chức năng chưa được cấu hình, Hệ thống hiển thị toast: "Xóa chức năng thành công"
Pop-up xác nhận xóa hàng loạt:
1	Bạn có chắc chắn muốn xóa X chức năng đã chọn? Thao tác này không thể khôi phục!	Label			Trong đó X là số lượng bản ghi được lựa chọn để xóa
2	Hủy	Button			Chức năng cho phép người dùng thoát khỏi Pop-up xác nhận xóa
3	Tôi chắc chắn	Button			Cho phép người dùng xóa chức năng đã chọn Hệ thống Cảnh báo và chặn trường hợp Xóa Chức năng đã được cấu hình hành động đã được cấu hình hành động (Xem, Thêm,..) trong một nhóm quyền, người dùng đang active => Cảnh báo đã sử dụng Chức năng chưa được cấu hình, Hệ thống hiển thị toast: "Xóa chức năng thành công"

3.4.6. Mô tả Cảnh báo trùng thông tin

Cảnh báo trùng thông tin xuất hiện khi Thêm mới hoặc Sửa chức năng mà thông tin sau Cập nhật trùng với thông tin của một Chức năng đã tồn tại trên danh sách

STT

Trường/ Nút chức năng

Kiểu dữ liệu

Điều kiện

Quy định

Mô tả

1

Thông tin X đã tồn tại tại Mã chức năng Y. Vui lòng kiểm tra lại!

Label

Nội dung cảnh báo trong đó:

X là thông tin trùng: Mã chức năng hoặc Đường dẫn
Y: Thông tin mã chức năng có tồn tại nội dung bị trùng

2

Thoát

button

Cho phép thoát khỏi popup Cảnh báo và không hoàn thành được thao tác Thêm mới/Cập nhật

3.4.7. Mô tả Cảnh báo đã sử dụng

Gọi popup cảnh báo đã sử dụng trường hợp xóa hoặc sửa 1 bản ghi:

Khi xác nhận tại button Tôi chắc chắn trường hợp xóa chức năng đã được cấu hình hành động trong một nhóm quyền
Khi áp dụng của sửa chức năng gặp lỗi

STT	Trường/ Nút chức năng	Kiểu dữ liệu	Mô tả
1	Chức năng đã được cấu hình hành động tại nhóm quyền/quyền người dùng. Vui lòng kiểm tra lại!	Label+ hyper link
2	Danh sách lỗi	Button	Cho phép tải xuống danh sách lỗi bao gồm các cột thông tin STT: Số nguyên tự tăng Mã chức năng: Mã chức năng đã được cấu hình Tên chức năng: Tên chức năng đã được cấu hình Mã nhóm quyền: Mã nhóm quyền đã được cấu hình Tên nhóm quyền: Tên nhóm quyền đã được cấu hình Tên đăng nhập: Tên đăng nhập của người dùng đang cấu hình chức năng (Chỉ check với những case cấu hình ngoại lệ, không thuộc cấu hình trong nhóm quyền) Họ và tên người dùng: Họ và tên người dùng đang cấu hình chức năng (Chỉ check với những case cấu hình ngoại lệ, không thuộc cấu hình trong nhóm quyền)
3	Xác nhận	Button	Chỉ hiển thị với trường hợp cảnh báo, không chặn ( Sửa cấu hình hành động đã sử dụng) Ẩn với trường hợp chặn ( Sửa trạng thái, xóa một chức năng, xóa nhiều chức năng) Xác nhận thì cho phép hoàn thành hành động Sửa
4	Thoát	Button	Cho phép thoát khỏi popup Cảnh báo và không hoàn thành được thao tác

Gọi pop-up cảnh báo trường hợp xóa nhiều bản ghi, gọi popup cảnh báo đã sử dụng như sau:

STT	Trường/ Nút chức năng	Kiểu dữ liệu	Mô tả
1	Tồn tại A chức năng đã được cấu hình hành động tại nhóm quyền/ quyền người dùng. Vui lòng kiểm tra lại!	Label	Trong đó A là số lượng Chức năng đã được cấu hình
2	Danh sách lỗi	Button	Cho phép tải xuống danh sách lỗi bao gồm các cột thông tin STT: Số nguyên tự tăng Mã chức năng: Mã chức năng đã được cấu hình Tên chức năng: Tên chức năng đã được cấu hình Mã nhóm quyền: Mã nhóm quyền đã được cấu hình Tên nhóm quyền: Tên nhóm quyền đã được cấu hình Tên đăng nhập: Tên đăng nhập của người dùng đang cấu hình chức năng (Chỉ check với những case cấu hình ngoại lệ, không thuộc cấu hình trong nhóm quyền) Họ và tên người dùng: Họ và tên người dùng đang cấu hình chức năng (Chỉ check với những case cấu hình ngoại lệ, không thuộc cấu hình trong nhóm quyền)
3	Xác nhận	Button	Chỉ hiển thị với trường hợp cảnh báo, không chặn ( Sửa cấu hình hành động đã sử dụng) Ẩn với trường hợp chặn ( Sửa trạng thái, xóa một chức năng, xóa nhiều chức năng) Xác nhận thì cho phép hoàn thành hành động Sửa
4	Thoát	Button	Cho phép thoát khỏi popup Cảnh báo và không hoàn thành được thao tác

Mẫu file excel trả về Danh sách lỗi các chức năng đã được cấu hình hành động

3.4.8. Mô tả Popup Xuất file excel

Popup xuất excel được hiển thị khi chọn Xuất file excel trên Danh sách chức năng

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