FLYER Teacher · PRD · Sprint 110
🎯 Kiểm tra đầu vào
Trung tâm tuyển sinh liên tục: học sinh mới cần được đo trình độ và xếp đúng lớp. Placement gom toàn bộ luồng: gửi bài test → điểm 4 kỹ năng → đề xuất trình độ → chuyển vào lớp.
📈 Số liệu production (15/08/2026)11.946 lượt làm placement/30 ngày
🔗 Link mẫu trên productKiểm tra đầu vào ↗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
Trung tâm tuyển sinh liên tục: học sinh mới cần được đo trình độ và xếp đúng lớp. Placement gom toàn bộ luồng: gửi bài test → điểm 4 kỹ năng → đề xuất trình độ → chuyển vào lớp.
- Chuẩn hoá đo trình độ đầu vào
- Rút ngắn thời gian từ đăng ký tới vào lớp
- Dữ liệu điểm làm căn cứ tư vấn phụ huynh
2Người dùng & user stories
| Vai trò | User story | Ưu tiên |
|---|---|---|
| Trung tâm | Gửi bài kiểm tra trình độ cho HS mới chưa phân lớp. | P0 |
| Trung tâm | Xem điểm 4 kỹ năng + trình độ đề xuất để xếp lớp. | P0 |
| Sales/CS | Theo dõi danh sách chờ và trạng thái tài khoản. | P1 |
3Phạm vi & phase
| Phase | Nội dung | Trạng thái |
|---|---|---|
| Phase 1 | Danh sách + gửi test + điểm + chuyển lớp + CSV | Done |
| Phase 2 | Preview đề Placement cho GV (Sprint 104) | Done |
| Phase 3 | Placement cho IELTS (backlog Sprint 107); thiết kế lại vị trí nút/content (backlog) | Đề xuất |
4Luồng sản phẩm
- HS mới vào danh sách chờ → gửi placement test → HS làm bài → điểm + trình độ đề xuất → Chuyển học sinh vào lớp
5Spec UI — cho Designer
- Bảng 2 cohort: chưa phân lớp / danh sách chờ; cột điểm Nghe · Đọc&Viết · Nói · Tổng + cột Trình độ xếp lớp nổi bật
- Modal gửi test 3 bước chọn: Nguồn đề → Nhóm bài thi → Bài; hint liên hệ admin khi thiếu nguồn
- Badge trạng thái tài khoản (Chưa đăng ký/Đã đăng ký/Hết hạn)
- 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 |
|---|---|
| Cảnh báo chuyển lớp | Case không move được phải hiện mô tả lý do (backlog 106 đã ghi nhận) |
| Đề Mix | Theo flag enable_is_mix |
| Lớp placement | Không dùng 11 tab thường, có màn theo dõi riêng |
7Data & API — cho Developer
- GraphQL v2 students + placement queries; điểm đổ về từ exam platform
- Route: /placement, /[classId]/placement-test
8Edge cases đã xử lý
| Case | Hành vi chuẩn |
|---|---|
| HS chưa làm bài | Nằm ở Danh sách chờ, không có điểm |
| Chuyển lớp bị giới hạn | Thông báo lỗi limit rõ ràng |
| HS làm lại test | Lấy lần nộp gần nhất, giữ ngày nộp đầu/cuố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ểm 4 kỹ năng + trình độ đề xuất hiện đúng sau khi nộp
- Chuyển học sinh đổi lớp ngay và rời danh sách chưa phân lớp
- Lớp placement không hiện 11 tab thường
10Ngoài phạm vi / tương lai
- Placement IELTS (backlog 107)
- Tự xếp lớp gợi ý theo trình độ + sĩ số lớp trống
- Bài số hoá xong setup thành placement test (backlog 107)
← 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.