Versions Compared

Old Version 46

changes.mady.by.user Nguyễn Anh Tuấn

Saved on

compared with

New Version Current

changes.mady.by.user locnh1

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


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 Anh Tuấn

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 member

Techlead

Ngày soạn thảo/phê duyệt

 


26.06.2025


Jira Ticket

[BSHKVH-1049] Màn hình danh sách gói thầu (Site đấu 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 quản lý tập trung các gói thầu của tôi trong 1 menu

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

  1. Phân quyền truy cập
    1. Chỉ cán bộ nhân viên tham gia vào gói thầu mới được quyền truy cập vào gói thầu
    2. Cấp quản lý được truy cập toàn bộ các gói thầu mà đơn vị đó tham gia
    3. Cán bộ nhân viên sau khi từ chối công việc sẽ không còn quyền truy cập gói thầu
  2. Hiển thị Danh sách các gói thầu với các thông tin:
    1. Mã gói thầu
    2. Tên gói thầu
    3. Tên dự án
    4. Lĩnh vực
    5. Đơn vị thụ hưởng
    6. Thời gian bắt đầu (thời gian bắt đầu hình thành công việc A1.02)
    7. Thời gian kết thúc (thời gian dự kiến Phê duyệt Báo cáo thầu A1.10)
    8. Trạng thái gói thầu:
      • Đang thực hiện 
      • Hoàn thành
      • Hủy
  3. Tìm kiếm nhanh + Bộ lọc
    1. Tìm kiếm theo
      • Tên gói thầu
      • Tên dự án
    2. Lọc nhiều điều kiện
      • Khoảng thời gian 
      • Dự án
      • Lĩnh vực
      • Đơn vị thụ hưởng
      • Trạng thái

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

3.1 UIUX:

3.1.1. Màn hình Site đấu thầu - Danh sách gói thầu

Image Modified

...


3.1.2. Màn hình Site đấu thầu - Danh sách gói thầu nếu không tìm thấy dữ liệu phù hợp → hiển thị màn hình "Ở đây chưa có gì cả. Hiện tại chưa có gói thầu nào"

Image Added


3.2 Luồng:

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

Panel
titleAPI Spec Document

Method

Get

URL

/application/purchaseRequestbidPackage/list

1. Headers

STT

Field

Source Data Type / Length 

Description

Sample Values

1authorizationStringTokenBearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjYzOTgyNDUsInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.qRoaRDxjqyWS-3Az_ZqLmR0KAcPTM7jXggW1Ja5wpEc










2. Param

STT

Field

Required

Data Type / Length

Description

Note

1namefalseStringTên gói thầu
2fieldIdfalseIntegerMã lĩnh vực
3projectIdfalseIntegerMã dự án
4statusfalseIntegerTrạng thái (0: Hủy, 1: Đang thực hiện, 2: Hoàn thành)
5departmentIdfalseIntegerMã phòng ban
6

investorId

falseIntegerMã đơn vị thụ hưởng
7processCodefalseStringMã quy trình8

startTime

falseStringThời gian bắt đầuVD:12/07/2025
98

endTime

falseStringThời gian kết thúcVD:12/07/2025
109limitfalseIntegerSố bản ghi trong trên 1 trang
1110pagefalseIntegerSố trang

3. Response / Incoming Data Specification

STT

Field

Data Type / Length

Description

Note

1idIntegerID gói thầu
2codeStringMã gói thầu 
3

name

StringTên gói thầu
4

scheduledStartTimestartTime

TimestampNgày Thời gian bắt đầu dự kiến
5

triggerStatus

IntegerTrạng thái kích hoạt6

triggerTime

endTime

TimestampThời gian kích hoạt7

pteId

Integer

ID pte (Process Task Executor)

8

fieldId

IntegerID lĩnh vực9

projectId

IntegerID dự án10kết thúc
6

status

Integer

Trạng thái (0: Hủy, 1: Đang thực hiện, 2: Hoàn thành)

11

employeeId

Integer

Người yêu cầu


12

departmentId

Integer

ID của phòng ban liên quan (Bộ phận yêu cầu)

13

nodeId

String

Mã ID của node

147

potId

Integer

ID của hồ sơ

15

processId

IntegerID của quy trình16

rootId

IntegerID của quy trình cha17

priorityLevel

Integer

Mức độ ưu tiên của hồ sơ

18

hasFile

Integer

Có đính kèm file

19

procurementTypeId

Integer

Mã hồ sơ mời thầu

20

requestId

Integer

Mã yêu cầu khởi tạo


218

pteName

StringTên pte (Process Task Executor)UserTask, ServiceTask, ...
229

fieldName

StringTên lĩnh vực
2310

projectName

StringTên dự án
2411

departmentName

StringTên phòng ban liên quan (Bộ phận yêu cầu)
2512

procurementTypeName

StringTên hồ sơ mời thầu
2613

nodeName

StringTên của node27

workId

Integer
Mã công việc2814

investorName

StringTên đơn vị thụ hưởng29

startTime

TimestampThời gian bắt đầu30endTimeTimestampThời gian kết thúc

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

...


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

Kiểu dữ liệu

Điều kiện

Quy định

Mô tả

1Mã gói thầuTextBắt buộcDữ liệu lấy tự động từ nền tảng BPM1, người dùng không được phép chỉnh sửa.

Mã định danh duy nhất của gói thầu.

2Tên gói thầuHyperlinkBắt buộc

  • Tên gói thầu mặc định hiển thị dưới dạng văn bản tĩnh. Khi người dùng di chuột qua (trạng thái hover), trường này sẽ hiển thị dưới dạng hyperlink và cho phép nhấn để điều hướng đến màn hình chi tiết gói thầu.

  • Là trường có dữ liệu được lấy tự động từ nền tảng BPM1; người dùng không được phép chỉnh sửa.
  • Chỉ hiển thị các gói thầu đã hoàn thành phê duyệt.
  • Không hiển thị các gói thầu đang ở trạng thái Lưu nháp.

Tên hiển thị của gói thầu, người dùng có thể nhấn để xem chi tiết.

3Dự ánTextKhông bắt buộcDữ liệu lấy tự động từ nền tảng BPM1, người dùng không được phép chỉnh sửa.

Tên dự án mà gói thầu thuộc về.

4Lĩnh vựcTextKhông bắt buộcDữ liệu lấy tự động từ nền tảng BPM1, người dùng không được phép chỉnh sửa.

Lĩnh vực chuyên môn của gói thầu.

5

Đơn vị thụ hưởng

Text (Dropdown)Không bắt buộcDữ liệu lấy tự động từ nền tảng BPM1, người dùng không được phép chỉnh sửa.

Tên chủ đầu tư của gói thầu.

6

Thời gian bắt đầu

DateBắt buộcDữ liệu lấy tự động từ nền tảng BPM1, người dùng không được phép chỉnh sửa.

  • Thể hiện thời điểm hoàn thành bước khởi tạo YCMS/TT Chủ trương trong bước A1.01 trong quy trình xử lý gói thầu.

  • Không lấy dữ liệu nếu yêu cầu mua sắm đang ở trạng thái lưu nháp.

  • Dữ liệu được ghi nhận cho cả các trường hợp:

    • Tạo thủ công

    • Thêm mới hàng loạt Yêu cầu mua sắm

    • Kích hoạt theo Timer (hẹn giờ)

7

Thời gian kết thúc

DateBắt buộcDữ liệu lấy tự động từ nền tảng BPM1, người dùng không được phép chỉnh sửa.

Ngày kết thúc dự là thời gian kết thúc quy trình

8Trạng tháiEnum / LabelBắt buộc


Trạng thái hiện tại của gói thầu, phản ánh tiến độ xử lý theo quy trình đấu thầu:

  • Đang thực hiện: Gói thầu đang trong quá trình triển khai
  • Hoàn thành: Gói thầu đã được phê duyệt báo cáo thầu 
  • Hủy : Gói thầu bị hủy
9Nút "Tìm kiếm"ButtonKhông bắt buộcTìm kiếm theo Contains trên Biểu tượng tìm kiếm (Kính lúp/Icon Search)Button/IconKhông bắt buộc
  • Chỉ thực hiện tìm kiếm khi ô nhập liệu có giá trị hợp l
  • Biểu tượng cho phép người dùng click vào biểu tượng để thực hiện tìm kiếm theo từ khóa đã nhập.
10Ô nhập liệu (Search Box)Textbox

Không bắt buộc

  • Cho phép nhập ký tự chữ và số

  • Hỗ trợ tìm kiếm theo 2 tiêu chí: Mã gói thầu và Tên gói thầu

  • Mã gói thầu: Không giới hạn độ dài từ khóa.

  • Tên gói thầu: Không giới hạn độ dài từ khóa.

  • Không phân biệt chữ hoa/thường

, không phân biệt dấu tiếng Việt.

  • khi tìm kiếm

  • Cho phép nhấn Enter thay cho click biểu tượng kính lúp

  • Nếu không tìm thấy dữ liệu phù hợp → hiển thị màn hình "Ở đây chưa có gì cả. Hiện tại chưa có gói thầu nào"

  • Hỗ trợ multi-keyword: AND giữa các từ (tách từ theo dấu cách).
  • Nếu ô tìm kiếm trống → hệ thống không thực hiện tìm kiếm, ô nhập liệu hiển thị placeholder “Tìm kiếm"
  • Ví dụ: nhập "Gia Lộc" → trả về các gói có chứa đồng thời "gia" và "loc" (không phân biệt hoa/thường, không phân biệt dấu) trong Mã hoặc Tên gói thầu.
  • Không giới hạn độ dài từ khóa.

    • Nút cho phép người dùng nhập từ khóa và thực hiện tìm kiếm theo Mã gói thầu hoặc Tên gói thầu.

    1011Nút "Lọc"ButtonKhông bắt buộc

    Khi người nhấn vào nút "Lọc

    • Nút mở bộ lọc để lọc danh sách theo các tiêu chí: Trạng thái, Thời gian, Lĩnh vực, Tên chủ đầu tư.
    • Người dùng có thể chọn 1 hoặc nhiều tiêu chí kết hợp.

    ...