2482_User Story - Nhân viên đánh giá gửi yêu cầu làm rõ cho nhà cung cấp

	Nghiệp vụ		IT
	Người lập	Người duyệt	Người lập	Người duyệt
Họ và tên	Nguyễn Thanh Vân	Nguyễn Đức Trung
Họ và tên	Vũ Thị Mơ	Nguyễn Đức Trung
Tài khoản email/MS team	vannt4	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	19/11/2025
Ngày soạn thảo	27/11/2025
Jira Link	BPMKVH-2482 BPMKVH-3616

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

Là nhân viên tham gia đánh giá, tôi muốn gửi được yêu cầu làm rõ cho nhà cung cấp, nhà thầu trong trường hợp cần làm rõ thông tin đối với Loại đánh giá lần đầu qua mail

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

2.1. Tại giao diện đánh giá nhà cung cấp, nhà thầu đối với Loại đánh giá lần đầu, tôi muốn tạo được thông tin yêu cầu làm rõ TRƯỚC KHI GỬI NHÂN VIÊN ĐÁNH GIÁ cho nhà thầu để nhà thầu thực hiện trả lời bao gồm các thông tin:

Yêu cầu làm rõ : Nhập tay thông tin chung
Nội dung yêu cầu làm rõ: Nhập tay
Hồ sơ đính kèm: Thêm, xóa, view tài liệu đính kèm ( Ràng buộc dưới 25MB)

2.2. Tôi muốn xem được lịch sử chi tiết thông tin yêu cầu làm rõ ở từng lần yêu cầu trên công việc

2.3. Tôi muốn hệ thống tự động gửi mail yêu cầu làm rõ cho nhà cung cấp

2.3.1. Người nhận:

Nguồn dữ liệu: Lấy thông tin của người liên hệ mặc định và cho phép chọn lại trong danh sách người liên hệ về những trường thông tin sau:
- Họ và tên
- Email: Load theo tên người liên hệ

2.3.2. Mẫu mail:

Tiêu đề: [Tên đơn vị] Yêu cầu cung cấp và làm rõ thông tin phục vụ đánh giá nhà cung cấp
Nội dung:

Kính gửi Quý [Tên nhà cung cấp],

Tôi là [Tên nhân viên], đại diện bộ phận [Tên phòng ban], [Tên đơn vị].
Hiện tại, chúng tôi đang thực hiện quy trình đánh giá và rà soát nhà cung cấp để phục vụ cho kế hoạch hợp tác trong thời gian tới.

Để hoàn thiện hồ sơ đánh giá, kính đề nghị Quý Công ty hỗ trợ cung cấp và làm rõ một số thông tin sau:

Yêu cầu làm rõ: [Yêu cầu làm rõ]

Nội dung yêu cầu làm rõ: [Nội dung yêu cầu làm rõ]

Tài liệu yêu cầu làm rõ (tài liệu đính kèm bên dưới)

Kính mong Quý Công ty gửi lại các thông tin và tài liệu nêu trên để chúng tôi có thể tiến hành đánh giá đúng tiến độ.

Trong trường hợp cần trao đổi thêm, Quý Công ty vui lòng liên hệ:

Email: [Email của nhân viên đánh giá]

SĐT: [Số điện thoại của nhân viên đánh giá]

Xin chân thành cảm ơn sự hợp tác của Quý Công ty.

Trân trọng,

<Tên nhân viên>
<Chức danh>
<Tên phòng ban>

---

[File đính kèm]

2.4. Tôi muốn tạo được nhiều yêu cầu làm rõ trong quá trình thực hiện đánh giá ncc, nhà thầu

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

3.1 UI/UX:

3.1.1 Màn hình pop-up Yêu cầu làm rõ gửi nhà cung cấp

3.1.2 Màn hình pop-up Xác nhận gửi yêu cầu làm rõ

3.1.3 Toast cảnh báo

3.1.4 Phần "Ghi chú dự án" trong màn hình Chi tiết công việc "Nhân viên đánh giá nhà cung cấp"

3.2 Luồng:

3.3 API Spec:

API Spec thêm mới YCLR

3.3.1. Thông tin API

Method	POST	URL	/application/supplierEvaluationClarification/insert
Description	API thêm mới YCLR
Note	API mới

3.3.2. Headers

STT

Field

Source Data Type / Length

Description

Sample Values

1

authorization

String

Token

Bearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjYzOTgyNDUsInVz

ZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMD

M3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIE

xpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fs

b25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUl

kXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.qRoaRDxjqyWS-3Az_ZqLmR0KAcPTM7jXggW1Ja5wpEc

3.3.2. Request body

STT	Field	Required	Data Type / Length	Description
1	potId	true	Integer	potId hồ sơ đánh giá (lấy từ quy trình)
2	contactId	true	Integer	id người liên hệ
3	processId	true	Integer	id lấy từ
4	name	true	String	tên YCLR
5	content	true	String	Nội dung YCLR
6	attachments	true	String	file đính kèm
7	contactName	true	String	tên người liên hệ
8	contactEmail	true	String	email người liên hệ
9	orgName	true	String	tên NCC

3.3.3. Response / Incoming Data Specification

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: 120: "không tìm thấy thông tin đánh giá nhà cung cấp!" 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 YCLR	id YCLR
5	(result) potId	Integer	potId hồ sơ đánh giá (lấy từ quy trình)
6	(result) suppplierEvaluationId	Integer	id hồ sơ đánh giá
7	(result) employeeId	Integer	người gửi đánh giá
8	(result) contactId	Integer	id người liên hệ
9	(result) name	String	tên YCLR
10	(result) content	String	Nội dung YCLR
11	(result) attachments	String	file đính kèm
12	(result) orgName	String	Tên NCC

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

3.4.1. Màn hình pop-up Yêu cầu làm rõ gửi nhà cung cấp:

STT	Trường dữ liệu/ Nút chức năng	Kiểu dữ liệu	Điều kiện	Độ dài kí tự	Quy định	Mô tả
1	Tên yêu cầu làm rõ	Văn bản (Text)	Bắt buộc	500	Cho phép người dùng nhập thông tin chung của yêu cầu	Thể hiện tên yêu cầu làm rõ
2	Nội dung yêu cầu làm rõ	Văn bản (Text)	Không bắt buộc	5000	Cho phép người dùng nhập thông tin chung của yêu cầu	Thể hiện nội dung yêu cầu làm rõ
3	Tài liệu đính kèm	File / Attachment	Không bắt buộc		- Cho phép người dùng đính kèm tài liệu đánh giá lên hệ thống - Cho phép người dùng xem lại tài liệu đính kèm - Cho phép người dùng tải về tài liệu đính kèm - Giới hạn kích thước tệp đính kèm: 25MB. - Hành vi hệ thống nếu tệp đính kèm quá 25MB: Hệ thống không cho phép đính kèm Hiển thị toast cảnh báo đỏ trong 3s: "Kích thước tệp tối đa 25MB"	Thể hiện Tài liệu đính kèm
4	Người liên hệ	Lựa chọn (Droplist)	Bắt buộc		- Hiển thị sẵn thông tin người liên hệ có trường "Mặc định"= "Bật" - Cho phép người dùng chọn người liên hệ của nhà cung cấp (nếu cần) - Nguồn dữ liệu: Lấy theo trường "Họ và tên người liên hệ" trong tab Người liên hệ tại Danh mục NCC thuộc phân hệ Quản lý NT/NCC	Thể hiện tên người liên hệ
5	Email	Văn bản (Text)	Không bắt buộc		- Hệ thống hiển thị sẵn thông tin người liên hệ có trường "Mặc định"= "Bật" - Cho phép người dùng chọn địa chỉ email ứng với tên người liên hệ của nhà cung cấp (nếu cần) - Nguồn dữ liệu: Lấy theo trường "Email" trong tab Người liên hệ tại Danh mục NCC thuộc phân hệ Quản lý NT/NCC dựa trên thông tin trường "Người liên hệ"	Thể hiện địa chỉ email người liên hệ của nhà cung cấp
6	Nút Gửi yêu cầu làm rõ	Nút chức năng (Button)	Không bắt buộc		- Cho phép người dùng mở pop-up "Xác nhận gửi yêu cầu làm rõ" - Pop-up "Xác nhận gửi yêu cầu làm rõ": tham chiếu mục 3.4.2. Xác nhận gửi yêu cầu làm rõ	Thể hiện nút cho phép gửi yêu cầu làm rõ
7	Nút X	Nút chức năng (Button)	Không bắt buộc		Cho phép nhấn để thoát khỏi màn hình pop-up "Yêu cầu làm rõ gửi nhà cung cấp"	Thể hiện nút chức năng cho phép thoát khỏi màn hình pop-up "Yêu cầu làm rõ gửi nhà cung cấp"

3.4.2. Màn hình pop-up Xác nhận gửi yêu cầu làm rõ:

STT

Trường dữ liệu/

Nút chức năng

Kiểu dữ liệu

Điều kiện

Quy định

Mô tả

1

Tôi chắc chắn

Nút chức năng (Button)

Không bắt buộc

- Cho phép người dùng nhấn để xác nhận gửi yêu cầu làm rõ

- Hành vi hệ thống sau khi người dùng nhấn nút "Tôi chắc chắn" như sau:

Hệ thống thực hiện gửi mail yêu cầu làm rõ cho nhà cung cấp.
Hệ thống lưu thông tin về lần yêu cầu làm rõ vào phần Ghi chú dự án tại màn hình Chi tiết công việc "Yêu cầu làm rõ gửi nhà cung cấp" và lưu vào màn hình Lịch sử đánh giá nhà cung cấp chi tiết tại 2489_User Story - Lịch sử đánh giá nhà cung cấp

Thể hiện nút chức năng cho phép người dùng xác nhận gửi yêu cầu làm rõ.

2

Hủy