Versions Compared

Key

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

...

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 lịch sử mua sắm, lịch sử giá (thời gian, giá, nhãn hiệu, nhà cc,...)


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

...

  • Bộ phận sử dụng: Thêm list các bộ phận được phép truy cập thông tin theo cơ cấu tổ chức, được phép chọn Tất cả hoặc theo bộ phận, phòng ban cho phép, mặc định theo phòng ban của user khởi tạo
  • Sửa tên công việc thành hàng hóa dịch vụ: Danh mục công việc, Mã công việc, Tên công việc → Danh muc hàng hóa dịch vụ, Mã hàng hóa dịch vụ, Tên hàng hóa dịch vụ

...

  • Giá mua gần nhất
  • Giá mua trung bình 6 tháng
  • Giá mua tối thiểu
  • Giá mua tối đa

...

Tôi muốn xem được thông tin lịch sử mua sắm của HHDV bao gồm các thông tin:

  • Ngày mua
  • Nhà cung cấp
  • Đơn vị sử dụng
  • Số hợp đồng
  • Gói thầu
  • Số lượng
  • Đơn giá
  • Thành tiền
  • Tỷ lệ thuế %
  • Số tiền thuế
  • Tổng tiền
  • Ghi chú

...

  • Tỉnh/Thành phố
  • Phường/Xã
  • Đơn giá
  • Ngày dữ liệu
  • Ghi chú

...


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. Danh mục hàng hóa dịch vụ

Image Removed

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

Image Removed

Image Removed

Image Removed

Image Removed

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

Image Removed

Image Removed

Image Removed

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

Image Removed

Image Removed

Image Removed

Image Removed

Image Removed

3.2 Luồng:3.2.1. Tìm kiếm hàng hóa

Image Removed

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

Image Removed

3 .2.3. Chỉnh sửa hàng hóa

Image Removed

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

Image Removed

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

3.4.1. Danh sách hàng hóa dịch vụ

Màn hình danh sách hàng hóa dịch vụ được sử dụng để quản lý danh mục hàng hóa và ngân hàng giá tương ứng: Quản lý danh mục → Hàng hóa dịch vụ

...

Field

(Trường dữ liệu)

...

Type

(Kiểu dữ liệu)

...

Required

(Bắt buộc)

...

Validation

(Quy định)

...

Description

(Mô tả)

...

Cho phép chọn  tất cả bản ghi trên trang, một hoặc nhiều các bản ghi, trên danh sách, khi chọn checkbox hiển thị thông tin số lượng bản ghi đang chọn và icon xóa:

  • Đang chọn x: Trong đó x là số lượng bản ghi đang được chọn
  • Xóa: Cho phép xóa thông tin các bản ghi đang được chọn

Khi chọn nhiều bản ghi, hiển thị icon không cho chọn các button sửa, xóa tại từng bản ghi và button thêm mới, xuất excel 

Ẩn checkbox tại các bản ghi với trường hợp bản ghi đó đã được sử dụng tại một biểu mẫu hoặc một công việc

...

trên màn hình

...

Hiển thị khi có bản ghi được tích chọn trên màn hình

Chọn xóa gọi popup Xác nhận

...

Cho phép tìm kiếm gần đúng theo mã- tên:

  • Không phân biệt hoa thường
  • Tìm kiếm gần đúng tên
  • Không phân biệt dấu cách

...

Giá mua gần nhất

...

Giá mua trung bình 6 tháng

...

Giá mua tối thiểu

...

Giá mua tối đa

...

Hiển thị trạng thái HHDV và cho phép chuyển trạng thái của HHDV 

...

3.4.2. 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ụ

...

Field

(Trường dữ liệu)

...

Type

(Kiểu dữ liệu)

...

Required

(Bắt buộc)

...

Validation

(Quy định)

...

Description

(Mô tả)

...

Enable

Mã hàng hóa không được trùng nhau

...

Enable

Mặc định là active

...

STT

...

Ngày dữ liệu

...

Enable

dd/mm/yyyy

...

Tỉnh/Thành phố

...

Phường/Xã

...

Đơn giá

...

Ghi chú

...

Xóa

...

Enable

Tích chọn mặc định phòng ban người khởi tạo 

...

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!

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

...

Field

(Trường dữ liệu)

...

Type

(Kiểu dữ liệu)

...

Required

(Bắt buộc)

...

Validation

(Quy định)

...

Description

(Mô tả)

...

Tỉnh/Thành phố

...

Phường/Xã

...

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

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

...

Field

(Trường dữ liệu)

...

Type

(Kiểu dữ liệu)

...

Required

(Bắt buộc)

...

Validation

(Quy định)

...

Description

(Mô tả)

...

STT

...

Ngày dữ liệu

...

Enable

dd/mm/yyyy

...

Tỉnh/Thành phố

...

Phường/Xã

...

Đơn giá

...

Ghi chú

...

Xóa

...

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- Sửa 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!

3.4.4. 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ụ

...

Field

(Trường dữ liệu)

...

Type

(Kiểu dữ liệu)

...

Required

(Bắt buộc)

...

Validation

(Quy định)

...

Description

(Mô tả)

...

STT

...

Ngày dữ liệu

...

Tỉnh/Thành phố

...

Phường/Xã

...

Đơn giá

...

Ghi chú

...

Lịch sử mua hàng: Sắp xếp theo ngày mua gần nhất lên trên, cập nhật thông tin từ hợp đồng đã phát hành theo mã hàng hóa dịch vụ

...

Tìm kiếm theo tên nhà cung cấp

...

Tìm kiếm nhanh theo tên nhà cung cấp

  • Không phân biệt hoa thường
  • Tìm kiếm gần đúng tên
  • Không phân biệt dấu cách

...

Lọc

...

Xuất file excel

...

STT

...

Ngày mua

...

Nhà cung cấp

...

Đơn vị sử dụng

...

Số hợp đồng

...

Gói thầu

...

Số lượng

...

Đơn giá

...

Thành tiền

...

Tỷ lệ thuế %

...

Số tiền thuế

...

Tổng tiền

...

Ghi chú

...

Button chung

...

Hủy

...

Pop-up lọc thông tin:

...

Field

(Trường dữ liệu)

...

Type

(Kiểu dữ liệu)

...

Required

(Bắt buộc)

...

Validation

(Quy định)

...

Description

(Mô tả)

...

3.4.5. Xác nhận xóa

Pop-up Xác nhận xóa khi xóa một bản ghi dữ liệu

Popup Xác nhận hiển thị khi người dùng thực hiện Xóa 1 hoặc nhiều bản ghi đồng thời 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ả

...

Nội dung cảnh báo

...

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

...

Chức năng cho phép người dùng xóa HHDV đã chọn.

  • Hệ thống Cảnh báo và chặn trường hợp Xóa hàng hóa dịch vụ đã được sử dụng trong một công việc hay một biểu mẫu, thông báo toast: " Thất bại- Hàng hóa dịch vụ đã được sử dụng"
  • HHDV chưa sử dụng, Hệ thống hiển thị toast: "Thành công- Xóa hàng hóa dịch vụ  thành công"

...

Trong đó X là số lượng bản ghi được lựa chọn để xóa

...

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

...

Cho phép người dùng xóa chức năng đã chọn

  • HHDV chưa sử dụng, Hệ thống hiển thị toast: "Thành công- Xóa hàng hóa dịch vụ  thành công"

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ả

...

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

...

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 danh mục hàng hóa: Danh mục hàng hóa dịch vụ.xlsx

Image Removed

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

Image Removed

File excel tại Lịch sử mua hàng:Danh mục lịch sử mua hàng.xlsx

Image Removed

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ả

...

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:  

Image Removed

Điều kiện kiểm tra của file import: Trường hợp dữ liệu giá địa phương được import trùng thông tin Ngày dữ liệu, Tỉnh/Thành phố, Phường xã với một bản ghi sẵn có, update thông tin đơn giá theo bản ghi mới

...

STT

...

Dữ liệu

...

Điều kiện

...

Quy định

...

Mô tả

...

Tên lỗi

...

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

...

Sai cấu trúc file

...

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

...

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

...

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

Image Removed

...

STT

...

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

...

Kiểu dữ liệu

...

Điều kiện

...

Quy định

...

Mô tả

...

Không thành công

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

...

:

...

  • 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 Removed

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

...

Trả về số thứ tự của dòng lỗi

...

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

...