FLYER Học sinh (exam.flyer.us) · PRD · Sprint 110
🏫 Lớp học & bài tập được giao
Cầu nối với FLYER Teacher: học sinh join lớp bằng mã, nhận "Nhiệm vụ được giao" với hạn nộp, trạng thái Cần Làm Lại, khoá đáp án/khoá bài theo cài đặt của giáo viên — cùng chương trình của trường và kỳ thi tập trung.
📈 Số liệu production (15/08/2026)1,13 triệu lượt học sinh trong lớp38.120 bài được giao/30 ngày
🔗 Link mẫu trên productJoin lớp bằng mã ↗Modal nhắc bài tập ↗đăng nhập tài khoản demo HS: 0909469666
1Bối cảnh & mục tiêu
Cầu nối với FLYER Teacher: học sinh join lớp bằng mã, nhận "Nhiệm vụ được giao" với hạn nộp, trạng thái Cần Làm Lại, khoá đáp án/khoá bài theo cài đặt của giáo viên — cùng chương trình của trường và kỳ thi tập trung.
- Join lớp không ma sát (mã 1 lần)
- Học sinh không sót bài tập: nhắc nhở + trạng thái rõ
- Tôn trọng cài đặt sư phạm của GV (ẩn đáp án, khoá hạn)
2Người dùng & user stories
| Vai trò | User story | Ưu tiên |
|---|---|---|
| Học sinh | Nhập mã lớp cô đưa để vào lớp và nhận bài. | P0 |
| Học sinh | Thấy rõ bài nào phải làm, hạn nộp, bài nào cần làm lại. | P0 |
| Học sinh | Vào phòng thi tập trung của trường đúng giờ. | P1 |
3Phạm vi & phase
| Phase | Nội dung | Trạng thái |
|---|---|---|
| Phase 1 | Join lớp/trường + mission + trạng thái + hạn nộp | Done |
| Phase 2 | Khoá bài sau hạn (allowLateSubmit) + ẩn đáp án + trial khi được thêm vào lớp | Done |
| Phase 3 | 1 HS nhiều lớp song song (documenting backlog 108) | Đề xuất |
4Luồng sản phẩm
- Nhận mã lớp → /join-class → chọn người chơi → nhập mã → vào lớp → tab Nhiệm vụ hiện bài được giao
- Làm bài giao → nộp → GV thấy realtime; bị yêu cầu làm lại → trạng thái "Cần Làm Lại"
- Kỳ thi trường: banner "Bạn đang trong phòng thi" + VÀO THI NGAY
5Spec UI — cho Designer
- Màn join: chọn learner profile + ô "Điền mã lớp"; thông báo đổi lớp nếu đang ở lớp khác
- Card nhiệm vụ: badge trạng thái (được giao/cần làm lại/hoàn thành), "Ngày nộp", "Giao bởi"
- RemindHomeworkModal "Nhắc nhẹ: Vẫn còn bài chưa xong nè!"; tab kỳ thi Sắp/Đang/Đã diễn ra
- 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 |
|---|---|
| Khoá bài hết hạn | "Bạn không thể bắt đầu làm bài vì đã hết hạn nộp." khi GV bật khoá |
| Ẩn đáp án | isHiddenAnswer chặn cả trang review + lịch sử |
| Làm lại sau hạn | Tính là tự luyện, không vào báo cáo bài giao |
| Giới hạn lớp | Lỗi join: đủ chỗ/đang rời lớp/đã ở trong lớp… có message riêng |
7Data & API — cho Developer
- class_students 1,13M; assign_tests theo profile_ids/class_ids; trạng thái profile_completed_ids
- Route: /join-class, /join-school, /mission, /libraries; deep-link bài AI ?assignTestCode=
8Edge cases đã xử lý
| Case | Hành vi chuẩn |
|---|---|
| Chưa có profile | Đẩy sang /create-profile rồi quay lại join |
| Link mời kèm checkpoint | Tự vào thẳng bài sau khi join |
| Rời lớp | LeaveClassModal xác nhận, có lỗi đang-rời-lớ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
- Join đúng lớp bằng mã, có xác nhận tên lớp
- Bài hết hạn không bắt đầu được khi GV khoá
- Đáp án ẩn hoàn toàn khi GV bật ẩn
- Trạng thái REDO hiện đúng sau khi GV yêu cầu làm lại
10Ngoài phạm vi / tương lai
- Nhiều lớp song song, bài ghi rõ từ lớp nào (backlog 108)
- Thông báo bài mới qua Zalo phụ huynh (nối Zalo OA)
← Danh mục PRD · Nguồn: quét codebase flyer-webs/apps/exam + số liệu read-replica production · 15/08/2026.