Page History

3.4.2.1 Màn hình tiêu chí đánh giá (grid)

	Nghiệp vụ		IT
	Người lập	Người duyệt	Người lập	Người duyệt
Tên, Chức danh	Vũ Thị Mơ
Ngày ký
Jira Link	https://jira.popplife.vn/browse/BPMKVH-2327

...

Tôi muốn Tạo mới/Sửa/Xem/xóa được thông tin thang điểm bao gồm:
- Mã thang điểm (Duy nhất)
- Tên thang điểm
- Loại đánh giá: Đánh giá lần đầu/ Đánh giá định kỳ/ Đánh giá trong sử dụng dịch vụ/ Đánh giá sau sử dụng dịch vụ
- Lĩnh vực kinh doanh ( Check lại nghiệp vụ Ví dụ Lĩnh vực kinh doanh : CNTT, XDCB, TMDV, ME)
- Trạng thái: Active/Not active
Tôi muốn khai báo được các tiêu chí vào thang điểm đánh giá và cho phép nhập trọng số tiêu chí
- Tên tiêu chí: Nhập tiêu chí
- Mô tả tiêu chí: Nhập các tiêu chuẩn và khoảng điểm gợi ý cho tiêu chuẩn
- Trọng số %: Nhập trọng số (<=100)số
Tôi muốn hệ thống cảnh báo và chặn với trường hợp thang điểm trùng lĩnh vực và loại thang điểm với một thang điểm đang active
Tôi muốn phân loại các khoảng thang điểm theo khoảng giá trị chi tiết. Bao gồm:
Mã khoảng điểm
Tên khoảng điểm (Minh họa: Năng lực tốt, Khá, TB, Kém/ A, B, C, D)
Giá trị tối thiểu
Giá trị tối đa

Ghi chú: (Minh họa: Duy trì ký kết Hợp đồng nguyên tắc (HĐNT) đối với các trường hợp có thể ký kết được HĐNT để cung cấp chính cho các sản phẩm/dịch vụ được đánh giá loại A, Ưu tiên lựa chọn trong các lần tham gia chào giá/đấu thầu khi đáp ứng được các yêu cầu đàm phán)

hệ thống cảnh báo và chặn trong trường hợp trùng mã thang điểm

Tôi muốn hệ thống cảnh báo trong trường hợp thêm mới trùng mã thang điểm
Tôi muốn xem được danh sách thang điểm bao gồm các thông tin:
1. Mã thang điểm
2. Tên thang điểm
3. Loại đánh giá: Đánh giá lần đầu/Đánh giá định kỳ/Đánh giá sau sử dụng dịch vụ
4. Lĩnh vực kinh doanh (Check lại nghiệp vụ Lĩnh vực kinh doanh sản phẩm)Trạng thái: Active/Not active
Tôi muốn tìm kiếm được thang điểm theo thông tin:
1. Tên thang điểmTrạng thái
Cho phép lọc theo
1. Loại đánh giá
2. Lĩnh vực kinh doanh

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

3.1 UIUX:

3.1.1 Màn hìnhDanh mục thang điểm

Image AddedImage AddedImage Added

3.1.2 Màn hình Pop-up Thêm mới loại thang điểm

Image Added

3.1.3 Màn hình Pop-up Chỉnh sửa loại thang điểm

Image Added

3.1.4 Màn hình Pop-up Xem chi tiết loại thang điểm

Image Added

3.1.5 Pop-up/ Toast

Image Added

3.2 Luồng:

Activity Diagram:

Sequence Diagram:

...

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

Panel

title	API lấy danh sách thang điểm

Method	GET	URL	application/ratingScale/list
Description	API lấy danh sách thang điểm
Note	API mới

1. Headers

STT	Field	Source Data Type / Length	Description	Sample Values
1	authorization	<token>	Token của người dùng đăng nhập	Bearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjY0NTU3ODksInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.wrvIFd-Q2kHgkTmPf6ryMY6aDIgXpNsWmSvvifQWc5k

2. Request

STT	Field	Require	Data Type / Length	Description	Note
1	page	true	Integer	trang
2	limit	true	Integer	số bản ghi cần lấy
3	evaluationType	false	Integer	Loại đánh giá	Loại đánh giá: 1 - Đánh giá lần đầu. 2 - Đánh giá định kỳ. 3 - Đánh giá trong sử dụng dịch vụ. n4 - Đánh giá sau sử dụng dịch vụ
4	fieldId	false	Integer	id lĩnh vực
5	name	false	String	tên danh mục

3. Response / Incoming Data Specification

STT	Field	Data Type / Length	Description
1	code	Integer	0: thành công còn lại thất bại
2	message	String	message
3	result	List<Object>	kết quả trả ra
4	(result) id	Integer	id
5	(result) code	String	mã thang điểm
6	(result) name	String	tên thang điểm
7	(result) evaluationType	Integer	loại đánh giá
8	(result) fieldId	Integer	id lĩnh vực
9	(result) inputFormId	Integer	id bảng nhập liệu
11	(result) data	String	dữ liệu grid
12	(result) dataHeader	String	header
13	(result) employeeId	Integer	id nhân viên tạo
14	(result) createdAt	String	ngày tạo
15	(result) updatedAt	String	ngày cập nhật

Path

Panel

title	API Spec Documentphê duyệt đánh giá

Method	POST	URL	/application/supplierEvaluation/update
Description	API phê duyệt đánh giá
Note	API mới

1. Headers

STT	Field	Source Data Type / Length	Description	Sample Values

2. Body

STT


1	authorization	String	Token	Bearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjYzOTgyNDUsInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.qRoaRDxjqyWS-3Az_ZqLmR0KAcPTM7jXggW1Ja5wpEc

Text		-Không cho phép thêm mới/sửa/xóa dữ liệu	Thể hiện thông tin loại đánh giá áp dụng cho thang điểm
4	Lĩnh vực kinh doanh

nhiều thang điểm
11	Nút lọc	Button			Cho phép lọc theo loại đánh giá, lĩnh vực kinh doanh

- Giới hạn 50 ký tự	-Mã định danh duy nhất của thang điểm
Tên thang điểm	Text	x	-

Giới hạn 50 ký tự	Tên hiển thị của thang điểm
Biểu mẫu thang điểm	Droplist	x	- Cho phép chọn mã biểu mẫu thang điểm đã tạo từ danh sách mã biểu mẫu màn hình Tab Bảng nhập liệu trong mục Quản lý bảng nhập liệu tại danh mục Cài đặt - Khi tạo thang điểm, người dùng cần chọn đúng thang điểm có mã btddgncc từ danh sách mã biểu mẫu màn hình Tab Bảng nhập liệu trong mục Quản lý bảng nhập liệu tại danh mục Cài đặt	Thể hiện tên của biểu mẫu thang điểm đã tạo(grid)
Loại đánh giá	Droplist	x	-Cho phép chọn 1 trong 3 loại đánh giá ứng với mỗi lĩnh vực kinh doanh, không cho phép người dùng được chọn lại loại đánh giá trùng với lĩnh vực kinh doanh đã chọn lần trước 1 - Đánh giá lần đầu 2 - Đánh giá định kỳ 3 - Đánh giá trong sử dụng dịch vụ 4- Đánh giá sau sử dụng dịch vụ	Thể hiện thông tin loại đánh giá áp dụng cho thang điểm VD: Lần 1 chọn đánh giá lần đầu ứng với lĩnh vực XDCB -> lần 2 chỉ được phép chọn đánh giá sau sử dụng/ đánh giá định kỳ của lĩnh vực XDCB
Lĩnh vực kinh doanh	Droplist	x	-Cho phép chọn 1 lĩnh vực kinh doanh (trạng thái đang active) trong danh mục lĩnh vực (ví dụ: XDCB, CNTT, TMDV...) tương ứng với các loại đánh giá, không cho phép người dùng được chọn lại lĩnh vực kinh doanh với loại đánh giá trùng đã chọn lần trước	Thể hiện thông tin lĩnh vực kinh doanh của NCC mà thang điểm đang áp dụng với loại đánh giá tương ứng VD: Lần 1 chọn đánh giá lần đầu ứng với lĩnh vực XDCB -> lần 2 chỉ được phép chọn đánh giá lần đầu của của lĩnh vực CNTT
Nút đóng "X"	Button		Khi nhấn → đóng popup, quay lại màn hình trước.	Thể hiện nút chức năng cho phép đóng pop-up
Nút áp dụng	Button		Check các trường bắt buộc Check trùng mã thang điểm => Khi trùng mã thang điểm hệ thống sẽ hiện pop up cảnh báo trùng → chọn nút thoát hiển thị về màn hình thêm mới loại thang điểm Check trùng đồng thời thỏa mãn trường lĩnh vực và trường loại đánh giá => Khi trùng trường lĩnh vực và trường loại đánh giá hệ thống sẽ hiện pop up cảnh báo trùng ở mã thang điểm nào VD: lần 1 tạo mã thang điểm A Loại đánh giá lần đầu trong lĩnh vực XDCB → Hệ thống cho lưu Lần 2 tạo mã thang điểm B, loại đánh giá lần đầu lĩnh vực XDCB → hệ thống không cho lưu do đã có thang điểm loại đánh giá lần đầu cho lĩnh vực XDCB tạo ở lần 1	Lưu thông tin loại dự án.
Nút hủy	Button			Đóng pop-up vào không lưu thông tin

Field (Trường dữ liệu)	Type (Kiểu dữ liệu)	Required (Bắt buộc)	Validation (Quy định)	Description (Mô tả)
Xuất file excel	Button			Cho phép xuất file thông tin excel Tham chiếu tài liệu URD
Nhập file excel	Button			Cho phép nhận file thông tin exvel Tham chiếu tài liệu URD
STT	Number		Hệ thống tự sinh số thứ tự tăng dần	Số thứ tự sắp xếp tiêu chí đánh giá
Chỉ tiêu đánh giá	Text	x	Cho phép nhập tiêu chí đánh giá	Nội dung tiêu chí sử dụng để đánh giá
Tiêu chuẩn	Text		Cho phép nhập các mô tả tiêu chuẩn tương ứng với chỉ tiêu đánh giá	Mô tả tiêu chuẩn cụ thể của từng chỉ tiêu đánh giá
Thang điểm	Number	x	Cho phép nhập thang điểm tối đa được đánh giá theo quy định	Thể hiện thang điểm đánh giá nhà cung cấp VD: thang điểm 10, thang điểm 100
Điểm đánh giá	Number	x	Cho phép nhập điểm Lấy đến 2 chữ số thập phân (VD: 0.05)	Thể hiện điểm số đánh giá cho chỉ tiêu
Trọng số (%)	Number	x	Cho phép nhập trọng số của chỉ tiêu Lấy đến 2 chữ số thập phân (VD: 0.05)	Thể hiện mức độ quan trọng của từng chỉ tiêu
Điểm quy đổi	Number	x	Tự động tính điểm theo công thức: Điểm quy đổi = Điểm đánh giá x trọng số/100 Lấy đến 2 chữ số thập phân (VD: 0.05)	Thể hiện điểm sau khi quy đổi theo trọng số tương ứng
Ghi chú	Text		Cho phép nhập ý kiến nhận xét, ý kiến bổ sung	Thể hiện thông tin nhận xét, hoặc ý kiến bổ sung của người đánh giá
Tổng điểm	Number	x	Tự động tính điểm theo công thức: Tổng điểm = Điểm quy đổi tiêu chí 1 + điểm quy đổi tiêu chí 2+….+ điểm quy đổi tiêu chí n	Thể hiện tổng số điểm mà nhà cung cấp đạt được sau các tiêu chí

Page tree

Versions Compared

Old Version 23

New Version Current

Key

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

1. Headers

2. Request

3. Response / Incoming Data Specification

1. Headers

2. Body

2. Request body

3. Response / Incoming Data Specification

1. Headers

2. Request body

3. Response / Incoming Data Specification

1. Headers

2. Param

3. Response / Incoming Data Specification

1. Headers

2. Request body

3. Response / Incoming Data Specification

STT	Field	Required	Data Type / Length	Description
1	potId	true	Integer
2	approvalNote	true	String	ghi chú phê duyệt
3	status	true	Integer	trạng thái (mặc định giá trị = 2)
4	attachments	true	String	file đính kèm

STT	Field	Data Type / Length	Description	Note
1	code	Integer	0: thành công, != 0 thất bại	Danh sách code báo lỗi: 116: "Lĩnh vực và loại đánh giá bị trùng với Thang điểm: %s. Vui lòng kiểm tra lại!" 117: "Mã thang điểm bị trùng với Thang điểm: %s. Vui lòng kiểm tra lại!" 118: "Mã thang điểm, lĩnh vực và loại đánh giá bị trùng với Thang điểm: %s. Vui lòng kiểm tra lại!" 119: "Mã thang điểm bị trùng với Thang điểm: %s. Lĩnh vực và loại đánh giá bị trùng với Thang điểm: %s. Vui lòng kiểm tra lại!" 500: "Lỗi hệ thống. Chi tiết: %s"
2	message	String	message trả về
3	result	Object	Object
4	(result) id	Integer	Id thang điểm
5	(result) code	String	mã thang điểm
6	(result) name	String	Tên thang điểm
7	(result) evaluationType	Integer	loại đánh giá
8	(result) fieldId	Integer	id lĩnh vực
9	(result) inputFormId	Integer	id bảng nhập liệu

	-Không cho phép thêm mới/sửa/xóa dữ liệu	Mã định danh duy nhất của thang điểm
2	Tên thang điểm

Trường/nút chức năng	Kiểu dữ liệu	Bắt buộc	ID	Cấu hình
Chỉ tiêu đánh giá	Văn bản	x	criteriaid
Tiêu chuẩn	Văn bản		criterion
Thang điểm	Số nguyên		scale
Điểm đánh giá	Số thập phân		point	Lấy 2 số sau dấu phẩy
Trọng số (%)	Số thập phân	x	weight	Lấy 2 số sau dấu phẩy Tính tổng trọng số của cột tại ô cuối cùng của cột (dòng Tổng giá trị)
Điểm quy đổi	Số thập phân		conversion	Lấy 2 số sau dấu phẩy Công thức: conversion =<point>* <weight>/100 Tính tổng điểm quy đổi của cột tại ô cuối cùng của cột (dòng Tổng giá trị)
Ghi chú	Văn bản		note

Trường dữ liệu	Kiểu dữ liệu	Bắt buộc	Quy định	Mô tả
Mã thang điểm	Text	x	Chỉ xem	-Mã định danh duy nhất của thang điểm
Tên thang điểm	Text	x	- Giới hạn 50 ký tự	Tên hiển thị của thang điểm
Biểu mẫu thang điểm	Droplist	x	- Cho phép chọn mã biểu mẫu thang điểm đã tạo từ màn hình Tab Bảng nhập liệu trong mục Quản lý bảng nhập liệu tại danh mục Cài đặt - Khi tạo thang điểm, người dùng cần chọn đúng thang điểm có mã btddgncc từ danh sách mã biểu mẫu màn hình Tab Bảng nhập liệu trong mục Quản lý bảng nhập liệu tại danh mục Cài đặt	Thể hiện tên của biểu mẫu thang điểm đã tạo(grid)
Loại đánh giá	Droplist	x	-Cho phép chọn 1 trong 3 loại đánh giá ứng với mỗi lĩnh vực kinh doanh, không cho phép người dùng được chọn lại

với lĩnh vực XDCB -> lần 2 chỉ được phép chọn đánh giá lần đầu của của lĩnh vực CNTT
Nút đóng "X"	Button	Khi nhấn → đóng popup, quay lại màn hình trước.	Thể hiện nút chức năng cho phép đóng pop-up
Nút áp dụng	Button	Check các trường bắt buộc Check trùng mã thang điểm Check trùng đồng thời thỏa mãn trường lĩnh vực và trường loại đánh giá => Khi trùng các trường thang điểm hệ thống sẽ hiện pop up cảnh báo trùng → chọn nút thoát hiển thị về màn hình thêm mới loại thang điểm VD: lần 1 tạo mã thang điểm A Loại đánh giá lần đầu trong lĩnh vực XDCB → Hệ thống cho lưu Lần 2 tạo mã thang điểm B, loại đánh giá lần đầu lĩnh vực XDCB → hệ thống không cho lưu do đã có thang điểm loại đánh giá lần đầu cho lĩnh vực XDCB tạo ở lần 1	Lưu thông tin loại dự án.
Nút hủy	Button		Đóng pop-up vào không lưu thông tin