FLYER Học sinh (exam.flyer.us) · PRD · Sprint 110
💎 Gamification & phần thưởng
Hệ động lực giữ trẻ học mỗi ngày: Kim cương (mua/tặng — trả cho chấm AI), Coin & Sao (thu thập đổi vật phẩm), Streak ngày học, Quà tặng hàng ngày, Nhiệm vụ ngày theo CEFR, Thành tích đa cấp, khung avatar, bảng xếp hạng toàn quốc — và Đá Tri Thức nhận realtime từ giáo viên.
📈 Số liệu production (15/08/2026)51.858 học sinh active 30 ngày1,26 triệu bài nộp/30 ngày — nhiên liệu của mọi phần thưởng
1Bối cảnh & mục tiêu
Hệ động lực giữ trẻ học mỗi ngày: Kim cương (mua/tặng — trả cho chấm AI), Coin & Sao (thu thập đổi vật phẩm), Streak ngày học, Quà tặng hàng ngày, Nhiệm vụ ngày theo CEFR, Thành tích đa cấp, khung avatar, bảng xếp hạng toàn quốc — và Đá Tri Thức nhận realtime từ giáo viên.
- Học liên tục (streak + nhiệm vụ ngày)
- Kinh tế ảo lành mạnh: kiếm bằng học, tiêu cho AI/vật phẩm
- Cảm giác được ghi nhận từ giáo viên (Đá Tri Thức)
2Người dùng & user stories
| Vai trò | User story | Ưu tiên |
|---|---|---|
| Học sinh | Giữ streak, nhận quà ngày, hoàn thành nhiệm vụ ngày. | P0 |
| Học sinh | Tích kim cương/coin để chấm AI và mua khung avatar. | P0 |
| Học sinh | Nhận toast "+Đá Tri Thức" khi cô khen thưởng. | P0 |
3Phạm vi & phase
| Phase | Nội dung | Trạng thái |
|---|---|---|
| Phase 1 | Kim cương + coin/sao + streak + quà ngày + thành tích + xếp hạng | Done |
| Phase 2 | Daily Quest theo CEFR + Đá Tri Thức realtime (API v4) + recap năm/tháng | Done |
| Phase 3 | Đổi Coin của học sinh (backlog 108) + HUY HIỆU (đang "Sắp cập nhật") | Đề xuất |
4Luồng sản phẩm
- Làm bài → nhận coin/sao + tiến độ nhiệm vụ ngày → mở quà ngày → giữ streak
- Cô thưởng ở lớp → toast realtime + lịch sử "LỊCH SỬ KHEN THƯỞNG" (Đã nhận/Đã đổi)
- Xem hạng: /ranking theo Ngày/Tuần/Tháng/Năm, học sinh vs trường
5Spec UI — cho Designer
- Ví kép trên header (Kim cương + Coin); modal streak với lịch; DailyGift đếm ngược hết hạn
- Daily Quest card góc phải home, claim có Lottie
- Thành tích đa cấp: Nhà thám hiểm tập sự→huyền thoại, Tuần lễ Vàng→Kim Cương…
- Khung avatar mua bằng Sao, có loại vĩnh viễn/thời hạn
- 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 |
|---|---|
| Kim cương | 2 nguồn: Được tặng (hệ thống) vs Đã mua — hiển thị tách bạch; giá chấm AI từ 2 KC (mini) / 25 KC (full) |
| Streak | Mất khi bỏ ngày; có cảnh báo "Bạn sắp mất Streak rồi" |
| Đá Tri Thức | Chỉ học sinh thuộc lớp; nhận realtime; ví riêng do GV quản qua v4 |
7Data & API — cho Developer
- wallets; user_attempts làm nguồn điểm/hoạt động; wisdom-stones API v4 (chưa expose replica)
- Route: /diamonds-preview, /ranking, /invite-friends, /year-recap/*, modal streak/quest/gift
8Edge cases đã xử lý
| Case | Hành vi chuẩn |
|---|---|
| Thiếu coin mua khung | "Bạn không có đủ coin…" chặn mua |
| Claim quest trễ | Nhiệm vụ reset 23:59, không cộng bù |
| Đổi thưởng Đá vượt số dư | Backend v4 chặn (409) |
| 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
- Streak tính đúng theo ngày làm bài
- Quà ngày mỗi ngày 1 lần
- Toast Đá Tri Thức đến trong phiên đang mở
- Xếp hạng đổi kỳ Ngày/Tuần/Tháng/Năm đúng dữ liệu
10Ngoài phạm vi / tương lai
- Đổi Coin lấy vật phẩm thật (backlog 108)
- HUY HIỆU hồ sơ (đang Sắp cập nhật)
- Tặng kim cương theo rating bài GV build (backlog 108)
← Danh mục PRD · Nguồn: quét codebase flyer-webs/apps/exam + số liệu read-replica production · 15/08/2026.