SRS_Bảng giá

Giới thiệu & tài liệu liên quan

Đặc tả yêu cầu phần mềm cho module Bảng giá (OW-03). Xem thêm Tổng quan module · UC · UI.

1/ Luồng Sequence

2/ Luồng di chuyển màn hình

3/ Đặc tả chi tiết theo màn hình

MH1: Bảng giá theo loại sân

Mô tả màn hình: Hiển thị bảng giá theo từng loại sân (tab Trong nhà / Ngoài trời) gồm khối giá mặc định và khối giá khuyến mãi; cho chọn nhiều sân áp dụng và xem trước (preview) toàn bộ bảng giá.

Sự kiện 1 — Xem & chuyển tab loại sân

STT	Tác nhân	Mô tả
1	Chủ sân	Mở màn hình Bảng giá
2	Chủ sân	Chuyển giữa tab Sân trong nhà và Sân ngoài trời
3	Pricing Server	Hợp lệ: Trả về bảng giá hiện hành của loại sân đã chọn

Không hợp lệ — Sự kiện 1

STT	Trường hợp	Thông báo	Vị trí · Loại	Xử lý
1	Không có quyền cấu hình giá	"Bạn không có quyền chỉnh sửa bảng giá."	Toàn màn hình · cảnh báo	Ẩn nút sửa, chỉ cho xem

Sự kiện 2 — Mở form sửa / lịch sử

STT	Tác nhân	Mô tả
1	Chủ sân	Nhấn [+ Thêm khung giờ] hoặc [Sửa] (sang MH2)
2	Chủ sân	Nhấn Lịch sử thay đổi giá (sang MH4)

MH2: Form khung giá

Mô tả màn hình: Form chọn sân áp dụng và nhập các dòng giá theo Thứ · Khung giờ · Giá (peak/off-peak), kèm khối giá khuyến mãi theo khoảng ngày.

Sự kiện 1 — Chọn sân áp dụng

STT	Tác nhân	Mô tả
1	Chủ sân	Tick chọn nhiều sân hoặc Chọn tất cả sân cùng loại
2	Pricing Client	Cập nhật phạm vi áp dụng của cấu hình giá

Không hợp lệ — Sự kiện 1

STT	Trường hợp	Thông báo	Vị trí · Loại	Xử lý
1	Chưa chọn sân nào	"Vui lòng chọn ít nhất một sân để áp giá."	Khu vực chọn sân · cảnh báo	Chặn lưu

Sự kiện 2 — Thêm khung giá & lưu

STT	Tác nhân	Mô tả
1	Chủ sân	Nhấn [+ Thêm khung giờ]: Thứ + Khung giờ + Giá
2	Chủ sân	Thêm giá khuyến mãi theo khoảng ngày nếu cần
3	Chủ sân	Xem preview, nhấn [Lưu cấu hình]
4	Pricing Server	Hợp lệ: Lưu giá, snapshot giá cũ, áp cho booking mới (không hồi tố)

Không hợp lệ — Sự kiện 2

STT	Trường hợp	Thông báo	Vị trí · Loại	Xử lý
1	Hai khung giờ chồng lấn	"Khung giờ bị trùng, vui lòng điều chỉnh."	Dòng khung giờ · lỗi	Chặn lưu
2	Giá trống hoặc nhỏ hơn 0	"Giá phải là số lớn hơn 0."	Ô giá · lỗi	Chặn lưu

MH3: Giá sản phẩm

Mô tả màn hình: Danh sách sản phẩm (FNB / thuê / bán dụng cụ) với ô nhập giá theo loại; cho chỉnh và lưu giá để POS tiêu thụ.

Sự kiện 1 — Đặt & lưu giá sản phẩm

STT	Tác nhân	Mô tả
1	Chủ sân	Chọn sản phẩm, nhập giá (bán theo đơn vị / thuê theo giờ-lượt)
2	Chủ sân	Nhấn [Lưu]
3	Pricing Server	Hợp lệ: Lưu giá, ghi nhật ký, cập nhật để POS lấy

Không hợp lệ — Sự kiện 1

STT	Trường hợp	Thông báo	Vị trí · Loại	Xử lý
1	Giá trống hoặc nhỏ hơn 0	"Giá phải là số lớn hơn 0."	Ô giá · lỗi	Chặn lưu

MH4: Lịch sử thay đổi giá

Mô tả màn hình: Bảng lịch sử các lần thay đổi giá gồm người thực hiện, thời điểm, giá cũ và giá mới; chỉ để xem (read-only).

Sự kiện 1 — Xem lịch sử

STT	Tác nhân	Mô tả
1	Chủ sân	Mở lịch sử thay đổi giá của loại sân / sản phẩm
2	Pricing Server	Hợp lệ: Trả về danh sách lần đổi (ai · khi nào · giá cũ → giá mới)

Không hợp lệ — Sự kiện 1

STT	Trường hợp	Thông báo	Vị trí · Loại	Xử lý
1	Chưa có lần thay đổi nào	"Chưa có lịch sử thay đổi giá."	Vùng danh sách · thông tin	Hiển thị trạng thái trống

4/ Trường hợp đặc biệt

Case đặc biệt cần xử lý

• Case: Giá khuyến mãi đè giá mặc định. Trong khoảng ngày & khung giờ trùng, giá khuyến mãi được áp thay cho giá mặc định; ngoài khoảng đó dùng lại giá mặc định peak/off-peak.
• Case: Giá không hồi tố. Booking đã chốt giữ nguyên giá tại thời điểm đặt; bảng giá mới chỉ áp cho booking tạo sau đó.
• Case: Áp một cấu hình cho nhiều sân. Khi chọn nhiều sân hoặc "Chọn tất cả", cùng một cấu hình giá được lưu và áp đồng thời cho mọi sân được chọn trong một thao tác.
• Case: Slot chưa có giá. Khi POS hỏi giá cho loại sân/khung giờ chưa cấu hình, hệ thống báo chưa có giá và yêu cầu cấu hình trước khi tạo đơn.