Nghiệp vụ

IT

Người lập

Người duyệt

Người lập

Người duyệt

Tên, Chức danh





Ngày ký





Jira Link


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

Tôi muốn đồng bộ được thông tin dự án từ SAP về BPM

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

  1. Tôi muốn đồng bộ được thông tin dự án khi Tạo mới/Chỉnh sửa của các dự án đầu tư xây dựng cơ bản tại SAP về BPM
    1. Mã loại dự án ( Danh mục)
    2. Mã dự án
    3. Tên dự án
    4. Tỉnh thành phố
    5. Phường Xã
    6. Địa chỉ
    7. Chủ đầu tư ( Danh mục chủ đầu tư)
    8. Quy mô dự án (Diện tích)
    9. Trạng thái
  2. Tôi muốn cấu hình được tần suất cập nhật theo thời gian
  3. Tôi muốn chủ động cập nhật thủ công được thông tin khi có nhu cầu
  4. Tôi muốn quản lý được lịch sử đồng bộ danh mục dự án
    1. Thời gian băt đầu
    2. Thời gian kết thúc
    3. Người đồng bộ
    4. Trạng thái
    5. Mã lỗi
    6. Mô tả lỗi
  5. Tôi muốn lọc được thông tin lịch sử đồng bộ theo
    1. Ngày: Từ- Đến
    2. Người đồng bộ
    3. Trạng thái
    4. Mã lỗi
TTTên trườngMô tảLoại dữ liệuĐộ dàiBắt buộcGhi chú
1Mã loại dự ánDanh mục cố định
A: Star (Thấp tầng)
B: Khu công nghiệp
C: Cao tầng
F: Sojo
W: Dự án CNTT		CHAR5
SAP: Danh mục Loại dự án: Mã ,Tên, Chỉ XDCB, ít thay đổi
BPM: Danh mục có Mã, tên, Trạng thái và chia nhỏ theo Hạ tầng, Giao thông,...
2Mã dự án
CHAR24Bắt buộc
3Tên dự án
CHAR40Bắt buộc
4Tỉnh thành phố
CHAR50

5Phường Xã
CHAR50

6Địa chỉ


Bắt buộc
8Chủ đầu tư Danh mục BPM đồng bộ theo SAP CHAR4
Danh mục chủ đầu tư: Mã chủ đầu tư, Mã số thuế, Tên, Địa chỉ, BPM thêm mới theo đúng mã của SAP
9Quy mô dự án ( Diện tích)
QUAN13

10Trạng tháiREL1 :Chuẩn bị triển khai
REL2 : Đang triển khai
REL3: Dự án hoàn thành
REL4: Dự án hủy		CHAR4

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

3.1 UIUX:

3.4.1. Màn hình danh sách tích hợp thông tin dự án (SAP)


3.4.2. Màn hình pop-up "Bộ lọc" 


3.4.3. Nút cấu hình tích hợp danh mục dự án


3.4.4. Pop-up xác nhận đồng bộ ngay 


3.4.5. Pop-up chi tiết mã lỗi



3.2 Luồng:


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

Method


URL


1. Headers

STT

Field

Source Data Type / Length 

Description

Sample Values






2. Body

STT

Path

Field

Data Type / Length

Description

Note

Sample Values















3. Response / Incoming Data Specification

STT

Field

Data Type / Length

Description

Note

Sample Values




















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

3.4.1. Màn hình danh sách tích hợp thông tin dự án (SAP)


Field

(Trường dữ liệu)

Type

(Kiểu dữ liệu)

Required

(Bắt buộc)

Validation

(Quy định)

Description

(Mô tả)

1

STT

Số (Number)
  • Hệ thống tự động gán STT theo thời gian đồng bộ gần nhất: giao dịch đồng bộ gần nhận STT nhỏ hơn, giao dịch đồng bộ gần xa hơn nhận STT lớn hơn.
  • 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 thứ tự các bản ghi lịch sử đồng bộ màn hình "Tích hợp thông tin dự án"

2Thời gian bắt đầuThời gian (date-time)
  • Hệ thống Tự động lấy dữ liệu khi hệ thống bắt đầu việc đồng bộ thông tin

Thể hiện thời gian bắt đầu đồng bộ thông tin dự án

3Thời gian kết thúcThời gian (date-time)
  • Hệ thống Tự động lấy dữ liệu khi hệ thống kết thúc việc đồng bộ thông tin

Thể hiện thời gian kết thúc đồng bộ thông tin dự án

4Người đồng bộVăn bản (Text)
  • Trường hợp 1: Hệ thống tự đồng bộ thông tin người đồng bộ là hệ thống
  • Trường hợp 2: Người dùng thao tác đồng bộ,  cho phép lấy thông tin trong mục danh sách nhân viên (Cài đặt cơ sở/Danh sách nhân viên)

Thể hiện thông tin người đồng bộ dự án

5Trạng tháiVăn bản (Text)
  • Thể hiển trạng thái đồng bộ thông tin dự án

+ Thành công: khi cập nhật thông tin thành công

+ Thất bại: khi cập nhật thông tin xảy ra lỗi

+ Đang thực hiện: khi hệ thống đang thực hiện cập nhật thông tin

Thể hiển trạng thái đồng bộ thông tin dự án

6Mã lỗiVăn bản (Text)
  • Cho phép người dùng nhấn xuất hiện pop-up xem chi tiết lỗi. Chi tiết 3.4.5
  • Thể hiện mã lỗi hệ thống quy định trả về với trạng thái thất bại

Thể hiện mã lỗi hệ thống trả về khi đồng bộ thất bại

7

Nút lọc

Nút chức năng (Button)
  • Cho phép người dùng nhấn để mở ra màn hình pop-up "Bộ lọc"
  • -Màn hình pop-up "Bộ lọc": tham chiếu mục 3.4.2. Màn hình pop-up "Bộ lọc".

Thể hiện nút chức năng bộ lọc

8Nút cấu hìnhNút chức năng (Button)
  • Cho phép người dùng nhấn chọn cấu hình tần suất đồng bộ thông tin. Khi nhấn mở ra màn hình chi tiết 3.4.3

Mở màn hình cấu hình tích hợp/cấu hình lịch đồng bộ

9Nút đồng bộ ngayNút chức năng (Button)
  • Cho phép người dùng nhấn khi muốn đồng bộ dự liệu ngay lập tức. Khi nhấn sẽ xuất hiện pop-up xác nhận. Chi tiết 3.4.4

Thể hiện đồng bộ dữ liệu ngay lập tức theo thời gian hiện tại

3.4.2. Màn hình pop-up "Bộ lọc" 


Field

(Trường dữ liệu)

Type

(Kiểu dữ liệu)

Required

(Bắt buộc)

Validation

(Quy định)

Description

(Mô tả)

1Tiêu đề bộ lọcNhãn hiệu (Label)

Thể hiển thị tiêu đề popup “Bộ lọc”
2Khoảng thời gianNgày tháng năm (date)Không bắt buộc
  • Cho phép người dùng chọn khoảng thời gian từ ngày đến ngày đồng bộ dự án
Thể hiện thời gian lọc từ ngày đến ngày 
3

Người đồng bộ

Lựa chọn (Droplist)Không bắt buộc

Hệ thống lấy ra từ list danh sách

  • Trường hợp 1: Hệ thống tự đồng bộ thông tin người đồng bộ là hệ thống
  • Trường hợp 2: Người dùng thao tác đồng bộ,  cho phép lấy thông tin trong mục danh sách nhân viên (Cài đặt cơ sở/Danh sách nhân viên)

Thể hiện người thực hiện đồng bộ thông tin dự án

4

Trạng thái

Lựa chọn (Droplist)Không bắt buộc
  • Cho phép người dùng chọn giá trị trạng thái tương ứng:

+ Thành công

+ Thất bại

+ Đang thực hiện

+ Tất cả (Khi người dùng không chọn sẽ để mặc định)

Thể hiện trạng thái đồng bộ dự án

5

Mã lỗi

Văn bản (Text)Không bắt buộc
  • Cho phép người dùng nhập mã lỗi đồng bộ thông tin không thành công

Thể hiện thông tin mã lỗi khi đồng bộ thông tin

6Nút "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 lọc.
  • Khi nhấn, màn hình pop-up "Bộ lọc" đóng lại. 
Thể hiện nút "X" để hủy bỏ thao tác lọc.
7Nút "Đặt lại"Nút chức năng (Button)Không bắt buộc
  • Cho phép người dùng nhấn để đặt lại tất cả tiêu chí lọc về trạng thái mặc định ban đầu.

-Hành vi hệ thống khi người dùng nhấn nút "Đặt lại" như sau: 

  • Hành vi 1: Toàn bộ các trường trên màn hình pop-up "Bộ lọc" sẽ được chuyển về giá trị mặc định ban đầu.
  • Hành vi 2: Màn hình pop-up "Bộ lọc" vẫn được giữ trạng thái mở để người dùng có thể tiếp tục thao tác.
Thể hiện nút đặt lại tất cả tiêu chí lọc về trạng thái mặc định ban đầu.
8Nút "Áp dụng"Nút chức năng (Button)Không bắt buộc

- Cho phép người dùng nhấn để áp dụng những tiêu chí lọc đã chọn.

- Hành vi hiển thị kết quả hệ thống khi người dùng nhấn nút "Áp dụng" như sau: 

  • Trường hợp 1: Không chọn bất kỳ tiêu chí lọc nào:
    • Hệ thống vẫn cho phép người dùng nhấn nút “Áp dụng”.
    • Sau khi nhấn, hệ thống đóng pop-up nhưng không thực hiện lọc.
    • Màn hình "Tích hợp thông tin dự án" vẫn giữ nguyên dữ liệu như trước khi thao tác.
    • Không hiển thị bất kỳ thông báo lỗi hay cảnh báo nào.
  • Trường hợp 2: Chọn một hoặc nhiều tiêu chí lọc:
    • Hệ thống vẫn cho phép người dùng nhấn nút “Áp dụng”.
    • Sau khi nhấn, hệ thống đóng pop-up và thực hiện lọc theo toàn bộ các tiêu chí mà người dùng đã chọn.
    • Màn hình "Tích hợp thông tin dự án" được cập nhật và hiển thị theo đúng những tiêu chí người dùng chọn đã chọn. 
Thể hiện nút áp dụng tiêu chí lọc được chọn

3.4.3. Nút cấu hình tích hợp danh mục dự án


Field

(Trường dữ liệu)

Type

(Kiểu dữ liệu)

Required

(Bắt buộc)

Validation

(Quy định)

Description

(Mô tả)

1Tiêu đề màn hìnhNhãn hiệu (Label)

Hiển thị tiêu đề " Tích hợp thông tin danh mục dự án (SAP)"
2Nút đóng (X)Nút chức năng (Button)
  • Cho phép người dùng nhấn để hủy bỏ thao tác lọc.
  • Khi nhấn, màn hình pop-up "Bộ lọc" đóng lại. 
Đóng màn hình cấu hình, không lưu thay đổi
3Tần suấtNhãn hiệu (Label)
  • Chỉ được chọn 1 giá trị tần suất đồng bộ thông tin dự án hàng ngày/hàng tuần
Thể hiện tần suất người dùng chọn đồng bộ dữ liệu dự án
4Hàng ngàyNút chọn (Radio Option)
  • Khi chọn nút "Hàng ngày" nút "Hàng tuần" sẽ bị ẩn
  • Khi chọn Nút "Hàng ngày" hệ thống sẽ hiện hộp thời gian chọn thời điểm thực hiện đồng bộ thông tin dự án, theo kiểu thời gian time picker định dạng HH:mm (24h).
  • Hệ thống mặc định để thời gian là 00:00
Thể hiện thời gian đồng bộ dữ liệu dự án được chọn trong ngày
5Hàng tuầnNút chọn (Radio Option)
  • Khi chọn nút "Hàng tuần" nút "Hàng ngày" sẽ bị ẩn
  • Khi chọn nút "Hàng tuần" hệ thống sẽ hiện các checkbox group thời gian từ thứ 2 đến chủ nhật. Người dùng có thể chọn thời gian thực ngày thực hiện đồng bộ thông tin. Khi chọn nút "Hàng tuần" hệ thống mặc định chọn tất cả các ngày
  • Sau khi chọn thời gian ngày trong tuần. hệ thống sẽ hiện hộp thời gian chọn thời điểm thực hiện đồng bộ thông tin dự án, theo kiểu thời gian time picker định dạng HH:mm (24h).
  • Hệ thống mặc định để thời gian là 00:00
Thể hiện thời gian đồng bộ dữ liệu dự án các ngày được chọn trong tuần
6Nút HủyNút chức năng (Button)
  • Cho phép người dùng  nhấn để hủy bỏ thao tác cấu hình 
Thể hiện để hủy bỏ thao tác cấu hình.
7Nút Áp dụng
Nút chức năng (Button)
  • Cho phép người dùng nhấn để áp dụng những tiêu chí lọc đã chọn.

- Hành vi hiển thị kết quả hệ thống khi người dùng nhấn nút "Áp dụng" như sau: 

  • Trường hợp 1: Không chọn bất kỳ tiêu chí lọc nào:
    • Hệ thống vẫn cho phép người dùng nhấn nút “Áp dụng”.
    • Sau khi nhấn, hệ thống đóng pop-up nhưng không thực hiện lọc.
    • Màn hình "Tích hợp thông tin dự án" vẫn giữ nguyên dữ liệu như trước khi thao tác.
    • Không hiển thị bất kỳ thông báo lỗi hay cảnh báo nào.
  • Trường hợp 2: Chọn một hoặc nhiều tiêu chí lọc:
    • Hệ thống vẫn cho phép người dùng nhấn nút “Áp dụng”.
    • Sau khi nhấn, hệ thống đóng pop-up và thực hiện lọc theo toàn bộ các tiêu chí mà người dùng đã chọn.
    • Màn hình "Tích hợp thông tin dự án (SAP)" được cập nhật và hiển thị theo đúng những tiêu chí người dùng chọn đã chọn. 
Thể hiện nút áp dụng tiêu chí lọc được chọn

3.4.4. Pop-up xác nhận đồng bộ ngay 


Field

(Trường dữ liệu)

Type

(Kiểu dữ liệu)

Required

(Bắt buộc)

Validation

(Quy định)

Description

(Mô tả)

1Tiêu đề màn hìnhNhãn hiệu (Label)

Hiển thị tiêu đề " Xác nhận đồng bộ dữ liệu"
2Văn bản thông báoNút chức năng (Button)
  • 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 văn bản thông báo

- Nội dung văn bản thông báo: "Bạn có chắc chắn muốn đồng bộ dữ liệu dự án (SAP)"

3Nút "Tôi chắc chắn" Nút chức năng (Button)
  • Cho phép người dùng nhấn để thực hiện đồng bộ thông tin dự án ngay 

Cho phép người dùng nhấn để thực hiện đồng bộ thông tin dự án theo cấu hình hiện tại

4Nút Hủy
Nút chức năng (Button)
  • Cho phép người dùng  nhấn để hủy bỏ thao tác cấu hình 
Thể hiện để hủy bỏ thao tác đồng bộ ngay.

3.4.5. Pop-up chi tiết mã lỗi


Field

(Trường dữ liệu)

Type

(Kiểu dữ liệu)

Required

(Bắt buộc)

Validation

(Quy định)

Description

(Mô tả)

1Tiêu đề màn hìnhNhãn hiệu (Label)

Hiển thị tiêu đề "Đồng bộ thất bại"
2Văn bản thông báoNút chức năng (Button)
  • 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 văn bản thông báo

- Nội dung văn bản thông báo: "Mã lỗi. Mô tả chi tiết lỗi"

3Nút "Thoát Nút chức năng (Button)
  • Cho phép người dùng nhấn để tắt màn hình pop-up.
    Khi nhấn, màn hình pop-up đóng lại và hệ thống điều hướng về màn hình về màn hình danh sách "Tích hợp dữ liệu dự án"

Thể hiện nút "Thoát" để đóng màn hình pop up cảnh báo