FLYER Teacher · PRD · Sprint 110
🤖 Chấm điểm AI
Chấm Viết và Nói là phần tốn thời gian nhất của giáo viên tiếng Anh. Trợ giảng AI chấm trong vài phút với rubric chuẩn (IELTS, KET/PET), nhận xét tới từng lỗi, quy đổi thang điểm quốc tế — giáo viên chỉ duyệt và gửi kết quả.
📈 Số liệu production (15/08/2026)47.830 lượt nói/30 ngày33.169 lượt viết/30 ngày7,06 triệu speaking attempts all-time
🔗 Link mẫu trên productChấm điểm AI ↗Demo chấm Viết ↗Demo chấm Nói ↗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
Chấm Viết và Nói là phần tốn thời gian nhất của giáo viên tiếng Anh. Trợ giảng AI chấm trong vài phút với rubric chuẩn (IELTS, KET/PET), nhận xét tới từng lỗi, quy đổi thang điểm quốc tế — giáo viên chỉ duyệt và gửi kết quả.
- Tiết kiệm hàng giờ chấm tay mỗi tuần
- Chuẩn hoá rubric chấm toàn trường
- Mở phễu: bản demo công khai cho GV chưa đăng ký
2Người dùng & user stories
| Vai trò | User story | Ưu tiên |
|---|---|---|
| Giáo viên | Upload bài viết tay (ảnh) hoặc dán bài → báo cáo chấm đầy đủ. | P0 |
| Giáo viên | Chấm bài nói qua ghi âm/video với transcript + 4 tiêu chí. | P0 |
| GV IELTS | Chấm band từng tiêu chí, xuất Word/PDF. | P0 |
| Giáo viên | Sửa tay + nhận xét, xử lý phúc khảo. | P1 |
3Phạm vi & phase
| Phase | Nội dung | Trạng thái |
|---|---|---|
| Phase 1 | Chấm Viết + Nói + lịch sử + bản anonymous/demo | Done |
| Phase 2 | Improve UI tab AI grading + filter type lịch sử (Sprint 107) | Done |
| Phase 3 | Teado Tools thêm chế độ chấm rẻ không chấm phát âm (backlog 108) | Đề xuất |
4Luồng sản phẩm
- GV upload bài → AI chấm nền (progress) → xem báo cáo → duyệt → gửi kết quả
- HS xin phúc khảo → GV mở give-score → sửa + chấm lại → nộp điểm
5Spec UI — cho Designer
- Hub 2 card lớn Chấm Viết / Chấm Nói + tooltip lượt miễn phí + entry tour
- Báo cáo viết: section navigator (Tổng quan → Từ vựng → Ngữ pháp → Bài mẫu), highlight lỗi inline
- Speaking: waveform + transcript đồng bộ thời gian, bảng quy đổi 5 thang điểm
- Give-score: editor Lexical với comment từng đoạn, thanh điểm + đếm từ, nút Nộp điểm
- 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 file | Ảnh ≤3MB · audio ≤10MB · video ≤250MB, ≤2 phút |
| Thanh toán | Trừ xu ví theo kiểu chấm; hết xu chặn + điều hướng nạp |
| Phúc khảo | Kết quả GV nộp ghi đè kết quả AI |
| Anonymous | Bản công khai giới hạn + nhắc đăng nhập để lưu |
7Data & API — cho Developer
- REST v3 grading + job nền polling tiến độ; ví xu wallet; export Word/PDF
- Route: /flyer-ai, /flyer-ai/writing/*(+ielts,ket-pet), /flyer-ai/speaking/*, /give-score/[id], /flyer-ai-anonymous, /flyer-ai-free-demo
8Edge cases đã xử lý
| Case | Hành vi chuẩn |
|---|---|
| Ảnh mờ/OCR kém | Báo lỗi đọc bài kèm hướng dẫn chụp lại |
| Video quá 2 phút | Chặn ngay khi chọn file |
| Mất mạng giữa chừng | Job nền tiếp tục, lịch sử hiện Đang chấm |
| 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
- Ảnh bài viết tay OCR và chấm được
- Quy đổi thang điểm khớp bảng chuẩn
- Hết xu → chặn + điều hướng nạp rõ ràng
- Kết quả chấm tay ghi đè AI khi nộp
10Ngoài phạm vi / tương lai
- Chế độ chấm giá rẻ (không phát âm) cho Teado Tools
- Chấm hàng loạt theo bài giao (batch grading)
← 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.