Versions Compared

Old Version 41

changes.mady.by.user Mai Kiều Mi

Saved on

compared with

New Version Current

changes.mady.by.user Vũ Thị Mơ

Saved on

Key

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

...

  1. Tại màn hình Danh sách dự án, bổ sung thêm trường
    1. Nguồn dữ liệu: Phân biệt dữ liệu là dữ liệu đồng bộ về từ SAP hay tạo mới tại BPM
  2. Tôi muốn tìm kiếm được theo tên dự án
  3. Tôi muốn lọc được theo:
    1. Nguồn dữ liệu
    2. Tỉnh thành phố
    3. Phường xã
    4. Chủ đầu tư
    5. Trạng thái
  4. Tôi muốn hiển thị được thông tin dự án được đồng bộ từ SAP về BPM, màn hình Xem chi tiết
    1. Nguồn dữ liệu: Mặc định "SAP"
    2. Loại dự án: Hiển thị Tên loại dự án
    3. Mã dự án
    4. Tên dự án
    5. Tỉnh thành phố: Nhập tại BPM
    6. Phường Xã: Nhập tại BPM
    7. Địa chỉ: Lấy thông tin Địa chỉ+ Phường xã+ Tỉnh thành
    8. Chủ đầu tư: Hiển thị Tên chủ đầu tư 
    9. Quy mô dự án 
    10. Trạng thái
      1. Hiển thị active với trạng thái nhận về là 
        1. REL1 :Chuẩn bị triển khai
        2. REL2 : Đang triển khai
      2. Hiển thị inactive với trạng thái nhận về là
        1. REL3: Dự án hoàn thành
        2. REL4: Dự án hủy
  5. Tôi muốn các dự án được đồng bộ về sẽ không được chỉnh sửa các thông tin đồng bộ, cho phép chỉnh sửa các thông tin khác của dự án không đồng bộ về bao gồm:
    1. Phòng ban quản lý
    2. Tỉnh thành
    3. Phường xã
    4. Dự án bàn giao cơ quan nhà nước: : Khi đồng bộ thông tin từ SAP về mặc định là Có và cho phép sửa
  6. Tôi muốn chủ động tạo mới, chỉnh sửa, xem chi tiết, xóa được thông tin dự án với các dự án không quản lý tại SAP: VD: Dự án thương mại dịch vụ, CNTT,... 
    1. Nguồn dữ liệu: Mặc định " BPM"
    2. Loại dự án: Chọn theo tên loại dự án trong danh mục loại dự án
    3. Mã dự án
    4. Tên dự án
    5. Tỉnh thành phố
    6. Phường Xã
    7. Địa chỉ
    8. Chủ đầu tư: chọn theo tên chủ đầu tư trong danh mục chủ đầu tư
    9. Phòng ban quản lý
    10. Dự án bàn giao cơ quan nhà nước
    11. Quy mô dự án
    12. Trạng thái
  7. Hệ thống cảnh báo và chặn trong trường hợp tạo mới trùng mã dự án với dự án đang tồn tại trong danh mục
  8. Tôi muốn khi đồng bộ dự án từ SAP về BPM trùng mã dự án tại BPM, dữ liệu sẽ được update theo dữ liệu của SAP và Nguồn dữ liệu sẽ cập nhật thành "SAP"

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

3.1 UIUX:

3.2 Luồng:

  • Activity Diagram:
  • Sequence Diagram:
  • Flowchart: 

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

...

titleAPI Spec Document

...

Method

...

URL

1. Headers

...

STT

...

Field

...

Source Data Type / Length 

...

Description

...

Sample Values

2. Body

...

STT

...

Path

...

Field

...

Data Type / Length

...

Description

...

Note

...

4.1 Bổ sung trường trong màn hình danh sách danh mục dự án

Image Added

3.4.2 Bổ sung trường trong Màn hình pop-up tạo mới

Image Added

3.4.3 Màn hình xem chi tiết dự án 

Image Added

3.4.4. Màn hình pop-up chỉnh sửa

3.4.4.1 Màn hình pop-up chỉnh sửa nguồn dữ liệu là BPM

Image Added

3.4.4.2 Màn hình pop-up chỉnh sửa nguồn dữ liệu là SAP

Image Added

3.4.5 Màn hình pop-up bộ lọc

Image Added

3.2 Luồng:

  • Activity Diagram:


  • Sequence Diagram:


  • Flowchart: 


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

Panel
titleAPI Import danh sách hợp đồng

Method

GET

URL

/application/projectRealty/list

Description

API danh mục dự án

Note

API cũ

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ừ khóa tìm kiếm theo tên dự án
2pagefalseIntegerTrang dữ liệu (phân trang)
3sizefalseIntegerSố bản ghi mỗi trang
4sourcefalseStringNguồn dữ liệu
5cityIdfalseIntegerthành phố
6districtIdfalseIntegerphường xã
7investorIdfalseIntegerid chủ đầu tư
8statusfalseIntegertrạng thái

3. Response / Incoming Data Specification

STT

Field

Data Type / Length

Description

Note

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

3resultObject[]

4itemsList<Object>Danh sách dự án
5(items) idIntegerid
6(items) addressStringđịa chỉ
7(items) cityIdIntegerid thành phố
8(items) cityNameStringtên thành phố
9(items) codeStringmã dự án
10(items) departmentIdIntegerid phòng ban
11(items) departmentNameStringtên phòng ban
12(items) districtIdIntegerid quận huyện

(items) districtNameStringquận huyện

(items) cityNameStringtên thành phố

(items) investorIdIntegerid chủ đầu tư

(items) investorNameStringchủ đầu tư

(items) isHandoverProjectInteger

dự án bàn giao cơ quan nhà nước




(items) nameStringtên dự án

(items) pclIdIntegerid loại dự án

(items) pclNameStringloại dự án

(items) sourceStringnguồn dữ liệu

(items) statusIntegertrạng thái

(items) subdistrictIdStringid  xã phường

(items) subdistrictNameStringtên xã phường

(items) totalAreaIntegerquy mô dự án
Panel
titleAPI Spec Document

Method

POST

URL

/application/projectRealty/update

Description

API cập nhật/ thêm mới dự án

Note

API cũ

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

1addressfalseStringđịa chỉ
2idfalseIntegerid dự án
3cityIdfalseIntegerid thành phố
4codefalseStringmã dự án
5departmentIdfalseIntegerid phòng ban
6districtIdfalseIntegerphường xã
7investorIdfalseIntegerid chủ đầu tư
8isHandoverProjectfalseIntegercó phải dự án bàn giao cơ quan nhà nước không

namefalseStringtên dự án

pclIdfalseIntegerid loại dự án

sourcefalseStringnguồn dữ liệu

statusfalseStringtrạng thái

totalAreafalseStringquy mô dự án

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:

...


Trường dữ liệu

Kiểu dữ liệu

Bắt buộc

Quy định

Mô tả

1

Nguồn dữ liệu

Văn bản (Text)Bắt buộc
  • Không cho người dùng thêm/sửa/xóa dữ liệu
Thể hiện nguồn dữ liệu dự án
2

Mã dự án


Văn bản (Text)Bắt buộc
  • Cho phép chỉnh sửa dữ liệu

Thể hiện mã dự án

3

Tên dự án


Văn bản (Text)Bắt buộc
  • Cho phép chỉnh sửa dữ liệu
Thể hiện tên/ mô tả dự án
4

Tỉnh thành phố


Lựa chọn (Drop list)Không bắt buộc
  • Cho phép chỉnh sửa dữ liệu
Thể hiện tên tỉnh thành phố của dự án


5

Phường Xã


Lựa chọn (Drop list)Không bắt buộc
  • Cho phép chỉnh sửa dữ liệu
Thể hiện tên phường xã của dự án
6

Địa chỉ


Văn bản (Text)Bắt buộc
  • Cho phép chỉnh sửa dữ liệu
Thể hiện tên địa chỉ của dự án
7

Loại dự án

Lựa chọn (Drop list)Không bắt buộc
  • Cho phép chỉnh sửa dữ liệu
Thể hiện tên loại của dự án
8

Chủ đầu tư

Lựa chọn (Drop list)Không bắt buộc
  • Cho phép chỉnh sửa dữ liệu
Thể hiện tên chủ đầu tư của dự án
9Phòng/ban quản lýLựa chọn (Drop list)Không bắt buộc
  • Cho phép chỉnh sửa dữ liệu
Thể hiện thông tin dự án có thuộc dự án bàn giao cơ quan nhà nước
10Dự án bàn giao cơ quan nhà nướcLựa chọn (Drop list)Bắt buộc
  • Cho phép chỉnh sửa dữ liệu
Thể hiện thông tin dự án có thuộc dự án bàn giao cơ quan nhà nước
11

Quy mô dự án

Văn bản (Text)Không bắt buộc
  • Cho phép chỉnh sửa dữ liệu
Thể hiện quy mô của dự án
12

Trạng thái

Nút công tắc (Toggle)Không bắt buộc
  • Cho phép chỉnh sửa dữ liệu
Thể hiện trạng thái hoạt động/không hoạt động của dự án
13Nút đóng "X"Nút chức năng (Button)Không bắt buộc

- Cho phép người dùng nhấn để hủy bỏ thao tác chỉnh sửa đơn 1 hợp đồng.
- Khi nhấn, màn hình pop-up "Chỉnh sửa dự án" đóng lại và hệ thống điều hướng về màn hình "Danh mục dự án"

Thể hiện nút đóng cho phép hủy bỏ thao tác chỉnh sửa đơn 1 dự án.
14Nút "Áp dụng"Nút chức năng (Button)Không bắt buộc

- Cho phép nhấn để lưu thông tin chỉnh sửa 

- Khi nhấn hệ thống tiến hành xác nhận dữ liệu khi chỉnh sửa như sau:

  • Điều kiện:

    • Tất cả các trường bắt buộc được nhập đầy đủ.

    • Mã dự án không trùng với bất kỳ bản ghi nào đang có trong hệ thống.

  • Hành vi hệ thống khi nhấn nút "Áp dụng":
    • Hệ thống hiển thị thông báo thành công.
      • Tiêu đề thông báo: Thành công
      • Nội dung thông báo: Cập nhật dự án thành công

Thể hiện nút đóng cho phép lưu thông tin dự án

15Nút "Hủy"Nút chức năng (Button)Không bắt buộc

- Cho phép người dùng nhấn để hủy bỏ thao tác chỉnh sửa đơn 1 dự án.
- Khi nhấn, màn hình pop-up "Chỉnh sửa dự án" đóng lại và hệ thống điều hướng về màn hình "Danh mục dự án

Thể hiện nút "Hủy" để hủy bỏ thao tác chỉnh sửa đơn 1 dự án.

3.4.4.2 3.4.4.1 Màn hình pop-up chỉnh sửa nguồn dữ liệu là SAP

...