FLYER Teacher · PRD · Sprint 110
🏫 Quản lý lớp
Lớp là đơn vị vận hành trung tâm — mọi tính năng hội tụ trong chi tiết lớp 11 tab. Danh sách lớp là bàn làm việc hằng ngày: mã lớp để học sinh join, link phòng học online, số liệu nhanh từng lớp.
📈 Số liệu production (15/08/2026)137.373 lớp đã tạo+15.031 lớp mới/30 ngày1,13 triệu lượt học sinh trong lớp
🔗 Link mẫu trên productQuản lý lớp ↗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
Lớp là đơn vị vận hành trung tâm — mọi tính năng hội tụ trong chi tiết lớp 11 tab. Danh sách lớp là bàn làm việc hằng ngày: mã lớp để học sinh join, link phòng học online, số liệu nhanh từng lớp.
- Một cửa vận hành mọi việc của lớp
- Học sinh join lớp tự phục vụ qua mã/link
- Chủ trường nhìn nhanh sức khỏe từng lớp
2Người dùng & user stories
| Vai trò | User story | Ưu tiên |
|---|---|---|
| Giáo viên | Tạo lớp, lấy mã/link join, vận hành trong 11 tab. | P0 |
| Chủ trường | Nhìn tổng thể các lớp: nộp bài, giờ học, độ chính xác, sĩ số. | P0 |
3Phạm vi & phase
| Phase | Nội dung | Trạng thái |
|---|---|---|
| Phase 1 | CRUD lớp + 11 tab + join link + online class | Done |
| Phase 2 | Tab Khen thưởng (v4) + Điểm danh + Quà tặng (prototype) vừa bổ sung | Done |
| Phase 3 | HS 1 tài khoản join nhiều lớp, nhận bài song song (documenting — backlog 108) | Đề xuất |
4Luồng sản phẩm
- Tạo lớp → copy mã join gửi phụ huynh → HS tự join → vận hành trong 11 tab
5Spec UI — cho Designer
- Bảng lớp: cột mã lớp copy 1 chạm, cột Online Class icon nền tảng, pin lớp lên đầu
- Drawer tạo lớp: toggle online mở khối link + lịch tuần (slot ≥30 phút)
- Chi tiết lớp: TabsList ngang 11 tab, deep-link ?currentTab=N, badge phúc khảo trên tab Học sinh
- 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 lớp | Chạm giới hạn gói → chặn tạo kèm thông báo |
| Lớp 0 học sinh | Thay tabs bằng màn thêm học sinh |
| Lớp placement | Chuyển sang màn theo dõi riêng |
| Join link | exam.flyer.us hoặc ielts theo loại lớp |
7Data & API — cho Developer
- GraphQL v2 partnerClasses/partnerViewerClass; meetingLink + lịch tuần trong settings lớp
- Route: /classes, /[classId] (dashboard 11 tab)
8Edge cases đã xử lý
| Case | Hành vi chuẩn |
|---|---|
| Xoá lớp còn học sinh | Confirm rõ hậu quả trước khi xoá |
| Link meeting sai định dạng | Validate bắt đầu bằng http |
| Tab bị flag tắt | Không render nút tab |
| 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
- Mã join đúng nền tảng theo loại lớp
- Tab theo flag ẩn/hiện đúng
- Ghim lớp giữ sau reload
10Ngoài phạm vi / tương lai
- 1 HS nhiều lớp + bài tập ghi rõ từ lớp nào (backlog 108)
- Nhóm menu 11 tab gọn lại (backlog 107 "Nhóm menu")
← 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.