Nghiệp vụ

IT

Người lập

Người duyệt

Người lập

Người duyệt


Họ và tên

Bùi Nguyệt Anh


Nguyễn Đức Trung



Vũ Thị Mơ




Tài khoản email/MS team

anhbn4


trungnd3



movt2





Chức danh



Business Analyst (BA)


Product Owner

(P.O)



Business Analyst Business (BA BIZ)



Ngày soạn thảo

 




 





Jira Link



[BPMKVH-3795] Quản lý ca làm việc - Jira

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

Là admin nghiệp vụ, tôi muốn đồng nhất quản lý thông tin Ca làm việc theo mã ca của mỗi nhân viên được đồng bộ từ HRIS về để quản lý đồng nhất

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

  1. Tôi muốn Xem được danh sách Ca làm việc bao gồm các thông tin
    1. STT
    2. Mã ca làm việc ( Duy nhất)
    3. Tên ca làm việc
    4. Trạng thái
  2. Tôi muốn tìm kiếm được thông tin Ca làm việc theo Mã-tên ca làm việc
  3. Tôi muốn Tạo mới được thông tin Ca làm việc bao gồm các thông tin
    1. Mã ca làm việc ( Duy nhất)
    2. Tên ca làm việc
    3. Trạng thái
    4. Cho phép Cài đặt thời gian của ca làm việc theo file BPM1_CALAMVIEC.xlsx ( Theo ca từ T2- Chủ nhật, bỏ lại phần khai báo ca theo từng ngày trong 365 ngày)
  4. Tôi muốn Sửa được thông tin Ca làm việc bao gồm các thông tin
    1. Mã ca làm việc
    2. Tên ca làm việc
    3. Trạng thái
    4. Cho phép Cài đặt thời gian của ca làm việc theo file BPM1_CALAMVIEC.xlsx
  5. Tôi muốn hệ thống cảnh báo và chặn trong trường hợp thêm mới và sửa trùng mã ca làm việc
  6. Tôi muốn Xem chi tiết được thông tin Ca làm việc
  7. Tôi muốn xóa được ca làm việc theo một bản ghi và nhiều bản 
  8. Tôi muốn hệ thống cảnh báo và chặn trong trường Xóa một ca làm việc có mã ca đang được sử dụng tại danh mục nhân viên
  9. Tôi muốn Nhập file excel/Xuất file excel thông tin ca làm việc bao gồm cả thông tin cài đặt thời gian

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

3.1 UI/UX: 

3.1.1. Màn hình "Cài đặt thời gian làm việc" - Tab "Ca làm việc" :

Vị trí: Figma S27

3.1.2. Màn hình "Cài đặt thời gian làm việc" - Tab "Ca làm việc" - Chức năng tìm kiếm
3.1.2.1. Trường hợp 1: Có kết quả tìm kiếm 

3.1.2.2. Trường hợp 2: Không có kết quả

Vị trí: Figma S27

3.1.2.2. Trường hợp 3: Danh sách trống (không có dữ liệu ban đầu):

Vị trí: Figma S27

3.1.3. Màn hình "Thêm mới ca làm việc" :

Vị trí: Figma S27

3.1.4. Màn hình "Chỉnh sửa ca làm việc" :

Vị trí: Figma S27

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

3.1.5.1. Màn hình pop-up "Xác nhận xóa" một ca làm việc :

Vị trí: Figma S27

3.1.5.2. Màn hình pop-up "Xác nhận xóa" nhiều ca làm việc :

Vị trí: Figma S27

3.1.6. Màn hình "Nhập file excel" :

3.1.7. Màn hình "Xuất file excel" :

3.1.8. Màn hình "Lỗi nhập file excel":

3.1.9. Thông báo:

3.1.9.1. Thông báo chức năng xóa
3.1.9.1.1.1. Thông báo (toast) - trường hợp 1: Xóa ca làm việc hợp lệ

Vị trí: Figma S27

3.1.9.1.1.2. Thông báo (toast) - trường hợp 2: Xóa ca làm việc không hợp lệ

Vị trí: Figma S27

3.1.9.2. Thông báo (toast) thêm mới ca làm
3.1.9.2.1.1. Trường hợp 1: Thêm mới ca làm việc - Dữ liệu hợp lệ:

3.1.9.2.1.2. Trường hợp 2: Thêm mới ca làm việc - Dữ liệu không hợp lệ:
3.1.9.3. Thông báo (toast) nhập dữ liệu excel ca làm việc
3.1.9.3.1.1. Trường hợp 1: Nhập dữ liệu - Dữ liệu hợp lệ:

3.1.9.3.1.2. Trường hợp 3: Nhập dữ liệu - Tệp không đúng định dạng

3.1.9.4. Thông báo (toast) xuất dữ liệu excel ca làm việc
3.1.9.1.4.1. Thông báo (toast) - trường hợp 1: Xuất dữ liệu làm việc hợp lệ

3.1.10. Màn hình pop-up "Xem chi tiết ca làm việc":

3.2 Luồng:

3.3 API Spec: 

Method

GET

URL

system/shift/list

Description

API lấy danh sách ca làm việc

Note

API cũ, sửa lại

1. Headers

STT

Field

Source Data Type / Length 

Description

Sample Values

1authorization<token>Token của người dùng đăng nhậpBearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjY0NTU3ODksInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.wrvIFd-Q2kHgkTmPf6ryMY6aDIgXpNsWmSvvifQWc5k

2. Request

STT

Field

Require

Data Type / Length

Description

Note

Sample Values

1pagetrueIntegertrang

2limittrueIntegersố bản ghi cần lấy

3namefalseStringTên ca làm việc hoặc mã ca làm việc


4activefalseIntegermã hợp đồng

3. Response / Incoming Data Specification

STT

Field

Data Type / Length

Description

Note

Sample Values

1codeInteger0: thành công còn lại thất bại

2messageStringmessage

3resultList<Object>kết quả trả ra

4(result) idIntegerid

5(result) codeStringmã ca làm việc

6(result) activeIntegertrạng thái (1: đang hoạt động, 0: không hoạt động)



7(result) nameStringtên ca làm việc

8(result) workDayConfigsList<Object>ngày áp dụng

9(workDayConfigs) dayOfWeekInteger
// 1 = Chủ Nhật, 2 = Thứ Hai, ..., 7 = Thứ Bảy


11(workDayConfigs) isWorkingDayInteger
// Có phải là ngày làm việc không (True/False)


12(workDayConfigs) morningStartTimeString
// Thời gian bắt đầu làm việc buổi sáng (hh:mm:ss)


13(workDayConfigs) morningEndTimeString
// Thời gian kết thúc làm việc buổi sáng (hh:mm:ss)


14(workDayConfigs) afternoonStartTimeString
// Thời gian bắt đầu làm việc buổi chiều(hh:mm:ss)


15(workDayConfigs) afternoonEndTimeString
// Thời gian kết thúc làm việc buổi chiều(hh:mm:ss)


16(workDayConfigs) shiftIdIntegerid ca làm việc

17(workDayConfigs) fmtMorningStartTimeString// Thời gian bắt đầu làm việc buổi sáng (hh:mm)

18(workDayConfigs) fmtMorningEndTimeString// Thời gian kết thúc làm việc buổi sáng (hh:mm)

19(workDayConfigs) fmtAfternoonStartTimeString// Thời gian bắt đầu làm việc buổi chiều(hh:mm)

20(workDayConfigs) fmtAfternoonEndTimeString// Thời gian kết thúc làm việc buổi chiều(hh:mm)

Method

GET

URL

system/shift/get

Description

API lấy chi tiết ca làm việc

Note

API cũ, sửa lại

1. Headers

STT

Field

Source Data Type / Length 

Description

Sample Values

1authorization<token>Token của người dùng đăng nhậpBearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjY0NTU3ODksInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.wrvIFd-Q2kHgkTmPf6ryMY6aDIgXpNsWmSvvifQWc5k

2. Request

STT

Field

Require

Data Type / Length

Description

Note

Sample Values

1idtrueIntegerid ca làm việc

3. Response / Incoming Data Specification

STT

Field

Data Type / Length

Description

Note

Sample Values

1codeInteger0: thành công còn lại thất bại

2messageStringmessage

3resultList<Object>kết quả trả ra

4(result) idIntegerid

5(result) codeStringmã ca làm việc

6(result) activeIntegertrạng thái (1: đang hoạt động, 0: không hoạt động)



7(result) nameStringtên ca làm việc

Method

GET

URL

system/workDayConfig/list

Description

API lấy danh sách ngày áp dụng của ca làm việc

Note

API cũ

1. Headers

STT

Field

Source Data Type / Length 

Description

Sample Values

1authorization<token>Token của người dùng đăng nhậpBearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjY0NTU3ODksInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.wrvIFd-Q2kHgkTmPf6ryMY6aDIgXpNsWmSvvifQWc5k

2. Request

STT

Field

Require

Data Type / Length

Description

Note

Sample Values

1shiftIdtrueIntegerid ca làm việc

3. Response / Incoming Data Specification

STT

Field

Data Type / Length

Description

Note

Sample Values

1codeInteger0: thành công còn lại thất bại

2messageStringmessage

3resultList<Object>kết quả trả ra

4(result) idIntegerid ngày áp dụng

5(result) dayOfWeekInteger
// 1 = Chủ Nhật, 2 = Thứ Hai, ..., 7 = Thứ Bảy


6(result) isWorkingDayInteger
// Có phải là ngày làm việc không (True/False)



7(result) morningStartTimeString
// Thời gian bắt đầu làm việc buổi sáng (hh:mm:ss)


8(result) morningEndTimeString
// Thời gian kết thúc làm việc buổi sáng (hh:mm:ss)


9(result) afternoonStartTimeString
// Thời gian bắt đầu làm việc buổi chiều(hh:mm:ss)


11(result) afternoonEndTimeString
// Thời gian kết thúc làm việc buổi chiều(hh:mm:ss)


12(result) shiftIdIntegerid ca làm việc

13(result) fmtMorningStartTimeString// Thời gian bắt đầu làm việc buổi sáng (hh:mm)

14(result) fmtMorningEndTimeString// Thời gian kết thúc làm việc buổi sáng (hh:mm)

15(result) fmtAfternoonStartTimeString// Thời gian bắt đầu làm việc buổi chiều(hh:mm)

16(result) fmtAfternoonEndTimeString// Thời gian kết thúc làm việc buổi chiều(hh:mm)

Method

POST

URL

system/shift/update

Description

API thêm mới cập nhật ca làm việc

Note

API cũ sửa lại

1. Headers

STT

Field

Source Data Type / Length 

Description

Sample Values

1authorization<token>Token của người dùng đăng nhậpBearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjY0NTU3ODksInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.wrvIFd-Q2kHgkTmPf6ryMY6aDIgXpNsWmSvvifQWc5k

2. Body

STT

Field

Require

Data Type / Length

Description

Note

Sample Values

1

id

falseIntegerid ca làm việc

2

name

trueStringtên ca làm việc

3

code

trueStringmã ca làm việc

4

active

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

3. Response / Incoming Data Specification

STT

Field

Data Type / Length

Description

Note

Sample Values

1codeInteger0: thành công còn lại thất bại

2messageStringmessage

Method

POST

URL

system/shift/deleteBatch

Description

API xóa nhiều ca làm việc

Note

API mới

1. Headers

STT

Field

Source Data Type / Length 

Description

Sample Values

1authorization<token>Token của người dùng đăng nhậpBearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjY0NTU3ODksInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.wrvIFd-Q2kHgkTmPf6ryMY6aDIgXpNsWmSvvifQWc5k

2. Body

STT

Field

Require

Data Type / Length

Description

Note

Sample Values

1

ids

trueList<Integer>danh sách id ca làm việc muốn xóa

3. Response / Incoming Data Specification

STT

Field

Data Type / Length

Description

Note

Sample Values

1codeInteger0: thành công còn lại thất bại

2messageStringmessage

Method

POST

URL

system/shift/import

Description

API import ca làm việc

Note

API mới

1. Headers

STT

Field

Source Data Type / Length 

Description

Sample Values

1authorization<token>Token của người dùng đăng nhậpBearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjY0NTU3ODksInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.wrvIFd-Q2kHgkTmPf6ryMY6aDIgXpNsWmSvvifQWc5k

2. Body

STT

Field

Require

Data Type / Length

Description

Note

Sample Values

1

file

truefilefile excel import

3. Response / Incoming Data Specification

STT

Field

Data Type / Length

Description

Note

Sample Values

1codeInteger0: thành công còn lại thất bại

2messageStringmessage

3

results

List<Object>danh sách các bản ghi đọc từ file excel

4

(results) rowNumber

Integerdòng trong excel

5

(results) shiftCode

Stringmã ca làm việc

6

(results) shiftName

Stringtên ca làm việc

7

(results) dayOfWeekStr

Stringngày áp dụng

8

(results) morningStartTimeStr

String

// Thời gian bắt đầu làm việc buổi sáng (hh:mm)



9

(results) morningEndTimeStr

String

// Thời gian kết thúc làm việc buổi sáng (hh:mm)



10

(results) afternoonStartTimeStr

String

// Thời gian bắt đầu làm việc buổi chiều(hh:mm)



11

(results) afternoonEndTimeStr

String

// Thời gian kết thúc làm việc buổi chiều(hh:mm)



12

(results) importExcelStatus

Integertrạng thái (0: lỗi, 1: không lỗi)

13

(results) messageError

StringThông báo lỗi

3.4 Mô tả những trường thông tin và nút chức năng trên màn hình:

3.4.1. Màn hình "Cài đặt thời gian làm việc" - Tab "Ca làm việc" :

STT

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

Kiểu dữ liệu

Điều kiện

Quy định

Mô tả

1Tab "Ca làm việc"

Tab điều hướng

(Navigation Tab)

Không

bắt buộc

Cho phép người dùng nhấn để điều hướng đến màn hình quản lý ca làm việcThể hiện tab chức năng cho phép truy cập khu vực quản lý ca làm việc.
2Hộp chọn

Boolean(True/Failse)

Không

bắt buộc

- Cho phép người dùng tích chọn một, nhiều, hoặc tất cả bản ghi ca làm việc.

- Khi vào hộp chọn tất cả, hệ thống hiển thị biểu tượng chức năng cho phép xóa nhiều: tham chiếu mục 3.4.4.2. Màn hình pop-up "Xác nhận xóa đơn 1 ca làm việc"

Thể hiện hộp chọn dùng để đánh dấu bản ghi được chọn.

3STTSố (Number)

Không

bắt buộc

Hệ thống tự sinh số thứ tự theo vị trí hiển thị.

Thể hiện số thứ tự của mỗi bản ghi.

4Mã caVăn bản (Text)

Không

bắt buộc

Cho phép người dùng nhập dữ liệu mã ca là dữ liệu giống mã ca trong tệp dữ liệu excel lấy từ HRIS.

Thể hiện mã định danh duy nhất của mỗi ca làm việc, mã ca phải là giá trị duy nhất, không được trùng với bất kỳ mã ca nào đã tồn tại.

5Ca làm việcVăn bản (Text)

Không

bắt buộc

- Cho phép người dùng nhấn để mở ra màn hình pop-up "Xem chi tiết ca làm việc.

- Màn hình pop-up "Xem chi tiết ca làm việc: Tham chiếu mục 3.4.3. Màn hình pop-up "Xem chi tiết ca làm việc" 

- Thể hiện tên ca làm việc, giá trị được nhập bởi người dùng khi tạo mới hoặc chỉnh sửa ca làm việc.

6Hoạt động (toggle)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  hoạt động của ca làm việc; thay đổi sẽ được áp dụng trực tiếp lên bản ghi.

  • Công tắc Bật (ON): Ca làm việc được kích hoạt/hoạt động.
  • Công tắc Tắt (OFF): Tắt = Ca làm việc bị vô hiệu hóa/không hoạt động.

Thể hiện công tắc phân loại ca làm việc có hoặc không ở trạng thái hoạt động trên hệ thống.

7Cột thao tác (Row Actions)Biểu tượng/Nút chức năng (Icon / Button)

Không

bắt buộc

- Bao gồm 2 nút chức năng Chỉnh sửa và Xóa.
- Cho phép người dùng nhấn để thực hiện 2 thao tác chỉnh sửa hoặc xoá trên từng bản ghi riêng lẻ: chi tiết tham chiếu dòng STT 7.1 và STT 7.2.

Thể hiện nhóm nút chức năng gồm các thao tác chỉnh sửa và xoá.
7.1

Nút "Chỉnh sửa"

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

Không

bắt buộc

Cho phép người dùng người dùng nhấn để mở màn hình pop-up "Chỉnh sửa ca làm việc".

Thể hiện biểu tượng chức năng cho phép người dùng mở màn hình pop-up "Chỉnh sửa ca làm việc": Tham chiếu mục 3.1.3. Màn hình pop-up "Chỉnh sửa ca làm việc" 

7.2

Nút "Xóa"

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

Không

bắt buộc

- Cho phép người dùng người dùng nhấn để xóa đơn 1 ca làm việc.

- Khi nhấn biểu tượng xóa, hệ thống hiển thị pop-up "Xác nhận xóa": Tham chiếu mục 3.4.4.1. Màn hình pop-up "Xác nhận xóa đơn 1 ca làm việc" 

Thể hiện biểu tượng chức năng cho phép người dùng xóa ca làm việc.

8Ô tìm kiếm (Search input)Văn bản (Text)

Không

bắt buộc

- Cho phép người dùng nhập từ khóa liên quan đến "Mã ca làm việc" hoặc "Tên ca làm việc", hỗ trợ nhập có dấu và không dấu.

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

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

  • Trường hợp 1 - Có kết quả:
    • Điều kiện: Có ít nhất một ca làm việc trong hệ thống khớp với từ khóa người dùng nhập.
    • Hành vi: Hệ thống hiển thị danh sách ca làm việc 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ó ca làm việc khớp với từ khóa tìm kiếm hoặc danh sách ca làm việc 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ó ca làm việc  nào. Hãy thêm mới ca làm việc  đầu tiên nhé!
    • Figma cho cả 2 trường hợp: tham chiếu mục 3.1.2.2. Trường hợp 2: Không có kết quả/Danh sách trống (không có dữ liệu ban đầu)

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

11Nút "Nhập dữ liệu excel"Nút chức năng (Button)

Không

bắt buộc

Cho phép người dùng nhấn để điều hướng đến màn hình pop-up "Nhập dữ liệu 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 mở màn hình pop-up "Nhập dữ liệu excel".
12Nút "Xuất dữ liệu excel"Nút chức năng (Button)

Không

bắt buộc

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 ca làm việc"

Thể hiện nút chức năng cho phép người dùng mở màn hình pop-up "Xuất dữ liệu excel".
13Nút "Thêm mới"Nút chức năng (Button)

Không

bắt buộc

Cho phép người dùng nhấn để điều hướng đến màn hình pop-up "Thêm mới ca làm việc".Thể hiện nút chức năng cho phép mở màn hình "Tạo ca làm việc": Tham chiếu mục: 

3.4.1.2. Màn hình pop-up "Thêm mới ca làm việc" 

14Phân trangThành phần điều hướng (Pagination)

Không

bắt buộc

- Hiển thị theo tổng số bản ghi.

- Cho phép người dùng lựa chọn số lượng bản ghi hiển thị trên mỗi trang thông qua danh sách thả xuống, với các tùy chọn: 10, 30, 50, 100 bản ghi/trang.

- Tự động tải lại danh sách theo số lượng bản ghi được chọn.

Thể hiện thành phần phân trang.

3.4.2. Màn hình pop-up "Thêm mới đơn một ca làm việc" :

STT

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ên ca làm việc*

Văn bản (Text)

Bắt buộc- Cho phép người dùng nhập tên ca làm việc. 
- Không được để trống.                       		Thể hiện trường thông tin cho phép người dùng nhập tên ca làm việc với gợi ý mặc định (placeholder)  “Nhập tên ca làm việc”.
2Mã ca làm việc*

Văn bản (Text)

Bắt buộc

- Cho phép người dùng nhập mã ca làm việc.

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

Thể hiện trường thông tin cho phép người dùng nhập tên mã làm việc với gợi ý mặc định (placeholder)  “Nhập mã làm việc”.

3Trạng thái hoạt độngCông tắc (Toggle)

Không

bắt buộc

- Cho phép bật/tắt trạng thái hoạt động của ca làm việc; thay đổi sẽ được áp dụng trực tiếp lên bản ghi.

  • Công tắc Bật (ON): Ca làm việc được kích hoạt/hoạt động.
  • Công tắc Tắt (OFF): Tắt = Ca làm việc bị vô hiệu hóa/không hoạt động.

- Giá trị mặc định khi tạo mới ca làm việc: Bật = Ca làm việc được kích hoạt.

Thể hiện công tắc cho phép điều chỉnh trạng thái hoạt động của ca làm việc.

4Khối ngày làm việc theo ngày (Thứ 2 → Chủ nhật)Nhóm trường thời gian (Time Input)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 ngày làm việc (Thứ 2 → Chủ nhật) để hướng dẫn người dùng về vị trí nhập thông tin gồm:

  • Thời điểm bắt đầu và kết thúc ca làm việc buổi sáng của ngày.
  • Thời điểm bắt đầu và kết thúc ca làm việc buổi chiều của ngày.
4.1Buổi sáng: Giờ bắt đầu

Thời gian

(Date time)

Bắt buộc

- Cho phép người dùng thực hiện điền thông tin về thời điểm bắt đầu của ca làm việc buổi sáng trong ngày theo giờ-phút.

- Chỉ cho phép nhập số, không cho phép ký tự khác.

Thể hiện trường cho phép người dùng nhập giờ bắt đầu của ca buổi sáng.

4.2Buổi sáng: Giờ kết thúc

Thời gian

(Date time)

Bắt buộc

- Cho phép người dùng thực hiện điền thông tin về thời điểm kết thúc của ca làm việc buổi sáng trong ngày theo giờ-phút.

- Chỉ cho phép nhập số, không cho phép ký tự khác.

Thể hiện trường cho phép người dùng nhập giờ kết thúc của ca buổi sáng.
4.3Buổi chiều: Giờ bắt đầu

Thời gian

(Date time)

Bắt buộc

- Cho phép người dùng thực hiện điền thông tin về thời điểm bắt đầu của ca làm việc buổi chiều trong ngày theo giờ-phút.

- Chỉ cho phép nhập số, không cho phép ký tự khác.

Thể hiện trường cho phép người dùng nhập giờ bắt đầu của ca buổi chiều.

4.4Buổi chiều: Giờ kết thúc

Thời gian

(Date time)

Bắt buộc

- Cho phép người dùng thực hiện điền thông tin về thời điểm kết thúc của ca làm việc buổi chiều trong ngày theo giờ-phút.

- Chỉ cho phép nhập số, không cho phép ký tự khác.

Thể hiện trường cho phép người dùng nhập giờ kết thúc của ca buổi chiều.
5Nú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ỏ 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)

Không

bắt buộc

- Nút chỉ được kích hoạt khi người dùng đã hoàn thành nhập thông tin trường bắt buộc và tất cả các trường thời gian theo ngày (Thứ 2 → Chủ Nhật) hợp lệ.

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

  • Trường hợp 1: Dữ liệu hợp lệ:
    • Điều kiện:
      • Trường bắt buộc và tất cả các trường thời gian theo ngày (Thứ 2 → Thứ 6) đã được nhập đầy đủ và hợp lệ.

      • Bản ghi có Mã ca + Ngày áp dụng không trùng với dữ liệu đã tồn tại trong hệ thống.

    • Hành vi hệ thống:
      • Hành vi 1: Những ca làm việc được thêm mới sẽ được 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: Cài đặt ca làm việc thành công
  • Trường hợp 2: Dữ liệu không hợp lệ:
    • Điều kiện:
      • Tất cả các trường thời gian theo ngày (Thứ 2 → Thứ 6) đã không được nhập đầy đủ và hợp lệ.

      • Bản ghi có Mã ca + Ngày áp dụng trùng với dữ liệu đã tồn tại trong hệ thống.

    • Hành vi hệ thống: Hệ thống hiển thị thông báo lỗi
      • Hiển thị thông báo lỗi. 
        • Tiêu đề thông báo: Không thành công
        • Nội dung thông báo: Mã ca và ngày áp dụng đã tồn tại

Thể hiện nút chức năng áp dụng thêm mới ca làm việc

7Nú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.

3.4.3. Màn hình pop-up "Chỉnh sửa ca làm việc" :

STT

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ên ca làm việc*

Văn bản (Text)

Bắt buộc- Cho phép người dùng nhập/chỉnh sửa tên ca làm việc. 
- Không được để trống.                       		Thể hiện trường thông tin với dữ liệu tên ca làm việc hiện có.
2Mã ca làm việc*

Văn bản (Text)

Bắt buộc

- Cho phép người dùng nhập/chỉnh sửa mã ca làm việc.

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

- Hệ thống sẽ kiểm tra trùng mã:

  • Nếu mã nhập trùng: hiển thị thông báo lỗi “Mã ca đã tồn tại. Vui lòng nhập mã khác” và không cho phép lưu dữ liệu.
  • Nếu mã chưa tồn tại: cho phép lưu thông tin ca làm việc mới.

Thể hiện trường thông tin với dữ liệu tên mã làm việc hiện có.

3Trạng thái hoạt độngCông tắc (Toggle)Không bắt buộc

- Cho phép người dùng thực hiện chỉnh sửa trạng thái bật/tắt hoạt động của ca làm việc; thay đổi sẽ được áp dụng trực tiếp lên bản ghi.

  • Công tắc Bật (ON): Ca làm việc được kích hoạt/hoạt động.
  • Công tắc Tắt (OFF): Tắt = Ca làm việc bị vô hiệu hóa/không hoạt động.

Thể hiện công tắc với dữ liệu trạng thái hoạt động của ca làm việc hiện có.

4Khối ngày làm việc theo ngày (Thứ 2 → Chủ nhật)Nhóm trường thời gian (Time Input)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 ngày làm việc (Thứ 2 → Chủ nhật) để hướng dẫn người dùng về vị trí nhập thông tin gồm:

  • Thời điểm bắt đầu và kết thúc ca làm việc buổi sáng của ngày.
  • Thời điểm bắt đầu và kết thúc ca làm việc buổi chiều của ngày.
4.1Buổi sáng: Giờ bắt đầu

Thời gian

(Date time)

Bắt buộc

- Cho phép người dùng thực hiện nhập/chỉnh sửa thông tin về thời điểm bắt đầu của ca làm việc buổi sáng trong ngày theo giờ-phút.

- Chỉ cho phép nhập số, không cho phép ký tự khác.

Thể hiện trường thông tin với dữ liệu giờ bắt đầu của ca buổi sáng hiện có.

4.2Buổi sáng: Giờ kết thúc

Thời gian

(Date time)

Bắt buộc

- Cho phép người dùng thực hiện nhập/chỉnh sửa thông tin về thời điểm kết thúc của ca làm việc buổi sáng trong ngày theo giờ-phút.

- Chỉ cho phép nhập số, không cho phép ký tự khác.

Thể hiện trường thông tin với dữ liệu giờ kết thúc của ca buổi sáng hiện có.
4.3Buổi chiều: Giờ bắt đầu

Thời gian

(Date time)

Bắt buộc

- Cho phép người dùng thực hiện nhập/chỉnh sửa thông tin về thời điểm bắt đầu của ca làm việc buổi chiều trong ngày theo giờ-phút.

- Chỉ cho phép nhập số, không cho phép ký tự khác.

Thể hiện trường thông tin với dữ liệu giờ bắt đầu của ca buổi chiều hiện có.

4.4Buổi chiều: Giờ kết thúc

Thời gian

(Date time)

Bắt buộc

- Cho phép người dùng thực hiện nhập/chỉnh sửa thông tin về thời điểm kết thúc của ca làm việc buổi chiều trong ngày theo giờ-phút.

- Chỉ cho phép nhập số, không cho phép ký tự khác.

Thể hiện trường thông tin với dữ liệu giờ bắt đầu của ca buổi chiều hiện có.
5Nú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ỏ 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)Không bắt buộc

- Nút chỉ được kích hoạt khi người dùng đã hoàn thành nhập thông tin trường bắt buộc và tất cả các trường thời gian theo ngày (Thứ 2 → Chủ Nhật) cần chỉnh sửa một cách hợp lệ.

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

  • Trường hợp 1: Dữ liệu hợp lệ:
    • Điều kiện:
      • Trường bắt buộc và tất cả các trường thời gian theo ngày (Thứ 2 → Thứ 6) đã được nhập thông tin chỉnh sửa đầy đủ và hợp lệ.

      • Bản ghi có Mã ca + Ngày áp dụng + Thời gian bắt đầu/kết thúc của buổi sáng/buổi chiều sau khi chỉnh sửa không trùng với bản ghi đã tồn tại trong hệ thống.

    • Hành vi hệ thống:
      • Hành vi 1: Hệ thống cập nhật thông tin ca làm việc và giữ nguyên trạng thái hiện tại của ca.
      • 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: Cài đặt ca làm việc thành công
  • Trường hợp 2: Dữ liệu không hợp lệ:
    • Điều kiện:
      • Một hoặc nhiều trường thời gian theo ngày (Thứ 2 → Chủ Nhật) bị bỏ trống, nhập sai định dạng hoặc không hợp lệ.

      • Bản ghi có Mã ca + Ngày áp dụng sau khi chỉnh sửa trùng với bản ghi khác trong hệ thống.

    • Hành vi hệ thống: 
      • Không lưu chỉnh sửa.
      • Hiển thị thông báo lỗi. 
        • Tiêu đề thông báo: Không thành công
        • Nội dung thông báo: Mã ca và ngày áp dụng đã tồn tại

Thể hiện nút chức năng cho phép lưu thông tin thời điểm bắt đầu và kết thúc ca làm việc mỗi buổi sáng/chiều trong ngày sau khi người dùng nhập/chỉnh sửa thông tin.

7Nú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.

3.4.3. Màn hình pop-up "Xem chi tiết ca làm việc" :

STT

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ên ca làm việc*

Văn bản (Text)

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 trường thông tin với dữ liệu tên ca làm việc hiện có.
2Mã ca làm việc*

Văn bản (Text)

Bắt buộc

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

Thể hiện trường thông tin với dữ liệu tên mã làm việc hiện có.

3Trạng thái hoạt độngCông tắc (Toggle)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ông tắc với dữ liệu trạng thái hoạt động của ca làm việc hiện có, gồm:

  • Công tắc Bật (ON): Ca làm việc được kích hoạt/hoạt động.
  • Công tắc Tắt (OFF): Tắt = Ca làm việc bị vô hiệu hóa/không hoạt động.
4Khối ngày làm việc theo ngày (Thứ 2 → Chủ nhật)Nhóm trường thời gian (Time Input)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 ngày làm việc (Thứ 2 → Chủ nhật) để hướng dẫn người dùng về vị trí nhập thông tin gồm:

  • Thời điểm bắt đầu và kết thúc ca làm việc buổi sáng của ngày.
  • Thời điểm bắt đầu và kết thúc ca làm việc buổi chiều của ngày.
4.1Buổi sáng: Giờ bắt đầu

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 trường thông tin với dữ liệu giờ bắt đầu của ca buổi sáng hiện có.

4.2Buổi sáng: Giờ kết thú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).

Thể hiện trường thông tin với dữ liệu giờ kết thúc của ca buổi sáng hiện có.
4.3Buổi chiều: Giờ bắt đầu

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 trường thông tin với dữ liệu giờ bắt đầu của ca buổi chiều hiện có.

4.4Buổi chiều: Giờ kết thú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).

Thể hiện trường thông tin với dữ liệu giờ bắt đầu của ca buổi chiều hiện có.
5Nút "Đóng"Nút chức năng (Button)Không bắt buộcCho phép người dùng nhấn để đóng màn hình pop-up "Xem chi tiết ca làm việc"

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

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

3.4.4.1. Màn hình pop-up "Xác nhận xóa đơn 1 ca làm việc"

STT

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ộ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 tiêu đề pop-up "Xác nhận xóa" 
2Nút "Hủy"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 "Hủy" để hủy bỏ thao tác xóa.
3Nút "Tôi chắc chắn"Nút chức năng (Button)Bắt buộc

- Cho phép người dùng nhấn để xác nhận thao tác xóa đơn 1 ca làm việc.
-  Khi nhấn nút, hệ thống cần tiến hành kiểm tra ràng buộc của ca làm việc.

  • Trường hợp 1: Xóa ca làm việc hợp lệ
    • Điều kiện: Ca làm việc không đang được sử dụng tại màn hình mục "Danh mục nhân viên" thuộc phân hệ "Quản lý người dùng"
    • Hành vi hệ thống: Hệ thống xóa đơn 1 ca làm việc khỏi cơ sở dữ liệu, đồng thời đóng Pop-up và hiển thị 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: Xóa ca làm việc thành công
  • Trường hợp 2: Xóa ca làm việc không hợp lệ 
    • Điều kiện: Ca làm việc được sử dụng tại mục "Danh mục nhân viên" thuộc phân hệ "Quản lý người dùng"
    • Hành vi hệ thống: Hệ thống không xóa đơn 1 ca làm việc khỏi cơ sở dữ liệu, đồng thời đóng pop-up và hiển thị màn hình pop-up "Cảnh báo": tham chiếu mục: 3.4.5. Màn hình pop-up " Cảnh báo" chặn khi xóa ca làm việc đang được sử dụng tại màn hình mục "Danh mục nhân viên" thuộc phân hệ "Quản lý người dùng" 
Thể hiện nút cho phép xác nhận thao tác xóa đơn 1 ca làm việc.
3.4.4.2. Màn hình pop-up "Xác nhận xóa nhiều ca làm việc"

STT

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ộ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 tiêu đề pop-up "Xác nhận xóa" 
2Nút "Hủy"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 "Hủy" để hủy bỏ thao tác xóa.
3Nút "Tôi chắc chắn"Nút chức năng (Button)Bắt buộc

- Cho phép người dùng nhấn để xác nhận thao tác xóa đồng thời nhiều ca làm việc.
-  Khi nhấn nút, hệ thống cần tiến hành kiểm tra và xác định về ràng buộc của những ca làm việc mong muốn được xóa đồng thời.

  • Trường hợp 1: Xóa nhiều ca làm việc hợp lệ
    • Điều kiện: Những ca làm việc mong muốn được xóa đồng thời không đang được sử dụng tại màn hình mục "Danh mục nhân viên" thuộc phân hệ "Quản lý người dùng"
    • Hành vi hệ thống: Hệ thống xóa 1 hay nhiều bản ghi ca làm việc khỏi cơ sở dữ liệu, đồng thời đóng Pop-up và hiển thị 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: Xóa ca làm việc thành công
  • Trường hợp 2: Xóa ca làm việc không hợp lệ 
    • Điều kiện: Những ca làm việc mong muốn được xóa đồng thời đang được sử dụng tại mục "Danh mục nhân viên" thuộc phân hệ "Quản lý người dùng"
    • Hành vi hệ thống: Hệ thống không xóa bản ghi ca làm việc khỏi cơ sở dữ liệu, đồng thời đóng pop-up và hiển thị màn hình pop-up "Cảnh báo": tham chiếu mục: 3.4.5. Màn hình pop-up " Cảnh báo" chặn khi xóa ca làm việc đang được sử dụng tại màn hình mục "Danh mục nhân viên" thuộc phân hệ "Quản lý người dùng" 
Thể hiện nút cho phép xác nhận thao tác xóa đồng thời nhiều ca làm việc.

3.4.5. Màn hình pop-up " Cảnh báo" chặn khi xóa ca làm việc đang được sử dụng tại màn hình mục "Danh mục nhân viên" thuộc phân hệ "Quản lý người dùng"

STT

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ộ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 tiêu đề pop-up "Cảnh báo" 
2Văn bản cảnh báoNút chức năng (Button)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 văn bản cảnh báo

- Nội dung văn bản cảnh báo: "Không thể xóa ca làm việc đang sử dụng. Vui lòng kiểm tra lại !"

3Nút "Thoát" 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, bản ghi ca làm việc không bị xóa và hệ thống điều hướng về màn hình "Màn hình "Cài đặt thời gian làm việc" - Tab Ca làm việc".		Thể hiện nút "Thoát" để hủy bỏ thao tác xóa.

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

STT

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)

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.
1.1Tải xuốngNú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 : 
  • Hành vi 2: Hiển thị 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.
2Tài liệu đính kèmVă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 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.
2.1Nú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 để 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 hiển thị 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. 

3Nú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 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.

4Nú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 khi đã tải lên tệp dữ liệu và  xác nhận tệp dữ liệu ca làm việc sau khi tải lên như sau:

  • Trường hợp 1: Tệp dữ liệu hợp lệ:
    • Điều kiện:
      • 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 “Mẫu nhập file excel” phải đứng trước, sheet “Hướng dẫn nhập liệu” đứng sau
    • Hành vi hệ thống:
      • Hành vi 1: Những ca làm việc được thêm mới đồng thời sẽ được 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 tải lên tệp dữ liệu và 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: 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: Tệp không đúng định dạng

  •  Đ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:
    • Hệ thống hiển thị thông báo lỗi:
    • Tiêu đề: Không thành công
    • Nội dung: Định dạng file không hợp lệ

Lỗi 2: Lỗi dữ liệu trong không hợp lệ

  • Đ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ụ: Mã ca, thời gian bắt đầu/kết thúc).

    • Sai kiểu dữ liệu (nhập text thay vì giờ/số).

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

    • Thời gian bắt đầu lớn hơn thời gian kết thúc.

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

    • Giá trị không thuộc danh mục cho phép.

  • 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 "mã ca + ngày áp dụ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ã ca + Ngày áp dụng trùng với dữ liệu đã tồn tại trong hệ thống.

    • Bản ghi trùng lặp Mã ca + Ngày áp dụng ngay trong chính tệp được tải lên.

  • 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.8. 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.

5Nú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.7. Màn hình pop-up "Xuất file excel" :

STT

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 (Text)

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ên trường là "Chọn kiểu xuất file" để  hướng dẫn người dùng về cách thức xuất tệp dữ liệu excel danh sách ca.

1.1Tùy chọn "Tất cả ca làm việc"Nút chọn (Radio 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 ca làm việc trên hệ thống.Thể hiện tên tùy chọn là "Tất cả ca làm việc" 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 ca làm việc trên hệ thống.
1.2Tùy chọn "Trên trang này"Nút chọn (Radio 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 ca làm việc là bản ghi ca làm việc đang hiển thị 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 ca làm việc đang hiển thị trên trang hiện tại.
1.3Tùy chọn "Tất cả kết quả tìm kiếm hiện tại"Nút chọn (Radio 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 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 ca làm việc đã được lọc (filter) hoặc tìm kiếm (search).
2Nú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ỏ 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.

3Nút "Áp dụng"Nút chức năng (Button)Bắt buộc

- Cho phép người dùng nhấn khi đã tải xuống tệp dữ liệu ca làm việc

Trường hợp 1: Xuất dữ liệu thành công

  • Điều kiện: Kết nối mạng ổn định
  • Hành vi hệ thống:
    • 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ành vi 2: Hệ thống mở pop-up của trình duyệt để người dùng chọn vị trí lưu tệp.

    • Hành vi 3: 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 4: Hiển thị 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:

Trường hợp 2: Xuất dữ liệu không thành công do lỗi mạng

  • Điều kiện: Kết nối mạng không ổn định hoặc mất kết nối mạng
  • Hành vi hệ thống: Hệ thống không tiến hành tải xuống tệp dữ liệu ca làm việc
Thể hiện nút chức năng cho phép xuất tệp dữ liệu excel ca làm việc.
4Nú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.

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

STT

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

Kiểu dữ liệu

Điều kiện

Quy định

Mô tả

1Thông báo tóm tắt lỗiVă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
2Bả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
2.1Dòng lỗiVă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).

- Tiêu đề cột: Dòng lỗi

- Nội dung cột: Số thứ tự dòng/hàng bị lỗi trong file Excel gốc.

2.2Ghi chú lỗiVă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).

- Danh sách lỗi được hiển thị như sau:

  • 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 trùng mã ca làm viêc và ngày áp dụng: "Mã ca làm việc và Ngày áp dụng bị trùng với mã tại dòng (X), (Y),...". 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 sai kiểu dữ liệu: "Giá trị trường <Tên trường> sai kiểu dữ liệu"

- Tiêu đề cột: Tên lỗi 

- Nội dung cột: Thể hiện nội dung lỗi gặp phải tại dòng tương ứng ở mục 2.1.

3Nú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:






- 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.
5Nú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.6. 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.
6Nút "X"Nút chức năng (Button)

Không

bắt buộc

- Cho phép người dùng nhấn để hủy bỏ 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.