FLYER Teacher · PRD · Sprint 110
🧒 Học sinh
Quản lý học sinh cấp trường: tạo tài khoản hàng loạt (import Excel), phân gói, nâng cấp/gia hạn, hồ sơ học tập chi tiết từng học sinh — một chỗ cho cả vận hành lẫn CS.
📈 Số liệu production (15/08/2026)1,68 triệu hồ sơ học sinh483.758 tài khoản51.858 active 30 ngày
🔗 Link mẫu trên productDanh sách học sinh ↗Demo ↗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
Quản lý học sinh cấp trường: tạo tài khoản hàng loạt (import Excel), phân gói, nâng cấp/gia hạn, hồ sơ học tập chi tiết từng học sinh — một chỗ cho cả vận hành lẫn CS.
- Tạo & phân phối tài khoản không ma sát
- CS thao tác gia hạn/nâng cấp/mật khẩu 1 chỗ
- GV nắm hồ sơ học tập từng học sinh
2Người dùng & user stories
| Vai trò | User story | Ưu tiên |
|---|---|---|
| Trung tâm | Tạo 50 tài khoản/lần từ Excel, gửi mail đăng nhập. | P0 |
| CS | Gia hạn, nâng cấp, đặt lại mật khẩu, hoàn tiền. | P0 |
| Giáo viên | Xem hồ sơ: 4 kỹ năng, bài được giao, lỗi sai. | P1 |
3Phạm vi & phase
| Phase | Nội dung | Trạng thái |
|---|---|---|
| Phase 1 | Danh sách + tạo hàng loạt + hồ sơ chi tiết | Done |
| Phase 2 | Field SĐT từng HS trên form (UI xong — chờ backend nhận field) | Cần build |
| Phase 3 | Trial cap 30 (mới); student-manager mode theo billing flag | Done |
4Luồng sản phẩm
- Import Excel → tạo tài khoản + trừ xu theo gói → gửi mail từng học sinh → HS đăng nhập học
5Spec UI — cho Designer
- 2 tab list/archive; bộ lọc lớp + loại tài khoản; hàng có popover thao tác nhanh
- Drawer tạo hàng loạt: bảng dòng nhập + import .xlsx (≤2MB, template) + chọn gói/band + mật khẩu chung
- Hồ sơ HS: header thông tin + tab 4 kỹ năng/luyện tập/bài giao/lỗi sai/học phí
- 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 |
|---|---|
| Giới hạn batch | ≤50 HS/lần; dùng thử tối đa 30 HS/GV (đếm lùi, hết disable) |
| Username | 3–25 ký tự, check trùng ngay trong batch |
| Tìm kiếm | Tự bỏ +84/0 đầu số khi search SĐT |
| Hoàn tiền | Chỉ Admin + flag refund |
7Data & API — cho Developer
- GraphQL v2 partnerViewerStudentsCreate (batch) + rollup/any students; mail backend
- Route: /student-list, /[classId]/students/[studentId]; SĐT đang chờ backend thêm field vào input
8Edge cases đã xử lý
| Case | Hành vi chuẩn |
|---|---|
| File import sai header | Validate + chỉ rõ dòng/mã lớp sai theo tên |
| Trùng username trong batch | Chặn ngay khi nhập |
| Hết suất trial | Option Trial disable kèm tooltip |
| 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
- Import 50 dòng hợp lệ tạo đủ 50 tài khoản
- Hết 30 suất trial: disable + tooltip
- Mail chứa đúng username/mật khẩu/mã lớp
10Ngoài phạm vi / tương lai
- Backend nhận field SĐT học sinh (TODO trong code)
- Guest mode ứng dụng (backlog 108)
- Đổi Coin của học sinh (backlog 108)
← 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.