Versions Compared

Old Version 47

changes.mady.by.user Nguyễn Thanh Vân

Saved on

compared with

New Version Current

changes.mady.by.user datnt9

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

Tên, Chức danhHọ và tên

Nguyễn Thanh Vân

Vũ Thị Mơ



Tài khoản email/MS team

vannt4

movt2



Chức danh

Business Analyst (BA)

Business Analyst Business (BA BIZ)



Ngày soạn thảo

 




 




Jira Link

[BPMKVH-4665] Tích hợp SAP - Quản lý thông tin kế hoạch mua sắm - Jira

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

...

  1. Tôi muốn quản lý danh sách kế hoạch mua sắm bao gồm các thông tin:
    1. Nguồn dữ liệu: SAP hoặc BPM
    2. Dự án: Mã- Tên dự án
    3. Mã hạng mục
    4. Tên hạng mục
    5. Hạng mục cha: Mã - Tên
    6. Level
    7. Số tiền FS ban đầu
    8. Ngân sách khoán
    9. Số tiền đã dùng
    10. Số tiền còn lại 
    11. Ngày bắt đầu
    12. Ngày kết thúc
  2. Tôi muốn tìm kiếm được theo Mã-Tên hạng mục
  3. Tôi muốn lọc theo:
    1. Dự án
    2. Hạng mục cha
    3. Số tiền FS: Từ- Đến
    4. Ngân sách khoán: Từ- Đến
    5. Ngày bắt đầu: Từ ngày- Đến ngày
    6. Ngày kết thúc: Từ ngày- Đến ngày
  4. Tôi muốn xem được thông tin chi tiết hạng mục ngân sách của các dự án đã được đồng bộ từ SAP về bao gồm các thông tin:
    1. Nguồn dữ liệu: Mặc định "SAP"
    2. Dự án: Mã- Tên dự án
    3. Mã hạng mục
    4. Tên hạng mục
    5. Mã hạng Hạng mục cha
    6. Level
    7. Số tiền FS ban đầu
    8. Ngân sách khoán
    9. Số tiền đã dùng
    10. Số tiền còn lại 
  5. Tôi muốn thông tin không được đồng bộ về sẽ được chỉnh sửa bao gồm:
    1. Ngày bắt đầu
    2. Ngày kết thúc
  6. Tôi muốn Thêm mới/Chỉnh sửa/Xóa/Xem chi tiết được kế hoạch mua sắm chủ động tại BPM chi tiết tại User Story -02- Tạo mới/Điều chỉnh kế hoạch mua sắm dự án
  7. Tôi muốn danh mục được phân quyền theo các chức năng  tương tự các danh mục khác
TTTên trườngMô tảSap fieldLoại dữ liệuĐộ dàiBắt buộcGhi chú
1Mã dự án
Project definitionCHAR24Bắt buộc
2Mã hạng mục
WBS elementCHAR24Bắt buộc

Key so sánh khi insert, update

3Tên hạng mục
DescriptionCHAR40Bắt buộc
4Mã hạng mục cha
WBS element upCHAR24Bắt buộc

5LevelDanh sách mã wbs ( level 3 đến level 4 mục 1.4)Level CHAR2Bắt buộc
6Số tiền FS ban đầu 
Cost planCURR15Bắt buộc
Ngân sách FS - Tổng mức đầu tư ban đầu
7Ngân sách khoán
Budget CURR15
 Ngân sách khoán
8Số tiền đã dùng
Số đã dùngCURR15
Là số tiền theo hợp đồng đã ký hoặc theo số thanh quyết toán. Ưu tiên lấy theo số thanh quyết toán
9Số tiền còn lại 
Số còn lại CURR15Bắt buộc
Theo ngân sách khoán - Chỉ theo dõi báo cáo, không chặn

...

3.1.3. Màn hình pop-up "Xem chi tiết hạng mục" - Hạng mục được đồng bộ từ SAP

Image RemovedImage Added

3.1.4. Màn hình pop-up "Chỉnh sửa hạng mục" - Hạng mục được đồng bộ từ SAP

Image RemovedImage Added


3.2. Luồng:

  • Activity Diagram:

...

Sample Values
Panel
titleAPI Spec Document

Method

POST

URL

application/procurementPlan/deleteBatch

Description

API xóa batch

Note

API mới

1. Headers

STT

Path

Field

Data Type / Length

Description

Note

STTSTT 

Field

Source Data Type / Length 

Description

Sample Values

2. Body

1authorizationStringTokenBearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjYzOTgyNDUsInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.qRoaRDxjqyWS-3Az_ZqLmR0KAcPTM7jXggW1Ja5wpEc

2. Request body

STT

Field

Required

Data Type / Length

Description

Note

1List<Object>false
danh sách request
2projfalseStringMã SAP dự án
3wbsfalseStringmã kế hoạch mua sắm
4descrpfalseStringtên kế hoạch mua sắm
5

wbs_up

falseStringmã kế hoạch cha
6

level

falseStringlevel
7
costplan
falseString
số tiền FS ban đầu

8
budget
falseString
Ngân sách khoán

9
amount_th
falseString
Số tiền đã dùng

10
amount_cl
falseString
Số tiền còn lại

3. Response / Incoming Data Specification

STT

Field

Data Type / Length

Description

Note

1codeInteger0: thành công, != 0 thất bại
2messageString

Panel
titleAPI Spec Document

Method

POST

URL

application/procurementPlan/sync

Description

API đồng bộ kế hoạch mua sắm

Note

API mới

1. Headers

STT 

Field

Source Data Type / Length 

Description

Sample Values

1authorizationStringTokenBearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjYzOTgyNDUsInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.qRoaRDxjqyWS-3Az_ZqLmR0KAcPTM7jXggW1Ja5wpEc

2. Request body

STT

Field

Required

Data Type / Length

Description

Note

1List<Object>false
danh sách request
2projfalseStringMã SAP dự án
3wbsfalseStringmã kế hoạch mua sắm
4descrpfalseStringtên kế hoạch mua sắm
5

wbs_up

falseStringmã kế hoạch cha
6

level

falseStringlevel
7
costplan
falseString
số tiền FS ban đầu

8
budget
falseString
Ngân sách khoán

9
amount_th
falseString
Số tiền đã dùng

10
amount_cl
falseString
Số tiền còn lại

3. Response / Incoming Data Specification

STT

Field

Data Type / Length

Description

Note

1codeInteger0: thành công, != 0 thất bại
2messageString

Panel
titleAPI Spec Document

Method

DELETE

URL

application/procurementPlan/delete

Description

API xóa kế hoạch mua sắm

Note

API mới

1. Headers

STT 

Field

Source Data Type / Length 

Description

Sample Values

1authorizationStringTokenBearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjYzOTgyNDUsInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.qRoaRDxjqyWS-3Az_ZqLmR0KAcPTM7jXggW1Ja5wpEc

2. Request body

STT

Field

Required

Data Type / Length

Description

Note

1

id

falseIntegerid kế hoạch mua sắm

3. Response / Incoming Data Specification

STT

Field

Data Type / Length

Description

Note

1codeInteger0: thành công, != 0 thất bại
2messageString

Panel
titleAPI Spec Document

Method

POST

URL

application/procurementPlan/list

Description

API Lấy danh sách kế hoạch mua sắm

Note

API mới

1. Headers

STT 

Field

Source Data Type / Length 

Description

Sample Values

1authorizationStringTokenBearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjYzOTgyNDUsInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.qRoaRDxjqyWS-3Az_ZqLmR0KAcPTM7jXggW1Ja5wpEc

2. Request body

STT

Field

Required

Data Type / Length

Description

Note

1keywordfalseStringtên hoặc mã kế hoạch mua sắm
2pagefalseIntegerTrang dữ liệu (phân trang)
3limitfalseIntegerSố bản ghi mỗi trang
4

projectCode

falseStringMã dự án
5

projectId

falseStringid dự án
6

parentCode

falseStringmã kế hoạch cha
7

initialFsAmountFrom

falseIntegerSố tiền FS (từ)
8

initialFsAmountTo

falseIntegerSố tiền FS (đến)
9

allocatedBudgetFrom

falseIntegerNgân sách khoán (từ)
10

allocatedBudgetTo

falseIntegerNgân sách khoán (đến)
11

startDateFromStr

falseStringNgày bắt đầu (từ)Định dạng yyyy-mm-dd
12

startDateToStr

falseStringNgày  bắt đầu (đến)
13

endDateFromStr

falseStringNgày kết thúc (từ)
14

endDateToStr

falseStringNgày kết thúc (đến)
15

onlyLeaf

falseBooleantrue: chỉ lấy các bản ghi không có con

3. Response / Incoming Data Specification

STT

Field

Data Type / Length

Description

Note

1codeInteger0: thành công, != 0 thất bại
2messageString


resultList<Object>


(result) pageIntegertrang bao nhiêu

(result) totalIntegersố lượng bản ghi

(result) itemsList<Object>danh sách bản ghi

(items) idIntegerid 

(items) allocatedBudgetBigDecimalNgân sách khoán

(items) codeString mã kế hoạch

(items) createdTimeTimestampthời gian tạo

(items) employeeIdIntegerngười tạo

(items) endDateTimestampngày kết thúc

(items) initialFsAmountBigDecimalSố tiền fs

(items) levelIntegerlevel

(items) nameString tên

(items) parentCodeString mã kế hoạch cha

(items) parentNameString Tên kế hoạch cha

(items) projectCodeStringmã dự án

(items) projectNameString tên dự án

(items) remainingAmountString số tiền còn lại

(items) sourceString nguồn dữ liệu.

(items) startDateString ngày bắt đầu

(items) updatedTimeString thời gian cập nhật

(items) endDateIntegerngày kết thúc

(items) usedAmountString số tiền đã sử dụng
Panel
titleAPI Spec Document

Method

PUT

URL

application/procurementPlan/update

Description

API cập nhật kế hoạch mua sắm

Note

API mới

1. Headers

STT 

Field

Source Data Type / Length 

Description

Sample Values

1authorizationStringTokenBearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjYzOTgyNDUsInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.qRoaRDxjqyWS-3Az_ZqLmR0KAcPTM7jXggW1Ja5wpEc

2. Request body

STT

Field

Required

Data Type / Length

Description

Note

1

name

falseStringtên kế hoạch mua sắm
2

code

falseIntegermã kế hoạch
3

source

falseIntegernguồn dữ liệu
4

projectCode

falseStringMã dự án
5

parentCode

falseStringmã kế hoạch cha
6

level

falseIntegerlevel
7

initialFsAmount

falseIntegerSố tiền FS
8

allocatedBudget

falseIntegerNgân sách khoán
9

usedAmount

falseIntegersố tiền đã sử dụng
10

remainingAmount

falseIntegersố tiền còn lại
11

startDate

falseStringNgày bắt đầuĐịnh dạng yyyy-mm-dd
12

endDate

falseStringNgày kết thúc
13

id

trueInteger

3. Response / Incoming Data Specification

STT

Field

Data Type / Length

Description

Note

1codeInteger0: thành công, != 0 thất bại
2messageString



Panel
titleAPI Spec Document

Method

POST

URL

application/procurementPlan/insert

Description

API thêm mới kế hoạch mua sắm

Note

API mới

1. Headers

STT 

Field

Source Data Type / Length 

Description

Sample Values

1authorizationStringTokenBearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjYzOTgyNDUsInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.qRoaRDxjqyWS-3Az_ZqLmR0KAcPTM7jXggW1Ja5wpEc

2. Request body

STT

Field

Required

Data Type / Length

Description

Note

1

name

falseStringtên kế hoạch mua sắm
2

code

falseIntegermã kế hoạch
3

source

falseIntegernguồn dữ liệu
4

projectCode

falseStringMã dự án
5

parentCode

falseStringmã kế hoạch cha
6

level

falseIntegerlevel
7

initialFsAmount

falseIntegerSố tiền FS
8

allocatedBudget

falseIntegerNgân sách khoán
9

usedAmount

falseIntegersố tiền đã sử dụng
10

remainingAmount

falseIntegersố tiền còn lại
11

startDate

falseStringNgày bắt đầuĐịnh dạng yyyy-mm-dd
12

endDate

falseStringNgày kết thúc

3. Response / Incoming Data Specification

STT

Field

Data Type / Length

Description

Note

Sample Values

1codeInteger0: thành công, != 0 thất bại
2messageString

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

...


Field

(Trường dữ liệu)

Type

(Kiểu dữ liệu)

Required

(Bắt buộc)

Validation

(Quy định)

Description

(Mô tả)

1

Nguồn dữ liệu

Văn bản (Text)

Bắt buộc

Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa).

Thể hiện nguồn dữ liệu của hạng mục với giá trị: "SAP"

2

Dự án

Văn bản (Text)

Bắt buộc

- Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa).

- Dữ liệu được lấy theo giá trị của trường "PROJ" đồng bộ từ SAP.

Thể hiện mã - tên dự án của hạng mục

3Mã hạng mục

Văn bản (Text)

Bắt buộc

- Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa).

- Dữ liệu được lấy theo giá trị của trường "WBS" đồng bộ từ SAP.

Thể hiện mã của hạng mục

4Tên hạng mục

Văn bản (Text)

Bắt buộc

- Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa).

- Dữ liệu được lấy theo giá trị của trường "DESCRP" đồng bộ từ SAP.

Thể hiện tên của hạng mục

5Hạng mục cha

Văn bản (Text)

Bắt Không bắt buộc

- Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa).

- Dữ liệu được lấy theo giá trị của trường "WBS_UP" đồng bộ từ SAP.

Thể hiện mã - tên hạng mục cha của hạng mục

6Level

Văn bản (Text)

Bắt buộc

- Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa).

- Dữ liệu được lấy theo giá trị của trường "LEVEL" đồng bộ từ SAP.

Thể hiện level của hạng mục

7Số tiền FS ban đầu

Số (Number)

Bắt Không bắt buộc

- Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa).

- Dữ liệu được lấy theo giá trị của trường "COSTPLAN" đồng bộ từ SAP

Thể hiện số tiền FS ban đầu của hạng mục

8Ngân sách khoán

Số (Number)

Bắt Không bắt buộc

- Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa).

- Dữ liệu được lấy theo giá trị của trường "BUDGET" đồng bộ từ SAP

Thể hiện ngân sách khoán của hạng mục

9Số tiền đã dùng

Số (Number)

Bắt Không bắt buộc

- Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa).

- Dữ liệu được lấy theo giá trị của trường "AMOUNT_TH" đồng bộ từ SAP

Thể hiện số tiền đã dùng của hạng mục

10Số tiền còn lại 

Số (Number)

Bắt Không bắt buộc

- Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa).

- Dữ liệu được lấy theo giá trị của trường "AMOUNT_CL" đồng bộ từ SAP

Thể hiện số tiền còn lại của hạng mục

11Ngày bắt đầu

Thời gian (Date)

Không bắt buộc

Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa).

Thể hiện ngày bắt đầu của hạng mục

12Ngày kết thúc

Thời gian (Date)

Không bắt buộc

Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa).

Thể hiện ngày kết thúc của hạng mục

13

Nút “Hủy”/Nút Đóng “X” 

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

Không bắt buộc

Sau khi nhấn nút, hệ thống đóng pop-up và quay về giao diện trước đó

Thể hiện nút chức năng hủy bỏ thao tác xem chi tiết hạng mục và đóng pop-up

...


Field

(Trường dữ liệu)

Type

(Kiểu dữ liệu)

Required

(Bắt buộc)

Validation

(Quy định)

Description

(Mô tả)

1

Nguồn dữ liệu

Văn bản (Text)

Bắt buộc

Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa).

Thể hiện nguồn dữ liệu của hạng mục với giá trị: "SAP"

2

Dự án

Văn bản (Text)

Bắt buộc

Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa).

Thể hiện mã - tên dự án của hạng mục

3Mã hạng mục

Văn bản (Text)

Bắt buộc

Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa).

Thể hiện mã của hạng mục

4Tên hạng mục

Văn bản (Text)

Bắt buộc

Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa).

Thể hiện tên của hạng mục

5Hạng mục cha

Văn bản (Text)

Bắt Không bắt buộc

Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa).

Thể hiện mã - tên hạng mục cha của hạng mục

6Level

Văn bản (Text)

Bắt buộc

Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa).

Thể hiện level của hạng mục

7Số tiền FS ban đầu

Số (Number)

Bắt Không bắt buộc

Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa).

Thể hiện số tiền FS ban đầu của hạng mục

8Ngân sách khoán

Số (Number)

Bắt Không bắt buộc

Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa).

Thể hiện ngân sách khoán của hạng mục

9Số tiền đã dùng

Số (Number)

Bắt Không bắt buộc

Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa).

Thể hiện số tiền đã dùng của hạng mục

10Số tiền còn lại 

Số (Number)

Bắt Không bắt buộc

Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa).

Thể hiện số tiền còn lại của hạng mục

11Ngày bắt đầu

Bộ chọn ngày (Date picker)

Không bắt buộc

Cho phép chỉnh sửa dữ liệu

- Hệ thống tự động ngăn cách ngày, tháng, năm bằng dấu gạch chéo "/"

- Hệ thổng chỉ hiện thị những ngày từ quá khứ đến ngày cuối đã chọn tại trường "Đến ngày" 

- Định dạng hiển thị: DD/MM/YYYY

Thể hiện ngày bắt đầu của hạng mục

12Ngày kết thúc

Bộ chọn ngày (Date picker)

Không bắt buộc

Cho phép chỉnh sửa dữ liệu

- Hệ thống tự động ngăn cách ngày, tháng, năm bằng dấu gạch chéo "/"

- Hệ thổng chỉ hiện thị những ngày từ ngày đầu đã chon tại trường "Ngày bắt đầu" đến tương lai

- Định dạng hiển thị: DD/MM/YYYY

Thể hiện ngày kết thúc của hạng mục

13

Nút “Áp dụng” 

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

Không bắt buộc

- Nút chỉ kích hoạt khi có ít nhất 1 trường dữ liệu được chỉnh sửa

- Hệ thống kiểm tra điều kiện các trường bắt buộc

- Sau khi nhấn nút, hệ thống lưu thông tin chỉnh sửa, đóng pop-up và hiển thị toast thành công màu xanh lá: "Thành công - Cập nhât hạng mục thành công"

Thể hiện nút chức năng áp dụng chỉnh sửa thông tin hạng mục

14

Nút “Hủy”/Nút Đóng “X” 

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

Không bắt buộc

Sau khi nhấn nút, hệ thống đóng pop-up và quay về giao diện trước đó

Cho phép người dùng hủy thao tác xem chi tiết hạng mục và đóng pop-up

...