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ínhBá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ại
  4. Tô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:
    • Giá mua gần nhất
    • Giá mua trung bình 6 tháng
    • Giá mua nhỏ nhất
    • Giá mua lớn nhất
    • Mã hợp đồng cung cấp gần nhất
    • Trạng thái: Cung cấp
    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
  5. 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)
  6. 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
  7. 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



















...

Tại Danh sách nhà cung cấp, chọn button Gọi pop-up Danh mục hàng 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ả

1Tên nhà Nhà cung cấp: XLabel

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

Tìm kiếm hàng hóa theo tên 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
4Nhập file excelButton
EnableGọi Pop-up Nhập file excel
5Xuất file excelButton
EnableGọi Pop-up Xuất file excel
6Thêm mớiButton
EnableGọi Pop-up Thêm mới Hàng hóa dịch vụ của nhà cung cấp
7STTGrid- Number

Số thứ tự tự tăng
8Mã 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ụ

9Tê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

10Loại HHDVGrid-TextHiển thị thông tin loại hàng hóa dịch vụ11Đơn vị tínhGrid-Text

Hiển thị thông tin đơn vị tính12Báo giá gần nhấtGrid-TextHiển thị thông tin báo giá gần nhất của hàng hóa13Giá mua gần nhấtGrid-TextHiển thị thông tin giá mua gần nhất14Giá mua trung bình 6 thángGrid-TextHiển thị thông tin giá mua trung bình 6 tháng15Giá mua nhỏ nhấtGrid-TextHiển thị thông tin giá mua nhỏ nhất16Giá mua lớn nhấtGrid-TextHiển thị thông tin giá mua lớn nhất
1711Mã 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

18

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
1913SửaButton
EnableGọi Pop-up Sửa thông tin hàng hóa của NCC
14XóaButton
EnableGọi Pop-up Xác nhận xóa

...

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:

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ụ

Trạng thái9

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 HHDV của nhà cung cấphà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

3Loại hàng hóa dịch vụComboboxEnable4
Mã hàng hóa dịch vụCombobox
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

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

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

64Đơn vị tínhTextbox
DisableLoad thông tin Đơn vị tính theo Mã HHDV
7Báo giá gần nhấtTextboxEnableNhập thông tin báo giá gần nhất của nhà cung cấp với mã HHDV8
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
107Á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!"

...

34

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
2Loại hàng hóa dịch vụLấy theo thông tin Mã HHDV 
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
54Đơn vị tính


Lấy theo Mã HHDV6Báo giá gần nhấtLấy theo Giá hàng hóa tại hợp đồng7Giá mua gần nhấtLấy theo Giá hàng hóa tại hợp đồng8Giá mua trung bình 6 thángLấy theo Giá hàng hóa tại hợp đồng9Giá mua nhỏ nhấtLấy theo Giá hàng hóa tại hợp đồng10Giá mua lớn nhấtLấy theo Giá hàng hóa tại hợp đồng
11Mã hợp đồng cung cấp gần nhấtLấy thông tin Mã hợp đồng dịch vụ12Trạng tháiMặc định Cung Cấp

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

Trườ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 trùng mã HHDV tại Danh mục HHDV của NCC, Update 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ấpLấy theo mã nhà cung cấp tại hợp đồng2Mã hàng hóa dịch vụLấy Mã HHDV thuộc hợp đồng của nhà cung cấp đã thuộc Danh mục HHDV NCC
3Giá mua gần nhấtLấy theo Giá hàng hóa tại hợp đồng4Giá mua trung bình 6 thángTính trung bình giá mua của hàng hóa trong các hợp đồng phát hành thành công NCC 6 tháng gần nhất 5Giá mua nhỏ nhấtLấy theo Giá mua hàng MIN của hàng hóa trong các hợp đồng phát hành thành công của NCC6Giá mua lớn nhấtLấy theo Giá mua hàng MAX của hàng hóa trong các hợp đồng phát hành thành công của NCC7Mã hợp đồng cung cấp gần nhấtLấy thông tin Mã hợp đồng dịch vụ vừa phát hành8Trạng thái


Mặc định Cung Cấp

...

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ụ của nhà cung cấp vụ  bao gồm

4

STT

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

Kiểu dữ liệu

Điều kiện

Quy định

Mô tả

1Sửa HHDV của nhà cung cấphàng hóa dịch vụLabel

Tên Pop-up3Loại hàng hóa dịch vụComboboxDisable

Hiển thị Loại hàng hóa dịch vụ

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ụ

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

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

65Đơn vị tínhTextbox
DisableHiển thị đơn vị tính hàng hóa dịch vụ
7Báo giá gần nhấtTextboxEnableNhập thông tin báo giá gần nhất của nhà cung cấp với mã HHDV8Trạng thái6Trạng tháiCombobox
EnableCho phép chuyển trạng thái Cung cấp/Ngừng cung cấp của HHDV9
7HủyButton
EnableThoát khỏi Popup thêm mới
108Á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!"

...

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 HHDV của Nhà cung cấphà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

3Loại hàng hóa dịch vụComboboxDisableLấy theo thông tin Mã HHDV 4Mã 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
54Tên hàng hóa dịch vụTextbox
DisableLấy theo Mã HHDV
65Đơn vị tínhTextbox
DisableLấy theo Mã HHDV7Báo giá gần nhấtTextboxDisableLấy theo Giá hàng hóa tại hợp đồng8Giá mua gần nhấtTextboxDisableLấy theo Giá hàng hóa tại hợp đồng9
Giá mua trung bình 6 thángTextboxDisableLấy theo Giá hàng hóa tại hợp đồng10Giá mua nhỏ nhấtTextboxDisableLấy theo Giá hàng hóa tại hợp đồng11Giá mua lớn nhấtTextboxDisableLấy theo Giá hàng hóa tại hợp đồng12Mã hợp đồng cung cấp gần nhấtTextboxDisableLấy thông tin Mã hợp đồng dịch vụ13Trạng tháiTrạng tháiCombobox
DisableMặc định Cung Cấp
147HủyButton
EnableThoát

3.4.5. Lọc

...

56

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
2Mã HHDVComboboxLấy dữ liệu từ Mã HHDV 3Tên HHDVComboboxLấy dữ liệu từ Tên HHDV 4Trạ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

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


...