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 + Emotion | Giao diện (Minimal UI). FullCalendar hiển thị lịch buổi chơi, ApexCharts làm thống kê. |
| react-hook-form + zod | Form đăng ký và validate dữ liệu. |
| Prisma + PostgreSQL | Mô 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. |
| grammY | Telegram bot chạy qua webhook có secret: gửi thông báo, inline keyboard để admin xác nhận thanh toán. |
| jose + bcryptjs | Admin đăng nhập bằng mã PIN (băm bcrypt), phiên là JWT. |
| VietQR | Tạo ảnh QR chuyển khoản đúng số tiền của từng người. |
| Agent API | Endpoint 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 + ArgoCD | Image Node alpine. GitHub Actions build (buildx + cache) rồi cập nhật repo gitops; ArgoCD triển khai. |