You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 33 Next »


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



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

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

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

3.1.1.1. Màn hình "Cài đặt thời gian làm việc" - Tab "Ca làm việc" (Trạng thái bình thường)

Vị trí: Figma S27

3.1.1.2. Màn hình "Cài đặt thời gian làm việc" - Tab "Ca làm việc" (Không có kết quả tìm kiếm)

Vị trí: Figma S27

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

Vị trí: Figma S27

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

Vị trí: Figma S27

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

3.1.4.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.4.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.5. Màn hình "Nhập file excel" :

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

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

3.1.8. Thông báo:

3.1.8.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.8.2. Thông báo - trường hợp 2: Xóa ca làm việc không hợp lệ

Vị trí: Figma S27

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

Vị trí: Figma S23

3.2 Luồng:

3.3 API Spec: 

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ộcCho 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

Hộp chọn (Checkbox)

Không bắt buộc

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

- 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.1.4. Màn hình pop-up "Xác nhận xóa" 

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ộcHệ 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- 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.
-  Dữ liệu mã ca: Tích hợp từ hệ thống HRIS.

Thể hiện mã định danh duy nhất của mỗi ca làm việc.

5Ca làm việcVăn bản (Text)Không bắt buộcCho phép sắp xếp (Sort) theo thứ tự tăng dần/giảm dần dựa trên tên ca làm việc.

- Thể hiện tên ca làm việc tương ứng với mỗi 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 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.

  • Bật = Ca làm việc được kích hoạt/hoạt động.
  • Tắt = Ca làm việc bị vô hiệu hóa/không hoạt động.
Thể hiện trạng thái hoạt động của ca làm việc.
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 các nút chức năng Chỉnh sửa và Xóa.
- Cho phép người dùng thực hiện các thao tác chỉnh sửa hoặc xoá trên từng bản ghi riêng lẻ.		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

Biểu tượng chỉnh sửa

Biểu tượng/Nút chức năng (Icon / 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

Biểu tượng xóa

Biểu tượng/Nút chức năng (Icon / 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.1.4. Màn hình pop-up "Xác nhận xóa" 

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.
- Áp dụng cơ chế tìm kiếm “contains” (chứa ký tự).
- Khi người dùng nhập từ khóa: Hệ thống tự động lọc dữ liệu ngay khi người dùng nhập.
- Khi người dùng nhấn Enter hoặc nhấn biểu tượng kính lúp: Hệ thống thực hiện tìm kiếm và cập nhật danh sách theo từ khóa đã nhập.
- Khi không tìm thấy kết quả: Hệ thống hiển thị giao diện gồm:
+) Văn bả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é!"
+) Nút “Thêm mới làm việc”: tham chiếu mục 3.4.2. Màn hình pop-up "Thêm mới ca làm việc"

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.

9Nú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 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" :

10Phâ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.
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".


3.4.2. Màn hình pop-up "Thêm mới 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.       

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

  • Bật = Ca làm việc được kích hoạt/hoạt động.
  • 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.1- Buổi sáng: Giờ bắt đầuThời gian theo giờ - phút (hh:mm)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.2- Buổi sáng: Giờ kết thúcThời gian theo giờ - phút (hh:mm)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.3- Buổi chiều: Giờ bắt đầuThời gian theo giờ - phút (hh:mm)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.4- Buổi chiều: Giờ kết thúcThời gian theo giờ - phút (hh:mm)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- Cho phép lưu thông tin thời điểm bắt đầu và kết thúc ca sáng/ca chiều. 
- Nút chỉ được kích hoạt khi tất cả các trường thời gian theo ngày (Thứ 2 → Chủ Nhật) đã được nhập hợp lệ.

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.

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.

  • Bật = Ca làm việc được kích hoạt.
  • Tắt = Ca làm việc bị vô hiệu hó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ó.

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.1- Buổi sáng: Giờ bắt đầuThời gian theo giờ - phút (hh:mm)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.2- Buổi sáng: Giờ kết thúcThời gian theo giờ - phút (hh:mm)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.3- Buổi chiều: Giờ bắt đầuThời gian theo giờ - phút (hh:mm)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.4- Buổi chiều: Giờ kết thúcThời gian theo giờ - phút (hh:mm)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- Cho phép người dùng nhấn để lưu thông tin thời điểm bắt đầu và kết thúc ca sáng/chiều sau khi người dùng nhập hoặc chỉnh sửa.
- Nút chỉ được kích hoạt khi ít nhất một trường thời gian theo ngày (Thứ 2 → Chủ Nhật) được thay đổi và hợp lệ.

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.4. Màn hình pop-up "Xác nhận xóa" :

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 "Xác nhậ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.
-  Khi nhấn nút, hệ thống cần tiến hành kiểm tra và xác định về trạng thái hoạt động 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 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: 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 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".
Thể hiện nút "Xác nhận" để xác nhận thao tác xóa.

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

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 hoạt độ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ộ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à "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
hể hiện nút chức năng (Button) cho phép người dùng người dù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ộ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 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 để 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 đúng định dạng với tệp mẫu (template). 
    • 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 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: Lỗi không chọn tệp

  • Điều kiện: Người dùng nhấn “Áp dụng” khi chưa tải lên bất kỳ tệp nào.

  • Hành vi hệ thống:

    • Hiển thị thông báo (toast) lỗi
      •  Tiêu đề thông báo: Không thành công: tham chiếu mục:  

Lỗi 2: 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: 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 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ụ: 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 4: 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.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.

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ộcCho 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ộ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 đ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ộ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 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ộ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.

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 để thực hiện quá trình xuất tệp dữ liệu ca làm việc.
- 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: 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:

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


3.4.7. 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ộ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 đề 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ộ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 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
2.2Tên lỗiVă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 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
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.
  • No labels