| Nghiệp vụ | IT |
|---|
Người lập | Người duyệt | Người lập | Người duyệt |
Họ & Tên | Bùi Nguyệt Anh | Nguyễn Đức Trung | Nguyễn Hữu Lộc | Phạm Văn Quân |
|---|
Tài khoản email/MS Team | anhbn4 | trungnd3 | Locnh1 | Quanpv3 |
|---|
Chức danh | Business Analyst (BA) | Product Owner (P.O) | Dev | Techlead |
|---|
Ngày soạn thảo/phê duyệt | |
| 26.06.2025 |
|
|---|
Jira Ticket | [BSHKVH-1057] Màn hình Kết quả đánh giá (Chi tiết gói thầu) - Jira |
|
|
|
|---|
1. Card (Mô tả tính năng)
Là thành viên Hội đồng thầu tôi muốn xem, nhập và quản lý kết quả đánh giá hồ sơ kỹ thuật, hồ sơ tài chính của từng nhà thầu
2. Confirmation/ Acceptance Criteria (Tiêu chí nghiệm thu)
- Hiển thị màn hình kết quả đánh giá từng lần đánh giá hồ sơ dự thầu bao gồm
- Tên nhà thầu
- Phân loại hồ sơ kỹ thuật, hồ sơ tài chính
- Kết quả đánh giá của từng thành viên hội đồng thầu
- Cho phép thành viên tham gia vào gói thầu được xem kết quả đánh giá sau khi hoàn thành vòng đánh giá
- Cho phép thành viên hội đồng thầu xuất kết quả đánh giá sang file excel
3. Conversation (Mô tả chi tiết)
3.1 UIUX:
3.1.1 Màn hình Quản lý yêu cầu làm rõ
...
| Panel |
|---|
|
Method | GET | URL | <DOMAIN>/application/v2/documentEvaluation/getResult |
|---|
Description | API Danh sách kết quả đánh giá hồ sơ kỹ thuật |
|---|
Note | Đã có api cũ, nhưng hiện tại chưa chia rõ theo round. Cần làm api mới để chia theo round
→ Tạo api mới |
|---|
1. Headers STT | Field | Source Data Type / Length | Description | Sample Values |
|---|
| authorization | String | Token | Bearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjYzMDk1MTgsInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6 puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.UGz8TQudVxEd7rp_rsLXePraHELTRWHyc7iXNvVnn14 |
2. PARAMSTT | Field | Required | Data Type / Length | Description | Note |
|---|
| 1 | packageId | true | Integer | id gói thầu |
|
| round | true | Integer | Số lần |
|
3. Response / Incoming Data Specification| STT | Field | Data Type / Length | Description | Note | Sample Values |
|---|
| reviewerResponseList | List<ReviewerResponse> | Danh sách người phản hồi đánh giá | public class ReviewerResponse {
private Integer employeeId;
private String employeeName;
} |
|
| reviewerResponseList.employeeId | Integer | Id người phản hồi |
|
|
| reviewerResponseList.employeeName | String | Tên người phản hồi |
|
|
| evaluationDataResponseList | private List<EvaluationDataResponse> | Danh sách đánh giá dữ liệu phản hồi | public class EvaluationDataResponse {
private OrganizationResponse organizationResponse;
private List<EvaluationScoreResponse> evaluationScoreResponseLst;
} |
|
| evaluationDataResponseList.organizationResponse | OrganizationResponse | Phản hồi nhà thầu | public class OrganizationResponse {
private Integer organizationId;
private String organizationName;
} |
|
| evaluationDataResponseList.organizationResponse.organizationId | Integer | Id nhà thầu |
|
|
| evaluationDataResponseList.organizationResponse.organizationName | String | Tên nhà thầu |
|
|
| evaluationDataResponseList.evaluationScoreResponseLst | List<EvaluationScoreResponse> | Điểm đánh giá Phản hồi | public class EvaluationScoreResponse {
private Integer employeeId;
private Integer totalQualifiedQuantity;
private Integer totalDocument;
private Integer submittedDocumentId;
private Integer postion;
} |
|
| evaluationDataResponseList.evaluationScoreResponseLst.employeeId | Integer | Id người đánh giá |
|
|
| evaluationDataResponseList.evaluationScoreResponseLst.totalQualifiedQuantity | Integer | Tổng số lượng đủ điều kiện |
|
|
| evaluationDataResponseList.evaluationScoreResponseLst.totalDocument | Integer | Tổng số điều kiện |
|
|
| evaluationDataResponseList.evaluationScoreResponseLst.submittedDocumentId | Integer | Id tài liệu đã submit |
|
|
| evaluationDataResponseList.evaluationScoreResponseLst.postion | Integer | Chức vụ |
|
|
Method | GET | URL | <DOMAIN>/application/v2/documentEvaluation/getFinances |
|---|
Description | API Danh sách kết quả đánh giá Hồ sơ tài chính |
|---|
Note | Đã có api cũ, nhưng hiện tại chưa chia rõ theo round. Cần làm api mới để chia theo round
→ Tạo api mới |
|---|
1. Headers STT | Field | Source Data Type / Length | Description | Sample Values |
|---|
| authorization | String | Token | Bearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjYzMDk1MTgsInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6 puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.UGz8TQudVxEd7rp_rsLXePraHELTRWHyc7iXNvVnn14 |
2. PARAMSTT | Field | Required | Data Type / Length | Description | Note |
|---|
| 1 | packageId | true | Integer | id gói thầu |
|
| round | true | Integer | Số lần |
|
3. Response / Incoming Data Specification| STT | Field | Data Type / Length | Description | Note | Sample Values |
|---|
| code | Integer | code |
|
|
| message | String | message |
|
|
| result | List | Danh sách kết quả |
|
|
| result[?].organizationName | String | tên tổ chức |
|
|
| result[?].position | Integer | vị trí đánh giá |
|
|
| result[?].organizationId | Integer |
|
|
|
| result[?].employeeId | Integer |
|
|
|
| result[?].employeeName | String |
|
|
|
Method | GET | URL | <DOMAIN>/application/v2/documentEvaluation/sendEvaluation |
|---|
Description | API Gửi kết quả phản hồi |
|---|
Note | Đã có api cũ, nhưng hiện tại chưa chia rõ theo round. Cần làm api mới để chia theo round
→ Tạo api mới |
|---|
1. Headers STT | Field | Source Data Type / Length | Description | Sample Values |
|---|
| authorization | String | Token | Bearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjYzMDk1MTgsInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6 puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.UGz8TQudVxEd7rp_rsLXePraHELTRWHyc7iXNvVnn14 |
2. BodySTT | Field | Required | Data Type / Length | Description | Note |
|---|
| 1 | packageId | true | Integer | id gói thầu |
|
| round | true | Integer | Số lần |
|
| extensionHistory | true | Object |
|
|
| extensionHistory.attachments |
| String | file |
|
| extensionHistory.newTime |
| Timestamp | Thời gian nộp thầu lần tiếp theo |
|
| extensionHistory.note |
| String | Ghi chú |
|
| extensionHistory.oldTime |
| Timestamp |
|
|
| extensionHistory.packageId |
| Integer | id gói thầu |
|
3. Response / Incoming Data Specification| STT | Field | Data Type / Length | Description | Note | Sample Values |
|---|
| code | Integer | code |
|
|
| message | String | message |
|
|
| result | List | Danh sách kết quả |
|
|
| result[?].organizationId | Integer | tên tổ chức |
|
|
| result[?].id | Integer | vị trí đánh giá |
|
|
| result[?].note | String |
|
|
|
| result[?].attachments | String |
|
|
|
| result[?].position | Integer |
|
|
|
| result[?].evaluationStatus | Integer |
|
|
|
| result[?].employeeId | Integer |
|
|
|
| result[?].createdTime | Timestamp |
|
|
|
| result[?].documentDetailId | Integer |
|
|
|
| result[?].contactId | Integer |
|
|
|
| result[?].userId | Integer |
|
|
|
| result[?].packageId | Integer |
|
|
|
| result[?].packageName | String |
|
|
|
| result[?].projectId | Integer |
|
|
|
| result[?].projectName | String |
|
|
|
| result[?].projectAddress | String |
|
|
|
| result[?].employeeName | String |
|
|
|
| result[?].projectName | String |
|
|
|
| result[?].submittedDocumentId | Integer |
|
|
|
|
...
