Tổng quan Dự án Capminton

Capminton là hệ thống xử lý video cầu lông thông minh ứng dụng AI (Badminton AI Video Processor). Dự án đóng vai trò như một công cụ tiền xử lý (pre-processing tool), tự động nhận diện và trích xuất các pha cầu kịch tính (rallies), loại bỏ khoảng thời gian chết (dead time như nhặt cầu, nghỉ giữa hiệp, chuẩn bị giao cầu) và tự động tính toán điểm số để xuất ra các clip ngắn sẵn sàng biên tập hoặc đăng tải lên các nền tảng mạng xã hội như CapCut, TikTok, Facebook Reels.

Định vị Sản phẩm

• Giải pháp trọng tâm: Thay thế việc người dùng phải kéo dòng thời gian (timeline scrubbing) và cắt ghép thủ công hàng chục phút video trận đấu để tìm highlight.

• Hỗ trợ biên tập: Cung cấp đầu ra là các clip rally chất lượng cao, có sẵn bảng điểm đè (Scoreboard Overlay) để người dùng dễ dàng chỉnh sửa nâng cao trên các ứng dụng dựng video chuyên nghiệp.

---

Các Chức Năng Chính Trên Phiên Bản Website Hiện Tại

Hệ thống hoạt động thông qua một ứng dụng web trực quan, kết nối đồng bộ với backend FastAPI xử lý tác vụ AI. Dưới đây là các tính năng và trang chức năng đã được hiện thực hóa:

1. Trang Chủ (Home Page)

• AI Engine Status: Hiển thị huy hiệu trạng thái hoạt động của công cụ AI thời gian thực (Active/Inactive).

• Thao tác nhanh:

  • Xử lý video mới: Chuyển hướng người dùng đến khu vực tải video lên.

  • Thư viện video: Xem lại danh sách các video đã được phân tích và lưu trữ trong hệ thống.

• Tóm tắt quy trình: Trình bày trực quan quy trình 3 bước xử lý: Tải video lên -> AI tự động phân tích -> Xuất clip thành phẩm.

2. Tải Lên Video Trận Đấu (Upload Page)

• Vùng tải lên thông minh: Hỗ trợ kéo thả video (Drag & Drop) hoặc bấm để chọn tệp trực tiếp từ thiết bị (Hỗ trợ định dạng MP4, MOV với dung lượng tối đa lên đến 500MB).

• Tự động trích xuất Metadata tại Client: Trước khi bắt đầu tải lên, trình duyệt tự động đọc thông số video (độ phân giải, thời lượng, tên tệp, định dạng) để đồng bộ thông tin cấu hình với server.

• Quy trình tải lên tối ưu (Presigned URL):

  • Khởi tạo tải lên thông qua API để nhận Presigned URL kết nối trực tiếp đến S3 Cloud Storage.

  • Đo lường và hiển thị thanh tiến trình tải lên chi tiết (Tỉ lệ %, dung lượng đã tải trên tổng dung lượng, tốc độ truyền tải MB/s, thời gian đã trôi qua).

  • Tự động xác nhận trạng thái tải lên với Backend để kích hoạt Pipeline xử lý AI.

• Mẹo quay phim tối ưu: Cung cấp hướng dẫn chi tiết cho người chơi để AI nhận dạng chính xác nhất (sử dụng tripod tĩnh, góc quay toàn cảnh từ phía sau sân, đủ ánh sáng, không zoom).

3. Theo Dõi Tiến Trình Xử Lý AI (Processing Page)

• Giám sát thời gian thực: Hiển thị thanh tiến trình xử lý tổng quát kèm thời gian dự kiến hoàn thành (ETA) dựa trên hiệu suất của server.

• Quy trình Pipeline 5 bước minh bạch: Theo dõi trực quan trạng thái của từng bước trong luồng xử lý AI:

  1. Tải video lên (uploading)

  2. Nhận diện sân cầu lông (detecting_court)

  3. Phát hiện và tách rally (extracting_rallies)

  4. Phân tích điểm số (analyzing_scores)

  5. Tạo file xuất (creating_export)

• Hủy tác vụ: Cho phép người dùng dừng tiến trình xử lý bất kỳ lúc nào nếu muốn thay đổi.

4. Bảng Kết Quả Phân Tích (Results Page)

• Thống kê tổng quan: Hiển thị tổng số pha rally được phát hiện, tổng thời lượng video gốc và tỉ số chung cuộc của trận đấu.

• Bảng điểm trực quan: Hiển thị tỉ số chi tiết giữa hai bên sân (TRÊN và DƯỚI), làm nổi bật bên có điểm số cao hơn.

• Dòng thời gian Rally (Rally Overview Timeline): Trục timeline hiển thị vị trí phân bố của tất cả các pha rally trong toàn bộ video gốc, cho phép bấm vào để xem nhanh.

• Danh sách các Rally (Rally List):

  • Mỗi rally đi kèm ảnh thu nhỏ (thumbnail) tương ứng, thời điểm bắt đầu/kết thúc, thời lượng chi tiết của pha bóng đó.

  • Hiển thị diễn tiến tỉ số tại thời điểm pha bóng đó diễn ra để người dùng dễ theo dõi.

  • Tích chọn hộp kiểm để chuẩn bị cho việc xuất video hàng loạt.

5. Chi Tiết & Tinh Chỉnh Rally (Rally Detail & Editor Page)

• Trình phát Video thông minh: Tích hợp bảng điểm đè (Scoreboard Overlay) hiển thị trực tiếp trên video.

• Chế độ phát lặp lại (Loop Playback): Tự động phát lặp lại liên tục trong giới hạn thời gian của rally hiện tại giúp người dùng xem kỹ pha bóng.

• Điều khiển tua nhanh: Nút tua đi/tua lại nhanh 3 giây tiện lợi.

• Bộ chỉnh sửa thời lượng (Rally Trim Editor): Cho phép người dùng kéo thả thanh trượt dòng thời gian để tinh chỉnh lại điểm bắt đầu và kết thúc của rally một cách chính xác nhất.

• Sửa điểm thủ công (Score Correction): Trường hợp AI nhận diện điểm sai, người dùng có thể nhấp vào nút "Sửa điểm" để cập nhật lại tỉ số của rally đó. Hệ thống sẽ tự động cập nhật lại progression diễn tiến điểm số tiếp theo.

• Điều hướng nhanh: Hỗ trợ chuyển đổi qua lại giữa rally trước/sau bằng các nút mũi tên nhanh mà không cần quay lại trang kết quả.

6. Xuất Video Linh Hoạt (Exporting Features)

• Cấu hình xuất nâng cao:

  • Ghép thành 1 video duy nhất (Merged): Nối tiếp tất cả các pha rally đã chọn thành một video liền mạch đã loại bỏ hết thời gian chết.

  • Tách thành các video riêng lẻ (Individual):

    • Trên máy tính: Đóng gói tất cả các rally thành một tệp nén ZIP duy nhất.

    • Trên điện thoại (Mobile): Hỗ trợ tải trực tiếp từng video ngắn vào Thư viện ảnh (Camera Roll) hoặc kích hoạt tải xuống hàng loạt với cơ chế delay chống nghẽn trình duyệt.

• Cấu hình bảng điểm (Scoreboard Settings):

  • Tùy chọn bật/tắt hiển thị bảng điểm đè lên video.

  • Cho phép cá nhân hóa tên đội/tên người chơi (Team Top, Team Bottom) hiển thị trực tiếp trên bảng điểm.

---

Luồng Trải Nghiệm Người Dùng (User Flow)

[Chọn/Kéo thả Video] -> [Upload trực tiếp lên S3] -> [Theo dõi AI phân tích (5 bước)]
                                                                    │
[Xuất thành phẩm (Merged/ZIP/Lưu Gallery)] <- [Tinh chỉnh Trim/Sửa điểm] <- [Kết quả phân tích]