2603_User Story - Danh mục chức năng

	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
- Mô tả
Tôi muốn tạo mới/Sửa/Xóa đượ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 mới
- 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.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àn hình Danh sách 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 ->Quản trị 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	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
2	Đ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
3	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
4	Ứ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
5	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
6	STT	Grid- number			Số thứ tự tự sinh tăng dần
7	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
8	Mã chức năng	Grid- Text			Hiển thị thông tin mã chức năng
9	Đường dẫn	Grid- Text			Hiển thị thông tin đường dẫn
10	Trạng thái	Icon			Cho phép chuyển trạng thái trên danh sách
11	Thêm mới	Button			Gọi popup Thêm mới Danh sách chức năng
12	Sửa	Button			Gọi popup Sửa danh sách chức năng
13	Xóa	Button			Gọi popup Xác nhận
14	Xuất file excel	Button			Gọi popup Xuất file excel
15	Hiển thị	Droplist			Cho phép chọn số lượng bản ghi hiển thị trên trang
16	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		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		Nhập tên chức năng
4	Mã chức năng	Textbox	Bắt buộc		Nhập mã chức năng
5	Đường dẫn	Textbox	Bắt buộc		Nhập đường dẫn
6	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
7	View	icon	Không bắt buộc		Cho phép tích chọn, bỏ tích chọn hành động
8	Add	icon	Không bắt buộc		Cho phép tích chọn, bỏ tích chọn hành động
9	Update	icon	Không bắt buộc		Cho phép tích chọn, bỏ tích chọn hành động
10	Delete	icon	Không bắt buộc		Cho phép tích chọn, bỏ tích chọn hành động
11	Import	icon	Không bắt buộc		Cho phép tích chọn, bỏ tích chọn hành động
12	Export	icon	Không bắt buộc		Cho phép tích chọn, bỏ tích chọn hành động
13	Mô tả	Text	Không bắt buộc		Nhập thông tin mô tả
14	Á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/ Đườ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)
15	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		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		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		Sửa đường dẫn
6	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
7	Xem	icon	Không bắt buộc		Cho phép tích chọn, bỏ tích chọn hành động
8	Thêm	icon	Không bắt buộc		Cho phép tích chọn, bỏ tích chọn hành động
9	Sửa	icon	Không bắt buộc		Cho phép tích chọn, bỏ tích chọn hành động
10	Xóa	icon	Không bắt buộc		Cho phép tích chọn, bỏ tích chọn hành động
11	Nhập	icon	Không bắt buộc		Cho phép tích chọn, bỏ tích chọn hành động
12	Xuất	icon	Không bắt buộc		Cho phép tích chọn, bỏ tích chọn hành động
13	Mô tả	Text	Không bắt buộc		Nhập thông tin mô tả
14	Á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 hoặc Đường dẫn Hành động: cảnh báo trùng thông tin Hệ thống Cảnh báo và chặn 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 => Cảnh báo đã sử dụng 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 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)
15	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	View	icon	Không bắt buộc	Disable
8	Add	icon	Không bắt buộc	Disable
9	Update	icon	Không bắt buộc	Disable
10	Delete	icon	Không bắt buộc	Disable
11	Import	icon	Không bắt buộc	Disable
12	Export	icon	Không bắt buộc	Disable
13	Mô tả	Text	Không bắt buộc	Disable
14	Thoát	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 => 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 => 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"

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

icon

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

Cảnh báo được gọi 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