FLYER Học sinh (exam.flyer.us) · PRD · Sprint 110
⚔️ Thách đấu (học sinh)
Học sinh tự tạo phòng thách đấu bạn bè (không cần giáo viên): chọn đề, hẹn giờ, đặt mật khẩu, mời qua link/FB/Zalo — thi đấu có bảng xếp hạng realtime ngay trong lúc làm bài.
📈 Số liệu production (15/08/2026)Chưa có bảng dữ liệu tương ứng trên read-replica.
1Bối cảnh & mục tiêu
Học sinh tự tạo phòng thách đấu bạn bè (không cần giáo viên): chọn đề, hẹn giờ, đặt mật khẩu, mời qua link/FB/Zalo — thi đấu có bảng xếp hạng realtime ngay trong lúc làm bài.
- Biến luyện đề thành trò chơi xã hội
- Kênh viral tự nhiên (mời bạn qua link)
- Giữ chân nhóm bạn học cùng nhau
2Người dùng & user stories
| Vai trò | User story | Ưu tiên |
|---|---|---|
| Học sinh | Tạo phòng nhanh với đề yêu thích, gửi mã cho bạn. | P0 |
| Học sinh | Xem mình đứng thứ mấy ngay trong lúc làm. | P0 |
3Phạm vi & phase
| Phase | Nội dung | Trạng thái |
|---|---|---|
| Phase 1 | Sảnh + tạo phòng + join bằng mã + live ranking | Done |
| Phase 2 | Tuỳ chọn: ẩn tên thử thách, giới hạn 1 lần làm, mật khẩu, tên ngẫu nhiên | Done |
| Phase 3 | IELTS thách đấu (đánh giá thấp ưu tiên — backlog 108) | Đề xuất |
4Luồng sản phẩm
- SẢNH THÁCH ĐẤU → Tạo phòng nhanh → chọn đề + hẹn giờ + tuỳ chọn → Copy link mời bạn
- Bạn bè nhập mã ở /libraries hoặc link → cùng làm → bảng xếp hạng phòng realtime
5Spec UI — cho Designer
- Sảnh: tab Đấu trường/Phòng của tôi, trạng thái Đang diễn ra/Chưa bắt đầu/Kết thúc
- Phòng chờ: đếm ngược ngày-giờ-phút-giây, số người tham gia, chia sẻ FB/Zalo
- Trong bài thi: LiveRanking panel; kết thúc xem /leader-board-challenge (top 10)
- Thiết kế "vũ trụ FLYER" cho trẻ em: nền không gian, hành tinh Lottie, mascot Bingo; vi/en (mặc định vi).
- Ứng dụng exam là Next.js Pages Router + GraphQL v2 + REST v3/v4; deep-link ứng dụng mobile flyer-exam://.
6Business rules
| Rule | Định nghĩa |
|---|---|
| Mật khẩu phòng | Tuỳ chọn; cần nhập khi join |
| Giới hạn tham gia | Bật = mỗi người chỉ làm 1 lần |
| Đề premium | Join phòng đề khoá → nhắc nâng cấp |
7Data & API — cho Developer
- GraphQL v2 challenge create/invite; mã phòng dạng code; (bảng challenges chưa expose trên replica)
- Route: /challenges, /create-challenge, /join-challenge/*, /leader-board-challenge/[id]
8Edge cases đã xử lý
| Case | Hành vi chuẩn |
|---|---|
| Phòng kết thúc | Không cho nộp thêm; join hiện phòng đã đóng |
| Đề cần quyền | "Ui da! Đề này cần quyền truy cập…" |
| Khách chưa đăng nhập | Được làm thử/preview; toast + modal nhắc đăng nhập để lưu kết quả |
| Mạng chậm | Cảnh báo cáp quang/network chậm (remote config); SpeedTest ở home |
9Acceptance criteria
- Mã phòng join được từ cả 2 lối (libraries + link)
- Ranking cập nhật trong lúc làm
- Giới hạn 1 lần chặn lần làm thứ 2
10Ngoài phạm vi / tương lai
- IELTS thách đấu (ưu tiên thấp)
- Giải đấu liên trường theo mùa
← Danh mục PRD · Nguồn: quét codebase flyer-webs/apps/exam + số liệu read-replica production · 15/08/2026.