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 | |||
| [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)
- Tôi muốn Xem được danh sách Ca làm việc bao gồm các thông tin
- STT
- Mã ca làm việc ( Duy nhất)
- Tên ca làm việc
- Trạng thái
- 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
- 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
- Mã ca làm việc ( Duy nhất)
- Tên ca làm việc
- Trạng thái
- 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)
- Tôi muốn Sửa được thông tin Ca làm việc bao gồm các thông tin
- Mã ca làm việc
- Tên ca làm việc
- Trạng thái
- Cho phép Cài đặt thời gian của ca làm việc theo file BPM1_CALAMVIEC.xlsx
- 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
- Tôi muốn Xem chi tiết được thông tin Ca làm việc
- Tôi muốn xóa được ca làm việc theo một bản ghi và nhiều bản
- 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
- 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.
...
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ả
...
Tab điều hướng
(Navigation Tab)
...
Hộp chọn (Checkbox)
...
- 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.4.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.
...
Thể hiện số thứ tự của mỗi bản ghi.
...
Thể hiện mã định danh duy nhất của mỗi 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.
...
- 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.
...
Biểu tượng chỉnh sửa
...
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"
...
Biểu tượng xóa
...
- 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.
...
- 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ành vi hệ thống khi thực hiện tìm kiếm:
- Hành vi 1: Hệ thống cập nhật màn hình "Cài đặt ca làm việc - Tab ca làm việc" khi người dùng nhập từ khóa.
- Hành vi 2: Hệ thống thực hiện tìm kiếm và cập nhật danh sách khi người dùng nhấn Enter hoặc biểu tượng kính lúp
- Hành vi hệ thống 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ả:
- Điều kiện: Người dùng nhập từ khóa nhưng không có bản ghi nào thỏa mãn.
- Hành vi: Hệ thống hiển thị 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é!" kèm nút “Thêm mới ca làm việc”.
- 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"
- Figma: tham chiếu mục 3.1.2.2. Trường hợp 2: Không có kết quả tìm kiếm
- Trường hợp 3 – Danh sách trống (không có dữ liệu ban đầu):
- Điều kiện: Hệ thống chưa có bất kỳ ca làm việc nào và không có thao tác tìm kiếm.
- Hành vi: Hệ thống hiển thị:
"Ở đâ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é!"
Kèm theo nút “Thêm mới ca làm việc”- 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"
- Figma: tham chiếu mục 3.1.2.3. Trường hợp 3: Không có kết quả tìm kiếm
...
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.
...
3.4.1.2. Màn hình pop-up "Thêm mới ca làm việ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.
...
- 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"
...
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ả
...
Văn bản (Text)
...
Văn bản (Text)
...
- 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”.
...
- 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.
...
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.
...
- 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.
...
- 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.
...
- 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.
...
- 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 nút chức năng cho phép hủy bỏ thao tác mà không lưu dữ liệu.
...
- Cho phép lưu thông tin thêm mới 1 ca làm việc.
- 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:
- Tất cả các trường thời gian theo ngày (Thứ 2 → Chủ Nhật) đã đượ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: Nhập dữ liệu thành công
- Điều kiện:
- 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 → Chủ Nhật) đã 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 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
- Điều kiện:
...
Thể hiện nút chức năng thêm mới ca làm việc
...
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ả
...
Văn bản (Text)
...
Văn bản (Text)
...
- 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ó.
...
- 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ó.
...
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.
...
- 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ó.
...
- 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.
...
- 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ó.
...
- 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 nút chức năng cho phép hủy bỏ thao tác mà không lưu dữ liệu.
...
- Cho phép người dùng nhấn để chỉnh sửa thông tin ca làm việc.
- 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:
- Tất cả các trường thời gian theo ngày (Thứ 2 → Chủ Nhật) đã được nhập đầy đủ và hợp lệ.
Bản ghi có Mã ca + Ngày áp dụng 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ập nhật ca làm việc thành công
- Điều kiện:
- 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: Dữ liệu không hợp lệ
- Điều kiện:
...
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.
...
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ả
...
Tiêu đề pop-up
...
- 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 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: 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" 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"
...
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ả
...
Tiêu đề pop-up
...
- 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 !"
...
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ả
...
- Cho phép người dùng nhấn để thực hiện quá trình xuất tệp dữ liệu mẫu (template) ca làm việc.
- Khi nhấn nút, hành vi hệ thống như sau:
- Hành vi 1: Cho phép người dùng chọn vị trí lưu trữ tệp và tải xuống tệp
Hệ thống mở pop-up của trình duyệt để người dùng chọn vị trí lưu tệp.
Sau khi chọn xong, hệ thống tiến hành xuất và tải file Excel chứa tệp dữ liệu excel đã chọn về máy tính cá nhân.
- Thông tin tệp dữ liệu dùng để nhập dữ liệu excel :
- Tên tệp dữ liệu: BPM1-Mẫu nhập file excel
- Mẫu tệp dữ liệu (Template khi nhập file excel): BPM1-Mẫu nhập file excel.xlsx
- 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
...
- 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.
...
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.
...
- 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 đú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: 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 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 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.
...
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ả
...
Văn bản (Text)
...
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.
...
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:
| Panel | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
1. Headers
2. Request
3. Response / Incoming Data Specification
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Panel | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
1. Headers
2. Request
3. Response / Incoming Data Specification
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Panel | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
1. Headers
2. Request
3. Response / Incoming Data Specification
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Panel | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
1. Headers
2. Body
3. Response / Incoming Data Specification
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Panel | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
1. Headers
2. Body
3. Response / Incoming Data Specification
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Panel | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
1. Headers
2. Body
3. Response / Incoming Data Specification
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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ả |
|---|---|---|---|---|---|
| 1 | Tab "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ệc | Thể hiện tab chức năng cho phép truy cập khu vực quản lý ca làm việc. |
| 2 | Hộ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. |
| 3 | STT | Số (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. |
| 4 | Mã ca | Vă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. |
| 5 | Ca làm việc | Vă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. |
| 6 | Hoạ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.
| 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. |
| 7 | Cộ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. | 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ả:
| 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. |
| 11 | Nú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". |
| 12 | Nú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". |
| 13 | Nú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" |
| 14 | Phân trang | Thà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ả |
|---|---|---|---|---|---|
| 1 | Tê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”. |
| 2 | Mã 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”. |
| 3 | Trạng thái hoạt động | 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.
- 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. |
| 4 | Khố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:
|
| 4.1 | Buổ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.2 | Buổ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.3 | Buổ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.4 | Buổ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. |
| 5 | Nút "Hủy" | Nút chức năng (Button) | Không bắt buộc | - Cho phép người dùng nhấn để 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. |
| 6 | Nú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:
| Thể hiện nút chức năng áp dụng thêm mới ca làm việc |
| 7 | Nút "X" | Nút chức năng (Button) | Không bắt buộc | - Cho phép người dùng nhấn để hủy bỏ các thay đổi và đóng giao diện hiện tại mà không lưu thông tin. | Thể hiện nút chức năng cho phép hủy bỏ thao tác mà không lưu dữ liệu. |
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ả |
|---|---|---|---|---|---|
| 1 | Tê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ó. |
| 2 | Mã 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ã:
| Thể hiện trường thông tin với dữ liệu tên mã làm việc hiện có. |
| 3 | Trạng thái hoạt động | Cô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.
| 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ó. |
| 4 | Khố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:
|
| 4.1 | Buổ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.2 | Buổ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.3 | Buổ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.4 | Buổ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ó. |
| 5 | Nút "Hủy" | Nút chức năng (Button) | Không bắt buộc | - Cho phép người dùng nhấn để 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. |
| 6 | Nú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:
| 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. |
| 7 | Nút "X" | Nút chức năng (Button) | Không bắt buộc | - Cho phép người dùng nhấn để hủy bỏ các thay đổi và đóng giao diện hiện tại mà không lưu thông tin. | Thể hiện nút chức năng cho phép hủy bỏ thao tác mà không lưu dữ liệu. |
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ả |
|---|---|---|---|---|---|
| 1 | Tên 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 ca làm việc hiện có. |
| 2 | Mã 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ó. |
| 3 | Trạng thái hoạt động | Cô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:
|
| 4 | Khố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:
|
| 4.1 | Buổ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.2 | Buổ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.3 | Buổ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.4 | Buổ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ó. |
| 5 | Nút "Đóng" | Nút chức năng (Button) | Không bắt buộc | Cho 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. |
| 6 | Nút "X" | Nút chức năng (Button) | Không bắt buộc | - Cho phép người dùng nhấn để hủy bỏ các thay đổi và đóng giao diện hiện tại mà không lưu thông tin. | Thể hiện nút chức năng cho phép hủy bỏ thao tác mà không lưu dữ liệu. |
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ộc | Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa). | Thể hiện tiêu đề pop-up "Xác nhận xóa" |
| 2 | Nú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. |
| 3 | Nú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.
| 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ộc | Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa). | Thể hiện tiêu đề pop-up "Xác nhận xóa" |
| 2 | Nú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. |
| 3 | Nú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.
| 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ộc | Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa). | Thể hiện tiêu đề pop-up "Cảnh báo" |
| 2 | Văn bản cảnh báo | Nút chức năng (Button) | Bắt buộc | Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa). | - Thể hiện văn bản cảnh báo - Nội dung văn bản cảnh báo: "Không thể xóa ca làm việc đang sử dụng. Vui lòng kiểm tra lại !" |
| 3 | Nút "Thoát" | Nút chức năng (Button) | Bắt buộc | - Cho phép người dùng nhấn để 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ả |
|---|---|---|---|---|---|
| 1 | Tài liệu mẫu | Văn bản (Text) | Không bắt buộc | Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa). | Thể hiện tên trường là "Tài liệu mẫu" để hướng dẫn người dùng về file mẫu cần thiết cho việc nhập dữ liệu. |
| 1.1 | Tải xuống | Nút chức năng (Button) | Không bắt buộc | - Cho phép người dùng nhấn để thực hiện quá trình xuất tệp dữ liệu mẫu (template) ca làm việc.
| 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. |
| 2 | Tài liệu đính kèm | Văn bản (Text) | Không bắt buộc | Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa). | Thể hiện tên 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.1 | Nút "Nhấn hoặc tả để tải lên" | Nút chức năng (Button) | Không bắt buộc | - Cho phép người dùng nhấn để 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. | 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. |
| 3 | Nút "Hủy" | Nút chức năng (Button) | Không bắt buộc | - Cho phép người dùng nhấn để hủy bỏ thao tác 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. |
| 4 | Nút "Áp dụng" | Nút chức năng (Button) | Không bắt buộc | - Cho phép người dùng nhấn 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:
Lỗi 1: Tệp không đúng định dạng
Lỗi 2: Lỗi dữ liệu trong không hợp lệ
Lỗi 3: Lỗi trùng "mã ca + ngày áp dụng"
| 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. |
| 5 | Nú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 | 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:
- 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. | 4 | Nút "X" | Nút chức năng (Button) | Không
|---|---|---|---|---|---|
Kiểu dữ liệu | Điều kiện | Quy định | Mô tả | ||
| 1 | Chọn kiểu xuất file | Văn bản (Text) | Bắt buộc | Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa). | Thể hiện tên 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.1 | Tù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.2 | Tù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 để 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" :
Tiêu chí nghiệm thu
Màn hình và chức năng
- STT
- Mã ca làm việc (Duy nhất)
- Tên ca làm việc
- Trạng thái
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ả tìm kiếm
3.1.2.3. Trường hợp 3: Danh sách trống (không có dữ liệu ban đầu):
- Tên ca làm việc
- Trạng thái
- 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)
- Mã ca làm việc
- Tên ca làm việc
- Trạng thái
- Cho phép Cài đặt thời gian của ca làm việc theo fileBPM1_CALAMVIEC.xlsx
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 | Thông báo tóm tắt lỗi | Văn bản (Text) | Không bắt buộc | Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa). | Thể hiện tổng quan về kết quả của quá trình nhập file Excel như sau:
| |
| 2 | Bảng "Danh mục lỗi gặp phải" | Văn bản (Text) | Không bắt buộc | Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa). | Thể hiện tiêu đề bảng: Danh mục các lỗi gặp phải | |
| 2.1 | Dòng lỗi | Văn bản (Text) | Không bắt buộc | Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa). | - 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.2 | Tên lỗi | Văn bản (Text) | Không bắt buộc | - Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa). - Danh sách lỗi được hiển thị như sau:
|
| 3 | Nút "Tải xuống" | Nút chức năng (Button) | Không bắt buộc | 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.3 | Tù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). | |
| 2 | Nút "Hủy" | Nút chức năng (Button) | Không bắt buộc | Cho phép người dùng nhấn để hủy bỏ 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 | Nú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
| lỗi khi nhập file excel-
Trường hợp 2: Xuất dữ liệu không thành công do lỗi mạng
| 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. |
| 4 | Nút "X" | Nút chức năng (Button) | Không bắt buộc | Cho phép người dùng nhấn để hủy bỏ các thay đổi và đóng giao diện hiện tại mà không lưu thông tin. | Thể hiện nút chức năng cho phép hủy bỏ thao tác mà không lưu dữ liệu. | |
| 5 | Nút "Nhập lại" | Nút chức năng (Button) | Không bắt buộc | - Cho phép người dùng nhấn nút. - Khi nhấn nút, hệ thống đóng pop-up "Lỗi nhập file excel" và điều hướng người dùng quay lại màn hình pop-up "Nhập file excel": tham chiếu mục: 3.4.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. | |
| 6 | Nút "X" | Nút chức năng (Button) | Không bắt buộc | - Cho phép người dùng nhấn để hủy bỏ các thay đổi và đóng giao diện hiện tại mà không lưu thông tin. | Thể hiện nút chức năng cho phép hủy bỏ thao tác mà không lưu dữ liệu. |
4. Tổng hợp màn hình và chức năng tương ứng theo tiêu chí nghiệm thu
| 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ả |
|---|---|---|---|---|---|
| 1 | Thông báo tóm tắt lỗi | Văn bản (Text) | Không bắt buộc | Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa). | Thể hiện tổng quan về kết quả của quá trình nhập file Excel như sau:
|
| 2 | Bảng "Danh mục lỗi gặp phải" | Văn bản (Text) | Không bắt buộc | Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa). | Thể hiện tiêu đề bảng: Danh mục các lỗi gặp phải |
| 2.1 | Dòng lỗi | Văn bản (Text) | Không bắt buộc | Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa). | - 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.2 | Ghi chú lỗi | Văn bản (Text) | Không bắt buộc | - Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa). - Danh sách lỗi được hiển thị như sau:
| - 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. |
| 3 | Nút "Tải xuống" | Nút chức năng (Button) | Không bắt buộc | - Cho phép người dùng nhấn để thực hiện quá trình tải xuống tệp dữ liệu excel bảng "Danh mục các lỗi gặp phải". - Thông tin tệp dữ liệu được xuất ra:
| |
| - 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. | ||||
| 5 | Nút "Nhập lại" | Nút chức năng (Button) | Không bắt buộc | - Cho phép người dùng nhấn nút. - Khi nhấn nút, hệ thống đóng pop-up "Lỗi nhập file excel" và điều hướng người dùng quay lại màn hình pop-up "Nhập file excel": tham chiếu mục: 3.4.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. |
| 6 | Nút "X" | Nút chức năng (Button) | Không bắt buộc | - Cho phép người dùng nhấn để hủy bỏ các thay đổi và đóng giao diện hiện tại mà không lưu thông tin. | Thể hiện nút chức năng cho phép hủy bỏ thao tác mà không lưu dữ liệu. |
























