EN
Web app
Đang vận hành

SPARK Badminton

App đăng ký buổi chơi cầu lông theo nhóm: chia người vào sân, chia tiền sau buổi chơi, thanh toán bằng VietQR và xác nhận qua Telegram bot.

Thiết kế & phát triển

badminton.devbyspark.com

Bài toán

Nhóm chơi cầu lông mỗi buổi thuê nhiều sân. Trước buổi phải chốt ai đi, chia người vào sân. Sau buổi phải chia tiền sân, tiền cầu theo đầu người rồi đi đòi từng người. App gom các việc đó về một chỗ.

Tính năng

  • Buổi chơi và sân: mỗi buổi có nhiều sân, mỗi sân có giới hạn người, có báo khi sân sắp đủ.
  • Đăng ký: tự đăng ký hoặc đăng ký hộ, kèm trình độ. Huỷ bằng link riêng trước giờ chơi.
  • Chia tiền: admin nhập chi phí, app chia theo người và tạo mã VietQR.
  • Thanh toán: người chơi báo đã trả, admin xác nhận bằng nút bấm ngay trong tin nhắn Telegram.
  • API cho AI agent làm việc với dữ liệu buổi chơi.

Công nghệ sử dụng

Công nghệDùng để làm gì, dùng như thế nào
Next.js 14 (App Router + API Routes)Một ứng dụng chứa cả giao diện và API, build standalone, chạy trên Node.js.
MUI 6 + EmotionGiao diện (Minimal UI). FullCalendar hiển thị lịch buổi chơi, ApexCharts làm thống kê.
react-hook-form + zodForm đăng ký và validate dữ liệu.
Prisma + PostgreSQLMô hình dữ liệu buổi chơi, sân, người chơi, chi phí, thanh toán. Schema đồng bộ bằng prisma db push khi container khởi động.
grammYTelegram bot chạy qua webhook có secret: gửi thông báo, inline keyboard để admin xác nhận thanh toán.
jose + bcryptjsAdmin đăng nhập bằng mã PIN (băm bcrypt), phiên là JWT.
VietQRTạo ảnh QR chuyển khoản đúng số tiền của từng người.
Agent APIEndpoint riêng, xác thực bằng header khoá, để AI agent làm việc với dữ liệu buổi chơi.
Docker + Kubernetes + ArgoCDImage Node alpine. GitHub Actions build (buildx + cache) rồi cập nhật repo gitops; ArgoCD triển khai.
SPARK Badminton — Dự án của Vũ Xuân Bình