FLYER Teacher · PRD · Sprint 110
🏅 Khen thưởng (Đá Tri Thức)
Gamification trong lớp: giáo viên thưởng "Đá Tri Thức" 💎 theo tiêu chí hành vi tốt, học sinh tích đá và đổi thưởng. Chạy trên API v4 wisdom-stones thật — nền tảng ví điểm thưởng mà Quà tặng (prototype) sẽ hợp nhất vào.
📈 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 productLớp học → tab Khen thưởng ↗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
Gamification trong lớp: giáo viên thưởng "Đá Tri Thức" 💎 theo tiêu chí hành vi tốt, học sinh tích đá và đổi thưởng. Chạy trên API v4 wisdom-stones thật — nền tảng ví điểm thưởng mà Quà tặng (prototype) sẽ hợp nhất vào.
- Tạo văn hoá khen thưởng tức thì trong lớp
- Chuẩn hoá tiêu chí hành vi toàn trường
- Nền ví điểm thưởng dùng chung cho Quà tặng
2Người dùng & user stories
| Vai trò | User story | Ưu tiên |
|---|---|---|
| Giáo viên | Thưởng đá nhanh cho cá nhân/nhóm theo tiêu chí, hiệu ứng vui trước lớp. | P0 |
| Giáo viên | Trừ đá khi đổi thưởng; xem báo cáo tích luỹ từng học sinh. | P0 |
| Chủ trường | Bộ tiêu chí thống nhất toàn trường. | P1 |
3Phạm vi & phase
| Phase | Nội dung | Trạng thái |
|---|---|---|
| Phase 1 | Grant/redeem + tiêu chí + nhóm + lịch sử + hiệu ứng (API v4) | Done |
| Phase 2 | Widget Top HS trên Tổng quan + tour onboarding | Done |
| Phase 3 | Hợp nhất với Quà tặng (đổi đá lấy quà thật) | Đề xuất |
4Luồng sản phẩm
- GV mở tab Khen thưởng → chọn học sinh/nhóm → chọn tiêu chí → đá bay + toast → HS tích đá → đổi thưởng (trừ đá)
5Spec UI — cho Designer
- 2 sub-tab Cá nhân/Nhóm; card HS avatar + số đá; infinite scroll (IntersectionObserver)
- Modal 3 phần: Thưởng cá nhân (card tiêu chí) · Đổi thưởng (stepper 1–10) · Báo cáo
- FX: viên đá bay từ giữa màn vào card + âm thanh tang-qua.mp3; grant sau khi animation xong
- Drawer lịch sử: lọc ngày (mặc định 7 ngày) + search debounce, ±đá màu xanh/đỏ
- 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 |
|---|---|
| Tiêu chí mặc định | 6 tiêu chí seed, không xoá được; tiêu chí tự tạo chỉ chủ sở hữu sửa/xoá; trùng tên → 409 |
| Đổi thưởng | 1–10 đá/lần, không vượt số dư (409 nếu âm) |
| Nhóm | Thưởng nhóm = cộng mọi thành viên |
7Data & API — cho Developer
- REST v4 /teacher/wisdom-stones/* (grant, criteria, groups, report, history) — search server-side, phân trang 100
- Route: /[classId]?currentTab=2 (+ drawer lịch sử ?openHistory=1)
8Edge cases đã xử lý
| Case | Hành vi chuẩn |
|---|---|
| Đổi vượt số dư | Chặn 409 + thông báo thiếu đá |
| Grant khi đang animation | Mutation chỉ bắn sau flight complete — không double |
| Tên tiêu chí trùng | Báo "Tên tiêu chí đã tồn tại" |
| 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
- Đổi thưởng vượt số dư bị chặn
- Thưởng nhóm cộng đúng mọi thành viên
- Lịch sử phân trang 100/lần cuộn tải tiếp
- Thu hồi hiển thị "Đã thu lại Đá Tri Thức"
10Ngoài phạm vi / tương lai
- Hợp nhất ví đá với Quà tặng (đổi đá lấy quà vật lý/ảo)
- Bảng xếp hạng đá liên lớp/liên trườ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.