FLYER Teacher · PRD · Sprint 110
⚔️ Thách đấu
Phòng thi đấu realtime cho học sinh — tạo không khí lớp học và sự kiện: mở phòng với một đề, học sinh vào bằng link/mã, xếp hạng trực tiếp, xuất báo cáo gửi phụ huynh.
📈 Số liệu production (15/08/2026)Chưa có bảng dữ liệu trên read-replica cho tính năng này — cần thêm khi có backend/quyền đọc.
🔗 Link mẫu trên productThách đấu ↗Demo ↗tài khoản demo GV: 984855668 (CB Cái Bè) · bản demo tĩnh không cần đăng nhập
1Bối cảnh & mục tiêu
Phòng thi đấu realtime cho học sinh — tạo không khí lớp học và sự kiện: mở phòng với một đề, học sinh vào bằng link/mã, xếp hạng trực tiếp, xuất báo cáo gửi phụ huynh.
- Tăng hứng thú học qua thi đấu
- Công cụ sự kiện cho trung tâm
- Kết quả gửi phụ huynh tạo điểm chạm
2Người dùng & user stories
| Vai trò | User story | Ưu tiên |
|---|---|---|
| Giáo viên | Mở phòng thách đấu nhanh cho lớp với đề tự chọn. | P0 |
| Giáo viên | Theo dõi kết quả từng học sinh, gửi phụ huynh. | P1 |
3Phạm vi & phase
| Phase | Nội dung | Trạng thái |
|---|---|---|
| Phase 1 | Tạo phòng + mời + theo dõi + xuất Excel + kết thúc | Done |
| Phase 2 | Xử lý userErrors khi kết thúc phòng (đã vá) | Done |
| Phase 3 | IELTS thách đấu — đã đánh giá, ưu tiên thấp (backlog 108) | Đề xuất |
4Luồng sản phẩm
- Tạo phòng → gửi link/mã cho lớp → thi đấu realtime → xếp hạng → xuất Excel/gửi phụ huynh
5Spec UI — cho Designer
- Bảng phòng: trạng thái màu (Đã kết thúc/Đang diễn ra/Chưa bắt đầu), hành động trong popover
- Modal tạo phòng: tên + mật khẩu tuỳ chọn + cấp độ + chọn đề (kể cả Mix) + danh sách mời
- Chi tiết: bảng người chơi điểm/đúng/sai/chưa làm + trạng thái
- Toàn bộ theo design system FLYER Teacher: antd 6 + Tailwind, màu chủ đạo tím
#955DCB(primary), chữ#212B36, phụ#637381, viền#EEF0F2, bo góc 8–16px, font Public Sans. - Song ngữ VI/EN qua next-translate; mọi trạng thái lọc/tab persist trên URL để share được link.
6Business rules
| Rule | Định nghĩa |
|---|---|
| Mật khẩu phòng | Tuỳ chọn; có thì bắt buộc nhập khi join |
| Kết thúc phòng | Khoá nộp ngay; lỗi phân quyền/đã kết thúc báo riêng |
| Đề Mix | Theo flag enable_is_mix |
7Data & API — cho Developer
- GraphQL v2 PartnerViewerChallengeCreate/Invite/End
- Route: /challenge, /challenge/[code]
8Edge cases đã xử lý
| Case | Hành vi chuẩn |
|---|---|
| Kết thúc phòng 2 lần | Báo "đã kết thúc" thay vì lỗi chung |
| HS vào phòng đã đóng | Thông báo phòng kết thúc |
| Không có quyền kết thúc | Báo lỗi phân quyền riêng |
| Trạng thái rỗng | Mọi bảng/danh sách có Empty state riêng kèm CTA hành động kế tiếp |
| Đang tải | Skeleton/Spin cho khối dữ liệu; nút hành động disable khi thiếu điều kiện |
9Acceptance criteria
- Phòng có mật khẩu chặn người ngoài
- Kết thúc phòng khoá nộp ngay
- Excel xuất đủ người chơi
10Ngoài phạm vi / tương lai
- Thách đấu liên lớp/liên trường
- Giải đấu theo mùa với bảng xếp hạng
← Danh mục 20 tính năng · Nguồn: quét trực tiếp codebase branch dev + backlog sprint 104–108 · 14/08/2026.