Sự kiện & Giải đấu Phase 1 In-progress
Tài liệu nghiệp vụ (BA)
UC — Use Case · SRS — Đặc tả yêu cầu · UI — Đặc tả giao diện
Module cho phép Chủ sân tạo và quản lý sự kiện thể thao - giải đấu Pickleball, lớp tập, open play - bán vé online qua app khách hàng, quản lý danh sách người tham gia và tự động khoá sân theo lịch sự kiện. Phần thi đấu hỗ trợ bảng đấu (bracket) và bảng xếp hạng cập nhật trực tiếp.
Trạng thái: Built (P1 sự kiện · vé · đăng ký · check-in) · In-progress (P2 bảng đấu · xếp hạng · waitlist) · Map từ: OW-05
1. Định danh
| Thuộc tính | Giá trị |
|---|---|
| Module ID | OW-05 |
| Hạng | Core |
| Trạng thái | In-progress |
| Giai đoạn | P1 (sự kiện · vé · đăng ký · check-in QR) · P2 (bracket · xếp hạng) |
| Ưu tiên | MEDIUM |
| Người dùng chính | Chủ sân · Quản lý ca · Thu ngân |
2. Mục đích & Phạm vi
| Bao gồm | Loại trừ |
|---|---|
| Tạo / sửa / huỷ / nhân bản sự kiện (giải đấu · lớp tập · open play) | Lịch Gantt & slot booking thường (do Đặt sân & Lịch sở hữu) |
| Cấu hình loại vé (VIP / Regular / Early Bird) với giá & số lượng | Khai báo sân & bảng giá (Quản lý Chi nhánh & Sân) |
| Đăng ký online qua app & bán vé tại quầy | Cổng thanh toán (do Bán hàng POS sở hữu) |
| QR code vé & check-in người tham dự | Hồ sơ khách hàng CRM (do Khách hàng sở hữu) |
| Tự động khoá sân khi publish & giải phóng khi kết thúc | Báo cáo doanh thu sự kiện (do Báo cáo sở hữu) |
| Bảng đấu (bracket) & bảng xếp hạng live | |
| Mã giảm giá vé · danh sách chờ (waitlist) |
3. Năng lực
| Năng lực | Người dùng làm được gì | Trạng thái |
|---|---|---|
| Danh sách sự kiện | Xem list/grid với tên, loại, ngày, trạng thái, số người đăng ký | Built |
| Tạo sự kiện | Form: tên · loại · mô tả · ngày giờ · sân · sức chứa · banner | Built |
| Sửa / huỷ sự kiện | Sửa khi chưa có người đăng ký; huỷ → tự thông báo & hoàn vé | Built |
| Tự động khoá sân | Khi publish, tự block slot trên Gantt; giải phóng khi kết thúc/huỷ | Built |
| Cấu hình loại vé | Tạo VIP / Regular / Early Bird với giá và số lượng riêng | Built |
| Bán vé online & tại quầy | Khách đăng ký + thanh toán qua app; Thu ngân bán vé tại POS | Built |
| Danh sách đăng ký | Xem người đăng ký, trạng thái thanh toán & check-in (VD 45/60 slot) | Built |
| QR code vé | Mỗi vé có QR riêng dùng một lần để check-in nhanh | Built |
| Check-in vé | Quét QR hoặc tìm theo tên/SĐT để đánh dấu đã tham dự | Built |
| Mã giảm giá · waitlist | Tạo voucher giảm vé; tự tạo danh sách chờ khi hết vé | In-progress |
| Bảng đấu (bracket) | Tạo knock-out / round-robin / group stage; cập nhật kết quả từng trận | In-progress |
| Bảng xếp hạng live | Xếp hạng cập nhật trực tiếp khi có kết quả mới | In-progress |
4. Phụ thuộc Module
| Phụ thuộc vào | Lý do |
|---|---|
| Đặt sân & Lịch | Tự khoá slot sân khi sự kiện publish; giải phóng khi kết thúc/huỷ |
| Bán hàng POS | Bán vé tại quầy và xử lý thanh toán/hoàn tiền vé |
| Khách hàng | Danh sách người đăng ký lấy từ hồ sơ khách hàng; push thông báo theo CRM |
| Phân quyền | Phạm vi chi nhánh; RBAC kiểm soát quyền tạo/huỷ sự kiện và bán vé |
5. Backend Packages
Chi tiết triển khai nằm trong tài liệu lập trình viên - mục này chỉ ánh xạ module tới các service vận hành nó.
| Package | Vai trò | Tài liệu lập trình viên |
|---|---|---|
@nx/events | Sở hữu vòng đời sự kiện, vé & đăng ký, QR check-in, khoá/giải phóng sân | events |
@nx/tournament | Bảng đấu (bracket), cập nhật kết quả & bảng xếp hạng live | tournament |
6. Luồng người dùng chính
Tạo sự kiện & publish
Đăng ký online & check-in
Huỷ sự kiện
7. Vai trò & Phân quyền
| Vai trò | Được phép | Không được phép |
|---|---|---|
| Chủ sân | Toàn quyền tạo/sửa/huỷ sự kiện, cấu hình vé, mã giảm giá, bảng đấu; xem doanh thu sự kiện (mọi chi nhánh) | - |
| Quản lý ca | Tạo/sửa/publish/huỷ sự kiện, bán vé, check-in, quản lý bracket (chi nhánh được phân công) | - |
| Thu ngân | Bán vé tại quầy, check-in người tham dự | Tạo/sửa/huỷ sự kiện · cấu hình vé · bracket |
| Xem báo cáo | Xem danh sách sự kiện & số lượng đăng ký | Mọi thao tác chỉnh sửa và bán vé |
8. Trạng thái & Lộ trình
| Giai đoạn | Năng lực |
|---|---|
| P1 | Tạo/sửa/huỷ sự kiện, tự khoá sân khi publish, cấu hình loại vé, bán vé online & tại quầy, danh sách đăng ký, QR code & check-in, hoàn vé khi huỷ |
| P2 | Nhân bản & sự kiện định kỳ, mã giảm giá, waitlist tự động, bảng đấu (knock-out/round-robin), bảng xếp hạng live, streaming integration |
| P3 | Thống kê giải đấu chi tiết, hệ thống xếp hạng ELO/DUPR tích luỹ, giải đấu liên cơ sở |
9. Trang liên quan
- Đặt sân & Lịch · Quản lý Chi nhánh & Sân
- Bán hàng POS · Khách hàng · Báo cáo
- Phân quyền
- Tài liệu lập trình viên: Events Service · Tournament Service