Page History

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,...)thư ký tổ quản lý ngân hàng giá, Tôi muốn thêm mới dữ liệu vào ngân hàng giá phục vụ update dữ liệu ngân hàng giá theo thời gian

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

1. Tôi muốn quản lý bổ sung thông tin HHDV bổ sung bao gồm:
   
   • 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ụ
2. Tôi muốn hệ thống tự động tính toán được thông tin giá HHDV bao gồm:
   • 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

3. 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ú
4. Tôi muốn hệ thống tự động cập nhật thông tin lịch sử mua sắm của từng HHDV.
5. Tôi muốn tìm kiếm được thông tin lịch sử mua sắm của HHDV theo nhà cung cấp, đơn giá. Sắp xếp thông tin lịch sử mua sắm theo ngày mua
6. 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ú
7. 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.
8. 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á
9. Tôi muốn danh mục giá địa phương được sắp xếp được thông tin theo đơn giá từ thấp đến cao

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>

...

...

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

...

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

...

...

...

...

1. Tạo mới dữ liệu cập nhật ngân hàng giá với các thông tin:
   1. Loại yêu cầu: Chọn 1 trong 2 loại yêu cầu
      1.  Cập nhật ngân hàng giá theo Lịch sử mua
      2. Cập nhật ngân hàng giá theo Khảo sát
   2. Chi tiết yêu cầu: cho phép Thêm/Sửa/Xóa các bản ghi  
      1. Cập nhật ngân hàng giá theo Lịch sử mua:
         1. Mã hàng hóa: Chọn trong danh mục hàng hóa
         2. Tên hàng hóa Load theo mã hàng hóa
         3. Mã hàng hóa Spec: Chọn trong danh mục hàng hóa level 2 tương ứng với hàng hóa được chọn
         4. Đơn vị tính: Load theo mã hàng hóa
         5. Mã hiệu: Load theo mã hàng hóa spec
         6. Xuất xứ:  Load theo mã hàng hóa spec
         7. Nhà sản xuất:  Load theo mã hàng hóa spec
         8. Gói thầu: Lấy thông tin theo gói thầu đã ký kết thành công có chứa mã hàng hóa khớp spec gần nhất
         9. Giá trên gói thầu: Lấy thông tin theo gói thầu đã ký kết thành công có chứa mã hàng hóa khớp spec gần nhất
         10. Giá tham chiếu hiện tại: Lấy theo giá tham chiếu tại ngân hàng giá mã hàng hóa Spec, trường hợp mã hàng hóa spec mới chưa có trong ngân hàng giá, để trống và không cho sửa
         11. Giá tham chiếu đề xuất*: Nhập thông tin
      2. Cập nhật ngân hàng giá theo Khảo sát:
         1. Mã hàng hóa: Chọn trong danh mục hàng hóa
         2. Tên hàng hóa Load theo mã hàng hóa
         3. Mã hàng hóa Spec: Chọn trong danh mục hàng hóa level 2 tương ứng với hàng hóa được chọn
         4. Đơn vị tính: Load theo mã hàng hóa
         5. Mã hiệu: Load theo mã hàng hóa spec
         6. Xuất xứ:  Load theo mã hàng hóa spec
         7. Nhà sản xuất:  Load theo mã hàng hóa spec
         8. Giá khảo sát*: Nhập thông tin
         9. Giá tham chiếu*: Nhập thông tin
2. Tôi muốn hệ thống tự động đề xuất được thông tin chi tiết yêu cầu với Loại Cập nhật ngân hàng giá theo Lịch sử mua:
   1. Đề xuất các thông tin hàng hóa theo spec tại một gói thầu đã hoàn thành ký kết có spec chưa thuộc ngân hàng giá 
   2. Đề xuất thông tin các hàng hóa theo spec tại một gói thầu đã hoàn thành ký kết có giá trên gói thầu chêcnh lệch quá 15% giá tham chiếu (Trong thời gian từ ngày ký kết hợp đồng đến hiện tại chưa có lần cập nhật ngân hàng giá của hàng hóa theo spec này)
3. Tôi muốn hệ thống email và thông báo đến thư ký tổ quản lý ngân hàng giá khi giá hàng hóa tương ứng spec trên gói thầu chênh lệch quá 15% giá tham chiếu
4. Tôi muốn import được excel thông tin yêu cầu cập nhật với trường hợp cập nhật thông tin ngân hàng giá theo khảo sát bao gồm:
   1. Mã hàng hóa spec
   2. Giá khảo sát
   3. Giá tham chiếu
5. Tôi muốn export được thông tin chi tiết yêu cầu cập nhật dưới dạng excel
6. Tôi muốn hoàn thành được công việc lập yêu cầu và cập nhật dữ liệu tạo mới vào ngân hàng giá:
   1. Với các mã hàng hóa spec đã tồn tại ở ngân hàng giá: Update dữ liệu theo bản ghi mới nhất
   2. Với các mã hàng hóa spec chưa tồn tại ở ngân hàng giá: Thêm mới bản ghi

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

3.2 Luồng:

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

3.4 Mô tả các trường dữ liệu trên màn hình: