Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


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

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

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

Là admin nghiệp vụ, tôi muốn quản lý được danh mục hàng hóa dịch vụ mà các nhà cung cấp, nhà thầu cung cấp

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

  1. Tôi muốn xem được danh mục HHDV của nhà cung cấp, nhà thầu cung cấp từ danh mục Nhà cung cấp, nhà thầu
  2. Tôi muốn thêm mới/Sửa/Xóa được danh mục HHDV mà các nhà thầu cung cấp bằng chức năng thêm mới hoặc import file theo cấu trúc bao gồm các thông tin:
    • Mã HHDV
    • Tên HHDV
    • Loại HHDV
    • Đơn vị tính
    • Báo giá gần nhất
    • Trạng thái: Cung cấp/Ngừng cung cấp
  3. Tôi muốn hệ thống trả lại thông tin lỗi từng dòng trong file import hoặc cảnh báo trong trường hợp thêm mới trùng mã HHDV đã tồn tạiTôi muốn hệ thống tự động cập nhật HHDV bổ sung từ các hợp đồng mà các đơn vị cung cấp và cập nhật tự động các thông tin giá bán của các HHDV theo thông tin từ các hợp đồng của nhà cung cấp bao gồm:
  4. Giá mua gần nhất
  5. Giá mua trung bình 6 tháng
  6. Giá mua nhỏ nhất
  7. Giá mua lớn nhất
  8. Mã hợp đồng cung cấp gần nhất
  9. Trạng thái: Cung cấp
  10. Tôi muốn tìm kiếm được HHDV nhà thầu cung cấp theo thông tin:
    • Mã HHDV
    • Tên HHDV
    • Trạng thái
  11. Tôi muốn thông tin HHDV được sắp xếp theo Trạng thái  (Cung cấp lên trên, Ngừng cung cấp xuống dưới), theo thời gian (HHDV mới cập nhật lên trên)
  12. Tôi muốn link được thông tin sang Danh mục Tab hợp đồng từ Mã hợp đồng cung cấp gần nhất
  13. Tôi muốn link được thông tin sang Danh mục HHDV từ Mã HHDV

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

3.1 UIUX:

3.1.1. Màn hình danh sách nhà cung cấp

Image Added

3.1.2. Màn hình Thông tin giao dịch NCC- Tab Danh mục hàng hóa

Image Added

3.1.3. Màn hình Thêm mới hàng hóa dịch vụ

Image Added

3.1.4. Màn hình Chỉnh sửa hàng hóa dịch vụ

Image Added

3.1.5. Màn hình xem chi tiết hàng hóa dịch vụ

Image Added

3.2 Luồng:

  • Activity Diagram:
  • Sequence Diagram:

...

3.2.1. Tìm kiếm HHDV của NCC

Image Added

3.2.2. Thêm mới HHDV của NCC

Image Added

3.2.3. Chỉnh sửa hàng hóa trong danh mục HHDV của NCC

Image Added

3.2.4. Xem chi tiết hàng hóa

Image Added

3.2.5. Thêm mới/Cập nhật HHDV tự động

Image Added

3.2.6. Xuất file excel

Image Added

3.2.7. Nhập file excel

Image Added


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

Panel
titleAPI Spec Document

Method


URL


1. Headers

STT

Field

Source Data Type / Length 

Description

Sample Values






2. Body

STT

Path

Field

Data Type / Length

Description

Note

Sample Values















3. Response / Incoming Data Specification

STT

Field

Data Type / Length

Description

Note

Sample Values



















...

3.4.1. Danh sách hàng hóa dịch vụ của Nhà cung cấp

Tại màn hình chi tiết Danh sách nhà cung cấp, hiển thị thêm tab thông tin Danh mục chọn button Image AddedGọi pop-up Thông tin giao dịch nhà cung cấp, chọn Tab Hàng hóa dịch vụ của nhà cung cấp bao gồm: 

STT

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

Kiểu dữ liệu

Điều kiện

Quy định

Mô tả

1Nhà cung cấp: XLabel

Trong đó X là Tên nhà cung cấp đang được chọn
2Tìm kiếm theo Tên hàng hóa/MãSearchbox

Tìm kiếm hàng hóa theo tên

2

và mã HHDV

  • Không phân biệt hoa thường
  • Không phân biệt có dấu
  • Không kiểm tra dấu cách
3LọcButton
EnableGọi Pop-up lọc thông tin
34Nhập file excelButton
EnableGọi Pop-up Nhập file excel
45Xuất file excelButton
EnableGọi Pop-up Xuất file excel
56Thêm mớiButton
EnableGọi Pop-up Thêm mới Hàng hóa dịch vụ của nhà cung cấp
67STTGrid- Number

Số thứ tự tự tăng
78Mã HHDVHyperlink

Hiển thị thông tin mã HHDV

Link thông tin đến Danh sách hàng hóa dịch vụ phát triển tại mục 5. Quản lý hàng hóa, Ngân hàng giá, User Story - Đồng bộ danh mục công việc và danh mục vật tư thành danh mục Hàng hóa/dịch vụ

89Tên HHDVHyperlink

Hiển thị thông tin Tên HHDV

Link thông tin đến màn hình Xem chi tiết hàng hóa dịch vụ của NCC

9Loại HHDVGrid-TextHiển thị thông tin loại hàng hóa dịch vụ

10Đơn vị tínhGrid-Text

Hiển thị thông tin đơn vị tính
11Báo giá gần nhấtGrid-TextHiển thị thông tin báo giá gần nhất của hàng hóa12Giá mua gần nhấtGrid-TextHiển thị thông tin giá mua gần nhất13Giá mua trung bình 6 thángGrid-TextHiển thị thông tin giá mua trung bình 6 tháng14Giá mua nhỏ nhấtGrid-TextHiển thị thông tin giá mua nhỏ nhất15Giá mua lớn nhấtGrid-TextHiển thị thông tin giá mua lớn nhất16Mã hợp đồng cung cấp gần nhấtHyperlink

Hiển thị thông tin mã hợp đồng cung cấp gần nhất 

Link thông tin sang Danh mục hợp Tab Hợp đồng lọc theo mã hợp đồng đang chọn. Danh mục hợp đồng tại mục 3. Quản lý hợp đồng 2502 - User Story - Menu quản lý Cập nhật thông tin hợp đồng

17

vào thông tin nhà cung cấp

12Trạng tháiGrid-Text

Hiển thị thông tin trạng thái của hàng hóa dịch vụ Cung cấp/Ngừng cung cấp
1813SửaButton
EnableGọi Pop-up Sửa thông tin hàng hóa của NCC
1914XóaButton
EnableGọi Pop-up Xác nhận xóa

Sắp xếp: Thông tin HHDV được sắp xếp theo Trạng thái  (Cung cấp lên trên, Ngừng cung cấp xuống dưới), theo thời gian (HHDV mới cập nhật lên trên)

3.4.2. Thêm mới Hàng hóa dịch vụ của NCCvụ 

Gọi Pop-up Thêm mới hàng hóa dịch vụ của NCC vụ  khi chọn Button Thêm mới hàng hóa dịch vụ. Thông tin bao gồm:

Loại 89

STT

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

Kiểu dữ liệu

Điều kiện

Quy định

Mô tả

1Thêm mới hàng hóa dịch vụ của nhà cung cấpLabel

Tên Pop-up
2
3Mã hàng hóa dịch vụCombobox
hàng hóa dịch vụCombobox

Cho phép chọn Loại HHDV từ Danh mục loại HHDV tại US

User Story - Đồng bộ danh mục công việc và danh mục vật tư thành danh mục Hàng hóa/dịch vụ


Enable

Hiển thị thông tin HHDV theo Loại HHDV đã chọn

Khi tìm kiếm hiển thị mã HHDV-Tên HHDV

Trường hợp chưa chọn Loại HHDV, khi chủ động chọn mã HHDV load thông tin Loại HHDV, Tên HHDV, Đơn vị tính theo Mã HHDV đã chọn

43Tên hàng hóa dịch vụTextbox
Disable

Load thông tin Tên HHDV theo mã HHDV

54Đơn vị tínhTextbox
DisableLoad thông tin Đơn vị tính theo Mã HHDV
6Báo giá gần nhấtTextbox7Trạng thái
5Trạng tháiCombobox
EnableCho phép chuyển trạng thái Cung cấp/Ngừng cung cấp của HHDV
6HủyButton

EnableThoát khỏi Popup thêm mới
7Áp dụngButton
Enable

Lưu thông tin thêm mới

Không thành công

  • Mã HHDV thêm mới trùng với mã HHDV đã thuộc danh mục, Thông báo toast: " Thất bại- Trùng thông tin Mã hàng hóa dịch vụ!"

Thành công:

  • Lưu thông tin HHDV thêm mới và thông báo toast: " Thành công- Thêm mới hàng hóa dịch vụ vào danh mục thành công!"

3.4.3. Thêm mới HHDV tự động theo hợp đồng

3.4.4. Cập nhật thông tin giá mua HHDV của nhà cung cấp

3Trường hợp khi phát hành hợp đồng thành công, kiểm tra thông tin mã HHDV tại hợp đồng, trường hợp không trùng mã HHDV tại Danh mục HHDV của NCC, thêm mới thông tin HHDV vào danh mục bao gồm:

STT

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

Kiểu dữ liệu

Điều kiện

Quy định

Mô tả

1Mã nhà cung cấp


Lấy theo mã nhà cung cấp tại hợp đồng làm điều kiện kiểm tra thêm mới
2Mã hàng hóa dịch vụ


Lấy Mã HHDV thuộc hợp đồng của nhà cung cấp chưa thuộc Danh mục HHDV NCC làm điều kiện kiểm tra và thêm mới
3Tên hàng hóa dịch vụ


Lấy theo Mã HHDV
4Đơn vị tính


Lấy theo Mã HHDV
5Trạng thái


Mặc định Cung Cấp

3.4.3. Sửa thông tin Hàng hóa dịch vụ của NCC

Khi người dùng chọn Button Sửa trên giao diện, gọi pop-up Sửa thông tin hàng hóa dịch vụ  bao gồm

STT

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

Kiểu dữ liệu

Điều kiện

Quy định

Mô tả

1Sửa hàng hóa dịch vụLabel

Tên Pop-up
2Tên nhà cung cấpLabel

Hiển thị tên nhà cung cấp

3Mã hàng hóa dịch vụCombobox
Disable

Hiển thị mã hàng hóa dịch vụ

4Tên hàng hóa dịch vụTextbox
Disable

Hiển thị tên hàng hóa dịch vụ

5Đơn vị tínhTextbox
DisableHiển thị đơn vị tính hàng hóa dịch vụ
6Trạng tháiCombobox
EnableCho phép chuyển trạng thái Cung cấp/Ngừng cung cấp của HHDV
7HủyButton
EnableThoát khỏi Popup thêm mới
8Áp dụngButton
Enable

Lưu thông tin thêm mới

  • Lưu thông tin HHDV chỉnh sửa và thông báo toast: " Thành công- Thêm mới hàng hóa dịch vụ vào danh mục thành công!"

3.4.4. Xem chi tiết Hàng hóa dịch vụ của NCC

Khi người dùng chọn Tên hành hóa dịch vụ trên giao diện, gọi Pop-up Xem chi tiết HHDV bao gồm: 

STT

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

Kiểu dữ liệu

Điều kiện

Quy định

Mô tả

1Xem chi tiết hàng hóa dịch vụLabel

Tên Pop-up
2Tên nhà cung cấpLabel

Hiển thị tên nhà cung cấp

3Mã hàng hóa dịch vụCombobox
DisableLấy Mã HHDV thuộc hợp đồng của nhà cung cấp chưa thuộc Danh mục HHDV NCC
4Tên hàng hóa dịch vụTextbox
DisableLấy theo Mã HHDV
5Đơn vị tínhTextbox
DisableLấy theo Mã HHDV
6Trạng tháiCombobox
DisableMặc định Cung Cấp
7HủyButton
EnableThoát

3.4.5. Lọc

Gọi pop-up lọc khi chọn button lọc trên danh sách

STT

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

Kiểu dữ liệu

Điều kiện

Quy định

Mô tả

1Bộ lọcLabel

Tên pop-up
2Trạng thái hàng hóaCombobox

Lọc theo trạng thái 
3Đặt lạiButton

Clear dữ liệu của Pop-up lọc
4Áp dụngButton

Áp dụng điều kiện lọc

3.4.6. Nhập file excel

Gọi pop-up nhập file excel tại danh mục

Image Added

 file excel mẫu tải xuống bao gồm :

Sau import dữ liệu, , Trạng thái mặc định là Cung cấp

Điều kiện kiểm tra của file import:

STT

Dữ liệu

Điều kiện

Quy định

Mô tả

Tên lỗi
1Cấu trúc file

Bắt buộc

Import file theo đúng cấu trúc file mẫu


Sai cấu trúc file
2Mã HHDV


Mã HHDV- Không tồn tại trong Danh mục HHDV

Mã HHDV- Đã thuộc Danh mục HHDV của nhà cung cấp

3Báo giá gần nhấtKhông bắt buộcSố nguyên dương
Báo giá gần nhất- Số tiền sai định dạng

Pop-up trả lại lỗi khi import file dữ liệu

Image Added

STT

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

Kiểu dữ liệu

Điều kiện

Quy định

Mô tả

1Lỗi nhập file excelLabel

Tên popup
2

Không thành công

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

Label

Thông tin thông báo
3Danh mục các lỗi gặp phảiLabel


4Tải xuốngButton

  1. Cho phép tải xuống file lỗi gặp phải, thông tin file lỗi bao gồm:
  • Danh sách lỗi
  • Thời gian xuất:
  • Người xuất
  • Cột: Dòng lỗi: Dòng trong file import lỗi, Tên lỗi: Thông tin tên lỗiImage Added

2. Thông tin Tên lỗi được trả về từng dòng, hiển thị Tên cột- Tên lỗi, các lỗi cách nhau bằng dấu phẩy

5Dòng lỗiGrid-text

Trả về số thứ tự của dòng lỗi
6Tên lỗiGrid-text

Thông tin tên lỗi tương ứng với từng dòng
7HủyButton

Thoát khỏi popup lỗi
8Nhập lạiButton

Gọi pop-up Nhập file excel


3.4.7. Xuất file excel

Popup xuất excel được hiển thị khi chọn Xuất file excel trên Danh mục hàng hóa

STT

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

Kiểu dữ liệu

Điều kiện

Quy định

Mô tả

1Xuất file excelLabel

Tên popup
2Chọn kiểu xuất fileLabel


3Tất cả Radio button

Mặc định chọn tất cả chức năng

Cho phép xuất tất cả các chức năng trên danh sách

4Trên trang nàyRadio button

Cho phép xuất các chức năng trên trang hiển thị hiện tại
5Tất cả kết quả tìm kiếm hiện tạiRadio button

Cho phép xuất tất cả các chức năng phù hợp với tất cả tìm kiếm hiện tại

Thông tin fie excel: Danh sách HHDV của NCC.xlsx

STT

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

Kiểu dữ liệu

Điều kiện

Quy định

Mô tả

1Mã số thuế


Mã số thuế tương ứng với mã nhà cung cấp
2Tên nhà cung cấp


Tên nhà cung cấp
3STT


Số tự tăng
4Ngày xuất


Ngày xuất dữ liệu
5Người xuất


Tên hiển thị của người xuất dữ liệu
6Mã hàng hóa dịch vụ


Lấy thông tin Mã hàng hóa dịch vụ trên danh sách
7Tên hàng hóa dịch vụ


Lấy thông tin Tên hàng hóa dịch vụ trên danh sách
8Đơn vị tính


Lấy thông tin Đơn vị tính trên danh sách
9Trạng thái


Lấy thông tin Trạng thái trên danh sách

3.4.8. Xác nhận xóa

STT

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

Kiểu dữ liệu

Điều kiện

Quy định

Mô tả

Pop-up xác nhận xóa
1Bạn có chắc chắn muốn Xóa Hàng hóa đã chọn?Label

Nội dung cảnh báo

2HủyButton

Chức năng cho phép người dùng thoát khỏi Pop-up xác nhận xóa

3Tôi chắc chắnButton

Chức năng cho phép người dùng xóa hàng hóa đã chọn. Hệ thống hiển thị toast: "Thành công- Xóa hàng hóa thành công!"


...