FLYER Teacher · PRD · Sprint 110
🎁 Quà tặng (FLYER Gifts)
"Cô tặng quà, trò thêm vui" — giáo viên khen thưởng bằng quà cụ thể: quà hệ thống FLYER (quota) hoặc quà cô tự chuẩn bị, gửi kèm lời khen, phụ huynh nhận thông báo. Học sinh dùng đá 💎 đổi quà trong cửa hàng lớp. Prototype bám flyer-gift-demo.pages.dev.
📈 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 productÝ tưởng gốc — gift demo ↗Vị trí: Lớp học → tab Quà tặng ↗prototype đang chạy local partner-web — chưa lên production
1Bối cảnh & mục tiêu
"Cô tặng quà, trò thêm vui" — giáo viên khen thưởng bằng quà cụ thể: quà hệ thống FLYER (quota) hoặc quà cô tự chuẩn bị, gửi kèm lời khen, phụ huynh nhận thông báo. Học sinh dùng đá 💎 đổi quà trong cửa hàng lớp. Prototype bám flyer-gift-demo.pages.dev.
- Khen thưởng hữu hình, phụ huynh cảm nhận được
- GV tự vận hành chương trình thi đua của lớp
- Gắn kết 3 bên GV–HS–phụ huynh
2Người dùng & user stories
| Vai trò | User story | Ưu tiên |
|---|---|---|
| Giáo viên | Tặng quà nhanh cho HS nổi bật kèm lời khen — phụ huynh được báo. | P0 |
| Giáo viên | Tự đăng quà của lớp (ảnh/emoji + số lượng) làm thi đua. | P0 |
| Học sinh | Dùng đá kiếm từ việc học để đổi quà cô chuẩn bị. | P0 |
3Phạm vi & phase
| Phase | Nội dung | Trạng thái |
|---|---|---|
| Phase 1 | 4 màn GV + preview HS (prototype localStorage) + demo data | Done |
| Phase 2 | Backend: hợp nhất ví Đá Tri Thức (v4), bảng gifts/grants, kiểm duyệt ảnh, thông báo phụ huynh | Cần build |
| Phase 3 | Chương trình thi đua tự động trao quà theo tiêu chí (tab Campaigns của demo) | Đề xuất |
4Luồng sản phẩm
- Tặng trực tiếp: chọn nhiều HS (Bingo AI gợi ý) → chọn quà → lời khen → Gửi ✨
- HS đổi: vào cửa hàng lớp → trừ đá theo giá → vào bộ sưu tập
- GV theo dõi lịch sử + tồn kho + quà top
5Spec UI — cho Designer
- 4 màn Segmented: Tặng quà · Kho quà · Theo dõi · 🧒 Học sinh
- Modal chọn quà: 2 nguồn (Quà FLYER/Quà của tôi), card quà emoji + tồn kho, 3 lời khen mẫu, note phụ huynh vàng
- Preview HS: khung điện thoại header tím, ví đá, shop grid nút vàng "💎 giá · Đổi quà", bộ sưu tập
- Kho: nhấn quà → nhảy sang Tặng với quà chọn sẵn; quà tự tạo có nút ✕ xoá
- 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 |
|---|---|
| Quota | Quà FLYER 30/GV/tháng; quà tự tạo không quota |
| Tồn kho | Trừ theo số HS nhận; hết = "Hết quà" + disable |
| Giá đổi (prototype) | Ảo 30💎 · voucher 60💎 · vật lý 80💎 · Xu 20💎 |
| An toàn (thiết kế) | Ảnh quà kiểm duyệt AI; quà vật lý bắt buộc báo phụ huynh; cấm quy đổi tiền mặt |
7Data & API — cho Developer
- Hiện: localStorage flyer_gifts_<classId>; Phase 2: hợp nhất ví v4 wisdom-stones + bảng gifts/gift_grants + notify app/Zalo
- Route: /[classId]?currentTab=10
8Edge cases đã xử lý
| Case | Hành vi chuẩn |
|---|---|
| Gửi vượt tồn kho/quota | Chặn kèm cảnh báo số còn lại |
| HS thiếu đá | Nút Đổi disable + toast thiếu đá |
| Xoá dữ liệu demo | Chỉ xoá demo, không đụng dữ liệu thật |
| 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
- Gửi quà trừ đúng tồn kho + quota theo số HS
- Preview HS trừ đá đúng giá và ghi bộ sưu tập
- Hết quota/tồn kho chặn gửi rõ ràng
- Demo data tạo/xoá không ảnh hưởng dữ liệu thật
10Ngoài phạm vi / tương lai
- Backend + hợp nhất ví Đá Tri Thức
- Chương trình thi đua tự động (campaigns)
- Thông báo khen ngợi tới ứng dụng HS + Zalo phụ huynh
← 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.