Versions Compared

Old Version 18

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

Saved on

compared with

New Version Current

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

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Ngày ký


Nghiệp vụ

IT

Người lập

Người duyệt

Người lập

Người duyệt

Tên, Chức danh

Họ và tên

Nguyễn Thanh Vân

Vũ Thị Mơ



Vũ Thị Mơ



Tài khoản email/MS team

vannt4

movt2



movt2



Chức danh

Business Analyst (BA)

Business Analyst Business (BA BIZ)



Business Analyst Business (BA BIZ)




Ngày soạn thảo

 




 




Jira Link

https://jira.popplife.vn/browse/BPMKVH-3789

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

...

  1. Tôi muốn xem được danh sách loại hợp đồng bao gồm các thông tin
    1. Mã loại hợp đồng (Duy nhất)
    2. Tên loại hợp đồng
    3. Trạng thái
  2. Tôi muốn tìm kiếm được loại hợp đồng theo mã - tên loại hợp đồng
  3. Tôi muốn tạo mới được thông tin loại hợp đồng:
    1. Mã loại hợp đồng
    2. Tên loại hợp đồng
    3. Trạng thái
  4. Tôi muốn sửa được thông tin loại hợp đồng
    1. Tên loại hợp đồng
    2. Trạng thái
  5. Tôi muốn xem chi tiết được thông tin loại hợp đồng
    1. Mã loại hợp đồng
    2. Tên loại hợp đồng
    3. Trạng thái
  6. Tôi muốn xóa được loại hợp đồng theo một bản ghi hoặc nhiều bản ghi
  7. Tôi muốn hệ thống cảnh báo và chặn trong trường hợp Thêm mới trùng mã loại hợp đồng 
  8. Tôi muốn hệ thống cảnh báo và chặn trong trường hợp Xóa loại hợp đồng đã được sử dụng 
  9. Tôi muốn nhập file excel/ Xuất file excel được Loại hợp đồng

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

3.1 UIUX:

3.1.1. Màn hình danh mục Danh mục loại hợp đồng

3.1.1.1.

...

 Màn hình Danh sách trống (không có dữ liệu ban đầu):

Image RemovedImage Added

3.1.1.2.

...

Màn hình Danh sách (có kết quả):

Image Added

3.1.1.3. Màn hình Danh sách (không có kết quả):

Image Added

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

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

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

3.1.5. Màn hình pop-up "Xác nhận xóa"

Image Added

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

...

Image Removed

...

trùng"

3.1.

...

7. Màn hình pop-up "Xuất danh sách danh mục loại hợp đồng"

3.1.

...

8. Màn hình pop-up "Nhập file Excel"

3.1.9.

...

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

3.1.10 Màn hình pop-up "Xác nhận hủy"

 

3.2 Luồng:

  • Activity Diagram:


  • Sequence Diagram:


  • Flowchart: 


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

Panel
titleAPI Spec Document

Method


URL


1. Headers

STT

Field

Source Data Type / Length 

Description

Sample Values






2. Body

STT

Path

Field

Data Type / Length

Description

Note

Sample Values















3. Response / Incoming Data Specification

STT

Field

Data Type / Length

Description

Note

Sample Values




















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

3.4.1. Màn hình danh mục "Loại hợp đồng"
3.4.1.1 Màn hình Danh sách Danh mục loại hợp đồng
  • Màn hình Danh mục "Loại hợp đồng

...

  • ” cho phép người dùng lưu trữ dữ liệu về loại hợp đồng trên hệ thống để quản lý thông tin về loại hợp đồng

Type

(
STT

Field

(Trường dữ liệu)

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

Kiểu dữ liệu

)

Length

(

Required

(Bắt buộc)

Điều kiện

Độ dài ký tự

)Validation

(


Quy định

)Description

(

Mô tả

)


1 

STT 

Số (Number

 

)

 

 Không bắt buộc



Thể hiện số thự tự tự sinh tăng dần của từng bản ghi trên màn hình danh sách danh mục loại hợp đồng

2 

Mã loại hợp đồng

Văn bản (Text

 

)

 

 Không bắt buộc


Chỉ xem

Thể hiện mã của loại hợp đồng

3 

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

Văn bản (Text)+ Đường dẫn (Hyperlink)

 

 Không bắt buộc


- Chỉ xem

- Sau khi nhấn vào tên loại hợp đồng, hệ thống mở ra Pop-up "Xem chi tiết loại hợp đồng"

Thể hiện tên của loại hợp đồng

4 

Hoạt động

Công tắc (Toggle

button  

)

 Không bắt buộc


Hệ thống cho phép người dùng chọn 1 trong 2 giá trị:

  • Hoạt động
  • Không hoạt động

Thể hiện trạng thái hoạt động của loại hợp đồng với 2 giá trị tương ứng gồm:

  • Hoạt động: Thông tin đang hoạt động và có thể sử dụng. 
  • Không hoạt động: Thông tin đang không hoạt động và không thể sử dụng

5 

Ô
tìm kiếm  

 Search box

 
tìm kiếm (Search box)Văn bản (Text)

 Không bắt buộc

150

- Ô cho phép người dùng nhập từ khóa theo tiêu chí: 

  • Mã loại hợp đồng
  • Tên loại hợp đồng

- Hệ thống tự động lọc dữ liệu ngay khi người dùng nhập.

- 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 loại 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 loại 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ó loại hợp đồng nào khớp với từ khóa tìm kiếm hoặc danh sách loại 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ó loại hợp đồng nào. Hãy thêm mới loại hợp đồng đầu tiên nhé!"
Thể hiện ô tìm kiếm cho phép người dùng tìm loại hợp đồng

6

Nút “Thêm mới” 

Nút chức năng (Button

 

)

 

 Không bắt buộc


Sau khi nhấn nút, hệ thống hiển thị pop-up "Thêm mới loại hợp đồng"Cho phép người dùng thêm mới loại hợp đồng

7

Nút “Sửa” 

Nút chức năng (Button

 

)

 

 Không bắt buộc


Sau khi nhấn nút, hệ thống hiển thị pop-up "Chỉnh sửa loại hợp đồng"Cho phép người dùng chỉnh sửa loại hợp đồng

8

Nút “Xóa” 

Nút chức năng (Button

 

)

 - Không hiển thị hộp

 Không bắt buộc


Sau khi nhấn nút, hệ thống mở ra pop-up "Xác nhận xóa"Cho phép người dùng xóa loại hợp đồng

9

Hộp tích chọn
Checkbox
Hộp tích chọn (Check box)Không bắt buộc

- Disable hộp tích chọn đối với:

- Cho phép người dùng tích chọn một/ nhiều/ tất cả các dòng để thực hiện thao tác xóa hàng loạt.

Cho phép người dùng tích chọn loại hợp đồng

10

Nút "Xóa" hàng loạtImage Modified

Nút chức năng (Button)Không bắt buộc

Chỉ hiển thị nút sau khi người dùng đã bấm vào hộp tích chọn 

Sau khi nhấn nút, hệ thống mở ra pop-up "Xác nhận xóa (hàng loạt)"

Cho phép người dùng xóa nhiều loại hợp đồng
11Nút "Xuất file Excel"Nút chức năng (Button)Không bắt buộc

Sau khi nhấn nút, hệ thống hiển thị pop-up "Xuất danh sách danh mục loại hợp đồng"

Cho phép người dùng xuất file danh sách loại hợp đồng theo định dạng excel
12

Nút "Nhập file Excel"

Button
Nút chức năng (Button)Không bắt buộc

Sau khi nhấn nút, hệ thống hiển thị pop-up "Nhập file Excel"

Cho phép người dùng nhập file danh sách loại hợp đồng theo định dạng excel
3.4.1.2 Màn hình pop-up "Thêm mới loại hợp đồng"
  • Pop-up "Thêm mới loại hợp đồng" hiển thị khi người dùng nhấn button "Thêm mới" trên màn hình danh sách
STT

Field

(Trường dữ liệu)

Type

(Kiểu dữ liệu)

Required

(Bắt buộc)

Length

(Độ dài ký tự)


Validation

(Quy định)

Description

(Mô tả)


1 

Mã loại hợp đồng

Văn bản (Text

 

)

x

Bắt buộc

50

Cho phép nhập dữ liệu

Cho phép người dùng nhập mã của loại hợp đồng

2 

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

Văn bản (Text)

x
Bắt buộc150Cho phép nhập dữ liệuCho phép người dùng nhập tên của loại hợp đồng

3

Trạng thái hoạt động
Toggle button 

Công tắc (Toggle)

Không bắt buộc


Hệ thống cho phép người dùng chọn 1 trong 2 giá trị:

  • Hoạt động (mặc định)
  • Không hoạt động

Cho phép người dùng chọn trạng thái hoạt động của loại hợp đồng với 2 giá trị tương ứng gồm:

  • Hoạt động: Thông tin đang hoạt động và có thể sử dụng. 
  • Không hoạt động: Thông tin đang không hoạt động và không thể sử dụng

4

Nút “Áp dụng” 

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

Không bắt buộc


- Nút chỉ kích hoạt khi tất cả các trường dữ liệu bắt buộc đã được nhập

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

- Sau khi nhấn nút, hệ thống thực hiện kiểm tra trùng lặp dữ liệu ở trường "Mã loại hợp đồng" theo 2 trường hợp:

  • TH1: Mã loại hợp đồng không bị trùng lặp → Hệ thống lưu thông tin thêm mới, đóng pop-up và hiển thị toast thành công màu xanh lá: " Thành công - Thêm mới loại hợp đồng thành công"
  • TH2: Mã loại hợp đồng bị trùng lặp → Hệ thống không lưu thông tin thêm mới và hiển thị pop-up "Cảnh báo trùng"

Cho phép người dùng thêm mới loại hợp đồng

5

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

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

Không bắt buộc


- Sau khi nhấn nút, hệ thống thực hiện kiểm tra dữ liệu theo 2 trường hợp:

  • TH1: Chưa có trường nào được nhập → Hệ thống đóng pop-up và quay về giao diện trước đó
  • TH2: Có ít nhất 1 trường đã được nhập →Hệ thống hiển thị pop-up "Xác nhận hủy (thêm mới)"
Cho phép người dùng hủy thao tác thêm mới loại hợp đồng và đóng pop-up
3.4.1.3 Màn hình pop-up "Chỉnh sửa loại hợp đồng"
  • Pop-up "Chỉnh sửa loại hợp đồng" hiển thị khi người dùng nhấn button "Sửa" trên màn hình danh sách

STT

Field

(Trường dữ liệu)

Type

(

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

Kiểu dữ liệu

)

Validation

(Quy định)

Description

(Mô tả)

Required

(Bắt buộc)

Length

(Độ dài ký tự)

Điều kiện

Quy định

Mô tả


1 

Mã loại hợp đồng

Văn bản (Text

 Cho

)

x

50

Bắt buộc


Không cho phép chỉnh sửa dữ liệu
Cho phép người dùng sửa

Hiển thị mã của loại hợp đồng

2 

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

Văn bản (Text)

x
Bắt buộc150Cho phép chỉnh sửa dữ liệu

Cho phép người dùng sửa tên của loại hợp đồng

3

Trạng thái hoạt động
Toggle button 

Công tắc (Toggle)

Không bắt buộc


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

- Hệ thống cho phép người dùng chọn 1 trong 2 giá trị:

  • Hoạt động
  • Không hoạt động

Cho phép người dùng sửa trạng thái hoạt động của loại hợp đồng với 2 giá trị tương ứng gồm:

  • Hoạt động: Thông tin đang hoạt động và có thể sử dụng. 
  • Không hoạt động: Thông tin đang không hoạt động và không thể sử dụng

4

Nút “Áp dụng” 

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

Không bắt buộc


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

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

- Sau khi nhấn nút, hệ thống thực hiện

kiểm tra trùng lặp dữ liệu ở trường "Mã loại hợp đồng" theo 2 trường hợp:TH1: Mã loại hợp đồng không bị trùng lặp → Hệ thống lưu thông tin thêm mới, đóng pop

lưu thông tin chỉnh sửa, đóng pop-up và hiển thị toast thành công màu xanh lá: " Thành công -

Thêm mới

Cập nhât loại hợp đồng thành công

"TH2: Mã loại hợp đồng bị trùng lặp → Hệ thống không lưu thông tin thêm mới và hiển thị pop-up "Cảnh báo trùng

"

Cho phép người dùng chỉnh sửa loại hợp đồng

5

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

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

Không bắt buộc


- Sau khi nhấn nút, hệ thống thực hiện kiểm tra dữ liệu theo 2 trường hợp:

  • TH1: Chưa có trường nào được chỉnh sửa → Hệ thống đóng pop-up và quay về giao diện trước đó
  • TH2: Có ít nhất 1 trường đã được chỉnh sửa → Hệ thống hiển thị pop-up "Xác nhận hủy (chỉnh sửa)"
Cho phép người dùng hủy thao tác chỉnh sửa loại hợp đồng và đóng pop-up
3.4.1.4 Màn hình pop-up "Xem chi tiết loại hợp đồng"
  • Pop-up "Xem chi tiết loại hợp đồng" hiển thị khi người dùng nhấn vào tên loại hợp đồng trên màn hình danh sách

Type

(

STT

Field

(Trường dữ liệu)

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

Kiểu dữ liệu

)

Validation

(Quy định)

Description

(Mô tả)

Required

(Bắt buộc)

Length

(Độ dài ký tự)

Điều kiện

Quy định

Mô tả


1 

Mã loại hợp đồng

Văn bản (Text

 

)

x

Bắt buộc

50

 Chỉ xem

Thể hiện mã của loại hợp đồng

2 

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

Văn bản (Text)

x
Bắt buộc150Chỉ xem

Thể hiện tên của loại hợp đồng

3

Trạng thái hoạt động
Toggle button 

Công tắc (Toggle)

Không bắt buộc


Chỉ xem

Thể hiện trạng thái hoạt động của loại hợp đồng với 2 giá trị tương ứng gồm:

  • Hoạt động: Thông tin đang hoạt động và có thể sử dụng. 
  • Không hoạt động: Thông tin đang không hoạt động và không thể sử dụng

4

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

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

Không bắt buộc


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

Cho phép người dùng đóng pop-up
3.4.1.5 Màn hình pop-up "Xác nhận xóa"
  • Pop-up "Xác nhận xóa" hiển thị khi người dùng nhấn button "Xóa" trên màn hình danh sách
  • Pop-up "Xác nhận xóa (hàng loạt)" hiển thị khi người dùng nhấn button "Xóa hàng loạt" trên màn hình danh sách
STT

Field

(Trường dữ liệu)

Type

(Kiểu dữ liệu)

Required

(Bắt buộc)

Length

(Độ dài ký tự)


Validation

(Quy định)

Description

(Mô tả)


Pop-up Xác nhận xóa 

1 

Bạn có chắc chắn muốn xóa loại hợp đồng này?

Nhãn (Label)




Nội dung cảnh báo xác nhận xóa

2 

Tôi chắc chắn

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

Không bắt buộc

Sau khi nhấn nút, hệ thống kiểm tra bản ghi về loại hợp đồng theo 2 trường hợp:

⭢ Hệ thống không cho phép xóa và hiển thị toast cảnh báo: "Cảnh báo - Loại hợp đồng đang được sử dụng nên không thể xóa"

⭢ Hệ thống xóa dữ liệu về tất cả loại hợp đồng được chọn, đóng pop-up và hiển thị toast thành công màu xanh lá: "Thành công - Xóa loại hợp đồng thành công"

Cho phép người dùng xóa loại hợp đồng đã chọn

3

Hủy

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

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

Cho phép người dùng hủy thao tác xóa loại hợp đồng đã chọn và đóng pop-up

Pop-up Xác nhận xóa (hàng loạt)

1 

Bạn có chắc chắn muốn xóa X loại hợp đồng này?

Nhãn (Label)



Trong đó X là số lượng bản ghi được lựa chọn để xóa

Nội dung cảnh báo xác nhận xóa tất cả loại hợp đồng đã chọn

2 

Tôi chắc chắn

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

Không bắt buộc

Sau khi nhấn nút, hệ thống sẽ trả kết quả theo 2 trường hợp:

⭢ Hệ thống không cho phép xóa, đóng pop-up và quay về Màn hình Danh sách Danh mục loại hợp đồng và hiển thị

pop-up

toast cảnh báo: "Cảnh báo

đã sử dụng"TH2: Tất cả

- Có (X) loại hợp đồng

CHƯA được sử dụng trong:Bản ghi chưa được sử dụng

đang được sử dụng nên không thể xóa". Tại Màn hình Danh sách Danh mục loại hợp đồng, hệ thống thực hiện:

  • Làm mới trang (không xóa bất cứ giá trị nào)
  • Chỉ giữ lại lựa chọn các bản ghi có thể xóa
  • Disable hộp tích chọn các bản ghi đã sử dụng

⭢ Hệ thống xóa dữ liệu về tất cả loại hợp đồng được chọn, đóng pop-up và hiển thị toast thành công màu xanh lá: "Thành công - Xóa X loại hợp đồng thành công"

Cho phép người dùng xóa tất cả loại hợp đồng đã chọn

3

Hủy

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

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

Cho phép người dùng hủy thao tác xóa tất cả loại hợp đồng đã chọn và đóng pop-up

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

...

trùng"
  • Pop-up "Cảnh báo

...

  • trùng" hiển thị khi người dùng nhấn button "

...

  • Áp dụng" trên màn hình pop-up

...

  • "Thêm mới loại hợp đồng"
STT

Field

(Trường dữ liệu)

Type

(Kiểu dữ liệu)

Required

(Bắt buộc)

Length

(Độ dài ký tự)


Validation

(Quy định)

Description

(Mô tả)


1 

X loại hợp đồng đang

Mã đã được sử dụng

nên không thể xóa

. Vui lòng

kiểm tra lại

nhập mã khác!

Nhãn (Label

Trong đó X là số lượng bản ghi của loại hợp đồng đã được sử dụng trong hệ thống nằm trong danh sách loại hợp đồng đã chọn

)




Nội dung cảnh báo

đã sử dụngSTT

Field

(Trường dữ liệu)

Type

(Kiểu dữ liệu)

Required

(Bắt buộc)

Length

(Độ dài ký tự)

Validation

(Quy định

trùng

2

STT

Text

x

Hiển thị số thứ tự tự sinh tăng dần

3 

Mã loại hợp đồng

Text

x

50

Chỉ xem

Hiển thị mã loại hợp đồng đã được sử dụng trong hệ thống nằm trong danh sách loại hợp đồng đã chọn

4

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

Textx150Chỉ xemHiển thị tên loại hợp đồng đã được sử dụng trong hệ thống nằm trong danh sách loại hợp đồng đã chọn

5 

ThoátButton

Sau khi nhấn nút, hệ thống đóng pop-up và quay về Màn hình Danh sách Danh mục loại hợp đồng

Tại Màn hình Danh sách Danh mục loại hợp đồng, hệ thống thực hiện

  • Làm mới trang (không xóa bất cứ giá trị nào)
  • Chỉ giữ lại lựa chọn các bản ghi có thể xóa
  • Ẩn hộp tích chọn các bản ghi đã sử dụng

Cho phép người dùng đóng pop-up

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

Pop-up "Cảnh báo trùng" hiển thị khi người dùng nhấn button "Áp dụng" trên màn hình pop-up Thêm mới loại hợp đồng

ThoátNút chức năng (Button)Không bắt buộc
Sau khi nhấn nút, hệ thống đóng pop-up và quay về pop-up "Thêm mới loại hợp đồng"

Cho phép người dùng đóng pop-up

3.4.1.7 Màn hình pop-up "Xuất danh sách danh mục loại hợp đồng"
  • Pop-up "Xuất danh sách danh mục loại hợp đồng" hiển thị khi người dùng nhấn button "Xuất file Excel" trên màn hình danh sách
STT

Field

(Trường dữ liệu)

Type

(Kiểu dữ liệu)

Required

(Bắt buộc)

Length

(Độ dài ký tự)


Validation

(Quy định)

Description

(Mô tả)


1 

Chọn kiểu xuất fileNút chọn (Radio)Không bắt buộc

Hệ thống cho phép người dùng chọn 1 trong 3 giá trị:

  • Tất cả (mặc định)
  • Trên trang này
  • Tất cả loại hợp đồng phù hợp với kết quả tìm kiếm hiện tại
Cho phép người dùng chọn kiểu xuất file sẽ tải xuống

2

Xuất fileNút chức năng (Button)Không bắt buộc

- Quy tắc đặt tên: LoaiHopDong_yyyymmdd

  • VD: LoaiHopDong_20251215

- Sau khi nhấn nút, hệ thống thực hiện tải xuống tài liệu, đóng pop-up và hiển thị toast thành công màu xanh lá sau khi tải xong: "Thành công - Xuất dữ liệu thành công"

Cho phép người dùng tải xuống file loại hợp đồng theo định dạng excel và kiểu xuất file đã chọn

3 

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

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

Không bắt buộc


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

Cho phép người dùng hủy thao tác xuất danh sách loại hợp đồng và đóng pop-up

Thông tin file excel tải xuống: LoaiHopDong.xlsx

Image Added

STT

Field

(Trường dữ liệu)

Description

(Mô tả)


1 

Mã đã được sử dụng. Vui lòng nhập mã khác!

Label

Nội dung cảnh báo trùng

2

ThoátButtonSau khi nhấn nút, hệ thống đóng pop-up và quay về pop-up "Thêm mới loại hợp đồng"

Cho phép người dùng đóng pop-up

4.1.8 Màn hình pop-up "Xuất danh sách danh mục loại hợp đồng"

...

Thời gian xuấtThể hiện thời gian xuất dữ liệu theo định dạng: dd/mm/yyyy hh:mm

2

Người xuấtThể hiện thông tin tên hiển thị của người thực hiện xuất dữ liệu

3 

STTThể hiện số thự tự tự sinh tăng dần 

4

Mã loại hợp đồng *

Thể hiện thông tin mã của loại hợp đồng

5

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

Thể hiện thông tin tên của loại hợp đồng

6

Trạng thái hoạt động

Thể hiện trạng thái hoạt động của loại hợp đồng:

  • Hoạt động
  • Không hoạt động
3.4.1.8 Màn hình pop-up "Nhập file Excel"
  • Pop-up "Nhập file Excel" hiển thị khi người dùng nhấn button "

...

  • Nhập file Excel" trên màn hình danh sách
Cho phép người dùng chọn kiểu xuất file sẽ
STT

Field

(Trường dữ liệu)

Type

(Kiểu dữ liệu)

Required

(Bắt buộc)

Length

(Độ dài ký tự)


Validation

(Quy định)

Description

(Mô tả)


1 

Chọn kiểu xuất fileRadio

Hệ thống cho phép người dùng chọn 1 trong 3 giá trị:

  • Tất cả loại hợp đồng (mặc định)
  • Trên trang này
  • Tất cả loại hợp đồng phù hợp với kết quả tìm kiếm hiện tại
Tài liệu mẫuNhãn (Label)Không bắt buộc


Tài liệu mẫu để tải xuống

2

Xuất fileButton
Tải xuốngNút chức năng (Button)Không bắt buộc

- Quy tắc đặt tên: Template-LoaiHopDong

-

_yyyymmdd

  • VD:
LoaiHopDong-20251215- Sau khi nhấn nút, hệ thống thực hiện tải xuống tài liệu, đóng pop-up và hiển thị toast thành công màu xanh lá sau khi tải xong: "Thành công - Xuất dữ liệu thành công"
  • Template-LoaiHopDong_20251205
Cho phép người dùng tải xuống file
loại hợp đồng
tài liệu mẫu theo định dạng excel
và kiểu xuất file đã chọn

3 

Tài liệu đính kèmNút
“Hủy”/Nút Đóng “X” 

Button

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

Cho phép người dùng hủy thao tác xuất danh sách loại hợp đồng và đóng pop-up

Thông tin file excel tải xuống: LoaiHopDong.xlsx

Image Removed

...

Field

(Trường dữ liệu)

Description

(Mô tả)

...

1 

...

2

...

3 

...

4

...

Mã loại hợp đồng *

...

Thể hiện thông tin mã của loại hợp đồng

...

5

...

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

...

Thể hiện thông tin tên của loại hợp đồng

...

6

...

Trạng thái hoạt động

...

Thể hiện trạng thái hoạt động của loại hợp đồng:

  • Hoạt động
  • Không hoạt động

4.1.9 Màn hình pop-up "Nhập file Excel"

Pop-up "Nhập file Excel" hiển thị khi người dùng nhấn button "Nhập file Excel" trên màn hình pop-up danh sách

...

Field

(Trường dữ liệu)

...

Type

(Kiểu dữ liệu)

...

Required

(Bắt buộc)

Length

(Độ dài ký tự)

...

Validation

(Quy định)

Description

(Mô tả)

...

1 

...

2

...

- Quy tắc đặt tên: Template-LoaiHopDong-yyyymmdd

  • VD: Template-LoaiHopDong-20251205

...

3 

...

- Chỉ cho phép tải lên 1 file/lần

- Chỉ cho phép tải file với định dạng tệp Excel

  • VD: .xlsx , .xls , ...

-  Sau khi chọn xong, hệ thống hiển thị tệp dữ liệu đã tải lên trong mục Tài liệu đính kèm.

...

- Cho phép người dùng đính kèm tài liệu lên hệ thống

- 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 xóa tài liệu đính kèm

...

4

...

Áp dụng

...

Button

...

- Nút chỉ kích hoạt khi người dùng đã thực hiện đính kèm tài liệu

- Sau khi nhấn nút, hệ thống thực hiện kiểm tra điều kiện của các trường và sẽ trả kết quả theo 3 trường hợp:

  • TH1: File đúng định dạng với template và dữ liệu hợp lệ

→ Hệ thống lưu thông tin thêm mới, đóng pop-up và hiển thị toast thành công màu xanh lá: "Thành công- Nhập dữ liệu thành công"

  • TH2: File đúng định dạng với template và dữ liệu không hợp lệ bao gồm:

    • Thiếu dữ liệu bắt buộc.

    • Dữ liệu vượt quá giới hạn độ dài/giá trị.

    • Mã đơn vị đã tồn tại trong hệ thống.

    • Trùng lặp mã đơn vị ngay trong chính tệp được tải lên

→ Hệ thống không lưu thông tin thêm mới, hiển thị pop-up "Lỗi nhập file excel"

  • TH3: File sai định dạng với template

→ Hệ thống không lưu thông tin thêm mới, hiển thị toast lỗi màu đỏ: "Không thành công - Định dạng file không hợp lệ"

...

5

...

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

...

Button

...

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

...

Thông tin file excel tài liệu mẫu: Template-LoaiHopDong.xlsx

Image Removed

...

Field

(Trường dữ liệu)

...

Type

(Kiểu dữ liệu)

...

Required

(Bắt buộc)

Length

(Độ dài ký tự)

Validation

(Quy định)

...

Description

(Mô tả)

...

1 

...

Mã loại hợp đồng *

...

Text 

...

x

...

Cho phép người dùng nhập mã của loại hợp đồng

...

2

...

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

...

Text

...

Cho phép người dùng nhập tên của loại hợp đồng

...

3 

...

Trạng thái hoạt động *

...

x

...

Hệ thống chỉ cho phép nhập 1 trong 2 giá trị:

  • "Hoạt động"
  • "Không hoạt động"

...

Cho phép người dùng nhập giá trị tương ứng với trạng thái hoạt động của loại hợp đồng:

  •  "Hoạt động"
  • "Không hoạt động"

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

STT

Field

(Trường dữ liệu)

Type

(Kiểu dữ liệu)

Required

(Bắt buộc)

Validation

(Quy định)

Description

(Mô tả)

1

Không thành công

File excel bạn nhập chưa chính xác

LabelNội dung thông báo lỗi nhập file excel2Danh mục các lỗi gặp phảiLabelTiêu đề danh sách các lỗi3Dòng lỗiTextĐối với trường hợp file không theo template 

Trả về số thứ tự của dòng lỗi

4Ghi chú lỗiText

Hiển thị danh sách lỗi khi gán dữ liệu Excel:

  • Lỗi nhập thiếu trường bắt buộc: "Giá trị trường <Tên trường> chưa nhập"
  • Lỗi nhập thừa ký tự trường: "Giá trị trường <Tên trường> vượt quá giới hạn độ dài ký tự cho phép"
  • Lỗi trùng mã loại hợp đồng: "Mã loại hợp đồng <Mã loại hợp đồng> đã tồn tại"
  • Lỗi khi mã loại hợp đồng của bản ghi bị trùng với bản ghi khác trong tệp được tải lên: "Mã bị trùng với mã tại dòng (X)" (Trong đó, (X) là số thứ tự của bản ghi trùng mã nằm trong chính tệp được tải lên. Trường hợp có nhiều bản ghi trùng lắp, liệt kê các bản ghi và phân cách bằng dấu ",")
    • Lỗi giá trị trường trạng thái hoạt động: "Trường trạng thái hoạt động chỉ cho phép nhập "Hoạt động" hoặc "Không hoạt động""
    chức năng (Button)Không bắt buộc

    - Chỉ cho phép tải lên 1 file/lần

    - Chỉ cho phép tải file với định dạng tệp Excel

    • VD: .xlsx , .xls , ...

    -  Sau khi chọn xong, hệ thống hiển thị tệp dữ liệu đã tải lên trong mục Tài liệu đính kèm.

    - Cho phép người dùng đính kèm tài liệu lên hệ thống

    - 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 xóa tài liệu đính kèm

    4

    Áp dụng

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

    Không bắt buộc


    - Nút chỉ kích hoạt khi người dùng đã thực hiện đính kèm tài liệu

    - Sau khi nhấn nút, hệ thống thực hiện kiểm tra điều kiện của các trường và sẽ trả kết quả theo 3 trường hợp:

    • TH1: File đúng định dạng với template và dữ liệu hợp lệ
      • Tệp dữ liệu đầu vào thuân thủ theo tệp mẫu (template).
      • Thứ tự Sheet Bắt buộc: sheet “LoaiHopDong” phải đứng trước, sheet “Hướng dẫn nhập liệu” đứng sau

    → Hệ thống lưu thông tin thêm mới với giá trị trường Trạng thái của loại hợp đồng mặc định: "Hoạt động", đóng pop-up và hiển thị toast thành công màu xanh lá: "Thành công - Nhập dữ liệu thành công"

    • TH2: File đúng định dạng với template và dữ liệu không hợp lệ bao gồm:

      • Thiếu dữ liệu bắt buộc.

      • Dữ liệu vượt quá giới hạn độ dài/giá trị.

      • Mã loại hợp đồng đã tồn tại trong hệ thống.

      • Trùng lặp mã loại hợp đồng ngay trong chính tệp được tải lên

    → Hệ thống không lưu thông tin thêm mới, hiển thị pop-up "Lỗi nhập file excel"

    • TH3: File sai định dạng với template bao gồm:
      • Dòng tên trường dữ liệu của bảng bị chỉnh sửa (không ở dòng 4)
      • Tên trường dữ liệu bị chỉnh sửa
      • Sheet "LoaiHopDong" bị thay đổi vị trí (không phải là sheet đầu tiên)

    → Hệ thống không lưu thông tin thêm mới, hiển thị toast lỗi màu đỏ: "Không thành công - File excel không hợp lệ"

    		Cho phép người dùng thêm mới nhiều loại hợp đồng trong tài liệu

    5

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

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

    Không bắt buộc


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

    		Cho phép người dùng hủy thao tác nhập file excel và đóng pop-up

    Thông tin file excel tài liệu mẫu: Template-LoaiHopDong.xlsx

    Image Added

    STT

    Field

    (Trường dữ liệu)

    Type

    (Kiểu dữ liệu)

    Required

    (Bắt buộc)

    Length

    (Độ dài ký tự)


    Validation

    (Quy định)


    Description

    (Mô tả)

    1 

    Mã loại hợp đồng *

    Văn bản (Text)

    Không bắt buộc

    		50

    Cho phép người dùng nhập mã của loại hợp đồng

    2

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

    Văn bản (Text)

    		Không bắt buộc150

    Cho phép người dùng nhập tên của loại hợp đồng

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

    • Pop-up "Lỗi nhập file excel" hiển thị khi người dùng nhấn button "Áp dụng" trên màn hình pop-up "Nhập file Excel" (TH2)
    STT

    Field

    (Trường dữ liệu)

    Type

    (Kiểu dữ liệu)

    Required

    (Bắt buộc)

    Validation

    (Quy định)


    Description

    (Mô tả)

    1

    Không thành công

    File excel bạn nhập chưa chính xác

    		Nhãn (Label)

    		Nội dung thông báo lỗi nhập file excel
    2Danh mục các lỗi gặp phảiNhãn (Label)

    		Tiêu đề danh sách các lỗi
    3Dòng lỗiVăn bản (Text)Không bắt buộcĐối với trường hợp dữ liệu trong file lỗi

    Trả về số thứ tự của dòng lỗi

    4Ghi chú lỗiVăn bản (Text)Không bắt buộc

    Hiển thị danh sách lỗi khi gán dữ liệu Excel:

    • Lỗi nhập thiếu trường bắt buộc: "<Tên trường> - Thiếu thông tin <tên trường>"
    • Lỗi nhập thừa ký tự tại trường: "<Tên trường> - Vượt quá <độ dài ký tự của trường> ký tự"
    • Lỗi trùng mã duy nhất: "<Tên trường> - <Tên trường> đã tồn tại"
    • Lỗi khi mã của bản ghi bị trùng với bản ghi khác trong tệp được tải lên: "<Tên trường> - Mã bị trùng với mã tại dòng (X)" (trong đó, X là dòng đầu tiên xuất hiện mã trùng trong bảng thêm mới)
      • Ví dụ:

    Bảng thêm mới

    DòngMã loại hợp đồng*Tên loại hợp đồng*
    1HDNTHợp đồng nguyên tắc
    2

    HDTC

    		Hợp đồng tài chính 1
    3HDTCHợp đồng tài chính 2
    4HDTCHợp đồng tài chính 3

    Bảng thông báo lỗi

    Dòng lỗiGhi chú lỗi
    3Mã đơn vị tiền tệ - Mã bị trùng với mã tại dòng 2
    4Mã đơn vị tiền tệ - Mã bị trùng với mã tại dòng 2
    		Hiển thị ghi chú lỗi của dòng lỗi
    5Tải xuốngNút chức năng (Button)Không bắt buộc

    - Quy tắc đặt tên: LoaiHopDong_Error-yyyymmdd

    • VD: LoaiHopDong_Error-20251205

    - Sau khi nhấn nút, hệ thống thực hiện tải xuống tài liệu và hiển thị toast thành công màu xanh lá sau khi tải xong: "Thành công - Xuất dữ liệu thành công"

    		Cho phép người dùng tải xuống file danh sách các lỗi theo định dạng excel
    6Nhập lạiNút chức năng (Button)Không bắt buộcSau khi nhấn nút, hệ thống đóng pop-up và quay về màn hình pop-up "Nhập file Excel"Cho phép người dùng nhập lại file excel
    7Nút “Hủy”/Nút Đóng “X” Nút chức năng (Button)Không bắt buộc

    Sau khi nhấn nút, hệ thống đóng pop-up và quay về giao diện Màn hình Danh sách Danh mục loại hợp đồng

    		Cho phép người dùng đóng pop-up

    Thông tin file excel danh sách lỗi tải xuống: LoaiHopDong_Error.xlsx

    ...

    "Giá trị trường <Tên trường> chưa nhập"
  • Lỗi nhập thừa ký tự trường: "Giá trị trường <Tên trường> vượt quá giới hạn độ dài ký tự cho phép"
  • Lỗi trùng mã loại hợp đồng: "Mã loại hợp đồng <Mã loại hợp đồng> đã tồn tại"
  • Lỗi khi mã loại hợp đồng của bản ghi bị trùng với bản ghi khác trong tệp được tải lên: "Mã bị trùng với mã tại dòng (X)" (Trong đó, (X) là số thứ tự của bản ghi trùng mã nằm trong chính tệp được tải lên. Trường hợp có nhiều bản ghi trùng lắp, liệt kê các bản ghi và phân cách bằng dấu ",")
  • Lỗi giá trị trường trạng thái hoạt động: "Trường trạng thái hoạt động chỉ cho phép nhập "Hoạt động" hoặc "Không hoạt động""
    • STT

    Field

    (Trường dữ liệu)

    Description

    (Mô tả)


    1 

    		Thời gian xuấtThể hiện thời gian xuất dữ liệu theo định dạng: dd/mm/yyyy hh:mm:ss

    2

    		Người xuấtThể hiện thông tin tên của người thực hiện xuất dữ liệu

    3 

    		Dòng lỗiTrả về số thứ tự của dòng lỗi

    4

    		Ghi chú lỗi

    Hiển thị danh sách lỗi khi gán dữ liệu Excel:

    • Lỗi nhập thiếu trường bắt buộc:

    ...

    • "<Tên trường> - Thiếu thông tin <tên trường>"
    • Lỗi nhập thừa ký tự tại trường: "<Tên trường> - Vượt quá <độ dài ký tự của trường> ký tự"
    • Lỗi trùng mã duy nhất: "<Tên trường> - <Tên trường> đã tồn tại"
    • Lỗi khi mã của bản ghi bị trùng với bản ghi khác trong tệp được tải lên: "<Tên trường> - Mã bị trùng với mã tại dòng (X)" (trong đó, X là dòng đầu tiên xuất hiện mã trùng trong bảng thêm mới)
      • Ví dụ:

    Bảng thêm mới

    DòngMã loại hợp đồng*Tên loại hợp đồng*
    1HDNTHợp đồng nguyên tắc
    2

    HDTC

    		Hợp đồng tài chính 1
    3HDTCHợp đồng tài chính 2
    4HDTCHợp đồng tài chính 3

    Bảng thông báo lỗi

    Dòng lỗiGhi chú lỗi
    3Mã đơn vị tiền tệ - Mã bị trùng với mã tại dòng 2
    4Mã đơn vị tiền tệ - Mã bị trùng với mã tại dòng 2
    3.4.1.10 Màn hình pop-up "Xác nhận hủy"
    • Pop-up "Xác nhận hủy (thêm mới)" hiển thị khi người dùng nhấn nút “Hủy”/nút Đóng “X”  trên màn hình pop-up "Thêm mới loại hợp đồng"
    • Pop-up "Xác nhận hủy (chỉnh sửa)" hiển thị khi người dùng nhấn nút “Hủy”/nút Đóng “X”  trên màn hình pop-up "Chỉnh sửa loại hợp đồng"
    STT

    Field

    (Trường dữ liệu)

    Type

    (Kiểu dữ liệu)

    Required

    (Bắt buộc)

    Length

    (Độ dài ký tự)


    Validation

    (Quy định)

    Description

    (Mô tả)


    Pop-up Xác nhận hủy (thêm mới)

    1 

    		Bạn có chắc chắn muốn hủy thêm mới?

    Nhãn (Label)




    Nội dung cảnh báo xác nhận hủy thao tác thêm mới

    2 

    		Tôi chắc chắn

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

    		Không bắt buộc
    		Sau khi nhấn nút, hệ thống hủy thao tác thêm mới đơn vị tại pop-up "Thêm mới loại hợp đồng", đóng pop-up hiện tại và pop-up "Thêm mới loại hợp đồng", quay về giao diện Màn hình Danh sách Danh mục loại hợp đồng

    Cho phép người dùng hủy thao tác thêm mới loại hợp đồng và đóng pop-up

    3

    Hủy

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

    		Không bắt buộc
    		Sau khi nhấn nút, hệ thống đóng pop-up và quay về giao diện "Thêm mới loại hợp đồng" trước đó

    Cho phép người dùng đóng pop-up 

    Pop-up Xác nhận hủy (chỉnh sửa)

    1 

    		Bạn có chắc chắn muốn hủy chỉnh sửa?

    Nhãn (Label)




    Nội dung cảnh báo xác nhận hủy thao tác chỉnh sửa

    2 

    		Tôi chắc chắn

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

    		Không bắt buộc
    		Sau khi nhấn nút, hệ thống hủy thao tác chỉnh sửa đơn vị tại pop-up "Chỉnh sửa loại hợp đồng", đóng pop-up hiện tại và pop-up "Chỉnh sửa loại hợp đồng", quay về giao diện Màn hình Danh sách Danh mục loại hợp đồng

    Cho phép người dùng hủy thao tác chỉnh sửa loại hợp đồng và đóng pop-up

    3

    Hủy

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

    		Không bắt buộc
    		Sau khi nhấn nút, hệ thống đóng pop-up và quay về giao diện "Chỉnh sửa loại hợp đồng" trước đó

    Cho phép người dùng đóng pop-up 

    3.4.1.

    ...

    11. Cập nhật trường "Loại hợp đồng" tại 2442 - User Story - Nhân viên kế hoạch - tổng hợp soạn thảo hợp đồng
    x
    STT

    Field

    (Trường dữ liệu)

    Type

    (Kiểu dữ liệu)

    Required

    (Bắt buộc)

    Length

    (Độ dài ký tự)


    Validation

    (Quy định)


    Description

    (Mô tả)

    1

    Loại hợp đồng

    		Lựa chọn (Droplist)

    Bắt buộc


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

    - Hệ thống chỉ lấy các loại hợp đồng có trạng thái hoạt động = "Hoạt động"

    - Cho phép người dùng chọn loại hợp đồng sử dụng cho hợp đồng.

    - Danh sách dữ liệu được lấy từ trường "Mã loại hợp đồng"-"Tên loại hợp đồng" trong  Danh mục loại hợp đồng thuộc Phân hệ Quản lý danh mục

    ...