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

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

Là admin nghiệp vụ, tôi muốn HHDV được cập nhật thông tin giá địa phương 

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

  1. Tôi muốn Xem/tạo mới/sửa/xóa được thông tin đơn giá theo địa phương bao gồm các thông tin
    • Tỉnh/Thành phố
    • Phường/Xã
    • Đơn giá
    • Ngày dữ liệu
    • Ghi chú
  2. Tôi muốn load mặc định giá địa phương theo ngày dữ liệu trong 12 tháng gần nhất và cho phép sửa lại
  3. Tôi muốn import được thông tin giá địa phương của HHDV theo file excel có cấu trúc, cho phép tải xuống file import và trả về file lỗi, tải xuống file lỗi.
  4. Tôi muốn tìm kiếm được thông tin HHDV theo đơn giá địa phương theo Tỉnh/Thành phố, theo Phường, Xã, Theo đơn giá
  5. Tôi muốn danh mục giá địa phương được sắp xếp được thông tin theo ngày dữ liệu và giá mua ( Ngày gần nhất lên trên, giá thấp nhất lên trên)

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

3.1 UIUX: https://www.figma.com/design/0vkg7L5PNUACG6nsDlyAI0/BPM?node-id=19871-881&p=f&t=Zp71JY3jRdPO6ucL-0

3.1.1. Thêm mới hàng hóa dịch vụ


3.1.2. Chỉnh sửa hàng hóa dịch vụ

3.1.3. Xem chi tiết hàng hóa dịch vụ


3.2 Luồng:

3.2.1. Tìm kiếm hàng hóa

3.2.2. Thêm mới hàng hóa

3.2.3. Chỉnh sửa hàng hóa

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

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

API 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 Mô tả các trường dữ liệu trên màn hình:

3.4.1. Thêm mới hàng hóa dịch vụ

Gọi Pop-up thêm mới hàng hóa dịch vụ khi chọn button Thêm mới tại danh mục hàng hóa dịch vụ

STT

Field

(Trường dữ liệu)

Type

(Kiểu dữ liệu)

Required

(Bắt buộc)

Validation

(Quy định)

Description

(Mô tả)

1Thêm mới hàng hóa dịch vụLabel

Tên Pop-up
Giá địa phương: Sắp xếp theo ngày gàn nhất lên trên,  giá mua thấp nhất lên trên
2LọcButton

Gọi Pop-up lọc
3

STT

Number

Số thứ tự tự sinh
4

Ngày dữ liệu

dd/mm/yyyyBắt buộc

Enable

Cho phép nhập ngày dữ liệu
5

Tỉnh/Thành phố

ComboboxBắt buộcEnableChọn tỉnh thành phố
6

Phường/Xã

Combobox
EnableChọn Phường xã
7

Đơn giá

NumberBắt buộcEnableNhập đơn giá
8

Ghi chú

Textbox
EnableNhập ghi chứ
9Thêm dòngButton
EnableThêm dòng dữ liệu
10

Xóa

Button
EnableXóa dòng dữ liệu
11Nhập file excelButton
EnableGọi Popup Nhập file excel
12Xuất file excelButton
EnableGọi Popup Xuất file excel
Button chung
13HủyButton
EnableThoát khỏi Popup
14Áp dụngButton
Enable

Thành công:

  • Lưu thông tin hàng hóa dịch vụ 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ụ thành công!

Thất bại: Cảnh báo và không cho lưu

  • Nhập thiếu thông tin các trường bắt buộc: Thất bại- Thiếu thông tin trường bắt buộc!
  • Nhập mã hàng hóa trùng nhau: Thất bại- Mã hàng hóa đã tồn tại!
  • Phường xã để trống, Nhập Ngày dữ liệu, Tỉnh thành phố  đã tồn tại:Thất bại - Dữ liệu Giá địa phương đã tồn tại!
  • Nhập Ngày dữ liệu, Tỉnh thành phố, Phường xã đã tồn tại: Thất bại- Dữ liệu Giá địa phương đã tồn tại!

Pop-up Lọc thông tin giá địa phương

STT

Field

(Trường dữ liệu)

Type

(Kiểu dữ liệu)

Required

(Bắt buộc)

Validation

(Quy định)

Description

(Mô tả)

1Bộ lọcLabel

Tên Popup
2

Ngày dữ liệu

dd/mm/yyyy

Mặc định trong 12 tháng từ ngày hiện tại

VD:  17/11/2024 - 17/11/2025

Cho phép sửa lại thông tin tìm kiếm từ ngày, đến ngày
3

Tỉnh/Thành phố

Combobox
EnableChọn thông tin tỉnh thành phố muốn tìm kiếm
4

Phường/Xã

Combobox
EnableChọn thông tin phường xã muốn tìm kiếm

3.4.2. Sửa hàng hóa dịch vụ

Gọi Pop-up sửa hàng hóa dịch vụ 

STT

Field

(Trường dữ liệu)

Type

(Kiểu dữ liệu)

Required

(Bắt buộc)

Validation

(Quy định)

Description

(Mô tả)

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

Tên Pop-up
Giá địa phương: Sắp xếp theo ngày gàn nhất lên trên,  giá mua thấp nhất lên trên
2LọcButton

Gọi Pop-up Lọc thông tin
3

STT

Number

Số thứ tự tự sinh
4

Ngày dữ liệu

dd/mm/yyyyBắt buộc

Enable

Cho phép nhập ngày dữ liệu
5

Tỉnh/Thành phố

ComboboxBắt buộcEnableChọn tỉnh thành phố
6

Phường/Xã

Combobox
EnableChọn Phường xã
7

Đơn giá

NumberBắt buộcEnableNhập đơn giá
8

Ghi chú

Textbox
EnableNhập ghi chú, cho phép xuống dòng 
9Thêm dòngButton
EnableThêm dòng dữ liệu
10

Xóa

Button
EnableXóa dòng dữ liệu
11Nhập file excelButton
EnableGọi Popup Nhập file excel
12Xuất file excelButton
EnableGọi Popup Xuất file excel
Button chung
13Hủy

EnableThoát khỏi Popup Sửa hàng hóa dịch vụ
14Áp dụng

Enable

Thành công:

  • Lưu thông tin hàng hóa dịch vụ 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ụ thành công!

Thất bại: Cảnh báo và không cho lưu

  • Nhập thiếu thông tin các trường bắt buộc: Thất bại- Thiếu thông tin trường bắt buộc!
  • Nhập mã hàng hóa trùng nhau: Thất bại- Mã hàng hóa đã tồn tại!
  • Phường xã để trống, Nhập Ngày dữ liệu, Tỉnh thành phố  đã tồn tại:Thất bại - Dữ liệu Giá địa phương đã tồn tại!
  • Nhập Ngày dữ liệu, Tỉnh thành phố, Phường xã đã tồn tại: Thất bại- Dữ liệu Giá địa phương đã tồn tại!

3.4.3. Xem chi tiết hàng hóa dịch vụ

Gọi Pop-up xem chi tiết hàng hóa dịch vụ

STT

Field

(Trường dữ liệu)

Type

(Kiểu dữ liệu)

Required

(Bắt buộc)

Validation

(Quy định)

Description

(Mô tả)

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

Tên Pop-up
Giá địa phương: Sắp xếp theo ngày gàn nhất lên trên,  giá mua thấp nhất lên trên
2LọcButton
EnableGọi Pop-up Lọc thông tin
3

STT

Number
Disable
4

Ngày dữ liệu

dd/mm/yyyy
Disable
5

Tỉnh/Thành phố

Combobox
Disable
6

Phường/Xã

Combobox
Disable
7

Đơn giá

Number
Disable
8

Ghi chú

Textbox
Disable
9Xuất file excelButton
Disable

Button chung

10

Hủy

Button
EnableThoát Pop-up Xem chi tiết

Pop-up lọc thông tin:

STT

Field

(Trường dữ liệu)

Type

(Kiểu dữ liệu)

Required

(Bắt buộc)

Validation

(Quy định)

Description

(Mô tả)

1Bộ lọcLabel

Tên Popup
2

Ngày dữ liệu

dd/mm/yyyy

Mặc định trong 12 tháng từ ngày hiện tại

VD:  17/11/2024 - 17/11/2025

Cho phép tìm kiếm từ ngày, đến ngày
3

Tỉnh/Thành phố

Combobox
EnableChọn thông tin tỉnh thành phố muốn tìm kiếm
4

Phường/Xã

Combobox
EnableChọn thông tin phường xã muốn tìm kiếm


3.4.6. 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 nhóm quyền

Cho phép xuất tất cả các nhóm quyền trên file excel

4Trên trang nàyRadio button

Cho phép xuất các nhóm quyền 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 nhóm quyền phù hợp với tất cả tìm kiếm hiện tại


File excel tại Giá địa phương: Danh mục giá địa phương.xlsx

3.4.7. Nhập file excel

Popup nhập excel được hiển thị khi chọn Nhập 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ả

1Nhập file excelLabel

Tên popup
2Tài liệu mẫuLabel


3Tải xuốngButton

Cho phép tải xuống file excel mẫu
4Tài liệu đính kèmUpload file

Cho phép upload file theo mẫu
5HủyButton

Thoát khỏi popup import
6Áp dụngButton

Thất bại:

  • Gọi pop-up trả lỗi khi import dữ liệu, file trả lỗi theo từng dòng
  • Hiển thị thông báo: " Thất bại- Import danh sách nhóm quyền thất bại!"

Thành công:

  • Lưu thông tin import
  • Hiển thị thông báo: " Thành công- Import danh sách nhóm quyền thành công!"

File excel mẫu bao gồm thông tin:  Giá địa phương.xlsx

Đ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 fileBắt buộc

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


Sai cấu trúc file

2Ngày dữ liệuBắt buộcdd/mm/yyyy
Ngày dữ liệu- Sai định dạng
3Tỉnh/Thành phốBắt buộcDữ liệu Tỉnh Thành phố trong file hiển thị dưới dạng select lấy dữ liệu xuất ra từ hệ thống và cho phép chọn

Tỉnh/Thành phố-  Không được bỏ trống

Tỉnh/Thành phố- Dữ liệu không tồn tại trong danh mục

4Phường/XãKhông bắt buộcDữ liệu Phường xã trong file hiển thị dưới dạng select lấy dữ liệu xuất ra từ hệ thống và cho phép chọn

Phường/Xã-  Không được bỏ trống

Phường/Xã- Dữ liệu không tồn tại trong danh mục

5Đơn giáBắt buộcNumber
Đơn giá- Đơn giá nhập định dạng số
6

Phường xã để trống, Nhập Ngày dữ liệu, Tỉnh thành phố  trùng với một bản ghi sẵn có trong hệ thống




Ngày dữ liệu và tỉnh thành phố đã tồn tại trong hệ thống
7

Phường xã để trống, Nhập Ngày dữ liệu, Tỉnh thành phố  trùng với một bản ghi sẵn có trong file import




Trùng ngày dữ liệu và tỉnh thành phố trong file
8Nhập Ngày dữ liệu, Tỉnh thành phố, Phường xã trùng với bản ghi sẵn có trong hệ thống


Ngày dữ liệu và tỉnh thành phố, phường xã đã tồn tại trong hệ thống
9Nhập Ngày dữ liệu, Tỉnh thành phố, Phường xã trùng với bản ghi sẵn có trong file import


Trùng ngày dữ liệu và tỉnh thành phố, phường xã đã tồn tại trong file

Pop-up thông báo lỗi import

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ỗi

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 nhập file excel
8Nhập lạiButton

Gọi pop-up Nhập file excel
  • No labels