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 Tiến Đạt

Phạm Văn Quân

Tài khoản email/MS Team

anhbn4

trungnd3


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-1053] Màn hình Kế hoạch lựa chọn nhà thầu (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 Kế hoạch lựa chọn nhà thầu & danh sách nhà thầu được đề xuất

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

  1. Hiển thị Kế hoạch lựa chọn nhà thầu
  2. Hiển thị Danh sách nhà thầu được đề xuất
  3. Thành viên hội đồng thầu có thể xuất dữ liệu ra bảng excel

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

3.1 UIUX:

3.2 Luồng:

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

Method

GET

URL

application/document/detail/list

Description

API lấy dữ liệu file đính kèm và ghi chú

Note

API mới

1. Headers

STT

Field

Source Data Type / Length 

Description

Sample Values

1authorization<token>Token của người dùng đăng nhậpBearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjY0NTU3ODksInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.wrvIFd-Q2kHgkTmPf6ryMY6aDIgXpNsWmSvvifQWc5k

2. Request

STT

Field

Require

Data Type / Length

Description

Note

Sample Values

1potIdtrueIntegerid hồ sơ

3. Response / Incoming Data Specification

STT

Field

Data Type / Length

Description

Note

Sample Values

1codeInteger0: thành công còn lại thất bại

2messageStringmessage

3resultList<Object>kết quả trả ra

4(result) idIntegerid

5(result) potIdIntegerid hồ sơ

6(result) fieldNameString

attachments: kế hoạch lựa chọn nhà thầu, attachTenders: Danh sách nhà thầu,

note: Ghi chú phần kế hoạch lựa chọn nhà thầu

noteTenders: Ghi chú phần danh sách nhà thầu


7(result) documentTypeString


8(result) dataStringdữ liệu

attachments + attachTenders: list json,

note + noteTenders: json


Method

GET

URL

application/artifactGrid/get

Description

API lấy dữ liệu header và data

Note

API mới

1. Headers

STT

Field

Source Data Type / Length 

Description

Sample Values

1authorization<token>Token của người dùng đăng nhậpBearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjY0NTU3ODksInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.wrvIFd-Q2kHgkTmPf6ryMY6aDIgXpNsWmSvvifQWc5k

2. Request

STT

Field

Require

Data Type / Length

Description

Note

Sample Values

1potIdtrueIntegerid hồ sơ

3. Response / Incoming Data Specification

STT

Field

Data Type / Length

Description

Note

Sample Values

1codeInteger0: thành công còn lại thất bại

2messageStringmessage

3resultList<Object>kết quả trả ra

4(result) idIntegerid

5(result) potIdIntegerid hồ sơ

6(result) fileNameString
khlcnt: khách hàng lựa chọn nhà thầu, dsnt: danh sách nhà thầu
7(result) documentTypeString


8(result) dataStringDữ liệu data grid

10(result) dataHeaderStringdữ liệu header

Method

POST

URL

application/document/update

Description

API lưu thông tin ghi chú và file đính kèm KHLCNT, DSNT

Note

API mới

1. Headers

STT

Field

Source Data Type / Length 

Description

Sample Values

1authorization<token>Token của người dùng đăng nhậpBearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjY0NTU3ODksInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.wrvIFd-Q2kHgkTmPf6ryMY6aDIgXpNsWmSvvifQWc5k

2. Request

STT

Field

Require

Data Type / Length

Description

Note

Sample Values

1potIdtrueIntegerid hồ sơ

2nodeIdtrueString


3notefalseStringGhi chú của KHLCNT

4noteTendersfalseStringGhi chú của DSNT

5attachmentsfalseStringFile đính kèm của KHLCNT

6attachTendersfalseStringFile đính kèm của DSNT

3. Response / Incoming Data Specification

STT

Field

Data Type / Length

Description

Note

Sample Values

1codeInteger0: thành công còn lại thất bại

2messageStringmessage

4. Mô tả các trường dữ liệu trên màn hình Tab Kế hoạch lựa chọn nhà thầu (Chi tiết gói thầu)

Màn hình kế hoạch lựa chọn nhà thầu được mở cho phép người dùng nhấn khi hoàn thành bước lập kế hoạch lựa chọn nhà thầu (hoàn thành bước được cấu hình là khlcnt)

Màn hình kế hoạch lựa chọn nhà thầu là một đối tượng phân quyền tại chức năng: Quản lý người dùng > Quản lý cơ sở > Danh sách phòng ban > Cấu hình phân quyền

Với Site đấu thầu là chức năng cha và "Kế hoạch lựa chọn nhà thầu" là chức năng con với quyền Xem: hiển thị menu và cho phép xuất excel

STT

Trường/Nút chức năng

Kiểu dữ liệu

Bắt buộc

Quy định

Mô tả

Bảng chi tiết kế hoạch lựa chọn nhà thầu 
1Bảng dữ liệu kế hoạch lựa chọn nhà thầuiFrame
Không cho phép sửa xóa dữ liệu

Dữ liệu kế hoạch lựa chọn nhà thầu được lấy từ bước được cấu hình "khlcnt" lần gần nhất

2Xuất dữ liệu excelButton

Chức năng cho phép người dùng xuất dữ liệu kế hoạch lựa chọn nhà thầu ra excel

3Ghi chúText area
Không cho phép sửa xóa dữ liệu

Dữ liệu kế hoạch lựa chọn nhà thầu được lấy từ bước được cấu hình "khlcnt" lần gần nhất

Cho phép cấu hình node nào trong quy trình được lấy dữ liệu này

4Tệp đính kèmiFrame
Cho phép xem, tải về tài liệu đính kèm

Dữ liệu kế hoạch lựa chọn nhà thầu được lấy từ bước được cấu hình "khlcnt" lần gần nhất

Cho phép cấu hình node nào trong quy trình được lấy dữ liệu này

Bảng chi tiết danh sách nhà thầu
1Bảng chi tiết danh sách nhà thầuiFrame
Không cho phép sửa xóa dữ liệu

Dữ liệu danh sách nhà thầu được lấy từ bước được cấu hình DSNT lần gần nhất

2Xuất dữ liệu excelButton

Chức năng cho phép người dùng xuất dữ liệu danh sách nhà thầu ra excel

3Ghi chúText area
Không cho phép sửa xóa dữ liệu

Dữ liệu kế hoạch lựa chọn nhà thầu được lấy từ bước được cấu hình "dsnt" lần gần nhất

Cho phép cấu hình node nào trong quy trình được lấy dữ liệu này

4Tệp đính kèmiFrame

Dữ liệu kế hoạch lựa chọn nhà thầu được lấy từ bước được cấu hình "dsnt" lần gần nhất

Cho phép cấu hình node nào trong quy trình được lấy dữ liệu này