View Source

	Nghiệp vụ		IT
	Người lập	Người duyệt	Người lập	Người duyệt
Họ và tên	Bùi Nguyệt Anh	Nguyễn Đức Trung
Họ và tên	Vũ Thị Mơ	Nguyễn Đức Trung
Tài khoản email/MS team	anhbn4	trungnd3
Tài khoản email/MS team	movt2	trungnd3
Chức danh	Business Analyst (BA)	Product Owner (P.O)
Chức danh	Business Analyst Business (BA BIZ)	Product Owner (P.O)
Ngày soạn thảo	10 Dec 2025
Ngày soạn thảo	04 Dec 2025
Jira Link	[BPMKVH-2399] Đề xuất thông tin nhà thầu tại màn hình lựa chọn nhà thầu - Jira

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

Là thư ký hội đồng thầu, tôi muốn hệ thống đề xuất thông tin nhà thầu dựa trên lịch sử mua hàng

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

2.1. Tại màn hình Thư ký HĐT lập KHLCNT & Danh sách nhà thầu, tôi muốn hệ thống lấy dữ liệu từ danh mục nhà cung cấp và hiển thị được đề xuất theo gói thầu:

Danh sách những trường thông tin chi tiết của nhà cung cấp và nhà thầu cần thu thập gồm:
- Mã nhà thầu
- Tên nhà thầu
- Ngày ký kết gần nhất
- Tên gói thầu gần nhất
- Điểm số
- Xếp hạng
- Đề xuất
Điều kiện lấy lấy thông tin Danh sách nhà thầu đề xuất bao gồm:
- Điều kiện 1: Trạng thái nhà cung cấp/nhà thầu đang active
- Điều kiện 2: Lĩnh vực của gói thầu thuộc list Lĩnh vực của NCC
- Điều kiện 3: Theo xếp hạng nhà cung cấp: Nhà cung cấp có điểm trung bình từ cao xuống thấp

STT	Trường thông tin	Kiểu dữ liệu	Quy định	Mô tả
1	Danh sách nhà thầu đề xuất	Label		Vùng thông tin danh sách nhà thầu đề xuất
2	Số lượng nhà thầu đề xuất	Textbox	Number	Nhập số lượng nhà thầu cần đề xuất
3	TT	Grid-Number		Số thứ tự tự sinh
4	Mã nhà thầu	Grid- Text		Hiển thị thông tin mã nhà thầu
5	Tên nhà thầu	Grid- Text		Hiển thị thông tin tên nhà thầu
6	Ngày ký kết gần nhất	Grid- Text		Hiển thị thông tin ngày ký kết gần nhất của nhà thầu ký kết
7	Tên gói thầu gần nhất	Grid- Text		Hiển thị thông tin tên gói thầu gần nhất của nhà thầu ký kết
8	Điểm số	Grid- Text		Hiển thị thông tin điểm số của nhà thầu theo đợt đánh giá gần nhất
9	Xếp hạng	Grid- Text		Hiển thị thông tin xếp hạng của nhà thầu theo đợt đánh giá gần nhất
10	Đề xuất	Grid- Text		Hiển thị thông tin đề xuất nhà thầu theo đợt đánh giá gần nhất
11	Chọn	Button		Cho phép chọn thông tin từ Danh sách nhà thầu đề xuất xuống danh sách nhà thầu

2.2. Tôi muốn chọn được số lượng nhà cung cấp cần đề xuất

2.3. Tôi muốn chọn được nhà cung cấp, nhà thầu xuống danh sách nhà thầu

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

3.1 UI/UX:

3.1.1. Màn hình

3.1.1.1. Màn hình Danh sách nhà thầu đề xuất trống

BPM1- số hóa khối vận hành > 2399 - User Story - Đề xuất thông tin nhà thầu tại màn hình lựa chọn nhà thầu > image-2026-1-15_10-5-45.png

3.1.1.2. Màn hình Danh sách nhà thầu đề xuất

BPM1- số hóa khối vận hành > 2399 - User Story - Đề xuất thông tin nhà thầu tại màn hình lựa chọn nhà thầu > image-2026-1-16_10-17-11.png

3.1.1.3. Màn hình pop-up Bộ lọc

a. Màn hình bộ lọc

b. Màn hình bộ lọc khi không có kết quả lọc

BPM1- số hóa khối vận hành > 2399 - User Story - Đề xuất thông tin nhà thầu tại màn hình lựa chọn nhà thầu > image-2026-1-15_15-49-6.png

3.1.2. Thông báo (toast) khi thêm nhà thầu từ danh sách nhà thầu đề xuất thành công

BPM1- số hóa khối vận hành > 2399 - User Story - Đề xuất thông tin nhà thầu tại màn hình lựa chọn nhà thầu > image-2026-1-15_15-45-52.png

3.2 Luồng:

3.3 API Spec:

3.3.1. Thông tin API

Method	GET	URL	/application/organization/listOrganizationsRecommend

3.3.2. Headers

STT	Field	Source Data Type / Length	Description	Sample Values
1	authorization	String	Token	Bearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjYzOTgyNDUsInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.qRoaRDxjqyWS-3Az_ZqLmR0KAcPTM7jXggW1Ja5wpEc

3.3.3. Param

STT	Field	Required	Data Type / Length
1	potId	true	Integer
2	organizationName	false	String
3	packageName	false	String
4	fromValue	false	String - Patern(YYYY_MM_DD_HH_MM_SS)
5	toValue	false	String - Patern(YYYY_MM_DD_HH_MM_SS)
6	limit	true	Integer
7	signedAtFrom	false	BigDecimal
8	signedAtTo	false	BigDecimal

3.3.4. Response / Incoming Data Specification

STT	Field	Data Type / Length	Description
1	id	Integer	Mã nhà cung cấp
2	latestEvaluationScore	BigDecimal	Điểm đánh giá gần nhất
3	latestEvaluationGrade	StringXê	Xếp hạng đánh giá gần nhất
4	latestSignedAt	String	Ngày kí kết hợp đồng gần nhất
5	latestContractName	String	Tên hợp đồng (gói thầu) gần nhất

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

3.4.1. Màn hình bảng Danh sách nhà thầu đề xuất trống

STT

Trường thông tin/

Nút chức năng

Kiểu dữ liệu

Điều kiện

Quy định

Mô tả

1

Ô Số lượng nhà thầu đề xuất

Nút chức năng

(Button)

Không bắt buộc

- Cho phép người dùng nhập số lượng nhà thầu cần hệ thống đề xuất theo gói thầu là số nguyên dương.

- Sau khi người dùng nhập giá trị và nhấn nút Tìm kiếm (STT2 ) hoặc nhấn Enter, hệ thống tự động lấy dữ liệu nhà thầu nhà thầu đề xuất với thứ tự điểm trung bình từ cao xuống thấp.

- Nguồn dữ liệu: Kết quả đánh giá NT/NCC ở trạng thái đang hoạt động(active) gần nhất theo cặp loại đánh giá - lĩnh vực.

- US Lịch sử đánh giá nhà cung cấp: 2489_User Story - Lịch sử đánh giá nhà cung cấp

- Thể hiện ô nhập liệu cho phép người dùng nhập số lượng nhà thầu cần hệ thống đề xuất theo gói thầu

- Gía trị gợi ý (placeholder): Nhập số lượng nhà thầu đề xuất

2

Nút Áp dụng

Nút chức năng

(Button)

Không bắt buộc

- Cho phép người dùng nhấn để thực hiện tìm kiếm danh sách nhà thầu đề xuất theo số lượng nhà thầu đã nhập (STT 1).

- Sau khi người dùng nhấn nút hệ thống thực hiện, hệ thống tự động lấy dữ liệu nhà thầu nhà thầu đề xuất với thứ tự điểm trung bình từ cao xuống thấp.

- Nguồn dữ liệu: Kết quả đánh giá NT/NCC gần nhất theo cặp loại đánh giá - lĩnh vực.

- US đánh giá nhà thầu/nhà cung cấp: 2366 - Đánh giá nhà cung cấp, nhà thầu

Thể hiện nút chức năng cho phép người dùng kích hoạt việc hiển thị danh sách nhà thầu đề xuất số lượng nhà thầu đã nhập (STT 1).

3

Văn bản hiển thị

Văn bản (Text)

Không bắt buộc

Không cho phép thêm mới/sửa/xóa dữ liệu

- Thể hiện văn bản hướng dẫn

- Nội dung văn bản cảnh báo: "Ở đây chưa có gì cả

Vui lòng nhập số lượng nhà thầu đề xuất."

3.4.2. Màn hình bảng Danh sách nhà thầu đề xuất

STT	Trường thông tin/Nút chức năng	Kiểu dữ liệu	Điều kiện	Quy định	Mô tả
1	Ô Số lượng nhà thầu đề xuất	Nút chức năng (Button)	Không bắt buộc	- Cho phép người dùng nhập số lượng nhà thầu cần hệ thống đề xuất theo gói thầu là số nguyên dương. - Sau khi người dùng nhập giá trị và nhấn nút Tìm kiếm (STT2 ) hoặc nhấn Enter, hệ thống tự động lấy dữ liệu nhà thầu nhà thầu đề xuất với thứ tự điểm trung bình từ cao xuống thấp. - Nguồn dữ liệu: Kết quả đánh giá NT/NCC ở trạng thái đang hoạt động(active) gần nhất theo cặp loại đánh giá - lĩnh vực. - US Lịch sử đánh giá nhà cung cấp: 2489_User Story - Lịch sử đánh giá nhà cung cấp	- Thể hiện ô nhập liệu cho phép người dùng nhập số lượng nhà thầu cần hệ thống đề xuất theo gói thầu - Gía trị gợi ý (placeholder): Nhập số lượng nhà thầu đề xuất
2	Nút Áp dụng	Nút chức năng (Button)	Không bắt buộc	- Cho phép người dùng nhấn để thực hiện tìm kiếm danh sách nhà thầu đề xuất theo số lượng nhà thầu đã nhập (STT 1). - Sau khi người dùng nhấn nút hệ thống thực hiện, hệ thống tự động lấy dữ liệu nhà thầu nhà thầu với giao diện như sau: Hiển thị danh sách nhà thầu đề xuất đúng theo số lượng đã áp dụng sắp xếp theo điểm trung bình từ cao xuống thấp. Ưu tiên hiển thị nhà thầu theo Lĩnh vực chính của gói thầu. - Nguồn dữ liệu: Quản lý danh mục → Danh mục Nhà cung cấp → Màn hình Thông tin chung NCC, bao gồm: Trường Lĩnh vực chính Trường Lĩnh vực phụ - US Thông tin chung NCC: 3325 - User Story - Thông tin chung NCC	Thể hiện nút chức năng cho phép người dùng kích hoạt việc hiển thị danh sách nhà thầu đề xuất số lượng nhà thầu đã nhập (STT 1).
3	Mã nhà thầu	Văn bản (Text)	Không bắt buộc	Không cho phép thêm mới/sửa/xóa dữ liệu	Thể hiện mã định danh duy nhất của nhà thầu trong hệ thống.
4	Tên nhà thầu	Văn bản (Text)	Không bắt buộc	Không cho phép thêm mới/sửa/xóa dữ liệu	Thể hiện tên nhà thầu trên hệ thống.
5	Ngày ký kết gần nhất	Ngày (Date)	Không bắt buộc	- Không cho phép thêm mới/sửa/xóa dữ liệu - Nguồn dữ liệu: Lấy lấy giá trị Ngày ký hợp đồng gần nhất của nhà thầu từ phân hệ Quản lý hợp đồng, tại Màn hình Thông tin giao dịch → Tab Hợp đồng → Trường “Ngày ký hợp đồng”. - US màn hình Thông tin giao dịch → Tab Hợp đồng: Tham chiếu tài liệu 2322 - User Story - Cập nhật thông tin hợp đồng vào thông tin nhà cung cấp	Thể hiện ngày ký kết hợp đồng gần nhất.
6	Tên gói thầu gần nhất	Văn bản (Text)	Không bắt buộc	- Không cho phép thêm mới/sửa/xóa dữ liệu - Nguồn dữ liệu: Lấy giá trị Tên hợp đồng gần nhất từ phân hệ Quản lý hợp đồng → Màn hình Thông tin giao dịch → Tab Hợp đồng → Trường “Tên hợp đồng”. - US màn hình Thông tin giao dịch → Tab Hợp đồng: Tham chiếu tài liệu 2322 - User Story - Cập nhật thông tin hợp đồng vào thông tin nhà cung cấp	Thể hiện tên gói thầu/hợp đồng được ký kết gần nhất.
7	Điểm số	Văn bản (Text)	Không bắt buộc	- Không cho phép thêm mới/sửa/xóa dữ liệu - Nguồn dữ liệu: Lấy giá trị điểm đánh giá của nhà thầu từ phân hệ Quản lý NT/NCC → Danh mục NCC → Lịch sử đánh giá nhà cung cấp → Trường “Điểm đánh giá”. - US Lịch sử đánh giá nhà cung cấp: 2489_User Story - Lịch sử đánh giá nhà cung cấp	Thể hiện điểm số được đánh giá trong lần gần nhất của nhà thầu
8	Xếp hạng	Văn bản (Text)	Không bắt buộc	- Không cho phép thêm mới/sửa/xóa dữ liệu - Nguồn dữ liệu: Lấy giá trị Xếp hạng gần nhất của nhà thầu từ phân hệ Quản lý danh mục → Danh mục Xếp hạng → Trường “Xếp hạng”. - US Xếp hạng, đề xuất nhà cung cấp nhà thầu: 3804 - User Story - Xếp hạng, đề xuất nhà cung cấp nhà thầu v1 (tạo mới) mục 3.4.4.1 Bảng thông tin xếp hạng xem chi tiết	Thể hiện thứ tự xếp hạng của nhà thầu.
9	Đề xuất	Văn bản (Text)	Không bắt buộc	- Không cho phép thêm mới/sửa/xóa dữ liệu - Nguồn dữ liệu: Lấy giá trị đề xuất gần nhất của nhà thầu từ phân hệ Quản lý danh mục → Danh mục Nhà cung cấp → Màn hình Thông tin chung NCC → Trường “Lĩnh vực chính” và Trường “Lĩnh vực phụ”. - US Thông tin chung NCC: 3325 - User Story - Thông tin chung NCC	Thể hiện đề xuất tương ứng với số điểm xếp loại đạt được.
10	Nút Chọn	Nút chức năng (Button)	Không bắt buộc	- Cho phép người dùng nhấn Chọn để thêm nhà thầu không bị trùng từ danh sách đề xuất vào KHLCNT/Danh sách nhà thầu. - Hành vi hệ thống khi người dùng nhấn Chọn: Hệ thống thêm mới 01 dòng nhà thầu vào Danh sách nhà thầu KHLCNT. Hệ thống tự động hiển thị đầy đủ các cột thông tin theo cấu hình danh sách. Hiển thị thông báo (toast): Tiêu đề: Thành công Nội dung: Thêm nhà thầu vào danh sách thành công - Hành vi hệ thống khi người dùng xóa nhà thầu khỏi DSNT: Hệ thống xóa dòng bản ghi của nhà thầu tương ứng khỏi Danh sách nhà thầu (DSNT). Đồng thời, hệ thống thêm lại nhà thầu vừa bị xóa vào Danh sách nhà thầu đề xuất.	Thể hiện nút chức năng cho phép chọn đơn 1 nhà thầu từ danh sách đề xuất để đưa vào KHLCNT/Danh sách nhà thầu.
11	Nút Chọn tất cả	Nút chức năng (Button)	Không bắt buộc	- Cho phép người dùng nhấn để Chọn tất cả nhà thầu từ danh sách đề xuất để đưa vào KHLCNT/Danh sách nhà thầu; các nhà thầu đã tồn tại sẽ không được thêm lại. - Sau khi người dùng nhấn Chọn tất cả, hành vi hệ thống như sau: Hệ thống thêm mới các dòng nhà thầu tương ứng vào Danh sách nhà thầu KHLCNT (mỗi nhà thầu tương ứng 01 dòng). Tự động hiển thị đầy đủ các cột thông tin theo cấu hình danh sách. Hiển thị thông báo (toast): Tiêu đề: Thành công Nội dung: Thêm nhà thầu vào danh sách thành công	Thể hiện nút chức năng cho phép chọn tất cả nhà thầu từ danh sách đề xuất để đưa vào KHLCNT/Danh sách nhà thầu.
12	Phân trang	Nút chức năng (Button)	Không bắt buộc	- Thành phần phân trang hiển thị dữ liệu theo 10 bản ghi trên mỗi trang. - Cho phép người dùng nhấn vào số trang (Trang trước / Trang sau) để chuyển trang.	Thể hiện thành phần phân trang cho phép người dùng chuyển đổi giữa các trang dữ liệu trong danh sách bằng cách nhấn vào số trang.

3.4.3. Pop-up Bộ lọc

STT	Trường thông tin/Nút chức năng	Kiểu dữ liệu	Điều kiện	Quy định	Mô tả
1	Mã nhà thầu	Lựa chọn (Select)	Không bắt buộc	- Cho phép người dùng chọn mã nhà thầu để lọc danh sách nhà thầu đề xuất. - Nguồn dữ liệu: những bản ghi thuộc màn hình Danh sách nhà thầu đề xuất - Hành vi hệ thống khi thực hiện lọc như sau: Trường hợp 1: Người dùng chọn Mã nhà thầu: Khi nhấn nút "Áp dụng", hệ thống lọc danh sách hợp đồng theo Mã nhà thầu đã nhập Trường hợp 2: Người dùng không chọn giá trị nhà cung cấp: Khi nhấn nút "Áp dụng", hệ thống không lọc danh sách hợp đồng theo trường Mã nhà thầu.	- Thể hiện trường để thực hiện lọc theo mã định danh duy nhất của nhà thầu trong hệ thống. - Hiển thị theo định dạng: Mã nhà thầu – Tên nhà thầu
2	Tên gói thầu gần nhất	Văn bản (Text)	Không bắt buộc	- Cho phép người dùng nhập tên nhà thầu để lọc danh sách nhà thầu đề xuất. - Nguồn dữ liệu: những bản ghi thuộc màn hình Danh sách nhà thầu đề xuất - Hành vi hệ thống khi thực hiện lọc như sau: Trường hợp 1: Người dùng nhập Tên gói thầu gần nhất: Khi nhấn nút "Áp dụng", hệ thống lọc danh sách hợp đồng theo Mã nhà thầu đã nhập Trường hợp 2: Người dùng không chọn giá trị nhà cung cấp: Khi nhấn nút "Áp dụng", hệ thống không lọc danh sách hợp đồng theo trường Tên gói thầu gần nhất.	Thể hiện trường để thực hiện lọc theo Tên gói thầu gần nhất
3	Điểm số	Lựa chọn (Select)	Không bắt buộc	- Cho phép người dùng chọn khoảng điểm số để lọc danh sách nhà thầu đề xuất theo khoảng điểm. - Nguồn dữ liệu: những bản ghi thuộc màn hình Danh sách nhà thầu đề xuất - Hành vi hệ thống khi thực hiện lọc như sau: Trường hợp 1: Người dùng nhập khoảng Điểm số Khi nhấn nút Áp dụng, hệ thống lọc danh sách nhà thầu đề xuất và chỉ hiển thị các nhà thầu có Điểm số nằm trong khoảng đã nhập. Trường hợp 2: Người dùng không nhập giá trị Điểm số Khi nhấn nút Áp dụng, hệ thống không thực hiện lọc theo tiêu chí Điểm số và giữ nguyên dữ liệu hiện tại.	- Thể hiện trường để thực hiện lọc theo Điểm số - Hiển thị dưới dạng 02 trường khoảng giá trị: Từ điểm – Đến điểm
4	Ngày ký kết gần nhất	Bộ chọn ngày (Date picker)	Không bắt buộc	- Cho phép người dùng nhấn để chọn giá trị ngày cho 2 trường: Từ ngày và Đến ngày. - Hành vi hệ thống khi người dùng chọn giá trị như sau: Trường hợp 1: Người dùng chọn giá trị thời gian ký: Khi nhấn nút "Áp dụng", hệ thống lọc danh sách nhà thầu theo khoảng thời gian kí kết hợp đồng gần nhất đã chọn. Trường hợp 2: Người dùng không chọn giá trị thời gian ký: Khi nhấn nút Áp dụng, hệ thống không thực hiện lọc theo tiêu chí Điểm số và giữ nguyên dữ liệu hiện tại.	Thể hiện thời gian ngày ký hợp đồng gần nhất gồm 2 trường: Từ ngày và Đến ngày dùng để lọc hợp đồng theo ngày kí kết hợp đồng gần nhất
5	Nút X	Nút chức năng (Button)	Không bắt buộc	- Cho phép người dùng nhấn để hủy bỏ thao tác lọc. - Khi nhấn, màn hình pop-up "Bộ lọc" đóng lại.	Thể hiện nút X để thoát khỏi màn hình pop-up bộ lọc
6	Nút Áp dụng	Nút chức năng (Button)	Không bắt buộc	- Cho phép người dùng nhấn để áp dụng những tiêu chí lọc đã chọn. - Hành vi hiển thị kết quả hệ thống khi người dùng nhấn nút "Áp dụng" như sau: Trường hợp 1: Không chọn bất kỳ tiêu chí lọc nào: Hệ thống vẫn cho phép người dùng nhấn nút “Áp dụng”. Sau khi nhấn, hệ thống đóng pop-up nhưng không thực hiện lọc. Màn hình "Danh sách nhà thầu đề xuất" vẫn giữ nguyên dữ liệu như trước khi thao tác. Không hiển thị bất kỳ thông báo lỗi hay cảnh báo nào. Trường hợp 2: Chọn một hoặc nhiều tiêu chí lọc: Hệ thống vẫn cho phép người dùng nhấn nút “Áp dụng”. Sau khi nhấn, hệ thống đóng pop-up và thực hiện lọc theo toàn bộ các tiêu chí mà người dùng đã chọn. Màn hình "Danh sách nhà thầu đề xuất" được cập nhật và hiển thị theo đúng những tiêu chí người dùng chọn đã chọn.	Thể hiện nút áp dụng tiêu chí lọc được chọn
7	Nút Đặt lại	Nút chức năng (Button)	Không bắt buộc	- Cho phép người dùng nhấn để đặt lại tất cả tiêu chí lọc về trạng thái mặc định ban đầu. - Hành vi hệ thống khi người dùng nhấn nút "Đặt lại" như sau: Toàn bộ các trường trên màn hình pop-up "Bộ lọc" sẽ được chuyển về giá trị mặc định ban đầu. Màn hinh pop-up "Bộ lọc" vẫn được giữ trạng thái mở để người dùng có thể tiếp tục thao tác.	Thể hiện nút đặt lại tất cả tiêu chí lọc về trạng thái mặc định ban đầu.