UC_Quản lý Chi nhánh & Sân
Giới thiệu & tài liệu liên quan
Đặc tả Use Case cho 4 nghiệp vụ chính của module Quản lý Chi nhánh & Sân (OW-03). Xem thêm Tổng quan module · SRS · UI.
UC1 — Tạo chi nhánh
| Mục | Nội dung |
|---|---|
| Use Case ID | UC_OW03_BRANCH_001 |
| Use Case Name | Tạo chi nhánh |
| Use Case Description | Trên thanh header, Chủ sân mở dropdown Chi nhánh rồi chọn [+ Thêm chi nhánh] để hiện form "Thêm chi nhánh": nhập thông tin chi nhánh (tên, địa chỉ, SĐT, giờ mở-đóng cửa) và khai báo ít nhất một sân (Tên + Bộ môn + Loại sân + ảnh sân) trong cùng form; Website & ảnh chi nhánh là tùy chọn. Sân cũng có thể được khai báo riêng về sau qua UC2. |
| System Under Design | Court Client · Court Server |
| Primary Actor | Chủ sân |
| Supporting/External Actor | Quản lý ca |
| Priority | HIGH |
| Trigger | Chủ sân mở dropdown Chi nhánh trên thanh header và nhấn [+ Thêm chi nhánh] |
| Pre-Condition | Người dùng đã đăng nhập và có quyền quản lý chi nhánh |
| Post-Condition | Chi nhánh mới kèm ít nhất một sân được lưu; chi nhánh xuất hiện ngay trong danh sách |
Sơ đồ luồng — Basic Flow & ngoại lệ
Basic Flow
Basic Flow
| Bước | Actor | Mô tả hành động |
|---|---|---|
| 1 | Chủ sân | Mở dropdown Chi nhánh trên thanh header, nhấn [+ Thêm chi nhánh] |
| 2 | Court Client | Hiển thị form Thêm chi nhánh (modal 1 trang) |
| 3 | Chủ sân | Nhập tên chi nhánh, địa chỉ, số điện thoại, giờ mở - giờ đóng cửa |
| 4 | Chủ sân | Khai báo ít nhất 1 sân: mỗi dòng Tên sân + thêm bộ môn và chọn Bộ môn + thêm loại sân và chọn Loại sân + [+ Thêm ảnh sân]; thêm sân khác qua [+ Thêm sân] |
| 5 | Chủ sân | (Tùy chọn) Nhập website, kéo-thả / chọn ảnh chi nhánh |
| 6 | Chủ sân | (Tùy chọn) Khi đủ điều kiện, hệ thống hiển thị sẵn Bảng giá mặc định đúng loại sân vừa tạo; nhấn [+ Thêm khung giờ] để nhập Khung giờ (Bắt đầu - Kết thúc) + Khoảng ngày + Thứ + Giá rồi [THÊM], hoặc [+ Thêm bảng giá] để tạo bảng giá mới |
| 7 | Chủ sân | Nhấn [Lưu chi nhánh] |
| 8 | Court Server | Kiểm tra hợp lệ, lưu chi nhánh kèm danh sách sân (và bảng giá nếu có), trả về kết quả |
| 9 | Court Client | Đóng modal, hiển thị chi nhánh mới ngay trong danh sách |
Alternative Flow
Alternative Flow
| TT | Mã | Liên quan bước | Mô tả |
|---|---|---|---|
| 1 | AF_4A.1 | 4 | Bộ môn hoặc Loại sân cần dùng chưa có trong danh sách sổ xuống → Chủ sân nhấn [+ Thêm bộ môn] / [+ Thêm loại sân], nhập tên mới rồi chọn cho dòng sân |
| 2 | AF_4B.1 | 4 | Chủ sân nhấn biểu tượng ảnh trên dòng sân để gắn ảnh riêng cho từng sân; bỏ qua nếu chưa có ảnh |
| 3 | AF_4C.1 | 4 | Chủ sân nhấn [+ Thêm sân] để khai báo thêm sân và lặp lại thao tác như sân đầu tiên (nhập Tên + chọn Bộ môn & Loại sân + ảnh sân); có thể thêm nhiều sân trước khi lưu |
| 4 | AF_5A.1 | 5 | Chủ sân bỏ qua website / ảnh chi nhánh; chi nhánh dùng ảnh mặc định cho tới khi cập nhật sau |
| 5 | AF_6A.1 | 6 | Khi đủ điều kiện, hệ thống hiển thị sẵn Bảng giá mặc định đúng loại sân vừa tạo; Chủ sân nhấn [+ Thêm khung giờ] để thêm dòng giá: Khung giờ (Bắt đầu - Kết thúc) + Khoảng ngày + Thứ + Giá rồi [THÊM], lặp lại để thêm nhiều khung giờ |
| 6 | AF_6B.1 | 6 | Chủ sân nhấn [+ Thêm bảng giá] để tạo thêm bảng giá mới cho loại sân (ngoài bảng giá mặc định) |
| 7 | AF_6C.1 | 6 | Chủ sân bỏ qua cấu hình bảng giá để làm sau (qua chức năng Bảng giá của chi nhánh — xem UC4) |
Exception Flow
Exception Flow
| TT | Mã | Liên quan bước | Mô tả |
|---|---|---|---|
| 1 | EF_6.1 | 7 | Thiếu thông tin chung — bỏ trống Tên / Địa chỉ / SĐT / Giờ → hệ thống đánh dấu trường thiếu và yêu cầu bổ sung |
| 2 | EF_6.2 | 7 | Danh sách sân rỗng hoặc sân thiếu Tên / Bộ môn / Loại sân → hệ thống yêu cầu khai báo ít nhất một sân hợp lệ |
| 3 | EF_6.3 | 6 | Chọn cấu hình bảng giá khi chưa khai báo đủ Sân + Bộ môn + Loại sân → hệ thống báo lỗi, yêu cầu khai báo các mục này trước rồi mới hiển thị bảng giá mặc định |
| 4 | EF_3.1 | 3 | Giờ mở cửa muộn hơn hoặc bằng giờ đóng cửa → hệ thống báo lỗi logic khung giờ |
| 5 | EF_4.1 | 4 | Ảnh sân / ảnh chi nhánh vượt 5MB hoặc sai định dạng (ngoài JPG/PNG) → hệ thống từ chối ảnh và báo lỗi |
Business Rules
Business Rules
| TT | Mã | Quy tắc nghiệp vụ |
|---|---|---|
| 1 | BR1 | Chi nhánh bắt buộc có đủ Tên + Địa chỉ + SĐT + Giờ mở cửa khi lưu |
| 2 | BR2 | Giờ mở cửa phải sớm hơn giờ đóng cửa |
| 3 | BR3 | Bắt buộc khai báo ít nhất một sân; mỗi dòng sân cần đủ Tên + Bộ môn + Loại sân |
| 4 | BR4 | Bộ môn và Loại sân chọn từ danh mục dùng chung; có thể thêm mới ngay trong form qua [+ Thêm bộ môn] / [+ Thêm loại sân] |
| 5 | BR5 | Website & ảnh chi nhánh là tùy chọn; ảnh hỗ trợ JPG/PNG, tối đa 5MB mỗi ảnh |
| 6 | BR6 | Bảng giá là tùy chọn khi tạo chi nhánh; chỉ cấu hình được sau khi đã khai báo đủ Sân + Bộ môn + Loại sân, nếu chưa thì hệ thống chặn và yêu cầu khai báo trước |
| 7 | BR7 | Khi đủ điều kiện, hệ thống tạo sẵn một Bảng giá mặc định đúng theo loại sân vừa tạo; mỗi khung giờ gồm Thứ + Khung giờ + Giá (kèm Khoảng ngày nếu là giá khuyến mãi) |
| 8 | BR8 | Chủ sân có thể thêm nhiều khung giờ vào bảng giá mặc định và/hoặc tạo thêm bảng giá mới cho loại sân; toàn bộ chỉ được ghi nhận khi chi nhánh lưu thành công và có thể cấu hình lại sau qua chức năng Bảng giá |
UC2 — Khai báo sân
| Mục | Nội dung |
|---|---|
| Use Case ID | UC_OW03_COURT_002 |
| Use Case Name | Khai báo sân |
| Use Case Description | Chủ sân thêm một sân mới vào chi nhánh trong một form 1 trang — tương tự cách tạo chi nhánh: nhập tên sân, chọn Loại sân và Bộ môn từ danh mục dùng chung (tự thêm mới nếu chưa có), tải ảnh sân rồi lưu. |
| System Under Design | Court Client · Court Server |
| Primary Actor | Chủ sân |
| Supporting/External Actor | Quản lý ca |
| Priority | HIGH |
| Trigger | Chủ sân nhấn [+ Thêm sân] trên màn hình danh sách sân của chi nhánh |
| Pre-Condition | Đã tồn tại chi nhánh để thêm sân; người dùng có quyền quản lý sân |
| Post-Condition | Sân mới được lưu vào chi nhánh; card sân xuất hiện ngay trong danh sách |
Sơ đồ luồng — Basic Flow & ngoại lệ
Basic Flow
Basic Flow
| Bước | Actor | Mô tả hành động |
|---|---|---|
| 1 | Chủ sân | Nhấn [+ Thêm sân] trên danh sách sân |
| 2 | Court Client | Mở popup form điền thông tin sân |
| 3 | Chủ sân | Nhập tên sân |
| 4 | Chủ sân | Chọn Loại sân trong danh mục loại sân đã tạo |
| 5 | Chủ sân | Chọn Bộ môn trong danh mục bộ môn đã có |
| 6 | Chủ sân | Kéo-thả / tải ảnh sân |
| 7 | Chủ sân | Nhấn [Lưu sân] |
| 8 | Court Server | Kiểm tra hợp lệ, lưu sân vào chi nhánh, trả về kết quả |
| 9 | Court Client | Hiển thị card sân mới ngay trong danh sách |
Alternative Flow
Alternative Flow
| TT | Mã | Liên quan bước | Mô tả |
|---|---|---|---|
| 1 | AF_4A.1 | 4 | Loại sân cần dùng chưa có trong danh mục → Chủ sân nhấn [+ Thêm loại sân], nhập tên mới rồi chọn |
| 2 | AF_5A.1 | 5 | Bộ môn cần dùng chưa có trong danh mục → Chủ sân nhấn [+ Thêm bộ môn], nhập tên mới rồi chọn |
| 3 | AF_6A.1 | 6 | Chủ sân bỏ qua tải ảnh; sân dùng ảnh mặc định cho tới khi cập nhật sau |
Exception Flow
Exception Flow
| TT | Mã | Liên quan bước | Mô tả |
|---|---|---|---|
| 1 | EF_7.1 | 7 | Thiếu trường bắt buộc (Tên / Loại sân / Bộ môn) → hệ thống đánh dấu trường thiếu và yêu cầu bổ sung |
| 2 | EF_7.2 | 7 | Tên sân trùng với sân đã có trong cùng chi nhánh → hệ thống báo lỗi tên trùng |
Business Rules
Business Rules
| TT | Mã | Quy tắc nghiệp vụ |
|---|---|---|
| 1 | BR6 | Mỗi sân bắt buộc có đủ Tên + Loại sân + Bộ môn |
| 2 | BR7 | Sân phải thuộc về một chi nhánh đã tồn tại |
| 3 | BR8 | Bộ môn và Loại sân là danh mục dùng chung toàn hệ thống, tái sử dụng giữa các chi nhánh |
UC3 — Đóng sân (khoá bảo trì)
| Mục | Nội dung |
|---|---|
| Use Case ID | UC_OW03_COURT_003 |
| Use Case Name | Đóng sân (khoá bảo trì) |
| Use Case Description | Quản lý ca khoá một sân trong khung giờ xác định kèm lý do; hệ thống kiểm tra booking xung đột, đẩy slot khoá lên lịch Gantt và xử lý booking bị ảnh hưởng. |
| System Under Design | Court Client · Court Server |
| Primary Actor | Quản lý ca |
| Supporting/External Actor | Chủ sân · Module Đặt sân & Lịch |
| Priority | HIGH |
| Trigger | Quản lý ca chọn một sân và nhấn [Sửa] → "Đóng sân" |
| Pre-Condition | Sân đang hoạt động; người dùng có quyền đóng sân trên chi nhánh được phân công |
| Post-Condition | Sân chuyển trạng thái khoá trong khung giờ; slot khoá hiển thị xám trên Gantt với tooltip lý do |
Sơ đồ luồng — Basic Flow & ngoại lệ
Basic Flow
Basic Flow
| Bước | Actor | Mô tả hành động |
|---|---|---|
| 1 | Quản lý ca | Chọn sân, nhấn [Sửa] rồi chọn "Đóng sân" |
| 2 | Quản lý ca | Nhập khung giờ đóng (Từ - Đến) và lý do |
| 3 | Quản lý ca | Nhấn xác nhận đóng sân |
| 4 | Court Server | Kiểm tra booking xung đột trong khung giờ |
| 5 | Court Server | Lưu trạng thái khoá, đẩy slot khoá lên lịch Gantt (Module Đặt sân) |
| 6 | Court Client | Hiển thị sân ở trạng thái bảo trì kèm lý do |
Alternative Flow
Alternative Flow
| TT | Mã | Liên quan bước | Mô tả |
|---|---|---|---|
| 1 | AF_3A.1 | 3 | Có booking xung đột → hệ thống liệt kê các booking bị ảnh hưởng; Quản lý ca chọn Huỷ hoặc Đổi sân cho từng booking rồi tiếp tục đóng |
| 2 | AF_3B.1 | 3 | Quản lý ca chọn đóng sân không thời hạn (không nhập Đến) → sân khoá đến khi mở lại thủ công |
Exception Flow
Exception Flow
| TT | Mã | Liên quan bước | Mô tả |
|---|---|---|---|
| 1 | EF_2.1 | 2 | Khung giờ đóng nằm trong quá khứ → hệ thống báo lỗi không cho đóng |
| 2 | EF_3.1 | 3 | Người dùng huỷ thao tác giữa chừng → không thay đổi trạng thái sân |
Business Rules
Business Rules
| TT | Mã | Quy tắc nghiệp vụ |
|---|---|---|
| 1 | BR9 | Phải kiểm tra và giải quyết booking xung đột trước khi xác nhận đóng sân |
| 2 | BR10 | Mọi lần đóng sân đều ghi lý do để hiển thị tooltip trên Gantt |
| 3 | BR11 | Sân tự mở lại khi hết khung giờ đóng, hoặc do người có quyền mở thủ công |
UC4 — Cấu hình bảng giá
| Mục | Nội dung |
|---|---|
| Use Case ID | UC_OW03_PRICE_004 |
| Use Case Name | Cấu hình bảng giá mặc định & khuyến mãi |
| Use Case Description | Chủ sân thiết lập bảng giá theo loại sân gồm giá mặc định (Thứ · Khung giờ · Giá) và giá khuyến mãi theo khoảng ngày, áp cho một hoặc nhiều sân được chọn; thay đổi không hồi tố booking đã tạo. |
| System Under Design | Court Client · Pricing Server |
| Primary Actor | Chủ sân |
| Supporting/External Actor | Module Bán hàng POS |
| Priority | HIGH |
| Trigger | Chủ sân nhấn [Bảng giá] trên màn hình danh sách sân |
| Pre-Condition | Đã tồn tại chi nhánh và sân để áp giá |
| Post-Condition | Bảng giá được lưu và áp cho booking tạo mới; giá cũ được lưu lại làm lịch sử |
Sơ đồ luồng — Basic Flow & ngoại lệ
Basic Flow
Basic Flow
| Bước | Actor | Mô tả hành động |
|---|---|---|
| 1 | Chủ sân | Trên danh sách sân, nhấn [Bảng giá] |
| 2 | Chủ sân | Nhấn [Sửa bảng giá], chọn tab loại sân cần đặt |
| 3 | Chủ sân | Chọn sân áp dụng (tick nhiều sân hoặc Chọn tất cả) |
| 4 | Chủ sân | Nhấn [+ Thêm khung giờ], nhập Thứ + Khung giờ + Giá |
| 5 | Chủ sân | Nhấn [Lưu cấu hình] |
| 6 | Pricing Server | Lưu giá mới, snapshot giá cũ vào lịch sử, ghi nhật ký thay đổi |
| 7 | Pricing Server | Áp bảng giá cho booking tạo mới (không hồi tố booking cũ) |
Alternative Flow
Alternative Flow
| TT | Mã | Liên quan bước | Mô tả |
|---|---|---|---|
| 1 | AF_4A.1 | 4 | Chủ sân thêm giá khuyến mãi theo khoảng ngày → giá này đè giá mặc định trong khoảng ngày / khung giờ trùng |
| 2 | AF_3A.1 | 3 | Chủ sân chọn Chọn tất cả để áp cùng một bảng giá cho mọi sân cùng loại |
Exception Flow
Exception Flow
| TT | Mã | Liên quan bước | Mô tả |
|---|---|---|---|
| 1 | EF_5.1 | 5 | Hai khung giờ trùng/chồng lấn trong cùng loại sân → hệ thống báo lỗi và yêu cầu chỉnh lại |
| 2 | EF_5.2 | 5 | Giá để trống hoặc nhỏ hơn 0 → hệ thống báo lỗi giá không hợp lệ |
Business Rules
Business Rules
| TT | Mã | Quy tắc nghiệp vụ |
|---|---|---|
| 1 | BR12 | Giá khuyến mãi đè giá mặc định trong khoảng ngày & khung giờ trùng |
| 2 | BR13 | Thay đổi bảng giá không hồi tố các booking đã tạo trước đó |
| 3 | BR14 | Mỗi lần đổi giá đều lưu snapshot giá cũ và ghi nhật ký (ai · khi nào · cũ/mới) |
| 4 | BR15 | Một bảng giá có thể áp cho nhiều sân cùng loại trong một thao tác |
Non-Functional Requirements
Non-Functional Requirements
| TT | Loại | Yêu cầu |
|---|---|---|
| 1 | Khả dụng | Thao tác tạo chi nhánh, đóng sân, lưu giá phản hồi tức thì; card/Gantt cập nhật ngay sau khi lưu |
| 2 | Phân quyền | Mọi thao tác chỉnh sửa giới hạn theo phạm vi chi nhánh được phân công của người dùng |
| 3 | Truy vết | Đóng sân và thay đổi giá đều được ghi nhật ký để truy vết về sau |
| 4 | Toàn vẹn | Không cho xoá chi nhánh/sân khi còn sân active hoặc booking tương lai |