Page History

https://jira.popplife.vn/browse/BPMKVH-25972502https://jira.popplife.vn/browse/BPMKVH-3869

Nghiệp vụ

IT

Người lập

Người duyệt

Người lập

Người duyệt

Họ và tên

Mai Kiều Mi

Nguyễn Đức Trung

Tài khoản email/MS team

mimk3mimk2

trungnd3

Chức danh

Business Analyst (BA)

Product Owner

(P.O)

Business Analyst Business (BA BIZ)

Ngày soạn thảo

10 Dec 2025

04 Dec 2025

Jira Link

[BPMKVH-

4250] Menu quản lý hợp đồng ngoài quy trình - Jira

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

Là nhân viên chịu trách nhiệm quản lý hợp đồng tôi muốn cập nhật thủ công các hợp đồng, phụ lục hợp đồng được ký kết (ngoài hệ thống) để quản lý Danh mục hợp đồng tập trung thuận tiện truy cập, tìm kiếm, xem, chỉnh sửa hoặc theo dõi toàn bộ hợp đồng mua sắm

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

Cho phép thêm mới hợp đồng thủ công hoặc import từ excel
Cho phép export dữ liệu excel
Cho phép tích hợp dữ liệu trạng thái thực hiện hợp đồng từ hệ thống bên ngoài (ERP)
Cho phép cập nhật phụ lục hợp đồng
1. Nhận biết phụ lục ký phát sinh so với phụ lục ban đầu
2. Người dùng truy cập các phụ lục từ số lần cập nhật phụ lục trên danh sách
Cho phép kích hoạt quy trình đàm phán phụ lục phát sinh của hợp đồng theo phân quyền
Cho phép upload các phụ lục, email ... dữ liệu quá trình đàm phán phụ lục (nếu việc đàm phán ko thực hiện trên hệ thống)
Ghi log toàn bộ hành động thêm/sửa/xóa/tải dữ liệu hợp đồng

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

3.1 UIUX:

3.1.1. Màn hình "Danh sách hợp đồng"

Image Removed

...

Ghi log toàn bộ hành động thêm/sửa/xóa/tải dữ liệu hợp đồng

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

3.1 UIUX:

3.1.1. Màn hình "Danh sách hợp đồng"

Image Added

3.1.1.1. Màn hình kết quả tìm kiếm khi: Không có kết quả tìm kiếm/Danh sách trống

Image Modified

3.1.1.2. Màn hình pop-up "bộ lọc"

Image Modified

3.1.1.3. Màn hình pop-up "Tải tài liệu"

Image Modified

3.1.1.4. Màn hình pop-up "Thêm mới hợp đồng"

Image Modified

3.1.1.5. Màn hình pop-up "Chỉnh sửa hợp đồng"

3.1.1.5.1. Màn hình pop-up "Chỉnh sửa hợp đồng" với mã quy định HĐ NGOÀI quy trình BPM :

Image Modified

3.1.1.5.2. Màn hình pop-up "Chỉnh sửa hợp đồng" với mã quy định HĐ TRONG quy trình BPM :

Image Modified

3.1.1.6. Màn hình pop-up "Xem chi tiết hợp đồng"

Image Modified

3.1.1.7. Màn hình pop-up "Cảnh báo"

3.1.1.7. Màn hình pop-up "Cảnh báo trùng"

Image Modified

3.1.1.7. Màn hình pop-up "Cảnh báo điều kiện ngày hoàn thành (ngày hoàn thành nhỏ hơn ngày hợp đồng)

Image Modified

3.1.1.7. Màn hình pop-up "Cảnh báo ngày hết hạn bảo hành (ngày hết hạn bảo hành nhỏ hơn ngày dự kiến hoàn thành/ngày hợp đồng/ngày hiệu lực)"

Image Modified

3.1.1.8. Màn hình pop-up "Nhập file excel"

3.1.1.8. Màn hình pop-up "Xuất file excel"

3.1.1.8. Màn hình pop-up "Lỗi nhập file excel"

3.1.1.9. Màn hình pop-up "Thông báo"

3.1.1.9.1. Màn hình toast Nhập dữ liệu thành công

Image RemovedImage Added

3.1.1.9.2. Màn hình toast Xuất dữ liệu thành công

Image RemovedImage Added

3.1.1.9.3. Màn hình toast Không thành công

Image RemovedImage Added

3.1.1.9.4. Màn hình toast Thành công

Image RemovedImage Added

3.2 Luồng:

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

...

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 hợp đồng"

...

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

...

Kiểu dữ liệu

...

Điều kiện

...

Quy định

...

Mô tả

...

- Cho phép người dùng tích chọn một, nhiều, hoặc tất cả bản ghi hợp đồng để phục vụ cho chức năng "Xuất file excel".

- Chức năng "Xuất file excel": tham chiếu mục

...

STT

Số (Number)

...

- Hệ thống tự động gán STT theo ngày ký hợp đồng: hợp đồng ký gần hơn nhận STT nhỏ hơn, hợp đồng ký xa hơn nhận STT lớn hơn.

- Khi thực hiện thêm mới hợp đồng vào màn hình "Danh sách hợp đồng", hệ thống sẽ tự động cập nhật STT cho toàn bộ danh sách.

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

...

Số hợp đồng

...

Đường dẫn (Hyperlink)

...

- Số hợp đồng là giá trị duy nhất, không được trùng với bất kỳ số hợp đồng nào đã tồn tại.

...

- Khi người dùng nhấn vào số hợp đồng, hệ thống mở ra màn hình "Chi tiết hợp đồng"

Màn hình "Chi tiết hợp đồng": Tham chiếu mục 3.4.2.Màn hình "Chi tiết hợp đồng".
Trong trường hợp số hợp đồng của hợp đồng trên quy trình bị trùng→ khi nhân viên KHTH nhấn nút "hoàn thành" hệ thống sẽ chặn không cho hoàn thành công việc, sẽ báo toast cảnh báo theo mẫu chung của hệ thống => đồng thời nhân viên KHTH sẽ kiểm tra/xin lại số hợp đồng để update lại

...

Thể hiện số hợp đồng

...

Loại hợp đồng

...

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

...

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

...

- Cho phép người dùng nhấn để mở ra màn hình pop-up "Tải tài liệu"

- Màn hình pop-up "Bộ lọc": tham chiếu mục 3.4.1.2. Màn hình pop-up "Tải tài liệu".

...

Thể hiện nút chức năng tải tài liệu

...

Dự án

...

HĐ ngoài quy trình BPM

...

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

...

Nhà cung cấp

...

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

...

Mã số thuế (NT)

...

Ngày ký hợp đồng

...

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

...

Ngày hiệu lực

...

Ngày hết hạn bảo hành

...

Giá trị HĐ trước thuế

...

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

...

Giá trị HĐ sau thuế

...

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

...

Đơn vị tiền tệ

...

Tỉ giá tương ứng

...

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

- Hệ thống tự động hiển thị trạng thái hợp đồng, gồm:

- Chờ thống nhất: Khi nhân viên KHTH bấm nút hoàn thành từ 2442 - User Story - Nhân viên kế hoạch - tổng hợp soạn thảo hợp đồng
- Đang thực hiện: Khi nhân viên KHTH bấm nút hoàn thành từ 1556 - User Story - Ký kết và phát hành hợp đồng giấy
- Đã quyết toán: để sẵn chờ tích hợp ERP
- Hủy

...

Thể hiện trạng thái hiện tại của hợp đồng do hệ thống tự động gán.

...

- 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.1.1. Màn hình pop-up "Bộ lọc".

...

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

...

- Cho phép người dùng nhập từ khóa liên quan đến "Mã hợp đồng" hoặc "Số hợp đồng".

- Hệ thống thực hiện tìm kiếm và cập nhật màn hình "Danh sách hợp đồng" khi người dùng nhấn Enter hoặc biểu tượng kính lúp sau khi hoàn thành nhập từ khóa.

- Hành vi hệ thống khi Thể hiện kết quả:

Trường hợp 1 - Có kết quả:
- Điều kiện: Có ít nhất một hợp đồng trong hệ thống khớp với từ khóa người dùng nhập.
- Hành vi: Hệ thống Thể hiện danh sách các hợp đồng khớp với từ khóa tìm kiếm.
Trường hợp 2 - Không có kết quả/Danh sách trống (không có dữ liệu ban đầu):
- Điều kiện: Không có hợp đồng nào khớp với từ khóa tìm kiếm hoặc danh sách hợp đồng ban đầu trống.
- Hành vi: Hệ thống Thể hiện thông báo "Ở đây chưa có gì cả. Hiện tại chưa có hợp đồng nào. Hãy thêm mới hợp đồng đầu tiên nhé!
Figma cho cả 2 trường hợp: tham chiếu mục 3.1.1.2. Màn hình kết quả của ô tìm kiếm

...

Thể hiện ô tìm kiếm với gợi ý mặc định (placeholder) “Tìm theo Tên - Số hợp đồng” và biểu tượng kính lúp ở đầu ô nhập.

...

- Cho phép người dùng nhấn để mở ra màn hình pop-up "Thêm mới hợp đồng"

- Màn hình pop up "Chỉnh sửa hợp đồng": tham chiếu mục 3.4.1.2. Màn hình pop-up "Thêm mới hợp đồng"

...

Nút "Chỉnh sửa" Image Removed

...

- Cho phép người dùng nhấn để mở ra màn hình pop up "Chỉnh sửa loại thang điểm"

- Màn hình pop up "Chỉnh sửa loại thang điểm/hợp đồng": Tham chiếu mục 3.4.1.3. Màn hình pop up "Chỉnh sửa hợp đồng"

...

Nút "Ẩn hiện" Image Removed

...

- Cho phép người dùng nhấn để mở ra màn hình pop-up “Cài đặt hiển thị”.

- Màn hình pop up “Cài đặt hiển thị”: Tham chiếu mục 3.4.1.4. Màn hình pop up “Cài đặt hiển thị”

...

Thể hiện nút chức năng cài đặt hiển thị những trường thông tin không bắt buộc và chịu ảnh hưởng bởi nút công tắc (toggle) trong pop-up “Cài đặt hiển thị”.

...

- Cho phép người dùng nhấn để điều hướng đến màn hình pop-up "Xuất dữ liệu excel": tham chiếu mục 3.4.6. Màn hình pop-up "Xuất danh sách hợp đồng"

...

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

...

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

...

Kiểu dữ liệu

...

Điều kiện

...

Quy định

...

Mô tả

...

- Cho phép người dùng nhấn để chọn giá trị nhà cung cấp từ danh sách thả xuống của trường.

- Nguồn dữ liệu:

- Hành vi hệ thống khi thực hiện lọc như sau:

Trường hợp 1: Người dùng chọn giá trị nhà cung cấp: Khi nhấn nút "Áp dụng", hệ thống lọc danh sách hợp đồng theo nhà cung cấp đã chọn.
Trường hợp 2: Người dùng không chọn giá trị nhà cung cấp: Khi nhấn nút "Áp dụng", hệ thống không lọc danh sách hợp đồng theo trường nhà cung cấp.

...

Thể hiện tên nhà cung cấp trong hợp đồng với gợi ý mặc định (placeholder) "Chọn nhà cung cấp"

...

- Cho phép người dùng nhấn để chọn giá trị tên dự án từ danh sách thả xuống của trường.

- Giá trị của trường trạng thái:

Chờ thống nhất: Khi nhân viên KHTH bấm nút hoàn thành từ 2442 - User Story - Nhân viên kế hoạch - tổng hợp soạn thảo hợp đồng

Đang thực hiện: Khi nhân viên KHTH bấm nút hoàn thành từ 1556 - User Story - Ký kết và phát hành hợp đồng giấy

Đã quyết toán: để sẵn chờ tích hợp ERP
Hủy : để sẵn chờ có chức năng hủy sau phần chờ thống nhất nhưng không thực hiện

- Hành vi hệ thống khi thực hiện lọc như sau:

Trường hợp 1: Người dùng chọn giá trị tên dự án: Khi nhấn nút "Áp dụng", hệ thống lọc danh sách hợp đồng theo dự án đã chọn.
Trường hợp 2: Người dùng không chọn giá trị tên dự án: Khi nhấn nút "Áp dụng", hệ thống không lọc danh sách hợp đồng theo trường dự án.

...

- Cho phép người dùng nhấn để chọn giá trị trạng thái từ danh sách thả xuống của trường.

- Nguồn dữ liệu:

- Hành vi hệ thống khi thực hiện lọc như sau:

Trường hợp 1: Người dùng chọn giá trị trạng thái: Khi nhấn nút "Áp dụng", hệ thống lọc danh sách hợp đồng theo nhà cung cấp đã chọn.
Trường hợp 2: Người dùng không chọn giá trị trạng thái: Khi nhấn nút "Áp dụng", hệ thống không lọc danh sách hợp đồng theo trường trạng thái.

...

- Cho phép người dùng nhấn để chọn giá trị loại hợp đồng từ danh sách thả xuống của trường.

- Nguồn dữ liệu:

- Hành vi hệ thống khi thực hiện lọc như sau:

Trường hợp 1: Người dùng chọn giá trị loại hợp đồng: Khi nhấn nút "Áp dụng", hệ thống lọc danh sách hợp đồng theo nhà cung cấp đã chọn.
Trường hợp 2: Người dùng không chọn giá trị loại hợp đồng: Khi nhấn nút "Áp dụng", hệ thống không lọc danh sách hợp đồng theo trường loại hợp đồng.

...

- Cho phép người dùng nhấn để chọn 1 trong 3 giá trị tùy chọn từ danh sách thả xuống của trường

- Giá trị của trường:

Có tài liệu đính kèm
Không có tài liệu đính kèm
Hiển thị tất cả

...

- Cho phép người dùng nhấn để chọn chọn giá trị ngày cho 2 trường: Từ ngày và Đến ngày.

- Hành vi hệ thống khi người dùng chọn giá trị như sau:

Trường hợp 1: Người dùng chọn giá trị hợp lệ: Gía trị Từ ngày ≤ Đến ngày: Khi nhấn nút Áp dụng, hệ thống lọc danh sách hợp đồng theo khoảng thời gian đã chọn.
Trường hợp 2: Người dùng không chọn giá trị không hợp lệ: Gía trị Từ ngày > Đến ngày: Khi nhấn nút Áp dụng, hệ thống hiển thị cảnh báo ....
Trường hợp 3: Người dùng không chọn giá trị: Hệ thống không thực hiện lọc theo trường Thời gian kí HĐ.

...

Thể hiện thời gian ký hợp đồng gồm 2 trường: Từ ngày và Đến ngày dùng để lọc hợp đồng theo ngày ký hợp đồng

...

- 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 "Danh sách hợp đồng" 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 "Danh sách hợp đồng" được cập nhật và hiển thị theo đúng những tiêu chí người dùng chọn đã chọn.

...

- 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 hinh 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.

...

3.4.1.2. Màn hình pop-up "Tải tài liệu"

...

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

...

Kiểu dữ liệu

...

Điều kiện

...

Quy định

...

Mô tả

...

File HĐ đính kèm

...

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

...

Không bắt buộc

...

- Cho phép người dùng tải lên file hợp đồng.

- Sau khi người dùng tải file hợp đồng, hệ thống hiển thị danh sách file đã đính kèm gồm: tên file, dung lượng, icon loại file và nút 'X' để xóa. Người dùng có thể kiểm tra lại hoặc xóa file trước khi nhấn 'Áp dụng

...

Thể hiện file hợp đồng/phụ lục hợp đồng được ký kết

...

File PL đính kèm

...

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

...

Không bắt buộc

...

- Cho phép người dùng tải lên file phụ lục hợp đồng

- Sau khi người dùng tải file phụ lục hợp đồng, hệ thống hiển thị danh sách file đã đính kèm gồm: tên file, dung lượng, icon loại file và nút 'X' để xóa. Người dùng có thể kiểm tra lại hoặc xóa file trước khi nhấn 'Áp dụng

...

Thể hiện file phụ lục/hợp đồng được ký kết

...

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 đính kèm/ phụ lục hợp đồng.

...

Thể hiện nút "Hủy" để để hủy bỏ thao tác đính kèm/ phụ lục hợp đồng.

...

Nút "Áp dụng"

...

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

...

Không bắt buộc

...

Thể hiện nút lưu tài liệu đính kèm/phụ lục hợp đồng.

...

3.4.1.2. Màn hình pop-up "Thêm mới hợp đồng"

...

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

...

Kiểu dữ liệu

...

Điều kiện

...

Quy định

...

Mô tả

...

Mã HĐ ngoài quy trình BPM

...

- Không cho phép người dùng nhấn để thao tác chuyển đổi trạng thái của công tắc

- Khi mở màn hình “Thêm mới hợp đồng”, công tắc được hiển thị mặc định ở trạng thái Bật (ON) và người dùng không được phép thay đổi trạng thái này trong bước tạo mới.

Công tắc Bật (ON): Hợp đồng này được xử lý ngoài luồng quy trình BPM.

...

Thể hiện công tắc phân loại các hợp đồng có hoặc không được sử dụng trong luồng quy trình BPM.

...

- Cho phép người dùng nhấn để chọn trạng thái hợp đồng từ danh sách thả xuống của trường:

- Gía trị của trường

- Chờ thống nhất: Khi nhân viên KHTH bấm nút hoàn thành từ 2442 - User Story - Nhân viên kế hoạch - tổng hợp soạn thảo hợp đồng
- Đang thực hiện: Khi nhân viên KHTH bấm nút hoàn thành từ 1556 - User Story - Ký kết và phát hành hợp đồng giấy
- Đã quyết toán: để sẵn chờ tích hợp ERP
- Hủy : để sẵn chờ có chức năng hủy sau phần chờ thống nhất nhưng không thực hiện

- Không được để trống

...

Thể hiện trạng thái của hợp đồng khi thêm mới đơn 1 hợp đồng.

...

Số hợp đồng

...

- Cho phép người dùng chọn thông tin số hợp đồng.

- Số hợp đồng là giá trị duy nhất, không được trùng với bất kỳ số hợp đồng nào đã tồn tại.

- Không được để trống.

Thể hiện số hợp đồng

...

Loại hợp đồng

...

- Cho phép chọn loại hợp đồng với trạng thái đang hoạt động từ danh mục loại hợp đồng.

- Sau khi người dùng chọn giá trị loại hợp đồng, giá trị này sẽ được hiển thị trực tiếp trong trường "Loại hợp đồng".

- Không được để trống.

...

Thể hiện loại hợp đồng

...

Cho phép chỉnh sửa tên hợp đồng/gói thầu

...

Thông tin tên hợp đồng/ gói thầu

...

Dự án

...

- Cho phép chỉnh sửa dự án với trạng thái đang hoạt động từ danh mục loại hợp đồng.

- Sau khi người dùng chỉnh sửa giá trị dự án, giá trị này sẽ được hiển thị trực tiếp trong trường "Dự án".

- Không được để trống.

...

Thể hiện tên dự án gói thầu

...

Nhà cung cấp

...

- Cho phép chọn nhà cung cấp với trạng thái hoạt động từ danh mục NT/NCC.

- Sau khi người dùng chọn giá trị trong trường “Nhà cung cấp” và tự động hiển thị giá trị trong trường Mã số thuế (số thứ tự 8) tương ứng.

- Không được để trống.

...

Thể hiện tên nhà cung cấp

...

Mã số thuế (NT)

...

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

- Sau khi người dùng chọn giá trị trong trường “Nhà cung cấp”, hệ thống tự động hiển thị giá trị trong trường Mã số thuế tương ứng.

...

Thể hiện mã số thuế nhà thầu

...

- Cho phép chọn phòng ban thực hiện

- Sau khi người dùng chọn giá trị phòng ban thực hiện, giá trị này sẽ được hiển thị trực tiếp trong trường "Phòng ban thực hiện".

- Không được để trống.

...

Thông tin phòng ban thực hiển dự án

...

Ngày ký hợp đồng

...

- Cho phép người dùng nhấn để chọn giá trị ngày ký của hợp đồng.

- Sau khi người dùng chọn ngày và lưu, giá trị ngày được hiển thị trực tiếp trong trường "Ngày ký hợp đồng".

- Không được để trống.

...

Thể hiện ngày ký hợp đồng

...

Ngày hiệu lực

...

- Cho phép người dùng nhấn để chọn giá trị ngày hiệu lực của hợp đồng.

- Sau khi người dùng chọn ngày và lưu, giá trị ngày được hiển thị trực tiếp trong trường "Ngày hiệu lực".

- Không được để trống

...

Thể hiện ngày hiệu lực hợp đồng

...

- Cho phép người dùng nhấn để chọn giá trị ngày dự kiến hoàn thành của hợp đồng.

- Không được để trống

...

Thể hiện ngày dự kiến hoàn thành triển khai hợp đồng

...

- Cho phép nhập số ngày thực hiện công việc

- Sau khi người dùng nhập số ngày thực hiện công việc, giá trị ngày được hiển thị trực tiếp trong trường "Thời gian thực hiện".

...

Thông tin thời gian số ngày triển khai thực hiện hợp đồng

...

Ngày hết hạn bảo hành

...

- Cho phép nhập ngày hết hạn bảo hành

- Sau khi người dùng nhập số ngày thực hiện công việc, giá trị ngày được hiển thị trực tiếp trong trường "Thời gian thực hiện"

- Không được để trống

...

Thông tin thời gian hết hạn bảo hành

...

Đơn vị chủ đầu tư ký hợp đồng

...

- Cho phép nhập tên đơn vị chủ đầu tư ký hợp đồng với trạng thái đang hoạt động ký hợp đồng từ danh mục quản lý người dùng/cài đặt cơ sở/danh sách chi nhánh

- Sau khi người dùng nhập tên đơn vị chủ đầu tư ký hợp đồng, giá trị ngày được hiển thị trực tiếp trong trường "Tên đơn vị chủ đầu tư ký hợp đồng".

...

Thông tin đơn vị chủ đầu tư ký hợp đồng

...

Giá trị HĐ trước thuế

...

- Cho phép nhập giá trị hợp đồng trước thuế

- Sau khi người dùng nhập giá trị hợp đồng trước thuế, giá trị ngày được hiển thị trực tiếp trong trường "Giá trị hợp đồng trước thuế".

- Không được để trống

...

Thể hiện giá trị hợp đồng trước thuế

...

Giá trị HĐ sau thuế

...

- Cho phép nhập giá trị giá trị hợp đồng sau thuế.

- Sau khi người dùng nhập giá trị hợp đồng sau thuế, giá trị ngày được hiển thị trực tiếp trong trường "Giá trị hợp đồng sau thuế.".

- Không được để trống

...

Thể hiện giá trị hợp đồng sau thuế

...

- Cho phép nhập giá trị giá trị hợp đồng trước thuế sau điều chỉnh.

- Sau khi người dùng nhập giá trị hợp đồng trước thuế sau điều chỉnh, giá trị ngày được hiển thị trực tiếp trong trường "Giá trị HĐ trước thuế sau điều chỉnh".

...

Thể hiện giá trị hợp đồng trước thuế khi bổ sung phụ lục

...

- Cho phép nhập giá trị giá trị hợp đồng sau thuế sau điều chỉnh.

- Sau khi người dùng nhập giá trị hợp đồng sau thuế sau điều chỉnh, giá trị ngày được hiển thị trực tiếp trong trường "Giá trị HĐ sau thuế sau điều chỉnh".

...

Đơn vị tiền tệ

...

- Cho phép chọn tên đơn vị tiền tệ trạng thái hoạt động từ danh mục đơn vị tiền tệ

- Sau khi người dùng nhập đơn vị tiền tệ, giá trị ngày được hiển thị trực tiếp trong trường "Đơn vị tiền tệ".

- Không được để trống

...

Thể hiện đơn vị tiền tệ sử dụng cho hợp đồng

...

Tỉ giá tương ứng

...

- Cho phép chọn tỷ giá tương đương với đơn vị tệ tương ứng

- Sau khi người dùng nhập tỷ giá tương đương với đơn vị tệ tương ứng, giá trị ngày được hiển thị trực tiếp trong trường "Tỉ giá tương ứng".

- Không được để trống

...

Thể hiện tỷ giá quy đổi của ngoại tệ (nếu có)

...

- Cho phép nhập rủi ro hợp đồng

- Sau khi người dùng nhập thông tin rủi ro, giá trị ngày được hiển thị trực tiếp trong trường "Rủi ro".

- Không được để trống

...

Thể hiện rủi ro của hợp đồng

...

Cho phép nhấn để tải lên file đính kèm file HĐ

...

Thể hiện nút tải lên file phụ lục được ký kết

...

Thể hiện nút tải lên phụ lục được ký kết

...

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

- Màn hình "Danh sách hợp đồng: Tham chiếu mục 3.4.1. Màn hình "Danh sách hợp đồng.

...

- Cho phép nhấn để lưu thông tin thêm mới đơn 1 hợp đồng

- Khi nhấn hệ thống tiến hành xác nhận dữ liệu ca làm việc khi thêm mới như sau:

Trường hợp 1: Thêm mới dữ liệu hợp lệ:

Điều kiện:
- Tất cả các trường bắt buộc được nhập đầy đủ.
- Ngày dự kiến hoàn thành > Ngày hợp đồng/Ngày hiệu lực.
- Ngày hết hạn bảo hành > Ngày dự kiến hoàn thành/Ngày hợp đồng/Ngày hiệu lực)
- Số hợp đồng 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:
- Hợp đồng được thêm mới hiển thị với giá trị trạng thái mặc định là "Hoạt độ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: Thêm mới hợp đồng thành công

Trường hợp 2: Thêm mới dữ liệu không hợp lệ:

Điều kiện:
- Tất cả các trường bắt buộc được nhập đầy đủ.
- Ngày dự kiến hoàn thành < Ngày hợp đồng/Ngày hiệu lực.
- Ngày hết hạn bảo hành < Ngày dự kiến hoàn thành/Ngày hợp đồng/Ngày hiệu lực)
- Số hợp đồng không trùng với bản ghi sẵn có trong hệ thống.
Hành vi hệ thống:
- Hợp đồng không được thêm mới.
- Hệ thống hiển thị màn hình pop-up Cảnh báo:

...

Thể hiện nút cho phép lưu thông tin hợp đồng.

...

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

- Màn hình "Danh sách hợp đồng: Tham chiếu mục 3.4.1. Màn hình "Danh sách hợp đồng.

...

3.4.1.3. Màn hình pop-up "Chỉnh sửa hợp đồng"

3.4.1.3.1. Màn hình pop-up "Chỉnh sửa hợp đồng" - Tab "Thông tin chi tiết" với mã quy định HĐ NGOÀI quy trình BPM

...

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

...

Kiểu dữ liệu

...

Điều kiện

...

Quy định

...

Mô tả

...

HĐ ngoài quy trình BPM

...

- Khi mở màn hình “Thêm mới hợp đồng”, công tắc được hiển thị mặc định ở trạng thái Bật (ON) và người dùng không được phép thay đổi trạng thái này trong bước tạo mới.

Công tắc Bật (ON): Hợp đồng này được xử lý ngoài luồng quy trình BPM.

...

Thể hiện công tắc phân loại các hợp đồng có hoặc không được sử dụng trong luồng quy trình BPM.

...

- Cho phép người dùng nhấn để chỉnh sửa trạng thái hợp đồng từ danh sách thả xuống của trường:

- Gía trị của trường

Chờ thống nhất
Đang thực hiện
Đã quyết toán
Hủy

- Không được để trống

...

Thể hiện trạng thái của hợp đồng khi thêm mới đơn 1 hợp đồng.

...

Số hợp đồng

...

- Cho phép người dùng chỉnh sửa thông tin số hợp đồng.

- Số hợp đồng là giá trị duy nhất, không được trùng với bất kỳ số hợp đồng nào đã tồn tại.

- Không được để trống.

...

Thể hiện số hợp đồng

...

Loại hợp đồng

...

- Cho phép chỉnh sửa loại hợp đồng với trạng thái đang hoạt động từ danh mục loại hợp đồng.

- Sau khi người dùng chỉnh sửa giá trị loại hợp đồng, giá trị này sẽ được hiển thị trực tiếp trong trường "Loại hợp đồng".

- Không được để trống.

...

Thể hiện loại hợp đồng

...

Cho phép chỉnh sửa tên hợp đồng/gói thầu

...

Thông tin tên hợp đồng/ gói thầu

...

Dự án

...

- Cho phép chỉnh sửa dự án với trạng thái đang hoạt động từ danh mục loại hợp đồng.

- Sau khi người dùng chỉnh sửa giá trị dự án, giá trị này sẽ được hiển thị trực tiếp trong trường "Dự án".

- Không được để trống.

...

Thể hiện tên dự án gói thầu

...

Nhà cung cấp

...

- Cho phép chỉnh sửa dự án với trạng thái đang hoạt động từ danh mục NT/NCC.

- Sau khi người dùng chỉnh sửa giá trị trong trường “Nhà cung cấp” và tự động hiển thị giá trị trong trường Mã số thuế (số thứ tự 8) tương ứng.

- Không được để trống.

...

Thể hiện tên nhà cung cấp

...

Mã số thuế (NT)

...

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

- Sau khi người dùng chọn giá trị trong trường “Nhà cung cấp”, hệ thống tự động hiển thị giá trị trong trường Mã số thuế tương ứng.

...

Thể hiện mã số thuế nhà thầu

...

- Cho phép chỉnh sửa phòng ban thực hiện

- Sau khi người dùng chỉnh sửa giá trị phòng ban thực hiện, giá trị này sẽ được hiển thị trực tiếp trong trường "Phòng ban thực hiện".

- Không được để trống.

Cho phép chỉnh sửa thông tin phòng ban thực hiện dự án

...

Ngày ký hợp đồng

...

- Cho phép người dùng nhấn để chỉnh sửa giá trị ngày ký của hợp đồng.

- Sau khi người dùng chỉnh sửa ngày và lưu, giá trị ngày được hiển thị trực tiếp trong trường "Ngày ký hợp đồng".

- Không được để trống.

...

Thể hiện ngày ký hợp đồng

...

Ngày hiệu lực

...

- Cho phép người dùng nhấn để chỉnh sửa giá trị ngày hiệu lực của hợp đồng.

- Sau khi người dùng chỉnh sửa ngày và lưu, giá trị ngày được hiển thị trực tiếp trong trường "Ngày hiệu lực".

- Không được để trống

...

Thể hiện ngày hiệu lực hợp đồng

...

- Cho phép người dùng nhấn để chỉnh sửa giá trị ngày dự kiến hoàn thành của hợp đồng.

- Không được để trống

...

Thể hiện ngày dự kiến hoàn thành triển khai hợp đồng

...

- Cho phép chỉnh sửa số ngày thực hiện công việc

- Sau khi người dùng nhập số ngày thực hiện công việc, giá trị ngày được hiển thị trực tiếp trong trường "Thời gian thực hiện".

...

Thông tin thời gian số ngày triển khai thực hiện hợp đồng

...

Ngày hết hạn bảo hành

...

- Cho phép chỉnh sửa ngày hết hạn bảo hành

- Sau khi người dùng chỉnh sửa số ngày thực hiện công việc, giá trị ngày được hiển thị trực tiếp trong trường "Thời gian thực hiện"

- Không được để trống

...

Thông tin thời gian hết hạn bảo hành

...

Đơn vị chủ đầu tư ký hợp đồng

...

- Cho phép chỉnh sửa tên đơn vị chủ đầu tư ký hợp đồng với trạng thái đang hoạt động ký hợp đồng từ danh mục quản lý người dùng/cài đặt cơ sở/danh sách chi nhánh

- Sau khi người dùng chỉnh sửa tên đơn vị chủ đầu tư ký hợp đồng, giá trị ngày được hiển thị trực tiếp trong trường "Tên đơn vị chủ đầu tư ký hợp đồng".

...

Thông tin đơn vị chủ đầu tư ký hợp đồng

...

Giá trị HĐ trước thuế

...

- Cho phép chỉnh sửa giá trị hợp đồng trước thuế

- Sau khi người dùng chỉnh sửa giá trị hợp đồng trước thuế, giá trị ngày được hiển thị trực tiếp trong trường "Giá trị hợp đồng trước thuế".

- Không được để trống

...

- Thể hiện giá trị hợp đồng trước thuế

...

Giá trị HĐ sau thuế

...

- Cho phép người dùng chỉnh sửa giá trị hợp đồng sau thuế.

- Sau khi người dùng chỉnh sửa giá trị hợp đồng sau thuế, giá trị ngày được hiển thị trực tiếp trong trường "Giá trị hợp đồng sau thuế.".

- Không được để trống

...

- Thể hiện giá trị hợp đồng sau thuế

...

- Cho phép nhập giá trị hợp đồng trước thuế sau điều chỉnh.

- Sau khi người dùng nhập giá trị hợp đồng trước thuế sau điều chỉnh, giá trị ngày được hiển thị trực tiếp trong trường "Giá trị HĐ trước thuế sau điều chỉnh".

...

-Thể hiện giá trị hợp đồng trước thuế khi bổ sung phụ lục

...

- Cho phép chỉnh sửa giá trị giá trị hợp đồng sau thuế sau điều chỉnh.

- Sau khi người dùng chỉnh sửa giá trị hợp đồng sau thuế sau điều chỉnh, giá trị ngày được hiển thị trực tiếp trong trường "Giá trị HĐ sau thuế sau điều chỉnh".

...

Đơn vị tiền tệ

...

- Cho phép chọn chỉnh sửa đơn vị tiền tệ trạng thái hoạt động từ danh mục đơn vị tiền tệ

- Sau khi người dùng chỉnh sửa đơn vị tiền tệ, giá trị ngày được hiển thị trực tiếp trong trường "Đơn vị tiền tệ".

- Không được để trống

...

- Thể hiện đơn vị tiền tệ sử dụng cho hợp đồng

...

Tỉ giá tương ứng

...

- Cho phép chỉnh sửa tỷ giá tương đương với đơn vị tệ tương ứng

- Sau khi người dùng chỉnh sửa tỷ giá tương đương với đơn vị tệ tương ứng, giá trị ngày được hiển thị trực tiếp trong trường "Tỉ giá tương ứng".

- Không được để trống

...

- Thể hiện tỷ giá quy đổi của ngoại tệ (nếu có)

...

- Cho phép chỉnh sửa rủi ro hợp đồng

- Sau khi người dùng chỉnh sửa thông tin rủi ro, giá trị ngày được hiển thị trực tiếp trong trường "Rủi ro".

- Không được để trống

...

- Thể hiện tỷ giá quy đổi của ngoại tệ (nếu có)

...

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

- Cho phép người dùng xem lại tài liệu đính kèm

- Cho phép người dùng tải về tài liệu đính kèm

-Cho phép người dùng up file dữ liệu lên

...

Thể hiện file hợp đồng được ký kết

...

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

- Cho phép người dùng xem lại tài liệu đính kèm

- Cho phép người dùng tải về tài liệu đính kèm

-Cho phép người dùng up file dữ liệu lên

Thể hiện file phụ lục hợp đồng được ký kết

...

- 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 "Thêm mới hợp đồng" đóng lại và hệ thống điều hướng về màn hình "Danh sách hợp đồng.

- Màn hình "Danh sách hợp đồng: Tham chiếu mục 3.4.1. Màn hình "Danh sách hợp đồng.

...

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

- 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 đủ.
- Ngày dự kiến hoàn thành mới > Ngày hợp đồng/Ngày hiệu lực mới.
- Ngày hết hạn bảo hành mới > Ngày dự kiến hoàn thành mới/ Ngày hợp đồng mới/Ngày hiệu lực mới).
- Số hợp đồng 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":

Trường hợp 1: Dữ liệu hợp lệ

- Hành vi 1: Hợp đồng được chỉnh sửa hiển thị với giá trị trạng thái mặc định là "Hoạt động".
- Hành vi 2: 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: Chỉnh sửa hợp đồng thành công

...

Thể hiện nút đóng cho phép lưu thông tin hợp đồng.

...

- 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 "Thêm mới hợp đồng" đóng lại và hệ thống điều hướng về màn hình "Danh sách hợp đồng.

- Màn hình "Danh sách hợp đồng: Tham chiếu mục 3.4.1. Màn hình "Danh sách hợp đồng.

...

Tab điều hướng

(Navigation Tab)

...

- Cho phép người dùng nhấn để truy cập màn hình "Chỉnh sửa hợp đồng" - Tab "Thông tin chi tiết"
- Khi nhấn, hệ thống mở pop-up “Chỉnh sửa hợp đồng” - Tab “Thông tin chi tiết” để người dùng xem thông tin hợp đồng.

...

Tab điều hướng

(Navigation Tab)

...

- Cho phép người dùng nhấn để truy cập màn hình "Chỉnh sửa hợp đồng" - Tab "Lịch sử chỉnh sửa"
- Khi nhấn, hệ thống mở pop-up “Chỉnh sửa hợp đồng” - Tab “Lịch sử chỉnh sửa” để người dùng xem thông tin lịch sử chỉnh sửa.

...

Panel
title API Import danh sách hợp đồng
Method
GET
URL
/application/contract/list
Description
API tìm kiếm hợp đồng
Note
API mới
1. Headers
STT
Field
Source Data Type / Length
Description
Sample Values
1 authorization String Token Bearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjYzOTgyNDUsInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.qRoaRDxjqyWS-3Az_ZqLmR0KAcPTM7jXggW1Ja5wpEc
2. Param
STT
Field
Required
Data Type / Length
Description
Note
1 name false String Từ khóa tìm kiếm theo tên hợp đồng
2 orgId false Integer ID tổ chức (nhà thầu)
3 projectId false Integer ID dự án
4 status false Integer Trạng thái hợp đồng (1: chờ, 2: thực hiện, 3: quyết toán, 4: hủy)
5 contractTypeId false Integer ID loại hợp đồng
6 attachment false Integer Trạng thái đính kèm (-1: tất cả, 0: không có, 1: có)
7 signedAtFrom false Date Ngày ký hợp đồng từ utc format
8 signedAtTo false Date Ngày ký hợp đồng đến utc format
9 page false Integer Trang dữ liệu (phân trang)
10 size false Integer Số bản ghi mỗi trang
3. Response / Incoming Data Specification
STT
Field
Data Type / Length
Description
Note

code Integer 0: thành công, != 0 thất bại

message String

result Object[] danh sách cấu hình grid

id Integer ID hợp đồng

isInWorkflow Integer Có trong quy trình (0: không, 1: có)

status Integer 1: chờ thống nhất, 2: đang thực hiện, 3: đã quyết toán, 4: hủy

contractNo String Số hợp đồng

contractTypeId Integer ID loại hợp đồng

contractName String Tên hợp đồng/gói thầu

projectId Integer ID dự án

organizationId Integer ID nhà thầu

taxCode String Mã số thuế nhà thầu

departmentId Integer ID phòng ban

employeeId Integer ID nhân viên phụ trách

signedAt Timestamp Ngày ký hợp đồng

expectedFinishAt Timestamp Ngày dự kiến hoàn thành

executionTime Integer Thời gian thực hiện (ngày)

warrantyExpiredAt Timestamp Ngày hết hạn bảo hành

amountBeforeTax Decimal(18,2) Giá trị HĐ trước thuế

amountAfterTax Decimal(18,2) Giá trị HĐ sau thuế

adjAmountBeforeTax Decimal(18,2) Giá trị HĐ trước thuế sau điều chỉnh

adjAmountAfterTax Decimal(18,2) Giá trị HĐ sau thuế sau điều chỉnh

currencyUnitId Integer ID đơn vị tiền tệ

exchangeRate String Tỉ giá tương ứng

investorSigningUnitId Integer ID đơn vị chủ đầu tư ký hợp đồng

risk String / Null Rủi ro

potId Integer / Null ID POT

contractAttachments String / Null File đính kèm hợp đồng

appendixAttachments String / Null File đính kèm phụ lục

updatedAt Timestamp Ngày cập nhật

createdAt Timestamp Ngày tạo

contractTypeName String Tên loại hợp đồng

projectName String Tên dự án

organizationName String Tên nhà thầu

departmentName String Tên phòng ban

currencyUnitName String Tên đơn vị tiền tệ

investorSigningUnitName String Tên đơn vị chủ đầu tư ký hợp đồng
Panel
title API get detail hợp đồng
Method
GET
URL
/application/contract/getDetail?id=1
Description
API get chi tiết hợp đồng
Note
API mới
1. Headers
STT
Field
Source Data Type / Length
Description
Sample Values
1 authorization String Token Bearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjYzOTgyNDUsInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.qRoaRDxjqyWS-3Az_ZqLmR0KAcPTM7jXggW1Ja5wpEc
2. Param
STT
Field
Required
Data Type / Length
Description
Note
1 id String

3. Response / Incoming Data Specification
STT
Field
Data Type / Length
Description
Note

code Integer 0: thành công, != 0 thất bại

message String

result Object[] danh sách cấu hình grid

id Integer ID hợp đồng

isInWorkflow Integer Có trong quy trình (0: không, 1: có)

status Integer 1: chờ thống nhất, 2: đang thực hiện, 3: đã quyết toán, 4: hủy

contractNo String Số hợp đồng

contractTypeId Integer ID loại hợp đồng

contractName String Tên hợp đồng/gói thầu

projectId Integer ID dự án

organizationId Integer ID nhà thầu

taxCode String Mã số thuế nhà thầu

departmentId Integer ID phòng ban

employeeId Integer ID nhân viên phụ trách

signedAt Timestamp Ngày ký hợp đồng

expectedFinishAt Timestamp Ngày dự kiến hoàn thành

executionTime Integer Thời gian thực hiện (ngày)

warrantyExpiredAt Timestamp Ngày hết hạn bảo hành

amountBeforeTax Decimal(18,2) Giá trị HĐ trước thuế

amountAfterTax Decimal(18,2) Giá trị HĐ sau thuế

adjAmountBeforeTax Decimal(18,2) Giá trị HĐ trước thuế sau điều chỉnh

adjAmountAfterTax Decimal(18,2) Giá trị HĐ sau thuế sau điều chỉnh

currencyUnitId Integer ID đơn vị tiền tệ

exchangeRate String Tỉ giá tương ứng

investorSigningUnitId Integer ID đơn vị chủ đầu tư ký hợp đồng

risk String / Null Rủi ro

potId Integer / Null ID POT

contractAttachments String / Null File đính kèm hợp đồng

appendixAttachments String / Null File đính kèm phụ lục

updatedAt Timestamp Ngày cập nhật

createdAt Timestamp Ngày tạo

contractTypeName String Tên loại hợp đồng

projectName String Tên dự án

organizationName String Tên nhà thầu

departmentName String Tên phòng ban

currencyUnitName String Tên đơn vị tiền tệ

investorSigningUnitName String Tên đơn vị chủ đầu tư ký hợp đồng

Panel
title API validate hợp đồng
Method
POST
URL
/application/contract/validate
Description
API validate hợp đồng
Note
API mới
1. Headers
STT
Field
Source Data Type / Length
Description
Sample Values
1 authorization String Token Bearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjYzOTgyNDUsInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.qRoaRDxjqyWS-3Az_ZqLmR0KAcPTM7jXggW1Ja5wpEc
2. Param
STT
Field
Required
Data Type / Length
Description
Note
1 contractNo String

3. Response / Incoming Data Specification
STT
Field
Data Type / Length
Description
Note

code Integer 0: thành công, != 0 thất bại

message String

result String

Panel
title API tạo hợp đồng
Method
POST
URL
/application/contract/insert
Description
API tạo hợp đồng
Note
API mới
1. Headers
STT
Field
Source Data Type / Length
Description
Sample Values
1 authorization String Token Bearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjYzOTgyNDUsInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.qRoaRDxjqyWS-3Az_ZqLmR0KAcPTM7jXggW1Ja5wpEc
2. Param
STT
Field
Required
Data Type / Length
Description
Note

id false Integer ID hợp đồng

status false Integer Trạng thái: 1 chờ thống nhất, 2 đang thực hiện, 3 đã quyết toán, 4 hủy

contractNo false String Số hợp đồng

contractTypeId true Integer Loại hợp đồng (bắt buộc)

contractName true String Tên hợp đồng (bắt buộc)

projectId true Integer ID dự án (bắt buộc)

organizationId true Integer ID nhà cung cấp (bắt buộc)

taxCode true String Mã số thuế (bắt buộc)

departmentId false Integer ID phòng ban

employeeId false Integer ID người tạo

signedAtStr true String Ngày ký hợp đồng (dd/MM/yyyy) (bắt buộc)

expectedFinishAtStr true String Ngày dự kiến hoàn thành (dd/MM/yyyy) (bắt buộc)

executionTime true Integer Thời gian thực hiện (ngày) (bắt buộc)

warrantyExpiredAtStr false String Ngày hết hạn bảo hành (dd/MM/yyyy)

amountBeforeTax true BigDecimal Giá trị HĐ trước thuế (bắt buộc)

amountAfterTax true BigDecimal Giá trị HĐ sau thuế (bắt buộc)

adjAmountBeforeTax false BigDecimal Giá trị HĐ trước thuế sau điều chỉnh

adjAmountAfterTax false BigDecimal Giá trị HĐ sau thuế sau điều chỉnh

currencyUnitId true Integer ID tiền tệ (bắt buộc)

exchangeRate true String Tỉ giá tương ứng (bắt buộc)

investorSigningUnitId false Integer Đơn vị chủ đầu tư ký hợp đồng (ID)

risk false String Rủi ro

contractAttachments false String File đính kèm hợp đồng

appendixAttachments false String File đính kèm phụ lục

isInWorkflow true Integer 1: trong quy trình, 0: ngoài quy trình (bắt buộc)

signedAt false Timestamp Ngày ký hợp đồng

expectedFinishAt false Timestamp Ngày dự kiến hoàn thành

warrantyExpiredAt false Timestamp Ngày hết hạn bảo hành

potId false Integer POT ID

investorSigningUnitName false String Tên đơn vị chủ đầu tư ký hợp đồng

departmentName false String Tên phòng ban

contractTypeName false String Tên loại hợp đồng

projectName false String Tên dự án

organizationName false String Tên nhà cung cấp

currencyUnitName false String Tên đơn vị tiền tệ
3. Response / Incoming Data Specification
STT
Field
Data Type / Length
Description
Note

id Integer ID hợp đồng

status Integer Trạng thái: 1 chờ thống nhất, 2 đang thực hiện, 3 đã quyết toán, 4 hủy

contractNo String Số hợp đồng

contractTypeId Integer Loại hợp đồng (bắt buộc)

contractName String Tên hợp đồng (bắt buộc)

projectId Integer ID dự án (bắt buộc)

organizationId Integer ID nhà cung cấp (bắt buộc)

taxCode String Mã số thuế (bắt buộc)

departmentId Integer ID phòng ban

employeeId Integer ID người tạo

signedAtStr String Ngày ký hợp đồng (dd/MM/yyyy) (bắt buộc)

expectedFinishAtStr String Ngày dự kiến hoàn thành (dd/MM/yyyy) (bắt buộc)

executionTime Integer Thời gian thực hiện (ngày) (bắt buộc)

warrantyExpiredAtStr String Ngày hết hạn bảo hành (dd/MM/yyyy)

amountBeforeTax BigDecimal Giá trị HĐ trước thuế (bắt buộc)

amountAfterTax BigDecimal Giá trị HĐ sau thuế (bắt buộc)

adjAmountBeforeTax BigDecimal Giá trị HĐ trước thuế sau điều chỉnh

adjAmountAfterTax BigDecimal Giá trị HĐ sau thuế sau điều chỉnh

currencyUnitId Integer ID tiền tệ (bắt buộc)

exchangeRate String Tỉ giá tương ứng (bắt buộc)

investorSigningUnitId Integer Đơn vị chủ đầu tư ký hợp đồng (ID)

risk String Rủi ro

contractAttachments String File đính kèm hợp đồng

appendixAttachments String File đính kèm phụ lục

isInWorkflow Integer 1: trong quy trình, 0: ngoài quy trình (bắt buộc)

signedAt Timestamp Ngày ký hợp đồng

expectedFinishAt Timestamp Ngày dự kiến hoàn thành

warrantyExpiredAt Timestamp Ngày hết hạn bảo hành

potId Integer POT ID

investorSigningUnitName String Tên đơn vị chủ đầu tư ký hợp đồng

departmentName String Tên phòng ban

contractTypeName String Tên loại hợp đồng

projectName String Tên dự án

organizationName String Tên nhà cung cấp

currencyUnitName String Tên đơn vị tiền tệ
Panel
title API upload tài liệu
Method
PUT
URL
/application/contract/updateAttachment
Description
API upload tài liệu
Note
API mới
1. Headers
STT
Field
Source Data Type / Length
Description
Sample Values
1 authorization String Token Bearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjYzOTgyNDUsInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.qRoaRDxjqyWS-3Az_ZqLmR0KAcPTM7jXggW1Ja5wpEc
2. Param
STT
Field
Required
Data Type / Length
Description
Note

id true Integer ID hợp đồng

contractAttachments false String File đính kèm hợp đồng

appendixAttachments false String File đính kèm phụ lục

employeeId false Integer ID nhân viên phụ trách/tạo hợp đồng

3. Response / Incoming Data Specification
STT
Field
Data Type / Length
Description
Note

id Integer ID hợp đồng

contractAttachments String File đính kèm hợp đồng

appendixAttachments String File đính kèm phụ lục

employeeId Integer ID nhân viên phụ trách/tạo hợp đồng

Panel
title API service Task update
Method
PUT
URL
/application/contract/serviceTask/update
Description
API update service task
Note
API mới
1. Headers
STT
Field
Source Data Type / Length
Description
Sample Values
1 authorization String Token Bearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjYzOTgyNDUsInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.qRoaRDxjqyWS-3Az_ZqLmR0KAcPTM7jXggW1Ja5wpEc
2. Param
STT
Field
Required
Data Type / Length
Description
Note

potId false Integer ID POT (liên quan đến dự án hoặc quy trình)

employeeId false Integer ID nhân viên phụ trách/tạo hợp đồng

contractNo false String Số hợp đồng

status false Integer Trạng thái hợp đồng (1: chờ, 2: thực hiện, 3: quyết toán, 4: hủy)

contractAttachments false String File đính kèm hợp đồng

appendixAttachments false String File đính kèm phụ lục
3. Response / Incoming Data Specification
STT
Field
Data Type / Length
Description
Note

potId
Integer ID POT (liên quan đến dự án hoặc quy trình)

employeeId
Integer ID nhân viên phụ trách/tạo hợp đồng

contractNo
String Số hợp đồng

status
Integer Trạng thái hợp đồng (1: chờ, 2: thực hiện, 3: quyết toán, 4: hủy)

contractAttachments
String File đính kèm hợp đồng

appendixAttachments
String File đính kèm phụ lục

Panel
title API update hợp đồng
Method
PUT
URL
/application/contract/contract/update
Description
API update hợp đồng
Note
API mới
1. Headers
STT
Field
Source Data Type / Length
Description
Sample Values
1 authorization String Token Bearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjYzOTgyNDUsInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.qRoaRDxjqyWS-3Az_ZqLmR0KAcPTM7jXggW1Ja5wpEc
2. Param
STT
Field
Required
Data Type / Length
Description
Note

id false Integer

status false Integer Trạng thái: 1 chờ thống nhất, 2 đang thực hiện, 3 đã quyết toán, 4 hủy

contractNo false String Số hợp đồng

contractTypeId true Integer Loại hợp đồng (bắt buộc)

contractName true String Tên hợp đồng (bắt buộc)

projectId true Integer ID dự án (bắt buộc)

organizationId true Integer ID nhà cung cấp (bắt buộc)

taxCode true String Mã số thuế (bắt buộc)

departmentId false Integer ID phòng ban

employeeId false Integer ID người tạo

signedAtStr true String Ngày ký hợp đồng (dd/MM/yyyy) (bắt buộc)

expectedFinishAtStr true String Ngày dự kiến hoàn thành (dd/MM/yyyy) (bắt buộc)

executionTime true Integer Thời gian thực hiện (ngày) (bắt buộc)

warrantyExpiredAtStr false String Ngày hết hạn bảo hành (dd/MM/yyyy)

amountBeforeTax true BigDecimal Giá trị HĐ trước thuế (bắt buộc)

amountAfterTax true BigDecimal Giá trị HĐ sau thuế (bắt buộc)

adjAmountBeforeTax false BigDecimal Giá trị HĐ trước thuế sau điều chỉnh

adjAmountAfterTax false BigDecimal Giá trị HĐ sau thuế sau điều chỉnh

currencyUnitId true Integer ID tiền tệ (bắt buộc)

exchangeRate true String Tỉ giá tương ứng (bắt buộc)

investorSigningUnitId false Integer Đơn vị chủ đầu tư ký hợp đồng (ID)

risk false String Rủi ro

contractAttachments false String File đính kèm hợp đồng

appendixAttachments false String File đính kèm phụ lục

isInWorkflow true Integer 1: trong quy trình, 0: ngoài quy trình (bắt buộc)

signedAt false Timestamp Ngày ký hợp đồng

expectedFinishAt false Timestamp Ngày dự kiến hoàn thành

warrantyExpiredAt false Timestamp Ngày hết hạn bảo hành

potId false Integer POT ID

investorSigningUnitName false String Tên đơn vị chủ đầu tư ký hợp đồng

departmentName false String Tên phòng ban

contractTypeName false String Tên loại hợp đồng

projectName false String Tên dự án

organizationName false String Tên nhà cung cấp

currencyUnitName false String Tên đơn vị tiền tệ
3. Response / Incoming Data Specification
STT
Field
Data Type / Length
Description
Note

id Integer ID hợp đồng ID POT (liên quan đến dự án hoặc quy trình)

status Integer Trạng thái: 1 chờ thống nhất, 2 đang thực hiện, 3 đã quyết toán, 4 hủy ID nhân viên phụ trách/tạo hợp đồng

contractNo String Số hợp đồng Số hợp đồng

contractTypeId Integer Loại hợp đồng (bắt buộc) Trạng thái hợp đồng (1: chờ, 2: thực hiện, 3: quyết toán, 4: hủy)

contractName String Tên hợp đồng (bắt buộc) File đính kèm hợp đồng

projectId Integer ID dự án (bắt buộc) File đính kèm phụ lục

organizationId Integer ID nhà cung cấp (bắt buộc)

taxCode String Mã số thuế (bắt buộc)

departmentId Integer ID phòng ban

employeeId Integer ID người tạo

signedAtStr String Ngày ký hợp đồng (dd/MM/yyyy) (bắt buộc)

expectedFinishAtStr String Ngày dự kiến hoàn thành (dd/MM/yyyy) (bắt buộc)

executionTime Integer Thời gian thực hiện (ngày) (bắt buộc)

warrantyExpiredAtStr String Ngày hết hạn bảo hành (dd/MM/yyyy)

amountBeforeTax BigDecimal Giá trị HĐ trước thuế (bắt buộc)

amountAfterTax BigDecimal Giá trị HĐ sau thuế (bắt buộc)

adjAmountBeforeTax BigDecimal Giá trị HĐ trước thuế sau điều chỉnh

adjAmountAfterTax BigDecimal Giá trị HĐ sau thuế sau điều chỉnh

currencyUnitId Integer ID tiền tệ (bắt buộc)

exchangeRate String Tỉ giá tương ứng (bắt buộc)

investorSigningUnitId Integer Đơn vị chủ đầu tư ký hợp đồng (ID)

risk String Rủi ro

contractAttachments String File đính kèm hợp đồng

appendixAttachments String File đính kèm phụ lục

isInWorkflow Integer 1: trong quy trình, 0: ngoài quy trình (bắt buộc)

signedAt Timestamp Ngày ký hợp đồng

expectedFinishAt Timestamp Ngày dự kiến hoàn thành

warrantyExpiredAt Timestamp Ngày hết hạn bảo hành

potId Integer POT ID

investorSigningUnitName String Tên đơn vị chủ đầu tư ký hợp đồng

departmentName String Tên phòng ban

contractTypeName String Tên loại hợp đồng

projectName String Tên dự án

organizationName String Tên nhà cung cấp

currencyUnitName String Tên đơn vị tiền tệ

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

3.4.1.2. Màn hình pop-up "Thêm mới hợp đồng"

	Trường thông tin/Nút chức năng	Kiểu dữ liệu	Điều kiện	Quy định	Mô tả
1	Mã HĐ ngoài quy trình BPM

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

Công tắc (Toggle)

Bắt buộc

- Không cho phép người dùng nhấn để thao tác chuyển đổi trạng thái của công tắc

- Khi mở màn hình “Thêm mới hợp đồng”, công tắc được hiển thị mặc định ở trạng thái Bật (ON) và người dùng không được phép thay đổi trạng thái này trong bước tạo mới.

Công tắc

Tắt

Bật (

OFF

ON): Hợp đồng này được xử lý

trong luồng quy trình BPM.Thể hiện công tắc phân loại các hợp đồng có hoặc không được sử dụng trong

ngoài luồng quy trình BPM.

2Trạng thái hợp đồngLựa chọn (Select)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 trạng thái của hợp đồng khi thêm mới đơn 1 hợp đồng.

3

Số hợp đồng

Văn bản (Text

	Thể hiện công tắc phân loại các hợp đồng có hoặc không được sử dụng trong luồng quy trình BPM.
2	Trạng thái hợp đồng	Lựa chọn (Select)	Bắt buộc

Không cho

- Cho phép người dùng

thao tác tương tác (

nhấn

/chọn/sửa).

Thể hiện số hợp đồng

4

Loại hợp đồng

Lựa chọn (Droplist)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 loại hợp đồng

5Tên hợp đồng/ gói thầu

để chọn trạng thái hợp đồng từ danh sách thả xuống của trường:

- Gía trị của trường

- Chờ thống nhất: Khi nhân viên KHTH bấm nút hoàn thành từ 2442 - User Story - Nhân viên kế hoạch - tổng hợp soạn thảo hợp đồng
- Đang thực hiện: Khi nhân viên KHTH bấm nút hoàn thành từ 1556 - User Story - Ký kết và phát hành hợp đồng giấy
- Đã quyết toán: để sẵn chờ tích hợp ERP
- Hủy

- Không được để trống

Thể hiện trạng thái của hợp đồng khi thêm mới đơn 1 hợp đồng.

3

Số hợp đồng

Văn bản (Text)

Bắt buộc

Không cho

Thể hiện thông tin tên hợp đồng/ gói thầu

6

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 tên dự án gói thầu

7

Nhà cung cấp

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 nhà cung cấp

8Mã số thuế (NT)

- Cho phép người dùng

thao tác tương tác (nhấn/chọn/sửa).Phòng ban thực hiện

chọn thông tin số hợp đồng.

- Số hợp đồng là giá trị duy nhất, không được trùng với bất kỳ số hợp đồng nào đã tồn tại.

- Không được để trống.

Thể hiện số hợp đồng

4

Loại hợp đồng

Lựa chọn (Select)

Bắt buộc

- Cho phép chọn loại hợp đồng với trạng thái đang hoạt động từ danh mục loại hợp đồng.

- Sau khi người dùng chọn giá trị loại hợp đồng, giá trị này sẽ được hiển thị trực tiếp trong trường "Loại hợp đồng".

- Không được để trống.

Thể hiện loại hợp đồng

5

Tên hợp đồng/ gói thầ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 mã số thuế nhà thầu

9

Cho phép nhập tên hợp đồng/gói thầu	Thông tin tên hợp đồng/ gói thầu
6	Dự án	Lựa chọn (

Droplist

Select)

Không bắt

Bắt buộc

- Cho phép

chỉnh sửa thông tin phòng ban thực hiện dự án

nhập dự án với trạng thái đang hoạt động từ danh mục loại hợp đồng.

- Sau khi người dùng chỉnh sửa

tên phòng ban thực hiện

giá trị dự án, giá trị này sẽ được hiển thị trực tiếp trong trường "

Phòng ban thực hiện"

Thể hiện tên phòng ban thực hiện

10

Ngày ký hợp đồng

Thời gian (Date - Time)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ý hợp đồng

11

Ngày hiệu lực

Thời gian (Date - Time)Bắt buộc

Dự án".

- Không được để trống.

Thể hiện tên dự án gói thầu

7

Nhà cung cấp

Lựa chọn (Select)

Bắt buộc

- Cho phép chọn nhà cung cấp với trạng thái hoạt động từ danh mục NT/NCC.

- Sau khi người dùng chọn giá trị trong trường “Nhà cung cấp” và tự động hiển thị giá trị trong trường Mã số thuế (số thứ tự 8) tương ứng.

- Không được để trống.

Thể hiện tên nhà cung cấp

8

Mã số thuế (NT)

Văn bản (Text)

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 hiệu lực hợp đồng

12Ngày dự kiến hoàn thành

Thời gian (Date - Time)Bắt buộc

- Cho phép chỉnh sửa thông tin ngày dự kiến hoàn thành

-

- Sau khi người dùng

chỉnh sửa ngày dự kiến hoàn thành, giá trị này được hiển thị trực tiếp trong trường "Ngày dự kiến hoàn thành"

Thể hiện ngày dự kiến hoàn thành triển khai hợp đồng

13Thời gian thực hiệnSố (Number)Bắt buộc- Cho phép chỉnh sửa thông tin thời gian thực hiện

chọn giá trị trong trường “Nhà cung cấp”, hệ thống tự động hiển thị giá trị trong trường Mã số thuế tương ứng.

Thể hiện mã số thuế nhà thầu

9

Phòng ban thực hiện

Lựa chọn (Droplist)

Không bắt buộc

- Cho phép chọn phòng ban thực hiện

-Dữ liệu được lấy thông tin từ danh mục "Quản lý người dùng/ Cài đặt cơ sở/ Danh sách phòng ban)

- Sau khi người dùng

chỉnh sửa thời gian

chọn giá trị phòng ban thực hiện, giá trị này sẽ được hiển thị trực tiếp trong trường "

Thời gian

Phòng ban thực hiện".

- Không được để trống.

Thông tin

thời gian số ngày triển khai thực hiện hợp đồng 14

Ngày hết hạn bảo hành

Thời gian (Date - Time

phòng ban thực hiển dự án
10	Ngày ký hợp đồng	Bộ chọn ngày (Date picker)	Bắt buộc	- Cho phép

chỉnh sửa thông tin ngày hết hạn bảo hành

người dùng nhấn để chọn giá trị ngày ký của hợp đồng.

- Sau khi người dùng

chỉnh sửa ngày hết hạn bảo hành

chọn ngày và lưu, giá trị

này

ngày được hiển thị trực tiếp trong trường "Ngày

hết hạn bảo hành"

Thông tin thời gian hết hạn bảo hành

15Đơn vị chủ đầu tư

ký hợp đồng

Lựa chọn (Droplist)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ông tin đơn vị chủ đầu tư ký hợp đồng

16

Giá trị HĐ trước thuế

Số (Number

".

- Không được để trống.

Thể hiện ngày ký hợp đồng

11

Ngày dự kiến hoàn thành

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

Bắt buộc

Không cho

- Cho phép người dùng

thao tác tương tác (nhấn/chọn/sửa)

nhấn để chọn giá trị ngày dự kiến hoàn thành của hợp đồng.

- Không được để trống

Thể hiện

giá trị

ngày dự kiến hoàn thành triển khai hợp đồng

trước thuếGiá trị HĐ sau thuế

17

12

Thời gian thực hiện (ngày)

Số (Number)

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 giá trị hợp đồng sau thuế

18Giá trị HĐ trước thuế sau điều chỉnhSố (Number)Không bắt buộc- Cho phép chỉnh sửa giá trị HĐ trước thuế sau điều chỉnh

- Cho phép nhập số dương (số nguyên hoặc số thập phân) với giá trị > 0

- Sau khi người dùng nhập số ngày thực hiện công việc, giá trị ngày được hiển thị trực tiếp trong trường "Thời gian thực hiện".

Thông tin thời gian số ngày triển khai thực hiện hợp đồng

13

Ngày hết hạn bảo hành

Thời gian (Date - Time)

Bắt buộc

- Cho phép nhập ngày hết hạn bảo hành

- Sau khi người dùng nhập

giá trị hợp đồng trước thuế sau điều chỉnhgiá trị hợp đồng sau thuế sau điều chỉnh

số ngày thực hiện công việc, giá trị ngày được hiển thị trực tiếp trong trường "

Giá trị HĐ trước thuế sau điều chỉnh".

-Thể hiện giá trị hợp đồng trước thuế khi bổ sung phụ lục

19Giá trị HĐ sau thuế sau điều chỉnhSố (Number)Không bắt buộc

- Cho phép chỉnh sửa HĐ sau thuế sau điều chỉnh.

- Sau khi người dùng chỉnh sửa

Thời gian thực hiện (ngày)"

- Không được để trống

Thông tin thời gian hết hạn bảo hành

14

Đơn vị chủ đầu tư ký hợp đồng

Lựa chọn (Select)

Bắt buộc

- Cho phép nhập tên đơn vị chủ đầu tư ký hợp đồng với trạng thái đang hoạt động ký hợp đồng từ danh mục quản lý người dùng/cài đặt cơ sở/danh sách chi nhánh

- Sau khi người dùng nhập tên đơn vị chủ đầu tư ký hợp đồng, giá trị ngày được hiển thị trực tiếp trong trường "

Giá trị HĐ sau thuế sau điều chỉnh".-Thể hiện giá trị hợp đồng sau thuế khi bổ sung phụ lục20

Đơn vị tiền tệ

Văn bản (Text)Không bắt buộcKhông cho phép người dùng thao tác tương tác (nhấn/chọn/sửa).

- Thể hiện đơn vị tiền tệ sử dụng cho hợp đồng

21

Tỉ giá tương ứng

Văn bản (Text)Không bắt buộcKhô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ỷ giá quy đổi của ngoại tệ (nếu có)

22Rủi roVăn bản (Text) areaKhô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 tỷ giá quy đổi của ngoại tệ (nếu có)

23File hợp đồng đính kèmNút chức năng (Button

Tên đơn vị chủ đầu tư ký hợp đồng".	Thông tin đơn vị chủ đầu tư ký hợp đồng
15	Giá trị HĐ trước thuế	Số (Number)	Bắt buộc	- Cho phép nhập giá trị hợp đồng trước thuế - Sau khi người dùng nhập giá trị hợp đồng trước thuế, giá trị ngày được hiển thị trực tiếp trong trường "Giá trị hợp đồng trước thuế". - Không được để trống	Thể hiện giá trị hợp đồng trước thuế
16	Giá trị HĐ sau thuế	Số (Number)	Bắt buộc	- Cho phép nhập giá trị giá trị hợp đồng sau thuế. - Sau khi người dùng nhập giá trị hợp đồng sau thuế, giá trị ngày được hiển thị trực tiếp trong trường "Giá trị hợp đồng sau thuế.". - Không được để trống	Thể hiện giá trị hợp đồng sau thuế
17	Giá trị HĐ trước thuế sau điều chỉnh	Số (Number)	Không bắt buộc	- Cho phép

chỉnh sửa dữ liệu

- Cho phép người dùng xem lại tài liệu đính kèm

- Cho phép người dùng tải về tài liệu đính kèm

-Cho phép người dùng up file dữ liệu lên

Thể hiện file hợp đồng hợp đồng được ký kết

24File phụ lục đính kèmNút chức năng (Button

nhập giá trị giá trị hợp đồng trước thuế sau điều chỉnh.

- Sau khi người dùng nhập giá trị hợp đồng trước thuế sau điều chỉnh, giá trị ngày được hiển thị trực tiếp trong trường "Giá trị HĐ trước thuế sau điều chỉnh".

Thể hiện giá trị hợp đồng trước thuế khi bổ sung phụ lục

18

Giá trị HĐ sau thuế sau điều chỉnh

Số (Number)

Không bắt buộc

- Cho phép

chỉnh sửa dữ liệu

- Cho phép người dùng xem lại tài liệu đính kèm

- Cho phép người dùng tải về tài liệu đính kèm

-Cho phép người dùng up file dữ liệu lên

Thể hiện file phụ lục hợp đồng được ký kết

25Nú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 "Thêm mới hợp đồng" đóng lại và hệ thống điều hướng về màn hình "Danh sách hợp đồng.

- Màn hình "Danh sách hợp đồng: Tham chiếu mục 3.4.1. Màn hình "Danh sách hợp đồng.

Thể hiện nút đóng cho phép hủy bỏ thao tác chỉnh sửa đơn 1 hợp đồng.26Nú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 đơn 1 hợp đồng

- 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 đủ.
- Ngày dự kiến hoàn thành mới > Ngày hợp đồng/Ngày hiệu lực mới.
- Ngày hết hạn bảo hành mới > Ngày dự kiến hoàn thành mới/ Ngày hợp đồng mới/Ngày hiệu lực mới).
- Số hợp đồng 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ành vi 1: Hợp đồng được chỉnh sửa hiển thị với giá trị trạng thái mặc định là "Hoạt động".
- Hành vi 2: 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: Chỉnh sửa hợp đồng thành công

Thể hiện nút đóng cho phép lưu thông tin hợp đồng.

27Nút "Hủy

nhập giá trị giá trị hợp đồng sau thuế sau điều chỉnh. - Sau khi người dùng nhập giá trị hợp đồng sau thuế sau điều chỉnh, giá trị ngày được hiển thị trực tiếp trong trường "Giá trị HĐ sau thuế sau điều chỉnh".	Thể hiện giá trị hợp đồng sau thuế khi bổ sung phụ lục
19	Đơn vị tiền tệ	Lựa chọn (Select)	Bắt buộc	- Cho phép chọn tên đơn vị tiền tệ trạng thái hoạt động từ danh mục đơn vị tiền tệ - Sau khi người dùng nhập đơn vị tiền tệ, giá trị ngày được hiển thị trực tiếp trong trường "Đơn vị tiền tệ". - Không được để trống	Thể hiện đơn vị tiền tệ sử dụng cho hợp đồng
20	Tỉ giá tương ứng	Số (number)	Bắt buộc	- Cho phép chọn tỷ giá tương đương với đơn vị tệ tương ứng - Sau khi người dùng nhập tỷ giá tương đương với đơn vị tệ tương ứng, giá trị ngày được hiển thị trực tiếp trong trường "Tỉ giá tương ứng". - Không được để trống	Thể hiện tỷ giá quy đổi của ngoại tệ (nếu có)
21	Rủi ro	Văn bản (Text) area	Không bắt buộc	- Cho phép nhập rủi ro hợp đồng - Sau khi người dùng nhập thông tin rủi ro, giá trị ngày được hiển thị trực tiếp trong trường "Rủi ro". - Không được để trống	Thể hiện rủi ro của hợp đồng
22	File hợp đồng đính kèm	Nút chức năng (Button)	Không bắt buộc	Cho phép nhấn để tải lên file đính kèm file HĐ	Thể hiện nút tải lên file phụ lục được ký kết
23	File phụ lục đính kèm	Nút chức năng (Button)	Không bắt buộc	Cho phép nhấn để tải lên file phụ lục hợp đồng	Thể hiện nút tải lên phụ lục được ký kết
24	Nú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

thêm mới đơn 1 hợp đồng.
- Khi nhấn, màn hình pop-up "Thêm mới hợp đồng" đóng lại và hệ thống điều hướng về màn hình "Danh sách hợp đồng.

- Màn hình "Danh sách hợp đồng: Tham chiếu mục 3.4.1. Màn hình "Danh sách hợp đồng.

Thể hiện nút

"Hủy" để

đóng cho phép hủy bỏ thao tác

chỉnh sửa

thêm mới đơn 1 hợp đồng.

28

Tab điều hướng

(Navigation Tab

25

Tab "Thông tin chi tiết"

Nú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 để

truy cập màn hình "Chỉnh sửa hợp đồng" - Tab "Thông tin chi tiết"
- Khi nhấn, hệ thống mở pop-up “Chỉnh sửa hợp đồng” - Tab “Thông tin chi tiết” để người dùng xem thông tin hợp đồng.Thể hiện toàn bộ thông tin chi tiết của hợp đồng ở dạng chỉ xem.29Tab "Lịch sử chỉnh sửa"

Tab điều hướng

(Navigation Tab)

Không bắt buộc

- Cho phép người dùng nhấn để truy cập màn hình "Chỉnh sửa hợp đồng" - Tab "Lịch sử chỉnh sửa"
- Khi nhấn, hệ thống mở pop-up “Chỉnh sửa hợp đồng” - Tab “Lịch sử chỉnh sửa” để người dùng xem thông tin lịch sử chỉnh sửa.

Thể hiện danh sách các lần chỉnh sửa hợp đồng kèm thời gian, người thực hiện và chi tiết thay đổi.

3.4.1.3.3. Màn hình pop-up "Chỉnh sửa hợp đồng" - Tab "Lịch sử chỉnh sửa"

Trường thông tin/Nút chức năng	Kiểu dữ liệu	Điều kiện	Quy định	Mô tả
1	Thời gian	Thời gian (Date - Time)	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 thời điểm hệ thống ghi nhận hành động được thực hiện
2	Người thực hiện	Văn bản (Text)	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 tên nhân sự đã thực hiện thao tác trên thông tin chi tiết hợp đồng
3	Chi tiết thay đổi	Đường dẫn (Hyperlink)	Không bắt buộc	- Cho phép người dùng nhấn để truy cập màn hình "Chỉnh sửa hợp đồng" - Tab "Lịch sử chỉnh sửa" - Khi nhấn, hệ thống hiển thị màn hình "Xem chi tiết lịch sử". - Màn hình "Xem chi tiết hợp đồng": tham chiếu mục 3.4.1.3.4. Màn hình pop-up "Xem chi tiết hợp đồng".	Thông tin chi tiết thay đổi lịch sử chỉnh sửa hệ thống
4	Nút "X lưu thông tin thêm mới đơn 1 hợp đồng - Trong mỗi trường hợp, hệ thống xử lý như sau: Trường hợp 1: Thêm mới dữ liệu hợp lệ: Điều kiện: Tất cả các trường bắt buộc được nhập đầy đủ. Ngày dự kiến hoàn thành > Ngày hợp đồng Ngày hết hạn bảo hành > Ngày dự kiến hoàn thành Số hợp đồng 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: Hợp đồng được thêm mới hiển thị với giá trị trạng thái mặc định là "Hoạt độ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: Thêm mới hợp đồng thành công Trường hợp 2: Thêm mới dữ liệu không hợp lệ: Điều kiện: Trường bắt buộc KHÔNG được nhập đầy đủ Trường đặc thù được nhập dữ liệu KHÔNG HỢP LỆ gồm: Ngày dự kiến hoàn thành < Ngày ký hợp đồng Ngày hết hạn bảo hành < Ngày dự kiến hoàn thành Số hợp đồng không trùng với bản ghi sẵn có trong hệ thống. Thời gian thực hiện (ngày): Nhập dấu phẩy “,” hoặc dấu chấm “.” nhưng không phải số hợp lệ (ví dụ: , ; . ; 1..2) Nhập số âm ( -5, -10 ) Nhập số bằng 0 Hành vi hệ thống: Kiểm tra dữ liệu tại dòng (inline validation) và hiển thị cảnh báo ngay dưới trường nhập chưa đầy đủ/không hợp lệ hoặc hiển thị pop-up cảnh báo như sau: Ngày dự kiến hoàn thành < Ngày ký hợp đồng → Hiển thị pop-up cảnh báo: Tham chiếu mục 3.4.3. Màn hình pop-up cảnh báo Ngày hết hạn bảo hành < Ngày dự kiến hoàn thành → Hiển thị pop-up cảnh báo: Tham chiếu mục 3.4.3. Màn hình pop-up cảnh báo Thời gian thực hiện (ngày) → Hiển thị cảnh báo ngay dưới trường: Giá trị không hợp lệ Không đóng màn hình pop-up Thêm mới hợp đồng	Thể hiện nút cho phép lưu thông tin hợp đồng.
26	Nú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 xem thông tin chung về lịch sử chỉnh sửathêm mới đơn 1 hợp đồng. - Khi nhấn, màn hình pop-up "Chỉnh sửa Thêm mới hợp đồng" đóng lại và hệ thống điều hướng về màn hình "Xem chi tiết hình "Danh sách hợp đồng - Tab Thông tin chi tiết.	Thể hiện nút đóng cho phép hủy bỏ thao tác xem thông tin chung về lịch sử chỉnh sửa.	. - Màn hình "Danh sách hợp đồng: Tham chiếu mục 3.4.1.

...

Màn hình

...

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

...

Kiểu dữ liệu

...

Điều kiện

...

Quy định

...

Mô tả

...

- Cho phép người dùng nhấn để hủy bỏ thao tác xem thông tin chi tiết lịch sử chỉnh sửa.
- Khi nhấn, màn hình pop-up "Chỉnh sửa hợp đồng" đóng lại và hệ thống điều hướng về màn hình "Xem chi tiết hợp đồng - Tab Thông tin chi tiết.

...

Image RemovedChi tiết lịch sử chỉnh sửa

...

- Cho phép người dùng nhấn Image Removedđể quay về màn hình "Xem chi tiết hợp đồng - Tab Thông tin chi tiết.
- Khi nhấn, màn hình pop-up "Chỉnh sửa hợp đồng" đóng lại và hệ thống điều hướng về màn hình "Xem chi tiết hợp đồng - Tab Thông tin chi tiết.

...

3.4.1.4. Màn hình pop-up "Cài đặt hiển thị"

- Cho phép người dùng nhấn để thao tác chuyển đổi trạng thái của công tắc

Công tắc Bật (ON): Hệ thống hiển thị trường trên màn hình "Danh sách hợp đồng"
Công tắc Tắt (OFF): Hệ thống không hiển thị trường trên màn hình "Danh sách hợp đồng"

- Cho phép người dùng nhấn để thao tác chuyển đổi trạng thái của công tắc

Công tắc Bật (ON): Hệ thống hiển thị trường trên màn hình "Danh sách hợp đồng"
Công tắc Tắt (OFF): Hệ thống không hiển thị trường trên màn hình "Danh sách hợp đồng"

Nút "Đặt lại mặc định"

Trường thông tin/Nút chức năng	Kiểu dữ liệu	Điều kiện	Quy định	Mô tả
1	Dự án	Công tắc (Toggle)	Không bắt buộc	- Cho phép người dùng nhấn để thao tác chuyển đổi trạng thái của công tắc Công tắc Bật (ON): Hệ thống hiển thị trường trên màn hình "Danh sách hợp đồng" Công tắc Tắt (OFF): Hệ thống không hiển thị trường trên màn hình "Danh sách hợp đồng"	Thể hiện trường thông tin "Dự án" cùng với công tắc (toggle switch).
2	Mã số thuế	Công tắc (Toggle)	Không bắt buộc	- Cho phép người dùng nhấn để thao tác chuyển đổi trạng thái của công tắc Công tắc Bật (ON): Hệ thống hiển thị trường trên màn hình "Danh sách hợp đồng" Công tắc Tắt (OFF): Hệ thống không hiển thị trường trên màn hình "Danh sách hợp đồng"	Thể hiện trường thông tin "Mã số thuế" cùng với công tắc (toggle switch).
3	Phòng ban thực hiệ	Công tắc (Toggle)	Không bắt buộc	- Cho phép người dùng nhấn để thao tác chuyển đổi trạng thái của công tắc Công tắc Bật (ON): Hệ thống hiển thị trường trên màn hình "Danh sách hợp đồng" Công tắc Tắt (OFF): Hệ thống không hiển thị trường trên màn hình "Danh sách hợp đồng"	Thể hiện trường thông tin "Phòng ban thực hiện" cùng với công tắc (toggle switch).
4	Ngày hiệu lực	Công tắc (Toggle)	Không bắt buộc	- Cho phép người dùng nhấn để thao tác chuyển đổi trạng thái của công tắc Công tắc Bật (ON): Hệ thống hiển thị trường trên màn hình "Danh sách hợp đồng" Công tắc Tắt (OFF): Hệ thống không hiển thị trường trên màn hình "Danh sách hợp đồng"	Thể hiện trường thông tin "Ngày hiệu lực" cùng với công tắc (toggle switch).
5	Ngày dự kiến hoàn thành	Công tắc (Toggle)	Không bắt buộc	- Cho phép người dùng nhấn để thao tác chuyển đổi trạng thái của công tắc Công tắc Bật (ON): Hệ thống hiển thị trường trên màn hình "Danh sách hợp đồng" Công tắc Tắt (OFF): Hệ thống không hiển thị trường trên màn hình "Danh sách hợp đồng"	Thể hiện trường thông tin "Ngày dự kiến hoàn thành" cùng với công tắc (toggle switch).
6	Thời gian thực hiện	Công tắc (Toggle)	Không bắt buộc	- Cho phép người dùng nhấn để thao tác chuyển đổi trạng thái của công tắc Công tắc Bật (ON): Hệ thống hiển thị trường trên màn hình "Danh sách hợp đồng" Công tắc Tắt (OFF): Hệ thống không hiển thị trường trên màn hình "Danh sách hợp đồng"	Thể hiện trường thông tin "Thời gian thực hiện" cùng với công tắc (toggle switch).
7	Ngày hết hạn bảo hành	Công tắc (Toggle)	Không bắt buộc	Thể hiện trường thông tin "Ngày hết hạn bảo hành" cùng với công tắc (toggle switch).	8	Đơn vị chủ đầu tư ký hợp đồng	Công tắc (Toggle)	Không bắt buộc	Thể hiện trường thông tin "Đơn vị chủ đầu tư ký hợp đồng" cùng với công tắc (toggle switch).
9	Giá trị HĐ sau thuế	Công tắc (Toggle)	Không bắt buộc	- Cho phép người dùng nhấn để thao tác chuyển đổi trạng thái của công tắc Công tắc Bật (ON): Hệ thống hiển thị trường trên màn hình "Danh sách hợp đồng" Công tắc Tắt (OFF): Hệ thống không hiển thị trường trên màn hình "Danh sách hợp đồng"	Thể hiện trường thông tin "Giá trị HĐ sau thuế" cùng với công tắc (toggle switch).
10	Giá trị HĐ sau thuế sau điều chỉnh	Công tắc (Toggle)	Không bắt buộc	- Cho phép người dùng nhấn để thao tác chuyển đổi trạng thái của công tắc Công tắc Bật (ON): Hệ thống hiển thị trường trên màn hình "Danh sách hợp đồng" Công tắc Tắt (OFF): Hệ thống không hiển thị trường trên màn hình "Danh sách hợp đồng"	Thể hiện trường thông tin "Giá trị HĐ sau thuế sau điều chỉnh" cùng với công tắc (toggle switch).
11	Đơn vị tiền tệ	Công tắc (Toggle)	Không bắt buộc	- Cho phép người dùng nhấn để thao tác chuyển đổi trạng thái của công tắc Công tắc Bật (ON): Hệ thống hiển thị trường trên màn hình "Danh sách hợp đồng" Công tắc Tắt (OFF): Hệ thống không hiển thị trường trên màn hình "Danh sách hợp đồng"	Thể hiện trường thông tin "Đơn vị tiền tệ" cùng với công tắc (toggle switch).
12	Tỉ giá tương ứng	Công tắc (Toggle)	Không bắt buộc	- Cho phép người dùng nhấn để thao tác chuyển đổi trạng thái của công tắc Công tắc Bật (ON): Hệ thống hiển thị trường trên màn hình "Danh sách hợp đồng" Công tắc Tắt (OFF): Hệ thống không hiển thị trường trên màn hình "Danh sách hợp đồng"	Thể hiện trường thông tin "Tỉ giá tương ứng" cùng với công tắc (toggle switch).
13	Rủi ro	Công tắc (Toggle)	Không bắt buộc	- Cho phép người dùng nhấn để thao tác chuyển đổi trạng thái của công tắc Công tắc Bật (ON): Hệ thống hiển thị trường trên màn hình "Danh sách hợp đồng" Công tắc Tắt (OFF): Hệ thống không hiển thị trường trên màn hình "Danh sách hợp đồng"	Thể hiện trường thông tin "Rủi ro" cùng với công tắc (toggle switch).
14	Nú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 cài đặt hiển thị - Khi nhấn, màn hình pop-up "Cài đặt hiển thị" đóng lại và hệ thống điều hướng về màn hình "Danh sách hợp đồng. - Màn hình "Danh sách hợp đồng: Tham chiếu mục 3.4.1. Màn hình "Danh sách hợp đồng.	Thể hiện nút đóng cho phép hủy bỏ thao tác cài đặt hiển thị
15	Nú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 cài đặt hiển thị đã thiết lập - Khi nhấn nút, hành vi hệ thống như sau: Hành vi 1: Hệ thống ghi lại cài đặt hiển thị đã thiết lập là trạng thái Bật/Tắt của các trường vào cache của trình duyệt trên máy tính người dùng. Hành vi 2: Pop-up "Cài đặt hiển thị" sẽ đóng lại Hành vi 3: Hệ thống tải lại hoặc cập nhật ngay lập tức màn hình "Danh sách hợp đồng để áp dụng cấu hình hiển thị mới đã thiết lập.	Thể hiện nút "Áp dụng" để lưu cài đặt hiển thị
16	Nú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 cài đặt hiển thị - Khi nhấn, màn hình pop-up "Cài đặt hiển thị" đóng lại và hệ thống điều hướng về màn hình "Danh sách hợp đồng. - Màn hình "Danh sách hợp đồng: Tham chiếu mục 3.4.1. Màn hình "Danh sách hợp đồng.	Thể hiện nút "Hủy" để thực hiện hủy bỏ thao tác cài đặt hiển thị
17	"Danh sách hợp đồng.	Thể hiện nút Hủy để để hủy bỏ thao tác thêm mới đơn 1 hợp đồng.

3.4.1.3. Màn hình pop-up "Chỉnh sửa hợp đồng"

3.4.1.3.1. Màn hình pop-up "Chỉnh sửa hợp đồng" - Tab "Thông tin chi tiết" với mã quy định HĐ NGOÀI quy trình BPM

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

Kiểu dữ liệu

Điều kiện

Quy định

Mô tả

1

HĐ ngoài quy trình BPM

Toggle nhấn để khôi phục cấu hình hiển thị về màn hình "Danh sách hợp đồng" ban đầu với những trường thông tin bắt buộc gồm:

Số hợp đồng
Loại hợp đồng
Tên hợp đồng/ gói thầu
HĐ ngoài quy trình BPM
Nhà cung cấp
Ngày ký hợp đồng
Giá trị HĐ trước thuế
Giá trị HĐ sau thuế
Giá trị HĐ trước thuế sau điều chỉnh
Giá trị HĐ sau thuế sau điều chỉnh

- Màn hình "Danh sách hợp đồng: Tham chiếu mục 3.4.1. Màn hình "Danh sách hợp đồng.

	Trường thông tin/Nút chức năng	Kiểu dữ liệu	Điều kiện	Quy định	Mô tả
1	HĐ ngoài quy trình BPM	Toggle Nút chức năng (Button)	Bắt buộc	- Khi mở màn hình “Thêm mới hợp đồng”, công tắc được hiển thị mặc định ở trạng thái Bật (ON) và người dùng không được phép thay đổi trạng thái này trong bước tạo mới. Công tắc Bật (ON): Hợp đồng này được xử lý ngoài luồng quy trình BPM.	Thể hiện công tắc phân loại các hợp đồng có hoặc không được sử dụng trong luồng quy trình BPM.
2	Trạng thái hợp đồng	Lựa chọn (Select)	Bắt buộc	- Cho phép người dùng nhấn để chỉnh sửa trạng thái hợp đồng từ danh sách thả xuống của trường: - Gía trị của trường Chờ thống nhất Đang thực hiện Đã quyết toán Hủy - Không được để trống	Thể hiện trạng thái của hợp đồng khi thêm mới đơn 1 hợp đồng.
3	Số hợp đồng	Văn bản (Text)	Bắt buộc	- Cho phép người dùng chỉnh sửa thông tin số hợp đồng. - Số hợp đồng là giá trị duy nhất, không được trùng với bất kỳ số hợp đồng nào đã tồn tại. - Không được để trống.	Thể hiện số hợp đồng
4	Loại hợp đồng	Lựa chọn (Droplist)	Bắt buộc	- Cho phép chỉnh sửa loại hợp đồng với trạng thái đang hoạt động từ danh mục loại hợp đồng. - Sau khi người dùng chỉnh sửa giá trị loại hợp đồng, giá trị này sẽ được hiển thị trực tiếp trong trường "Loại hợp đồng". - Không được để trống.	Thể hiện loại hợp đồng
5	Tên hợp đồng/ gói thầu	Văn bản (Text)	Bắt buộc	Cho phép chỉnh sửa tên hợp đồng/gói thầu	Thông tin tên hợp đồng/ gói thầu
6	Dự án	Văn bản (Text)	Bắt buộc	- Cho phép chỉnh sửa dự án với trạng thái đang hoạt động từ danh mục loại hợp đồng. - Sau khi người dùng chỉnh sửa giá trị dự án, giá trị này sẽ được hiển thị trực tiếp trong trường "Dự án". - Không được để trống.	Thể hiện tên dự án gói thầu
7	Nhà cung cấp	Văn bản (Text)	Bắt buộc	- Cho phép chỉnh sửa dự án với trạng thái đang hoạt động từ danh mục NT/NCC. - Sau khi người dùng chỉnh sửa giá trị trong trường “Nhà cung cấp” và tự động hiển thị giá trị trong trường Mã số thuế (số thứ tự 8) tương ứng. - Không được để trống.	Thể hiện tên nhà cung cấp
8	Mã số thuế (NT)	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). - Sau khi người dùng chọn giá trị trong trường “Nhà cung cấp”, hệ thống tự động hiển thị giá trị trong trường Mã số thuế tương ứng.	Thể hiện mã số thuế nhà thầu
9	Phòng ban thực hiện	Lựa chọn (Droplist)	Không bắt buộc	- Cho phép chỉnh sửa phòng ban thực hiện -Dữ liệu được lấy thông tin từ danh mục "Quản lý người dùng/ Cài đặt cơ sở/ Danh sách phòng ban) - Sau khi người dùng chỉnh sửa giá trị phòng ban thực hiện, giá trị này sẽ được hiển thị trực tiếp trong trường "Phòng ban thực hiện". - Không được để trống.	Cho phép chỉnh sửa thông tin phòng ban thực hiện dự án
10	Ngày ký hợp đồng	Thời gian (Date )	Bắt buộc	- Cho phép người dùng nhấn để chỉnh sửa giá trị ngày ký của hợp đồng. - Sau khi người dùng chỉnh sửa ngày và lưu, giá trị ngày được hiển thị trực tiếp trong trường "Ngày ký hợp đồng". - Không được để trống.	Thể hiện ngày ký hợp đồng
11	Ngày dự kiến hoàn thành	Thời gian (Date )	Bắt buộc	- Cho phép người dùng nhấn để chỉnh sửa giá trị ngày dự kiến hoàn thành của hợp đồng. - Không được để trống	Thể hiện ngày dự kiến hoàn thành triển khai hợp đồng
12	Thời gian thực hiện	Số (Number)	Bắt buộc	- Cho phép chỉnh sửa số ngày thực hiện công việc - Sau khi người dùng nhập số ngày thực hiện công việc, giá trị ngày được hiển thị trực tiếp trong trường "Thời gian thực hiện".	Thông tin thời gian số ngày triển khai thực hiện hợp đồng
13	Ngày hết hạn bảo hành	Thời gian (Date )	Bắt buộc	- Cho phép chỉnh sửa ngày hết hạn bảo hành - Sau khi người dùng chỉnh sửa số ngày thực hiện công việc, giá trị ngày được hiển thị trực tiếp trong trường "Thời gian thực hiện" - Không được để trống	Thông tin thời gian hết hạn bảo hành
14	Đơn vị chủ đầu tư ký hợp đồng	Lựa chọn (Droplist)	Bắt buộc	- Cho phép chỉnh sửa tên đơn vị chủ đầu tư ký hợp đồng với trạng thái đang hoạt động ký hợp đồng từ danh mục quản lý người dùng/cài đặt cơ sở/danh sách chi nhánh - Sau khi người dùng chỉnh sửa tên đơn vị chủ đầu tư ký hợp đồng, giá trị ngày được hiển thị trực tiếp trong trường "Tên đơn vị chủ đầu tư ký hợp đồng".	Thông tin đơn vị chủ đầu tư ký hợp đồng
15	Giá trị HĐ trước thuế	Số (Number)	Bắt buộc	- Cho phép chỉnh sửa giá trị hợp đồng trước thuế - Sau khi người dùng chỉnh sửa giá trị hợp đồng trước thuế, giá trị ngày được hiển thị trực tiếp trong trường "Giá trị hợp đồng trước thuế". - Không được để trống	Thể hiện giá trị hợp đồng trước thuế
16	Giá trị HĐ sau thuế	Số (Number)	Bắt buộc	- Cho phép người dùng chỉnh sửa giá trị hợp đồng sau thuế. - Sau khi người dùng chỉnh sửa giá trị hợp đồng sau thuế, giá trị ngày được hiển thị trực tiếp trong trường "Giá trị hợp đồng sau thuế.". - Không được để trống	Thể hiện giá trị hợp đồng sau thuế
17	Giá trị HĐ trước thuế sau điều chỉnh	Số (Number)	Không bắt buộc	- Cho phép nhập giá trị hợp đồng trước thuế sau điều chỉnh. - Sau khi người dùng nhập giá trị hợp đồng trước thuế sau điều chỉnh, giá trị ngày được hiển thị trực tiếp trong trường "Giá trị HĐ trước thuế sau điều chỉnh".	Thể hiện giá trị hợp đồng trước thuế khi bổ sung phụ lục
18	Giá trị HĐ sau thuế sau điều chỉnh	Số (Number)	Không bắt buộc	- Cho phép chỉnh sửa giá trị giá trị hợp đồng sau thuế sau điều chỉnh. - Sau khi người dùng chỉnh sửa giá trị hợp đồng sau thuế sau điều chỉnh, giá trị ngày được hiển thị trực tiếp trong trường "Giá trị HĐ sau thuế sau điều chỉnh".	Thể hiện giá trị hợp đồng sau thuế khi bổ sung phụ lục
19	Đơn vị tiền tệ	Văn bản (Text)	Không bắt buộc	- Cho phép chọn chỉnh sửa đơn vị tiền tệ trạng thái hoạt động từ danh mục đơn vị tiền tệ - Sau khi người dùng chỉnh sửa đơn vị tiền tệ, giá trị ngày được hiển thị trực tiếp trong trường "Đơn vị tiền tệ". - Không được để trống	Thể hiện đơn vị tiền tệ sử dụng cho hợp đồng
20	Tỉ giá tương ứng	Văn bản (Text)	Không bắt buộc	- Cho phép chỉnh sửa tỷ giá tương đương với đơn vị tệ tương ứng - Sau khi người dùng chỉnh sửa tỷ giá tương đương với đơn vị tệ tương ứng, giá trị ngày được hiển thị trực tiếp trong trường "Tỉ giá tương ứng". - Không được để trống	Thể hiện tỷ giá quy đổi của ngoại tệ (nếu có)
21	Rủi ro	Văn bản (Text) area	Không bắt buộc	- Cho phép chỉnh sửa rủi ro hợp đồng - Sau khi người dùng chỉnh sửa thông tin rủi ro, giá trị ngày được hiển thị trực tiếp trong trường "Rủi ro". - Không được để trống	Thể hiện tỷ giá quy đổi của ngoại tệ (nếu có)
22	File hợp đồng đính kèm	Nút chức năng (Button)	Không bắt buộc	- Cho phép chỉnh sửa dữ liệu - Cho phép người dùng xem lại tài liệu đính kèm - Cho phép người dùng	Thể hiện nút "Hủy" để thực hiện hủy bỏ thao tác cài đặt hiển thị

3.4.2. Màn hình "Xem chi tiết hợp đồng" - Tab Thông tin chi tiết"

tải về tài liệu đính kèm

-Cho phép người dùng up file dữ liệu lên

Thể hiện file hợp đồng được ký kết

23

File phụ lục đính kèm

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

Không bắt buộc

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

- Cho phép người dùng xem lại tài liệu đính kèm

- Cho phép người dùng tải về tài liệu đính kèm

-Cho phép người dùng up file dữ liệu lên

Thể hiện file phụ lục hợp đồng được ký kết

24

Nút đóng "X"

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

Bắt

Không bắt buộc

Không cho

- Cho phép người dùng nhấn để hủy bỏ thao tác

tương tác (nhấn/chọn/sửa).

Thể hiện thông tin quy định với các hợp đồng thực hiện bên trong luồng quy trình BPM

2

Số hợp đồng

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).

- Nguồn dữ liệu với HĐ TRONG quy trình BPM: Dữ liệu được lấy theo trường Số hợp đồng từ 1556 - User Story - Ký kết và phát hành hợp đồng giấy

Thể hiện số hợp đồng

3

Loại hợp đồng

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).

- Nguồn dữ liệu với HĐ TRONG quy trình BPM: Dữ liệu được lấy theo trường Loại hợp đồng từ 2442 - User Story - Nhân viên kế hoạch - tổng hợp soạn thảo hợp đồng

Thể hiện loại hợp đồng

4Tên hợp đồng/ gói thầuVă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).

- Nguồn dữ liệu với HĐ TRONG quy trình BPM: Dữ liệu lấy từ trường tên gói thầu từ 2442 - User Story - Nhân viên kế hoạch - tổng hợp soạn thảo hợp đồng

Thông tin tên hợp đồng/ gói thầu

5

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).

- Nguồn dữ liệu với HĐ TRONG quy trình BPM: Dữ liệu lấy từ trường dự án từ 2442 - User Story - Nhân viên kế hoạch - tổng hợp soạn thảo hợp đồng

Thể hiện tên dự án gói thầu

6

Nhà cung cấp

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).

- Nguồn dữ liệu với HĐ TRONG quy trình BPM: Dữ liệu lấy từ trường Tên nhà thầu từ 2442 - User Story - Nhân viên kế hoạch - tổng hợp soạn thảo hợp đồng

Thể hiện tên nhà cung cấp

7

Mã số thuế (NT)

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).

- Nguồn dữ liệu với HĐ TRONG quy trình BPM: Dữ liệu lấy từ trường Tên nhà thầu từ 2442 - User Story - Nhân viên kế hoạch - tổng hợp soạn thảo hợp đồng

Thể hiện mã số thuế nhà thầu

8Phòng ban thực hiệnLựa chọn (Droplist)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).

- Nguồn dữ liệu:

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

Thông tin phòng ban quản lý dự án

9

Ngày ký hợp đồng

Thời gian (Date - Time)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).

- Nguồn dữ liệu với HĐ TRONG quy trình BPM: Dữ liệu lấy từ trường ngày ký hợp đồng từ 2442 - User Story - Nhân viên kế hoạch - tổng hợp soạn thảo hợp đồng

Thể hiện ngày ký hợp đồng

10

Ngày hiệu lực

Thời gian (Date - Time)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).

- Nguồn dữ liệu với HĐ TRONG quy trình BPM: Dữ liệu lấy từ trường ngày hiệu lục từ 2442 - User Story - Nhân viên kế hoạch - tổng hợp soạn thảo hợp đồng

Thể hiện ngày hiệu lực hợp đồng

11Ngày dự kiến hoàn thànhThời gian (Date - Time)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).

- Nguồn dữ liệu với HĐ TRONG quy trình BPM: Dữ liệu lấy từ trường Ngày hết hạn dự kiến từ 2442 - User Story - Nhân viên kế hoạch - tổng hợp soạn thảo hợp đồng

Thể hiện ngày dự kiến hoàn thành triển khai hợp đồng

12Thời gian thực hiệnSố (Number)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).

- Nguồn dữ liệu với HĐ TRONG quy trình BPM: Dữ liệu lấy từ trường thời gian thực hiện 2442 - User Story - Nhân viên kế hoạch - tổng hợp soạn thảo hợp đồng

Thông tin thời gian số ngày triển khai thực hiện hợp đồng

13

Ngày hết hạn bảo hành

Thời gian (Date - Time)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).

- Nguồn dữ liệu với HĐ TRONG quy trình BPM: Dữ liệu được lấy theo trường Ngày hết hạn bảo hành từ 2442 - User Story - Nhân viên kế hoạch - tổng hợp soạn thảo hợp đồng

Thông tin thời gian hết hạn bảo hành

14

Đơn vị chủ đầu tư ký hợp đồng

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

chỉnh sửa đơn 1 hợp đồng. - Khi nhấn, màn hình pop-up "Thêm mới hợp đồng" đóng lại và hệ thống điều hướng về màn hình "Danh sách hợp đồng. - Màn hình "Danh sách hợp đồng: Tham chiếu mục 3.4.1. Màn hình "Danh sách hợp đồng.	Thể hiện nút đóng cho phép hủy bỏ thao tác chỉnh sửa đơn 1 hợp đồng.
25	Nú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 đơn 1 hợp đồng - Trong mỗi trường hợp, hệ thống xử lý như sau: Trường hợp 1: Nhập dữ liệu chỉnh sửa dữ liệu hợp lệ: Điều kiện: Tất cả các trường bắt buộc được nhập đầy đủ. Ngày dự kiến hoàn thành > Ngày hợp đồng Ngày hết hạn bảo hành > Ngày dự kiến hoàn thành Số hợp đồng 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: Hợp đồng được thêm mới hiển thị với giá trị trạng thái mặc định là "Hoạt độ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: Thêm mới hợp đồng thành công Trường hợp 2: Nhập dữ liệu chỉnh sửa dữ liệu không hợp lệ: Điều kiện: Trường bắt buộc KHÔNG được nhập đầy đủ Trường đặc thù được nhập dữ liệu KHÔNG HỢP LỆ gồm: Ngày dự kiến hoàn thành < Ngày ký hợp đồng Ngày hết hạn bảo hành < Ngày dự kiến hoàn thành Số hợp đồng không trùng với bản ghi sẵn có trong hệ thống. Thời gian thực hiện (ngày): Nhập dấu phẩy “,” hoặc dấu chấm “.” nhưng không phải số hợp lệ (ví dụ: , ; . ; 1..2) Nhập số âm ( -5, -10 ) Nhập số bằng 0 Hành vi hệ thống: Kiểm tra dữ liệu tại dòng (inline validation) và hiển thị cảnh báo ngay dưới trường nhập chưa đầy đủ/không hợp lệ hoặc hiển thị pop-up cảnh báo như sau: Ngày dự kiến hoàn thành < Ngày ký hợp đồng → Hiển thị pop-up cảnh báo: Tham chiếu mục 3.4.3. Màn hình pop-up cảnh báo Ngày hết hạn bảo hành < Ngày dự kiến hoàn thành → Hiển thị pop-up cảnh báo: Tham chiếu mục 3.4.3. Màn hình pop-up cảnh báo Thời gian thực hiện (ngày) → Hiển thị cảnh báo ngay dưới trường: Giá trị không hợp lệ Không đóng màn hình pop-up Thêm mới hợp đồng	Thể hiện nút đóng cho phép lưu thông tin hợp đồng.
26	Nú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 hợp đồng. - Khi nhấn, màn hình pop-up "Thêm mới hợp đồng" đóng lại và hệ thống điều hướng về màn hình "Danh sách hợp đồng. - Màn hình "Danh sách hợp đồng: Tham chiếu mục 3.4.1. Màn hình "Danh sách hợp đồng.	Thể hiện nút "Hủy" để hủy bỏ thao tác chỉnh sửa đơn 1 hợp đồng.
27	Tab "Thông tin chi tiết"	Tab điều hướng (Navigation Tab)	Không bắt buộc	- Cho phép người dùng nhấn để truy cập màn hình "Chỉnh sửa hợp đồng" - Tab "Thông tin chi tiết" - Khi nhấn, hệ thống mở pop-up “Chỉnh sửa hợp đồng” - Tab “Thông tin chi tiết” để người dùng xem thông tin hợp đồng.	Thể hiện toàn bộ thông tin chi tiết của hợp đồng ở dạng chỉ xem.
28	Tab "Lịch sử chỉnh sửa"	Tab điều hướng (Navigation Tab)	Không bắt buộc	- Cho phép người dùng nhấn để truy cập màn hình "Chỉnh sửa hợp đồng" - Tab "Lịch sử chỉnh sửa" - Khi nhấn, hệ thống mở pop-up “Chỉnh sửa hợp đồng” - Tab “Lịch sử chỉnh sửa” để người dùng xem thông tin lịch sử chỉnh sửa.	Thể hiện danh sách các lần chỉnh sửa hợp đồng kèm thời gian, người thực hiện và chi tiết thay đổi.

3.4.1.3.3. Màn hình pop-up "Chỉnh sửa hợp đồng" - Tab "Lịch sử chỉnh sửa"

- Không

	Trường thông tin/Nút chức năng	Kiểu dữ liệu	Điều kiện	Quy định	Mô tả
1	Màn hình lịch sửa chỉnh sửa				Khi chưa có lịch sử chỉnh sửa hợp đồng, hệ thống hiển thị màn hình trống kèm văn bản: "Ở đây chưa có gì cả"
2	Thời gian	Thời gian (Date - Time)	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).

- Nguồn dữ liệu với HĐ TRONG quy trình BPM: Dữ liệu được lấy theo trường Ngày hết hạn bảo hành từ 2442 - User Story - Nhân viên kế hoạch - tổng hợp soạn thảo hợp đồng

Thông tin đơn vị chủ đầu tư ký hợp đồng

- Dữ liệu được lấy theo trường Đơn vị ký hợp đồng trước thuế từ 2442 - User Story - Nhân viên kế hoạch - tổng hợp soạn thảo hợp đồng

15

Giá trị HĐ trước thuế

Số (Number)Bắt buộc

Thể hiện thời điểm hệ thống ghi nhận hành động được thực hiện
3	Người thực hiện	Văn bản (Text)	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).

- Nguồn dữ liệu với HĐ TRONG quy trình BPM: Dữ liệu được lấy theo trường Giá trị hợp đồng trước thuế từ 2442 - User Story - Nhân viên kế hoạch - tổng hợp soạn thảo hợp đồng

Thể hiện giá trị hợp đồng trước thuế

16

Giá trị HĐ sau thuế

Số (Number

Thể hiện tên nhân sự đã thực hiện thao tác trên thông tin chi tiết hợp đồng

4

Chi tiết thay đổi

Đường dẫn (Hyperlink)

Không bắt buộc

- Cho phép người dùng nhấn để truy cập màn hình "Chỉnh sửa hợp đồng" - Tab "Lịch sử chỉnh sửa"
- Khi nhấn, hệ thống hiển thị màn hình "Xem chi tiết lịch sử".

- Màn hình "Xem chi tiết hợp đồng": tham chiếu mục 3.4.1.3.4. Màn hình pop-up "Xem chi tiết hợp đồng".

Thông tin chi tiết thay đổi lịch sử chỉnh sửa hệ thống

5

Nút "X"

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

Không bắt buộc

-

Không cho

Cho phép người dùng

thao tác tương tác (nhấn/chọn/sửa).

- Nguồn dữ liệu với HĐ TRONG quy trình BPM: Dữ liệu được lấy theo trường Giá trị hợp đồng sau thuế từ 2442 - User Story - Nhân viên kế hoạch - tổng hợp soạn thảo hợp đồng

Thể hiện giá trị hợp đồng sau thuế

17Giá trị HĐ trước thuế sau điều chỉnhSố (Number)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 giá trị hợp đồng trước thuế khi bổ sung phụ lục

18Giá trị HĐ sau thuế sau điều chỉnhSố (Number)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 giá trị hợp đồng sau thuế khi bổ sung phụ lục19Đơn vị tiền tệ

nhấn để hủy bỏ thao tác xem thông tin chung về lịch sử chỉnh sửa
- Khi nhấn, màn hình pop-up "Chỉnh sửa hợp đồng" đóng lại và hệ thống điều hướng về màn hình "Xem chi tiết hợp đồng - Tab Thông tin chi tiết.

Thể hiện nút đóng cho phép hủy bỏ thao tác xem thông tin chung về lịch sử chỉnh sửa.

3.4.1.3.4. Màn hình pop-up "Chỉnh sửa hợp đồng" - Tab "Lịch sử chỉnh sửa" - Chi tiết lịch sử chỉnh sửa

	Trường thông tin/Nút chức năng	Kiểu dữ liệu	Điều kiện	Quy định	Mô tả
1	Màn hình lịch sửa chỉnh sửa				Khi chưa có lịch sử chỉnh sửa hợp đồng, hệ thống hiển thị màn hình trống kèm văn bản: "Ở đây chưa có gì cả"
2	Thời gian chỉnh sửa	Văn bản (Text)	Không bắt buộc

- Không

Thể hiện đơn vị tiền tệ sử dụng cho hợp đồng

20Tỉ giá tương ứng

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

- Nguồn dữ liệu với HĐ TRONG quy trình BPM: Dữ liệu được lấy theo trường Đơn vị tiền tệ từ 2442 - User Story - Nhân viên kế hoạch - tổng hợp soạn thảo hợp đồng

Thể hiện thời điểm thực hiện chỉnh sửa hợp đồng.
3	Người thực hiện	Văn bản (Text)	Không bắt buộc

- Không

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

- Nguồn dữ liệu với HĐ TRONG quy trình BPM: Dữ liệu được lấy theo trường Tỷ giá ngoại tệ từ 2442 - User Story - Nhân viên kế hoạch - tổng hợp soạn thảo hợp đồng

Thể hiện tỷ giá quy đổi của ngoại tệ (nếu có)

21Trạng thái hợp đồng

	Thể hiện tên người đã thực hiện chỉnh sửa.
4	Trường bị thay đổi	Văn bản (Text)	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 tên trường thông tin đã bị chỉnh sửa.
5	Thông tin trước thay đổi	Văn bản (Text)	Không bắt buộc

- Không

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

- Trạng thái hợp đồng với HĐ TRONG quy trình BPM thể hiện theo:

Chờ thống nhất: Khi nhân viên KHTH bấm nút hoàn thành từ 2442 - User Story - Nhân viên kế hoạch - tổng hợp soạn thảo hợp đồng

Thể hiện trạng thái của hợp đồng

22Rủi ro

Đang thực hiện: Khi nhân viên KHTH bấm nút hoàn thành từ 1556 - User Story - Ký kết và phát hành hợp đồng giấy

Đã quyết toán: để sẵn chờ tích hợp ERP
Hủy

Thể hiện giá trị cũ trước khi chỉnh sửa.
6	Thông tin sau thay đổi	Văn bản (Text)

area

Không bắt buộc

Không

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ông tin rủi ro23File HĐ/PL đính kèm

giá trị mới sau khi chỉnh sửa.
7	Nút quay lại	Nút chức năng (Button)	Không bắt buộc

- Không

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

- Nguồn dữ liệu với HĐ TRONG quy trình BPM: Dữ liệu được lấy từ 1556 - User Story - Ký kết và phát hành hợp đồng giấy

Thể hiện

file hợp đồng được ký kết 24Tab "Thông tin chi tiết"

Tab điều hướng

(Navigation Tab)

Không bắt buộc

- Cho phép người dùng nhấn để truy cập màn hình "Chỉnh sửa hợp đồng" - Tab "Thông tin chi tiết"
- Khi nhấn, hệ thống mở pop-up “Chỉnh sửa hợp đồng” - Tab “Thông tin chi tiết” để người dùng xem thông tin hợp đồng.

Thể hiện toàn bộ thông tin chi tiết của hợp đồng ở dạng chỉ xem.25Tab "Lịch sử chỉnh sửa"

Tab điều hướng

(Navigation Tab

nút "Quay lại" để điều hướng "Xem chi tiết hợp đồng - Tab Thông tin chi tiết.
8	Nút "X"	Nút chức năng (Button)	Không bắt buộc	- Cho phép người dùng nhấn để

truy cập màn hình "Chỉnh sửa hợp đồng" - Tab "Lịch

hủy bỏ thao tác xem thông tin chi tiết lịch sử chỉnh sửa

"

.
- Khi nhấn,

hệ thống mở

màn hình pop-up

“Chỉnh sửa hợp đồng” - Tab “Lịch sử chỉnh sửa” để người dùng xem thông tin lịch sử chỉnh sửa.Thể hiện danh sách các lần chỉnh sửa hợp đồng kèm thời gian, người thực hiện và chi tiết thay đổi.26Nút "X"

"Chỉnh sửa hợp đồng" đóng lại và hệ thống điều hướng về màn hình "Xem chi tiết hợp đồng - Tab Thông tin chi tiết.	Thể hiện nút đóng cho phép hủy bỏ thao tác xem thông tin chi tiết lịch sử chỉnh sửa.
9	Image AddedChi tiết lịch sử chỉnh sửa	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 xem thông tin

Image Addedđể quay về màn hình "Xem chi tiết hợp đồng - Tab Thông tin chi tiết.
- Khi nhấn, màn hình pop-up "

Xem chi tiết

Chỉnh sửa hợp đồng" đóng lại và hệ thống điều hướng về màn hình "

Danh sách

Xem chi tiết hợp đồng

.- Màn hình "Danh sách hợp đồng: Tham chiếu mục

- Tab Thông tin chi tiết.

Thể hiện nút đóng cho phép quay về màn hình "Xem chi tiết hợp đồng - Tab Thông tin chi tiết.

3.4.

...

2. Màn hình

...

"Xem chi tiết hợp đồng" - Tab Thông tin chi tiết"

nút đóng cho phép hủy bỏ thao tác xem chi tiết .

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

Kiểu dữ liệu

Điều kiện

Quy định

Mô tả

1

HĐ ngoài quy trình BPM

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

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

thông tin

quy định với các hợp đồng

27

Nú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 xem thông tin chi tiết hợp đồng.
- Khi nhấn, màn hình pop-up "Xem chi tiết hợp đồng" đóng lại và hệ thống điều hướng về màn hình "Danh sách hợp đồng.

- Màn hình "Danh sách hợp đồng: Tham chiếu mục 3.4.1. Màn hình "Danh sách hợp đồng.

Thể hiện nút "Hủy" để thực hiện hủy bỏ thao tác xem thông tin chi tiết hợp đồng.

3.4.3. Màn hình "Pop-up cảnh báo"

Tiêu đề pop-up2 cảnh báoNút chức năng (ButtonKhông - văn bản cảnh báo

- Nội dung văn bản cảnh báo: "Số hợp đồng đang bị trùng. Vui lòng kiểm tra lại!"

Trường thông tin/Nút chức năng	Kiểu dữ liệu	Điều kiện	Quy định	Mô tả	1
thực hiện bên trong luồng quy trình BPM
2	Số hợp đồng	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 số hợp đồng
3	Loại hợp đồng	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 loại hợp đồng
4	Tên hợp đồng/ gói thầ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ông tin tên hợp đồng/ gói thầu
5	Dự án	Văn bản (Text)	Bắt buộc	Không - 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 tiêu đề pop-up "Cảnh báo trùng"
tên dự án gói thầu
6	Nhà cung cấp	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
3	Nút "Thoát"	Nút chức năng (Button)	Bắt buộc	- 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 "Thêm mới hợp đồng" - Màn hình "Thêm mới hợp đồng": Tham chiếu mục 3.4.1.2. Màn hình pop-up "Thêm mới hợp đồng"	Thể hiện nút "Thoát" để đóng màn hình pop up cảnh báo

3.4.3.2. Pop up cảnh báo điều kiện ngày hoàn thành (ngày hoàn thành nhỏ hơn ngày hợp đồng)

Trường thông tin/Nút chức năng	Kiểu dữ liệu	Điều kiện	Quy định	Mô tả	1	Tiêu đề pop-up	Văn bản (Text)	Bắt buộc	Không tên nhà cung cấp
7	Mã số thuế (NT)	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ã số thuế nhà thầu
8	Phòng ban thực hiện	Lựa chọn (Droplist)	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). - Nguồn dữ liệu: Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa).	Thông tin phòng ban quản lý dự án
9	Ngày ký hợp đồng	Thời gian (Date )	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 tiêu đề pop-up "Cảnh báo"	2	Văn bản cảnh báo	Nút chức năng (Button ngày ký hợp đồng
10	Ngày dự kiến hoàn thành	Thời gian (Date )	Bắt buộc	Không - 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 cảnh báo- Nội dung văn bản cảnh báo: "Ngày ngày dự kiến hoàn thành không được nhỏ hơn <Ngày hợp đồng / Ngày hiệu lực>. Vui lòng kiểm tra và nhập lại."	3	Nút "Thoát"	Nút chức năng (Button triển khai hợp đồng
11	Thời gian thực hiện	Số (Number)	Bắt buộc	- Cho Không 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 "Thêm mới hợp đồng" - Màn hình "Thêm mới hợp đồng": Tham chiếu mục 3.4.1.2. Màn hình pop-up "Thêm mới hợp đồng"	Thể hiện nút "Thoát" để đóng màn hình pop up cảnh báo

3.4.3.3. Pop up cảnh báo ngày hết hạn bảo hành (ngày hết hạn bảo hành nhỏ hơn ngày dự kiến hoàn thành/ngày hợp đồng/ngày hiệu lực)

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

Kiểu dữ liệu

Điều kiện

Quy định

Mô tả

1Tài liệu mẫuVăn bản (Text

Trường thông tin/Nút chức năng	Kiểu dữ liệu	Điều kiện	Quy định	Mô tả	1	Tiêu đề pop-up	Văn bản (Text)	Bắt buộc	Không thao tác tương tác (nhấn/chọn/sửa).	Thông tin thời gian số ngày triển khai thực hiện hợp đồng
12	Ngày hết hạn bảo hành	Thời gian (Date )	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ông tin thời gian hết hạn bảo hành
13	Đơn vị chủ đầu tư ký hợp đồng	Lựa chọn (Droplist)	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ông tin đơn vị chủ đầu tư ký hợp đồng - Dữ liệu được lấy theo trường Đơn vị ký hợp đồng trước thuế từ 2442 - User Story - Nhân viên kế hoạch - tổng hợp soạn thảo hợp đồng
14	Giá trị HĐ trước thuế	Số (Number)	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 tiêu đề pop-up "Cảnh báo trùng"	2	Văn bản cảnh báo	Nút chức năng (Button)	Bắt buộc	Không giá trị hợp đồng trước thuế
15	Giá trị HĐ sau thuế	Số (Number)	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 văn bản cảnh báo - Nội dung văn bản cảnh báo: "Ngày hết hạn bảo hành không được nhỏ hơn <Ngày dự kiến hoàn thành/ Ngày hợp đồng / Ngày hiệu lực>. Vui lòng kiểm tra và nhập lại"
3	Nút "Thoát"	Nút chức năng (Button)	Bắt buộc	- 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 "Thêm mới hợp đồng" - Màn hình "Thêm mới hợp đồng": Tham chiếu mục 3.4.1.2. Màn hình pop-up "Thêm mới hợp đồng"	Thể hiện nút "Thoát" để đóng màn hình pop up cảnh báo

3.4.5. Màn hình pop-up "Nhập file excel"

Thể hiện giá trị hợp đồng sau thuế

16

Giá trị HĐ trước thuế sau điều chỉnh

Số (Number)

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 giá trị hợp đồng trước thuế khi bổ sung phụ lục

17

Giá trị HĐ sau thuế sau điều chỉnh

Số (Number)

Không bắt buộc

Không

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 trường là "Tài liệu mẫu" để hướng dẫn người dùng về file mẫu cần thiết cho việc nhập dữ liệu.2Tải xuốngNút chức năng (Button

giá trị hợp đồng sau thuế khi bổ sung phụ lục
18	Đơn vị tiền tệ	Văn bản (Text)	Không bắt buộc	-

Cho

Không cho phép người dùng

nhấn để thực hiện quá trình xuất tệp dữ liệu mẫu (template) ca làm việc.
- Khi nhấn nút, hành vi hệ thống như sau:

Hành vi 1: Cho phép người dùng chọn vị trí lưu trữ tệp và tải xuống tệp
- Hệ thống mở pop-up của trình duyệt để người dùng chọn vị trí lưu tệp.
- Sau khi chọn xong, hệ thống tiến hành xuất và tải file Excel chứa tệp dữ liệu excel đã chọn về máy tính cá nhân.
- Thông tin tệp dữ liệu dùng để nhập dữ liệu excel :
  - Tên tệp dữ liệu: BPM1-Mẫu nhập file excel
  - Mẫu tệp dữ liệu (Template khi nhập file excel): BPM1-File hợp đồng dữ liệu mẫu
  - Import file excel theo vị trí sheet
Hành vi 2: Thể hiện thông báo (toast) thành công:
- Tiêu đề thông báo: Thành công
- Nội dung thông báo: Tải xuống file dữ liệu mẫu thành công

Thể hiện nút chức năng cho phép người dùng chọn vị trí lưu trữ và tải tệp dữ liệu xuống máy tính cá nhân.3Tài liệu đính kèmKhông bắt buộcKhông

thao tác tương tác (nhấn/chọn/sửa).	Thể hiện đơn vị tiền tệ sử dụng cho hợp đồng
19	Tỉ giá tương ứng	Văn bản (Text)	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 tỷ giá quy đổi của ngoại tệ (nếu có)
20	Trạng thái hợp đồng	Văn bản (Text)	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). - Trạng thái hợp đồng với HĐ TRONG quy trình BPM thể hiện theo: Chờ thống nhất Đang thực hiện Đã quyết toán: để sẵn chờ tích hợp ERP Hủy	Thể hiện trạng thái của hợp đồng
21	Rủi ro	Văn bản (Text) area	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

tên mục là "Tài liệu đính kèm" để hướng dẫn người dùng về vị trí đính kèm tệp dữ liệu excel sau khi điền thông tin.4Nút "Nhấn hoặc tả để tải lên" 5Nút "Hủy"Nút chức năng (Button

thông tin rủi ro
22	File HĐ/PL đính kèm	Nút chức năng (Button)	Không bắt buộc

- Cho phép người dùng nhấn để mở màn hình pop-up chọn tệp của trình duyệt để lựa chọn tệp dữ liệu cần tải lên từ máy tính cá nhân.
- Sau khi chọn xong, hệ thống Thể hiện tệp dữ liệu đã tải lên trong mục Tài liệu đính kèm.

Thể hiện nút chức năng cho phép người dùng đính kèm tệp dữ liệu excel sau khi điền thông tin.

- 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 file hợp đồng được ký kết

23

Tab "Thông tin chi tiết"

Tab điều hướng

(Navigation Tab)

Không bắt buộc

- Cho phép người dùng nhấn để

hủy bỏ thao tác xóa.
- Khi nhấn, màn hình pop-up đóng lại và bản ghi

truy cập màn hình "Chỉnh sửa hợp đồng" - Tab "Thông tin chi tiết"
- Khi nhấn, hệ thống mở pop-up “Chỉnh sửa hợp đồng” - Tab “Thông tin chi tiết” để người dùng xem thông tin hợp đồng

không bị xóa

.

Thể hiện

nút chức năng cho phép hủy bỏ thao tác mà không lưu dữ liệu.6Nút "Áp dụng"Nút chức năng (Button

toàn bộ thông tin chi tiết của hợp đồng ở dạng chỉ xem.

24

Tab "Lịch sử chỉnh sửa"

Tab điều hướng

(Navigation Tab)

Không bắt buộc

- Cho phép người dùng nhấn để

xác nhận tệp dữ liệu ca làm việc sau khi tải lên như sau:

Nút chỉ kích hoạt khi người dùng đã thực hiện đính kèm tài liệu

Trường hợp 1: Tệp dữ liệu hợp lệ:
- Điều kiện: Tệp dữ liệu đúng định dạng với tệp mẫu (template).
- Hành vi hệ thống:
  - Hành vi 1: Hệ thống tải lên tệp dữ liệu và Thể hiện 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: Nhập dữ liệu thành công
Trường hợp 2: Tệp dữ liệu KHÔNG hợp lệ:

Lỗi 1: Lỗi tệp không đúng mẫu (không đúng template)

Điều kiện: Tệp người dùng tải lên có 1 trong những đặc điểm sau: Cấu trúc cột khác template, Thiếu cột bắt buộc, Sai tên cột, File dư cột.
Hành vi hệ thống:
- Thể hiện thông báo (toast) lỗi
  - Tiêu đề thông báo: Không thành công
  - Nội dung thông báo: Tệp không đúng mẫu. Vui lòng tải tệp theo đúng mẫu hệ thống

Lỗi 2: Lỗi dữ liệu trong file không hợp lệ (data validation error)

Điều kiện: Người dùng sử dụng tệp dữ liệu đúng mẫu(template), nhưng nội dung bên trong chứa giá trị không hợp lệ, bao gồm một hoặc nhiều trường hợp sau:
- Thiếu dữ liệu bắt buộc (ví dụ: số hợp đồng, tên hợp đồng, tên dự án).
- Sai kiểu dữ liệu (nhập Văn bản (Text) thay vì ngày/tháng).
- Thời gian ngày bảo hành nhỏ hơn thời gian ngày hợp đồng/
- Dữ liệu vượt quá giới hạn độ dài/giá trị.
Hành vi hệ thống: Hệ thống mở ra màn hình pop-up "Lỗi nhập file excel": Tham chiếu mục 3.4.7. Màn hình pop-up Lỗi nhập file excel

Lỗi 3: Lỗi trùng "số hợp đồng"

Điều kiện: Người dùng tải lên tệp dữ liệu đúng mẫu (template), nhưng trong nội dung file xuất hiện bản ghi không hợp lệ, bao gồm:
- Bản ghi có Mã hợp đồng bị trùng

Hành vi hệ thống: Hệ thống mở ra màn hình pop-up "Lỗi nhập file excel": Tham chiếu mục 3.4.7. Màn hình pop-up Lỗi nhập file excel

Thể hiện nút chức năng cho phép người dùng xác nhận tệp dữ liệu excel sau khi hoàn thành tải lên.

7Nút "X"Nút chức năng (Button)Bắt buộc- Cho phép người dùng nhấn để hủy bỏ thao tác xóa.
- Khi nhấn, màn hình pop-up đóng lại và bản ghi ca làm việc không bị xóa.Thể hiện nút chức năng cho phép hủy bỏ thao tác mà không lưu dữ liệu.

3.4.6.Màn hình pop-up "Xuất file excel" :

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

Kiểu dữ liệu

Điều kiện

Quy định

Mô tả

1Chọn kiểu xuất file

Văn bản (Văn bản (Text))

Bắt

truy cập màn hình "Chỉnh sửa hợp đồng" - Tab "Lịch sử chỉnh sửa"
- Khi nhấn, hệ thống mở pop-up “Chỉnh sửa hợp đồng” - Tab “Lịch sử chỉnh sửa” để người dùng xem thông tin lịch sử chỉnh sửa.

Thể hiện danh sách các lần chỉnh sửa hợp đồng kèm thời gian, người thực hiện và chi tiết thay đổi.

25

Nú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 xem thông tin chi tiết hợp đồng.
- Khi nhấn, màn hình pop-up "Xem chi tiết hợp đồng" đóng lại và hệ thống điều hướng về màn hình "Danh sách hợp đồng.

- Màn hình "Danh sách hợp đồng: Tham chiếu mục 3.4.1. Màn hình "Danh sách hợp đồng.

Thể hiện nút đóng cho phép hủy bỏ thao tác xem thông tin chi tiết hợp đồng.

26

Nú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 xem thông tin chi tiết hợp đồng.
- Khi nhấn, màn hình pop-up "Xem chi tiết hợp đồng" đóng lại và hệ thống điều hướng về màn hình "Danh sách hợp đồng.

- Màn hình "Danh sách hợp đồng: Tham chiếu mục 3.4.1. Màn hình "Danh sách hợp đồng.

Thể hiện nút "Hủy" để thực hiện hủy bỏ thao tác xem thông tin chi tiết hợp đồng.

3.4.3. Màn hình "Pop-up cảnh báo"

3.4.5. Màn hình pop-up "Nhập file excel"

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

Kiểu dữ liệu

Điều kiện

Quy định

Mô tả

1

Tài liệu mẫu

Văn bản (Text)

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 tên trường là "Tài liệu mẫu" để hướng dẫn người dùng về file mẫu cần thiết cho việc nhập dữ liệu.

2

Tải xuống

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

Không bắt buộc

- Cho phép người dùng nhấn để thực hiện quá trình xuất tệp dữ liệu mẫu (template) ca làm việc.
- Khi nhấn nút, hành vi hệ thống như sau:

Hành vi 1: Cho phép người dùng chọn vị trí lưu trữ tệp và tải xuống tệp
- Hệ thống mở pop-up của trình duyệt để người dùng chọn vị trí lưu tệp.
- Sau khi chọn xong, hệ thống tiến hành xuất và tải file Excel chứa tệp dữ liệu excel đã chọn về máy tính cá nhân.
- Thông tin tệp dữ liệu dùng để nhập dữ liệu excel :
  - Tên tệp dữ liệu: BPM1-Mẫu nhập file excel
  - Mẫu tệp dữ liệu (Template khi nhập file excel): BPM1-File hợp đồng dữ liệu mẫu
  - Import file excel theo vị trí sheet
Hành vi 2: Thể hiện thông báo (toast) thành công:
- Tiêu đề thông báo: Thành công
- Nội dung thông báo: Tải xuống file dữ liệu mẫu thành công

Thể hiện nút chức năng cho phép người dùng chọn vị trí lưu trữ và tải tệp dữ liệu xuống máy tính cá nhân.

3

Tài liệu đính kèm

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 tên

trường

mục là "

Chọn kiểu xuất file" để

Tài liệu đính kèm" để hướng dẫn người dùng về

cách thức xuất

vị trí đính kèm tệp dữ liệu excel

danh sách hợp đồng

sau khi điền thông tin.

2

4

Tùy chọn "Tất cả hợp đồng"

Nút "Nhấn hoặc tả để tải lên"

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

Không bắt buộc

- Cho phép người dùng nhấn để

chọn tùy chọn xuất toàn bộ dữ liệu hợp đồng trên hệ thống.Thể hiện tên tùy chọn là "Tất cả hợp đồng" cho phép người dùng chọn cách thức xuất tệp dữ liệu là xuất toàn bộ dữ liệu hợp đồng trên hệ thống.3Tùy chọn "Trên trang này"

mở màn hình pop-up chọn tệp của trình duyệt để lựa chọn tệp dữ liệu cần tải lên từ máy tính cá nhân. - Sau khi chọn xong, hệ thống Thể hiện tệp dữ liệu đã tải lên trong mục Tài liệu đính kèm.	Thể hiện nút chức năng cho phép người dùng đính kèm tệp dữ liệu excel sau khi điền thông tin.
5	Nú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 để

chọn tùy chọn xuất tệp dữ liệu hợp đồng là bản ghi ca làm việc đang Thể hiện trên trang hiện tại.Thể hiện tên tùy chọn là "Trên trang này" cho phép người dùng chọn cách thức xuất tệp dữ liệu là xuất chỉ dữ liệu hợp đồng đang Thể hiện trên trang hiện tại.4Tùy chọn "Tất cả kết quả tìm kiếm hiện tại"Không bắt buộcCho phép người dùng nhấn để chọn tùy chọn xuất tệp dữ liệu ca làm việc là bản ghi ca làm việc đã được lọc (filter) hoặc tìm kiếm (search).Thể hiện tên tùy chọn là "Tất cả kết quả tìm kiếm hiện tại" cho phép người dùng chọn cách thức xuất tệp dữ liệu là xuất danh sách hợp đồng đã được lọc (filter) hoặc tìm kiếm (search).5Nút "Hủy"Nút chức năng (Button)Không bắt buộcCho phép người dùng nhấn để hủy bỏ các thay đổi và đóng giao diện hiện tại mà không lưu thông tin.

Thể hiện nút chức năng cho phép hủy bỏ thao tác mà không lưu dữ liệu.

6Nút "Áp dụng"Nút chức năng (Button)Bắt buộc- Cho phép người dùng nhấn để thực hiện quá trình xuất tệp dữ liệu hợp đồng.
- Khi nhấn nút, hành vi hệ thống như sau:

Hành vi 1: kiểm tra việc người dùng đã hoàn thành chọn kiểu xuất File.
Hành vi 2: cho phép người dùng chọn vị trí lưu trữ tệp và tải xuống tệp
- Hệ thống mở pop-up của trình duyệt để người dùng chọn vị trí lưu tệp.
- Sau khi chọn xong, hệ thống tiến hành xuất và tải file Excel chứa tệp dữ liệu excel đã chọn về máy tính cá nhân.
Hành vi 3: Thể hiện thông báo (toast) thành công:
- Tiêu đề thông báo: Thành công
- Nội dung thông báo: Xuất dữ liệu thành công

- Thông tin tệp dữ liệu được xuất ra:

Tên tệp: BPM1-Dữ liệu danh sách hợp đồng
Mẫu tệp dữ liệu: BPM1-File xuất hợp đồng dữ liệu mẫu

Thể hiện nút chức năng cho phép xuất tệp dữ liệu excel hợp đồng

hủy bỏ thao tác xóa.
- Khi nhấn, màn hình pop-up đóng lại và bản ghi thông tin hợp đồng không bị xóa.

Thể hiện nút chức năng cho phép hủy bỏ thao tác mà không lưu dữ liệu.

6

Nú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 để xác nhận tệp dữ liệu ca làm việc sau khi tải lên như sau:

Nút chỉ kích hoạt khi người dùng đã thực hiện đính kèm tài liệu

Trường hợp 1: Tệp dữ liệu hợp lệ:
- Điều kiện: Tệp dữ liệu đúng định dạng với tệp mẫu (template).
- Hành vi hệ thống:
  - Hành vi 1: Hệ thống tải lên tệp dữ liệu và Thể hiện 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: Nhập dữ liệu thành công
Trường hợp 2: Tệp dữ liệu KHÔNG hợp lệ:

Lỗi 1: Lỗi tệp không đúng mẫu (không đúng template)

Điều kiện: Tệp người dùng tải lên có 1 trong những đặc điểm sau: Cấu trúc cột khác template, Thiếu cột bắt buộc, Sai tên cột, File dư cột.
Hành vi hệ thống:
- Thể hiện thông báo (toast) lỗi
  - Tiêu đề thông báo: Không thành công
  - Nội dung thông báo: Tệp không đúng mẫu. Vui lòng tải tệp theo đúng mẫu hệ thống

Lỗi 2: Lỗi dữ liệu trong file không hợp lệ (data validation error)

Điều kiện: Người dùng sử dụng tệp dữ liệu đúng mẫu(template), nhưng nội dung bên trong chứa giá trị không hợp lệ, bao gồm một hoặc nhiều trường hợp sau:
- Thiếu dữ liệu bắt buộc (ví dụ: số hợp đồng, tên hợp đồng, tên dự án).
- Sai kiểu dữ liệu (nhập Văn bản (Text) thay vì ngày/tháng).
- Thời gian ngày bảo hành nhỏ hơn thời gian ngày hợp đồng/
Hành vi hệ thống: Hệ thống mở ra màn hình pop-up "Lỗi nhập file excel": Tham chiếu mục 3.4.7. Màn hình pop-up Lỗi nhập file excel

Lỗi 3: Lỗi trùng "số hợp đồng"

Điều kiện: Người dùng tải lên tệp dữ liệu đúng mẫu (template), nhưng trong nội dung file xuất hiện bản ghi không hợp lệ, bao gồm:
- Bản ghi có Mã hợp đồng bị trùng

Hành vi hệ thống: Hệ thống mở ra màn hình pop-up "Lỗi nhập file excel": Tham chiếu mục 3.4.7. Màn hình pop-up Lỗi nhập file excel

Thể hiện nút chức năng cho phép người dùng xác nhận tệp dữ liệu excel sau khi hoàn thành tải lên.

7

Nút "X"

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

Không bắt

Bắt buộc

- Cho phép người dùng nhấn để hủy bỏ

các thay đổi và đóng giao diện hiện tại mà không lưu thông tin.

thao tác
- Khi nhấn, màn hình pop-up đóng lại

Thể hiện nút chức năng cho phép hủy bỏ thao tác mà không lưu dữ liệu.

3.4.6.Màn hình pop-up "Xuất file excel" :

3.4.7. Màn hình pop-up "Lỗi nhập file excel"

	Trường thông tin/Nút chức năng	Kiểu dữ liệu	Điều kiện	Quy định	Mô tả
1	Thông báo tóm tắt lỗi	Văn bản (Text)	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 tổng quan về kết quả của quá trình nhập file Excel như sau: Icon: Dấu "x" màu đỏ: biểu thị lỗi bên trái tiêu đề. Tiêu đề: Không thành công Mô tả chi tiết: File excel bạn nhập chưa chính xác
2	Bảng "Danh mục lỗi gặp phải"	Văn bản (Text)	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 tiêu đề bảng: Danh mục các lỗi gặp phải
3	Dòng lỗi	Văn bản (Text)	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 cột số thứ tự dòng/hàng bị lỗi trong file Excel gốc. - Tiêu đề cột: Dòng lỗi
4	Tên lỗi	Văn bản (Text)	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 cột nội dung/mô tả chi tiết lỗi gặp phải tại dòng tương ứng ở mục 2.1. - Tiêu đề cột: Tên lỗi
5	Nút "Tải xuống"	Nút chức năng (Button)	Không bắt buộc	- Cho phép người dùng nhấn để thực hiện quá trình tải xuống tệp dữ liệu excel bảng "Danh mục các lỗi gặp phải". - Thông tin tệp dữ liệu được xuất ra: Tên tệp: BPM1-Dữ liệu danh sách lỗi khi nhập file excel Mẫu tệp dữ liệu: BPM1-Mẫu danh sách lỗi khi nhập file excel.xlsx Các lỗi: Trùng số hợp đồng: Số hợp đồng <số hợp đồng> đã tồn tại" Nhà cung cấp chưa có trong danh mục: Nhà cung cấp <Tên nhà cung cấp> chưa có trong danh mục Dự án chưa có trong danh mục: Dự án <Tên dự án> chưa có trong danh mục Sai định dạng ngày tháng: "Sai định dạng ngày tháng. Vui lòng nhập theo định dạng DD/MM/YYYY.” Ngày bảo hành nhỏ hơn ngày dự kiến hoàn thành/ Ngày hợp đồng / Ngày hiệu lực: Ngày hết hạn bảo hành không được nhỏ hơn <Ngày dự kiến hoàn thành/ Ngày hợp đồng / Ngày hiệu lực>. Vui lòng kiểm tra và nhập lại." Ngày dự kiến hoàn thành không được nhỏ hơn ngày hợp đồng / Ngày hiệu lực: Ngày dự kiến hoàn thành không được nhỏ hơn < Ngày hợp đồng / Ngày hiệu lực>. Vui lòng kiểm tra và nhập lại."
6				- Cho phép người dùng nhấn để hủy bỏ các thay đổi và đóng giao diện hiện tại mà không lưu thông tin.	Thể hiện nút chức năng cho phép hủy bỏ thao tác mà không lưu dữ liệu.
7	Nút "Nhập lại"	Nút chức năng (Button)	Không bắt buộc	- Cho phép người dùng nhấn nút. - Khi nhấn nút, hệ thống đóng pop-up "Lỗi nhập file excel" và điều hướng người dùng quay lại màn hình pop-up "Nhập file excel": tham chiếu mục: 3.4.5. Màn hình pop-up "Nhập file excel"	Thể hiện nút chức năng cho phép người dùng quay lại màn hình pop-up "Nhập file excel" để thực hiện lại quá trình đính kèm tệp dữ liệu.
8	Nú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ỏ các thay đổi và đóng giao diện hiện tại mà không lưu thông tin.	Thể hiện nút chức năng cho phép hủy bỏ thao tác mà không lưu dữ liệu.

...

Page tree

Page History

Versions Compared

Old Version 2

New Version Current

Key

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

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

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

3.1 UIUX:

3.1.1. Màn hình "Danh sách hợp đồng"

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

3.1 UIUX:

3.1.1. Màn hình "Danh sách hợp đồng"

3.1.1.1. Màn hình kết quả tìm kiếm khi: Không có kết quả tìm kiếm/Danh sách trống

3.1.1.2. Màn hình pop-up "bộ lọc"

Image Modified

3.1.1.3. Màn hình pop-up "Tải tài liệu"

3.1.1.4. Màn hình pop-up "Thêm mới hợp đồng"

3.1.1.5. Màn hình pop-up "Chỉnh sửa hợp đồng"

3.1.1.5.1. Màn hình pop-up "Chỉnh sửa hợp đồng" với mã quy định HĐ NGOÀI quy trình BPM :

3.1.1.5.2. Màn hình pop-up "Chỉnh sửa hợp đồng" với mã quy định HĐ TRONG quy trình BPM :

3.1.1.6. Màn hình pop-up "Xem chi tiết hợp đồng"

3.1.1.7. Màn hình pop-up "Cảnh báo"

3.1.1.7. Màn hình pop-up "Cảnh báo trùng"

3.1.1.7. Màn hình pop-up "Cảnh báo điều kiện ngày hoàn thành (ngày hoàn thành nhỏ hơn ngày hợp đồng)

3.1.1.7. Màn hình pop-up "Cảnh báo ngày hết hạn bảo hành (ngày hết hạn bảo hành nhỏ hơn ngày dự kiến hoàn thành/ngày hợp đồng/ngày hiệu lực)"

3.1.1.8. Màn hình pop-up "Nhập file excel"

3.1.1.8. Màn hình pop-up "Xuất file excel"

3.1.1.8. Màn hình pop-up "Lỗi nhập file excel"

3.1.1.9. Màn hình pop-up "Thông báo"

3.1.1.9.1. Màn hình toast Nhập dữ liệu thành công

3.1.1.9.2. Màn hình toast Xuất dữ liệu thành công

3.1.1.9.3. Màn hình toast Không thành công

3.1.1.9.4. Màn hình toast Thành công

3.2 Luồng:

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

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 hợp đồng"

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

3.4.1.2. Màn hình pop-up "Tải tài liệu"

3.4.1.2. Màn hình pop-up "Thêm mới hợp đồng"

3.4.1.3. Màn hình pop-up "Chỉnh sửa hợp đồng"

3.4.1.3.1. Màn hình pop-up "Chỉnh sửa hợp đồng" - Tab "Thông tin chi tiết" với mã quy định HĐ NGOÀI quy trình BPM

1. Headers

2. Param

3. Response / Incoming Data Specification

1. Headers

2. Param

3. Response / Incoming Data Specification

1. Headers

2. Param

3. Response / Incoming Data Specification

1. Headers

2. Param

3. Response / Incoming Data Specification

1. Headers

2. Param

3. Response / Incoming Data Specification

1. Headers

2. Param

3. Response / Incoming Data Specification

1. Headers

2. Param

3. Response / Incoming Data Specification

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

3.4.1.2. Màn hình pop-up "Thêm mới hợp đồng"

3.4.1.3.3. Màn hình pop-up "Chỉnh sửa hợp đồng" - Tab "Lịch sử chỉnh sửa"

3.4.1.4. Màn hình pop-up "Cài đặt hiển thị"

3.4.1.3. Màn hình pop-up "Chỉnh sửa hợp đồng"

3.4.1.3.1. Màn hình pop-up "Chỉnh sửa hợp đồng" - Tab "Thông tin chi tiết" với mã quy định HĐ NGOÀI quy trình BPM

3.4.2. Màn hình "Xem chi tiết hợp đồng" - Tab Thông tin chi tiết"

3.4.1.3.3. Màn hình pop-up "Chỉnh sửa hợp đồng" - Tab "Lịch sử chỉnh sửa"

3.4.1.3.4. Màn hình pop-up "Chỉnh sửa hợp đồng" - Tab "Lịch sử chỉnh sửa" - Chi tiết lịch sử chỉnh sửa

3.4.

2. Màn hình

"Xem chi tiết hợp đồng" - Tab Thông tin chi tiết"

3.4.3. Màn hình "Pop-up cảnh báo"

3.4.3.1. Pop up "Cảnh báo trùng"

3.4.3.2. Pop up cảnh báo điều kiện ngày hoàn thành (ngày hoàn thành nhỏ hơn ngày hợp đồng)