⚽ PengoDocs
Trang chủ 🌐

Hướng Dẫn Đặt Sân & Vận Hành Sân Thể Thao

Tài liệu hướng dẫn toàn diện về hệ thống sân thể thao trên nền tảng Pengo, bao gồm cẩm nang dành cho Khách chơi thể thao (Người dùng) muốn tìm kiếm & đặt sân online, và hướng dẫn dành cho Chủ cơ sở sân (Pitch Owner) về đăng ký mở sân, thiết lập bảng giá, khóa sân và duyệt đơn đặt sân.

1. Tổng Quan Hệ Thống Sân Pengo

Hệ thống sân thể thao Pengo được thiết kế nhằm kết nối liền mạch giữa Người chơi thể thao, Host tổ chức trận đấu/giải đấu và Chủ cơ sở sân:

  • 100% Không Dùng Tiền Mặt (Cashless): Toàn bộ giao dịch đặt sân trực tuyến được thanh toán trực tiếp tới tài khoản ngân hàng của chủ sân qua mã VietQR động, đảm bảo minh bạch, chính xác từng đồng và loại bỏ rủi ro thất thoát tiền mặt.
  • Cơ Chế Giữ Chỗ 5 Phút (5-Minute Hold): Khi khách mở màn hình thanh toán, khung giờ được khóa tạm thời trong 5 phút để khách an tâm chuyển khoản mà không lo bị người khác đặt mất.
  • Bằng Chứng Chuyển Khoản Trực Tiếp (Proof of Transfer): Khách hàng tải ảnh chụp biên lai ngân hàng, chủ sân trực tiếp đối soát và bấm phê duyệt.
  • Quản Lý Lịch Sân Đa Năng Cho Chủ Sân: Hỗ trợ từ cấu hình giờ hoạt động, chia sân con, cài bảng giá linh hoạt (giờ thường, giờ vàng), đến khóa sân bảo trì, cài lịch khách quen định kỳ và đặt sân nhanh cho khách vãng lai tại quầy.

2. Cẩm Nang Dành Cho Người Chơi (Khách Đặt Sân)

2.1. Khám Phá & Tìm Kiếm Sân Thể Thao

Người chơi có thể dễ dàng tìm kiếm sân phù hợp trên ứng dụng Web hoặc Mobile:

  1. Tìm kiếm theo Vị trí & Bán kính (GPS):
    • Cho phép ứng dụng truy cập vị trí hiện tại để tự động sắp xếp các sân gần bạn nhất (kèm khoảng cách tính theo km).
    • Lọc theo khu vực Quận/Huyện, Thành phố.
  2. Lọc theo Môn thể thao:
    • Cầu lông, Pickleball, Bóng đá, Tennis, Bóng rổ...
  3. Lọc theo Khung giờ rảnh:
    • Chọn ngày thi đấu (hôm nay, ngày mai hoặc một ngày cụ thể).
    • Chọn ca rảnh: Ca Sáng (trước 12:00), Ca Chiều (12:00 - 17:00), hoặc Ca Tối (sau 17:00). Hệ thống sẽ tự động lọc ra những sân còn ít nhất 1 slot trống trong ca đó.

2.2. Xem Thông Tin Chi Tiết Sân

Tại trang chi tiết của sân (/field/[slug]), bạn có thể xem:

  • Hình ảnh thực tế: Không gian sân, mặt thảm, hệ thống ánh sáng, khu vực khán đài.
  • Sơ đồ sân con: Bố cục các sân con (Sân 1, Sân 2...) để bạn chọn vị trí đánh ưa thích.
  • Bảng giá niêm yết: Mức giá theo từng khung giờ trong ngày và cuối tuần.
  • Tiện ích đi kèm: Bãi đỗ xe ô tô/xe máy, máy lạnh, wifi, quầy nước giải khát, cho thuê vợt/giày.
  • Thông tin liên hệ & Chỉ đường: Địa chỉ chuẩn xác, nút mở bản đồ Google Maps và số hotline của sân.

2.3. Quy Trình Đặt Sân Online 4 Bước Siêu Tốc

[ Bước 1: Chọn Ngày & Slot trên Timeline ]
                 │
                 ▼
[ Bước 2: Đồng Hồ Giữ Chỗ 5:00 Bắt Đầu ]
                 │
                 ▼
[ Bước 3: Quét VietQR & Chuyển Khoản Chính Xác ]
                 │
                 ▼
[ Bước 4: Tải Ảnh Bill & Gửi Yêu Cầu Duyệt ]

Bước 1: Chọn Ngày & Khung Giờ Trên Bảng Timeline Grid

  • Chọn ngày thi đấu trên Thanh chọn ngày (Date Selector) (hỗ trợ xem trước tối đa 14 ngày).
  • Bảng Timeline hiển thị trực quan từng sân con (subPitch) và từng khung giờ:
    • 🟩 Màu xanh lá: Còn trống ──> Bấm để chọn.
    • 🟨 Màu vàng/cam có dấu tick ✓: Bạn đang chọn (hiển thị đơn giá cụ thể).
    • 🟥 Màu đỏ: Đã có người đặt hoặc sân đã khóa ──> Không thể chọn.
    • ⬜ Màu xám: Khung giờ đã trôi qua so với giờ hiện tại.
  • Bạn có thể chọn nhiều khung giờ liên tiếp hoặc trên các sân con khác nhau trong cùng một đơn đặt.
  • Thanh Dock nổi phía dưới màn hình sẽ hiển thị tổng số slot và tổng số tiền tạm tính. Bấm "Tiến hành đặt sân".

Bước 2: Nhập Số Điện Thoại & Kích Hoạt Giữ Chỗ 5 Phút

  • Nhập số điện thoại liên hệ của bạn (số di động Việt Nam 10 số). Hệ thống sẽ tự động ghi nhớ cho các lần đặt sau.
  • Cửa sổ thanh toán xuất hiện kèm Đồng hồ đếm ngược 05:00:
    • Khung giờ bạn chọn chính thức được khóa cho riêng bạn trong vòng 300 giây.
    • Người dùng khác trên hệ thống sẽ thấy khung giờ này chuyển sang trạng thái "Đang giữ chỗ" và không thể can thiệp.
    • Lưu ý: Nếu quá 5 phút mà bạn chưa gửi biên lai xác nhận, hệ thống sẽ tự động hủy giữ chỗ để nhường cho người khác.

Bước 3: Quét Mã VietQR Chuyển Khoản Chuẩn Xác

  • Hệ thống tự động tạo mã VietQR động có chứa sẵn:
    • Tên ngân hàng & Số tài khoản: Tài khoản ngân hàng chính chủ của chủ cơ sở sân.
    • Số tiền: Khớp chính xác 100% với tổng tiền đơn đặt sân.
    • Nội dung chuyển khoản chuẩn: Được sinh tự động (Ví dụ: PENGO SANYONEX 84920).
  • Người chơi mở ứng dụng ngân hàng bất kỳ (Vietcombank, MBBank, Techcombank, VPBank, MoMo...) và chọn Quét mã QR.
  • Kiểm tra lại thông tin và xác nhận chuyển khoản.

Bước 4: Tải Ảnh Biên Lai (Bill) & Bấm Hoàn Tất

  • Sau khi chuyển khoản thành công trên app ngân hàng, hãy chụp ảnh màn hình biên lai giao dịch.
  • Bấm "Tải ảnh biên lai / Bill chuyển khoản" để tải ảnh lên hệ thống.
  • Khi ảnh hiển thị dấu tick xanh hợp lệ, bấm nút "Tôi đã chuyển khoản thành công".
  • Đơn đặt sân chuyển sang trạng thái Chờ duyệt (Pending). Chủ sân nhận được thông báo ngay lập tức để kiểm tra tài khoản.

2.4. Theo Dõi & Quản Lý Đơn Đặt Sân Của Bạn

  • Truy cập mục "Lịch sử đặt sân" trong trang cá nhân:
    • Chờ duyệt (Pending): Bạn đã nộp biên lai, đang chờ chủ sân đối soát. Ở trạng thái này, nếu bạn đổi ý hoặc bận đột xuất, bạn có thể bấm "Hủy đơn" để giải phóng slot.
    • Đã xác nhận (Confirmed): Chủ sân đã nhận đủ tiền và duyệt đơn. Khung giờ chính thức thuộc về bạn. Bạn chỉ cần đến sân đúng giờ và xuất trình mã đơn trên app để nhận sân.
    • Đã hủy / Từ chối (Cancelled): Đơn bị từ chối kèm lý do rõ ràng từ chủ sân (ví dụ: Chưa nhận được tiền, Sai số tiền, hoặc bạn tự hủy đơn).
  • Quy định khi đến sân:
    • Vui lòng có mặt trước giờ thi đấu từ 5 - 10 phút.
    • Mang giày thể thao chuyên dụng phù hợp với mặt thảm sân để bảo quản cơ sở vật chất.

3. Cẩm Nang Dành Cho Chủ Cơ Sở Sân (Pitch Owner)

3.1. Quy Trình Đăng Ký Mở Sân Mới Trên Pengo

Chủ sân hoặc ban quản lý cơ sở thể thao có thể đăng ký gia nhập nền tảng Pengo theo 4 bước:

[ Nộp Hồ Sơ Đăng Ký Sân ] ──> [ Ban Quản Trị Xét Duyệt ] ──> [ Tự Động Xuất Bản Sân ] ──> [ Cấp Quyền Chủ Sân (OWNER) ]
  1. Truy cập biểu mẫu Đăng ký: Vào trang /field/create trên giao diện Web.
  2. Điền thông tin cơ sở sân:
    • Tên cơ sở sân: Tên thương hiệu rõ ràng (Ví dụ: CLB Cầu Lông Ngôi Sao - Chi nhánh 1).
    • Địa chỉ chi tiết: Số nhà, tên đường, phường/xã, quận/huyện, tỉnh/thành phố.
    • Tọa độ GPS: Chọn trên bản đồ hoặc nhập Latitude / Longitude để người chơi tìm thấy sân qua tính năng "Tìm sân gần đây".
    • Số điện thoại Hotline: Số liên hệ chính của sân để khách liên lạc khi cần.
    • Loại hình thể thao: Cầu lông, Bóng đá, Pickleball, v.v.
  3. Tải lên hình ảnh quảng bá:
    • Logo sân: Ảnh đại diện thương hiệu.
    • Album ảnh sân: Ít nhất 3 - 5 ảnh chụp góc rộng sân, ánh sáng, thảm đấu và tiện ích.
    • Ảnh sơ đồ sân (Diagram): Sơ đồ số thứ tự từng sân con để khách dễ hình dung.
    • Ảnh bảng giá: Bảng giá niêm yết chụp thực tế tại sân.
  4. Nộp hồ sơ minh chứng quyền sở hữu:
    • Họ tên người đại diện, số điện thoại, email.
    • Tải lên ảnh giấy tờ chứng minh (Giấy chứng nhận đăng ký kinh doanh, Hợp đồng thuê mặt bằng, hoặc Giấy ủy quyền quản lý sân).
  5. Xét duyệt & Kích hoạt:
    • Đội ngũ quản trị Pengo sẽ kiểm tra và phê duyệt hồ sơ trong vòng 12 - 24 giờ.
    • Ngay khi được duyệt:
      • Sân tự động được chuyển sang trạng thái Đã xuất bản (isPublished: true) và hiển thị trên kết quả tìm kiếm.
      • Tài khoản của bạn được nâng cấp lên vai trò Chủ sân (OWNER), mở khóa toàn bộ công cụ quản trị trong Dashboard Quản Lý Sân.

3.2. Cấu Hình Vận Hành Cơ Sở Sân (pitchConfigs)

Trong trang quản trị sân, chủ sân thiết lập các thông số vận hành cốt lõi:

Thông số cấu hình Ý nghĩa Ví dụ thiết lập
Giờ mở cửa (openAt) Thời điểm sân bắt đầu đón khách trong ngày 05:30
Giờ đóng cửa (closeAt) Thời điểm sân tắt đèn và kết thúc ca cuối 23:00
Ngày hoạt động (openDays) Các ngày trong tuần sân mở cửa 2,3,4,5,6,7,CN (Mở cả tuần)
Thời lượng Slot (slotDuration) Độ dài mỗi khung giờ đặt sân (phút) 60 (1 tiếng) hoặc 30 (30 phút)

[!WARNING]
Quy tắc an toàn dữ liệu: Hệ thống sẽ ngăn chặn việc thay đổi thời lượng slot (slotDuration) nếu sân đang có đơn đặt sân trong tương lai hoặc có lịch khóa sân định kỳ. Chủ sân cần xử lý xong các đơn hiện tại trước khi thay đổi quy cách slot.

3.3. Quản Lý Danh Sách Sân Con (subPitches)

Mỗi cơ sở sân thường có nhiều thảm đấu/sân con. Pengo hỗ trợ quản lý chi tiết từng sân:

  • Thêm sân con: Đặt tên định danh trực quan (ví dụ: Sân 1 (Thảm tiêu chuẩn), Sân 2, Sân VIP 1...).
  • Phân loại sân: Sân đơn, Sân đôi, Sân 5 người, Sân 7 người...
  • Bật/Tắt hoạt động (active): Nếu một sân con cụ thể cần thay thảm hoặc bảo dưỡng ngắn hạn, bạn chỉ cần gạt tắt nút kích hoạt của riêng sân đó mà không làm ảnh hưởng đến các sân con khác.

3.4. Thiết Lập Bảng Giá & Khung Giờ (timeSlots)

Hệ thống cho phép cài đặt giá linh hoạt theo từng ca và từng ngày:

  1. Khung giờ Ngày thường (Thứ 2 ──→ Thứ 6):
    • Giờ thấp điểm (06:00 - 17:00): Giá ưu đãi để kích thích khách chơi ban ngày (VD: 80.000 VNĐ / giờ).
    • Giờ vàng / Giờ cao điểm (17:00 - 21:00): Nhu cầu cao nhất trong ngày (VD: 130.000 VNĐ / giờ).
    • Giờ muộn (21:00 - 23:00): Mức giá điều chỉnh (VD: 100.000 VNĐ / giờ).
  2. Khung giờ Cuối tuần (Thứ 7 & Chủ Nhật):
    • Cài đặt mức giá riêng cho ngày nghỉ lễ và cuối tuần theo nhu cầu thực tế của cơ sở.
  3. Sinh khung giờ tự động (Batch Generate):
    • Công cụ tự động chia đều khoảng thời gian hoạt động thành các slot chuẩn theo slotDuration, giúp chủ sân không phải nhập tay từng giờ.

3.5. Quản Lý Timeline, Khóa Sân & Khách Vãng Lai (slotBlocks)

Bảng Timeline Trực Quan là trung tâm điều hành mọi hoạt động của sân theo thời gian thực:

Timeline Grid:
              [06:00 - 07:00]   [07:00 - 08:00]   ...   [17:00 - 18:00]   [18:00 - 19:00]
Sân 1:       [   Trống   ]     [ Khách Online ]         [ Khách Cố Định]  [ Khách Cố Định]
Sân 2:       [ Bảo Trì   ]     [   Trống      ]         [ Đặt Tại Quầy ]  [   Trống      ]
Sân 3:       [   Trống   ]     [   Trống      ]         [ Giải Đấu     ]  [ Giải Đấu     ]

1. Khóa sân linh hoạt (slotBlocks):

  • Khi có việc đột xuất, sửa chữa hệ thống đèn hoặc tổ chức giải nội bộ, chủ sân chỉ cần click vào slot trên Timeline và chọn:
    • Loại khóa: Bảo trì (Maintenance), Bận (Busy), hoặc Giải đấu (Tournament).
    • Ghi chú: Lý do khóa (VD: Thay dàn đèn LED).
    • Slot này sẽ lập tức bị ẩn/khóa trên giao diện của khách hàng.

2. Cài đặt Lịch Khách Cố Định Hàng Tuần (isRecurring):

  • Với khách chơi cố định tháng (VD: Nhóm anh Tuấn đánh cố định Thứ 3 - Thứ 5 hàng tuần từ 18:00 đến 20:00):
    • Chủ sân chọn slot ──> Bật tùy chọn "Lặp lại hàng tuần" (isRecurring: true).
    • Nhập tên khách, số điện thoại, ngày bắt đầu và ngày kết thúc hợp đồng.
    • Hệ thống tự động khóa khung giờ đó trên toàn bộ các tuần tiếp theo mà không cần phải bấm từng ngày.

3. Nhận Khách Vãng Lai (Walk-in) & Đặt Sân Tại Quầy:

  • Khi có khách đến chơi trực tiếp tại quầy hoặc gọi điện đặt sân gấp:
    • Bấm chọn slot trống trên Timeline ──> Chọn "Đặt nhanh tại quầy (Quick Walk-in)".
    • Nhập Tên khách hàng, Số điện thoại và Tiền thu.
    • Khung giờ được chuyển sang trạng thái đã đặt ngay lập tức, ngăn ngừa hoàn toàn tình trạng trùng lịch giữa khách tại quầy và khách đặt online.

4. Mở Khóa Sân (Unblock):

  • Khi khách cố định hủy lịch hoặc việc bảo trì hoàn tất sớm hơn dự kiến, chủ sân chỉ cần bấm vào slot đã khóa và chọn "Mở khóa slot" để sân sẵn sàng cho khách khác đặt online.

3.6. Tiếp Nhận, Đối Soát & Phê Duyệt Đơn Đặt Sân Online

Quy trình xử lý đơn đặt sân từ khách trực tuyến:

  1. Nhận thông báo tức thì:
    • Ngay khi khách hoàn tất chuyển khoản và nộp ảnh biên lai, bạn sẽ nhận được thông báo rung/chuông trên ứng dụng và thông báo trong mục quản trị.
  2. Kiểm tra thông tin & Xem ảnh biên lai:
    • Mở màn hình Quản lý Đơn đặt sân (/dashboard/pitch).
    • Bấm "Xem biên lai" để phóng to ảnh chụp giao dịch ngân hàng do khách tải lên.
    • Mở app ngân hàng của bạn để kiểm tra xem tiền đã vào tài khoản với đúng số tiền và nội dung hay chưa.
  3. Phê duyệt hoặc Từ chối:
    • Bấm Duyệt (Xác nhận): Đơn chuyển sang confirmed, slot chính thức được khóa cứng trên timeline, khách nhận được thông báo xác nhận thành công.
    • Bấm Từ chối: Nếu chưa nhận được tiền hoặc số tiền chuyển không khớp, bấm Từ chối và chọn/nhập lý do (VD: Chưa nhận được tiền chuyển khoản, Sai nội dung, Chuyển thiếu 20.000đ). Hệ thống sẽ gửi thông báo kèm lý do cho khách hàng.

3.7. Cài Đặt Thông Tin Ngân Hàng Nhận Tiền Trực Tiếp

Để khách quét mã VietQR chuyển thẳng vào tài khoản của bạn:

  1. Vào Trang cá nhân ──> Cài đặt ngân hàng.
  2. Chọn đúng Tên ngân hàng trong danh sách VietQR (Vietcombank, MB, Techcombank, ACB...).
  3. Nhập Số tài khoản và Tên chủ tài khoản (viết hoa không dấu).
  4. Bấm Lưu thông tin. Toàn bộ mã QR sinh ra cho các đơn đặt sân thuộc cơ sở của bạn sẽ tự động trỏ về tài khoản này.

4. Các Câu Hỏi Thường Gặp (FAQs)

Q1: Tôi đã quét mã chuyển khoản nhưng hết hạn 5 phút giữ chỗ thì xử lý thế nào?

  • Khách hàng: Nếu bạn đã chuyển khoản thành công nhưng đồng hồ đếm ngược vừa về 00:00, bạn vẫn có thể tải ảnh biên lai lên nếu slot đó chưa bị người khác chọn. Trong trường hợp slot bị người khác giữ mất, vui lòng liên hệ ngay số Hotline của chủ sân (hiển thị trên trang thông tin sân) để chủ sân đối soát và tạo slot thủ công hoặc hoàn lại tiền cho bạn.

Q2: Khách hàng có thể hủy đơn đặt sân đã thanh toán không?

  • Khi đơn đang ở trạng thái Chờ duyệt (Pending), khách có thể chủ động bấm Hủy đơn trên ứng dụng.
  • Khi đơn đã được chủ sân Xác nhận (Confirmed), khách không thể tự hủy trên app mà cần liên hệ trực tiếp với chủ sân qua số điện thoại để thỏa thuận theo chính sách hủy/đổi giờ riêng của từng cơ sở.

Q3: Ảnh biên lai chuyển khoản được lưu trữ ở đâu và có an toàn không?

  • Ảnh biên lai được lưu trữ an toàn trên dịch vụ lưu trữ đám mây Cloudflare R2 trong thư mục riêng biệt booking-proofs/. Hệ thống áp dụng chính sách tự động xóa vĩnh viễn ảnh biên lai cũ sau 30 ngày, vừa giúp bảo mật tuyệt đối thông tin tài khoản của khách vừa tối ưu dung lượng hệ thống.

Q4: Sân của tôi có nhiều chi nhánh thì quản lý như thế nào?

  • Bạn có thể đăng ký nhiều cơ sở sân khác nhau trên cùng một tài khoản Chủ sân (OWNER). Trong Dashboard quản trị, bạn có thể dễ dàng chuyển đổi qua lại giữa các cơ sở để theo dõi timeline và doanh thu độc lập.