Nghiệp vụ | IT | |||
|---|---|---|---|---|
Người lập | Người duyệt | Người lập | Người duyệt | |
Tên, Chức danh | Vũ Thị Mơ | |||
Ngày ký | ||||
Jira Link | [BPMKVH-4024] US Xếp hạng đánh giá NCC v2 (chỉnh sửa xếp hạng) - Jira | |||
1. Card (Mô tả tính năng)
Là admin nghiệp vụ, tôi muốn xếp hạng và đề xuất tương ứng với điểm số được đánh giá cho các nhà cung cấp nhà thầu
2. Confirmation/ Acceptance Criteria (Tiêu chí nghiệm thu)
- Tôi muốn sửa được Xếp hạng đánh giá tương ứng theo thang điểm bao gồm các thông tin (Note: Chỉ cho phép sửa khi trạng thái là Hoạt động/Không hoạt động, không cho phép sửa với trạng thái Đóng- Tránh trường hợp mở lại một phiên bản đã đóng)
- Mã xếp hạng đánh giá ( Không sửa mã xếp hạng)
- Tên xếp hạng đánh giá
- Mã thang điểm- Tên thang điểm ( Không sửa)
- Phiên bản: Tự động tăng phiên bản ( Trường hợp chỉ sửa Tên xếp hạng hoặc trạng thái hoặc sửa tất cả thông tin khi phiên bản đang ở trạng thái không hoạt động thì không tăng phiên bản)
- Ngày áp dụng: Cho phép nhập ngày quá khứ
- Loại đánh giá: disable,Load theo mã thang điểm
- Lĩnh vực: disable, Load theo mã thang điểm
- Thông tin xếp hạng
- Giá trị điểm tối thiểu: Dấu, Số
- Giá trị điểm tối đa: Dấu, Số
- Xếp hạng
- Đề xuất
- Trạng thái (Hoạt động/Không hoạt động)
- Tôi muốn hệ thống cảnh báo và chặn trong trường hợp các khoảng điểm trong cùng mã xếp hạng giao nhau
- Tôi muốn khi tăng phiên bản cho một mã xếp hạng thành công (Trạng thái là hoạt động), phiên bản cũ tự động cập nhật trạng thái Đóng và không cho phép sửa
- Tôi muốn cập nhật thông tin xếp hạng và đề xuất, phiên bản áp dụng khi cập nhật thông tin đánh giá lên lịch sử đánh giá theo mã xếp hạng của thang điểm tương ứng đang hoạt động
- Tôi muốn khi sửa xếp hạng, khi hoàn thành hệ thống hiển thị pop-up Cảnh báo các lần đánh giá có ngày hoàn thành đánh giá >= ngày áp dụng của xếp hạng sẽ được cập nhật thông tin xếp hạng (Nếu có) , bao gồm các thông tin
- Mã đánh giá
- Ngày hoàn thành
- Tên nhà cung cấp
- Số hợp đồng
- Điểm đánh giá
- Xếp hạng cũ
- Đề xuất cũ
- Xếp hạng cập nhật
- Đề xuất cập nhật
- Khi người dùng Đồng ý, Hệ thống cập nhật thông tin xếp hạng và đề xuất, phiên bản xếp hạng lên lịch sử đánh giá và tại lịch sử đánh giá link được đến thông tin chi tiết của phiên bản của xếp hạng đang áp dụng
3. Conversation (Mô tả chi tiết)
3.1 UIUX:
3.2 Luồng:
- Activity Diagram:
- Sequence Diagram:
- Flowchart:
3.3 API Spec: <gắn link tài liệu mô tả API vào đây>
Method | URL |
|---|
1. Headers
STT | Field | Source Data Type / Length | Description | Sample Values |
|---|---|---|---|---|
2. Body
STT | Path | Field | Data Type / Length | Description | Note | Sample Values |
|---|---|---|---|---|---|---|
3. Response / Incoming Data Specification
| STT | Field | Data Type / Length | Description | Note | Sample Values |
|---|---|---|---|---|---|
3.4 Mô tả các trường dữ liệu trên màn hình:
3.4.3.Màn hình Pop up chỉnh sửa Xếp hạng, đề xuất nhà cung cấp
Trường thông tin/Nút chức năng | Kiểu dữ liệu | Điều kiện | Quy định | Mô tả | |
|---|---|---|---|---|---|
| 1 | Mã xếp hạng đánh giá | 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). | Mã định danh duy nhất của xếp loại đánh giá |
| 2 | Tên xếp hạng đánh giá | Văn bản (Text) | Bắt buộc | Cho phép chỉnh sửa | Thể hiện thông tin tên xếp loại đánh giá |
| 3 | Thang điểm | Lựa chọn (Droplist) | Bắt buộc | Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa). | Thể hiện mã định danh duy nhất của thang điểm tương ứng với xếp loại đánh giá |
| 4 | Loại đánh giá | Lựa chọn (Droplist) | Bắt buộc | Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa). | Thể hiện thông tin loại đánh giá áp dụng cho thang điểm |
| 5 | Lĩnh vực | Lựa chọn (Droplist) | Bắt buộc | Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa). | Thể hiện thông tin lĩnh vực kinh doanh của NCC mà thang điểm đang áp dụng với loại đánh giá tương ứng |
| 6 | Phiên bản | Số (Number) | Bắt buộc | Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa). Hệ thống tự động cập nhật tăng phiên bản khi chỉnh sửa bảng thông tin xếp hạng thành công VD: trước chỉnh sửa bảng thông tin phiên bản là V1, sau khi chỉnh sửa bảng thông tin lưu thành công → phiên bản tự động cập nhập thành V2 | Thể hiện số phiên bản của mã xếp hạng đánh giá. |
| 7 | Ngày tạo | Thời gian (Date) | Bắt buộc | Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa). | Thế hiện số phiên bản của mã xếp hạng đánh giá. |
| 8 | Ngày áp dụng | Thời gian (Date) | Bắt buộc | Cho phép chỉnh sửa ngày áp dụng | Thể hiện thông tin ngày bắt đầu áp dụng bảng xếp hạng |
| 9 | Bảng thông tin xếp hạng đánh giá | Bắt buộc | Cho phép chỉnh sửa thông tin bảng xếp hạng. Chi tiết màn hình bảng thông tin xếp hạng đánh giá 3.4.3.1 | Thể hiển thông tin các khoảng điểm đánh giá xếp hạng nhà cung cấp | |
| 10 | Trạng thái | Lựa chọn (Droplist) | Không bắt buộc | Cho phép chỉnh sửa trạng thái:
Trường hợp chỉnh sửa bảng thông tin xếp hạng đánh giá (bảng 3.4.3.1)thành công. Hệ thống tự động cấp nhật trạng thái "Đóng" với phiên bản cũ của mã xếp hạng vừa điều chỉnh. Khi trạng thái đóng người dùng không thể thao tác chính sửa VD: trước chỉnh sửa bảng thông tin trạng thái mã đánh giá là "đang hoạt động" → sau khi chỉnh sửa thành công chuyển thành trạng thái "đóng" | Thể hiện trạng thái của xếp loại đánh giá |
| 11 | Nút áp dụng | Nút chức năng (Button) | Không bắt buộc | - Cho phép nhấn để lưu thông tin chỉnh sửa mới bảng xếp hạng - Khi nhấn hệ thống tiến hành xác nhận dữ liệu xếp hạng đánh giá nhà cung cấp khi chỉnh sửa như sau: Trường hợp 1: Chỉnh sửa dữ liệu hợp lệ:
Trường hợp 2: Chỉnh sửa dữ liệu không hợp lệ
VD: Dòng 1 tạo mã xếp hạng có khoảng điểm từ 5<x<10 đề xuất B dòng 2 có khoảng điểm từ 7<x<12 đề xuất đánh giá A, -> hệ thống không cho lưu hiển thị cảnh báo có đoạn điểm trùng giao nhau là từ 7>10
Trường hợp 3: Khi chỉnh sửa 1 trường trong bảng thông tin xếp hạng,đề xuất (bảng 3.4.3.1) và lưu thành công Khi chỉnh sửa 1 trường trong bảng thông tin xếp hạng, đề xuất(chi tiết bảng 3.4.3.1)→ ấn nút áp dụng thành công → hệ thống tự động sinh ra phiên bản mới theo số thứ tự tăng tiến dần, đồng thời cập nhật trạng thái "Đóng" với phiên cũ vừa bị chỉnh sửa. Khi trạng thái đóng người dùng không thể thao tác chỉnh sửa | Lưu thông tin bảng xếp hạng đánh giá NCC. Check các thông tin áp dụng theo quy định |
| 12 | Nút đóng "X" | Nút chức năng (Button) | Không bắt buộc | Khi nhấn → đóng popup, quay lại màn hình trước. | Thể hiện nút chức năng cho phép đóng pop-up |
| 13 | Nút hủy | Nút chức năng (Button) | Không bắt buộc | Đóng pop-up vào không lưu thông tin |
3.4.3.1 Màn hình chỉnh sửa bảng thông tin xếp hạng, đề xuất nhà cung cấp
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 | Giá trị điểm số tối thiểu (phần chọn công thức) | Lựa chọn (Droplist) | Bắt buộc | Cho phép chỉnh sửa chọn công thức cho phần điểm số tối thiểu | Thể hiện công thức để xác định điều kiện so sánh cho giá trị điểm số tối thiểu. |
| 2 | Giá trị điểm số tối thiểu | Số (Number) | Bắt buộc | Cho phép chỉnh sửa số điểm tối thiểu | Thể hiện giá trị nhỏ nhất hoặc bằng của điểm bắt đầu cho khoảng xếp hạng tương ứng với thang điểm |
| 3 | Giá trị điểm số tối đa (phần chọn công thức) | Lựa chọn (Droplist) | Bắt buộc | Cho phép chỉnh sửa chọn công thức cho phần điểm số tối đa | Thể hiện công thức để xác định điều kiện so sánh cho giá trị điểm số tối đa |
| 4 | Giá trị điểm số tối đa | Số (Number) | Bắt buộc | Cho phép chỉnh sửa số điểm tối đa | Thể hiện giá trị lớn nhất hoặc bằng của điểm kết thúc cho khoảng xếp hạng tương ứng với thang điểm |
| 5 | Xếp hạng | Văn bản (Text) | Bắt buộc | Cho phép chỉnh sửa xếp hạng của nhà cung cấp | Thể hiện tên mức xếp hạng tương ứng với khoảng điểm đánh giá |
| 6 | Đề xuất | Văn bản (Text) | Bắt buộc | Cho phép chỉnh sửa đề xuất tương ứng với từng xếp hạng | Thể hiện đề xuất tương ứng với số điểm xếp loại đạt được |
3.4.3.4. Màn hình cảnh báo khi "ngày hoàn thành >= ngày áp dụng
Trường thông tin/Nút chức năng | Kiểu dữ liệu | Điều kiện | Quy định | Mô tả | |
|---|---|---|---|---|---|
| 1 | Xác nhận chỉnh sửa xếp hạng đánh giá | Nhãn (Label) | Nội dung cảnh báo chỉnh sửa xếp hạng đánh giá "Các lần đánh giá sau sẽ được cập nhật lại thông tin xếp hạng. Bạn có muốn cập nhật lại?" | ||
| 2 | STT | Số (Number) | Bắt buộc | Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa). | Thể hiện thứ tự các trường thông tin trong màn hình cảnh báo |
| 3 | Mã đánh giá | Văn bản (Text) | Bắt buộc | Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa). | Thể hiện mã định danh duy nhất của xếp loại đánh giá |
| 4 | Ngày hoàn thành | Thời gian (Date) | Bắt buộc | Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa). | Thể hiện ngày bắt hoàn thành yêu cầu đánh giá lấy dữ liệu từ trường "Ngày |
| 5 | Tên nhà cung cấp | Văn bản (Text) | Bắt buộc | Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa). | Thể hiện tên nhà cung cấp dữ liệu được lấy dữ liệu từ trường "tên nhà cung cấp" của us 2489_User Story - Lịch sử đánh giá nhà cung cấp |
| 6 | Số hợp đồng | Văn bản (Text) | Không bắt buộc | Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa). | Thể hiện số hợp đồng dữ liệu được lấy từ trường "Số hợp đồng" của us 2489_User Story - Lịch sử đánh giá nhà cung cấp |
| 7 | Điểm đánh giá | Số thập phân | 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 điểm đánh giá dữ liệu được lấy từ trường "Điểm đánh giá" của us 2489_User Story - Lịch sử đánh giá nhà cung cấp |
| 8 | Xếp hạng 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 thông tin xếp hạng phiên bản cũ thông tin được lấy từ trường "Xếp hạng" của màn hình chi tiết us 3804 - User Story - Xếp hạng, đề xuất nhà cung cấp nhà thầu |
| 9 | Đề xuất 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 thông tin đề xuất phiên bản cũ thông tin được lấy từ trường "Đề xuất" của màn hình chi tiết us 3804 - User Story - Xếp hạng, đề xuất nhà cung cấp nhà thầu |
| 10 | Xếp hạng cập nhật | 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 thông tin xếp hạng mới thông tin được lấy từ trường "Xếp hạng" màn hình chỉnh sửa Xếp hạng, đề xuất nhà cung cấp |
| 11 | Đề xuất cập nhật | 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 thông tin đề xuất phiên bản cũ thông tin được lấy từ trường " đề xuất" màn hình chỉnh sửa Xếp hạng, đề xuất nhà cung cấp |
| 12 | Nú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 để tắt màn hình pop-up. - Khi nhấn, màn hình pop-up, đóng lại lưu dữ liệu chỉn sửa thành công, và hệ thống điều hướng về màn hình về màn hình "Chỉnh sửa xếp hạng đánh giá" | Lưu thông tin bảng xếp hạng đánh giá NCC. |
| 13 | Nút "Hủy" | Nút chức năng (Button) | Bắt buộc | Đóng pop-up vào không lưu thông tin | |
| 14 | Nút "X" | Nút chức năng (Button) | Bắt buộc | Khi nhấn → đóng popup, quay lại màn hình trước. | Thể hiện nút chức năng cho phép đóng pop-up |