FLYER Teacher · PRD · Sprint 110
📝 Giao bài tập
Luồng giao bài 3 bước là xương sống sản phẩm: chọn bài (kho hoặc link ngoài kiểu Google Classroom) → chọn lớp/học sinh → thiết lập thời gian. Sau giao là bộ theo dõi: tiến độ, chấm realtime, nhắc nhở, yêu cầu làm lại.
📈 Số liệu production (15/08/2026)410.419 bài đã giao all-time38.120 bài giao/30 ngày
🔗 Link mẫu trên productBài đã giao ↗Demo ↗Demo card Zalo ↗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
Luồng giao bài 3 bước là xương sống sản phẩm: chọn bài (kho hoặc link ngoài kiểu Google Classroom) → chọn lớp/học sinh → thiết lập thời gian. Sau giao là bộ theo dõi: tiến độ, chấm realtime, nhắc nhở, yêu cầu làm lại.
- Giao bài <1 phút cho nhiều lớp
- Theo dõi và nhắc nhở không sót học sinh nào
- Mở rộng giao cả tài nguyên ngoài hệ thống
2Người dùng & user stories
| Vai trò | User story | Ưu tiên |
|---|---|---|
| Giáo viên | Giao 1 bài cho nhiều lớp/HS lẻ, đặt hạn + chế độ thi. | P0 |
| Giáo viên | Theo dõi ai chưa làm, nhắc 1 chạm, xem chi tiết từng phần thi. | P0 |
| Phụ huynh | Tự giao bài cho con theo luồng riêng. | P1 |
3Phạm vi & phase
| Phase | Nội dung | Trạng thái |
|---|---|---|
| Phase 1 | 3 bước + theo dõi + luồng phụ huynh | Done |
| Phase 2 | Khoá bài khi hết hạn (allowLateSubmit) + review/redo theo điểm tối thiểu (107) | Done |
| Phase 3 | Chia sẻ qua Zalo (UI xong — chờ short-link backend); giao bài v3 kiểu Google Classroom mở rộng | Cần build |
4Luồng sản phẩm
- Nhấn Giao bài (từ kho đề/lớp/danh sách) → B1 chọn bài hoặc link ngoài → B2 chọn lớp/HS (cảnh báo trùng) → B3 thời gian + tuỳ chọn → Giao
- HS làm trên exam → GV theo dõi + nhắc → xem chi tiết → yêu cầu làm lại
5Spec UI — cho Designer
- Drawer full-màn 3 bước với banner hướng dẫn; tab Thư viện/Liên kết ngoài ở B1
- B3: các toggle Ẩn đáp án · Chế độ mô phỏng · Tự động khoá bài khi hết hạn (chỉ hiện khi có hạn nộp) · khối Zalo (toggle → card link + preview tin nhắn + nút SDK)
- Chi tiết bài: 5 KPI + progress chấm realtime → modal thành công; bảng HS expandable theo phần thi
- 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 |
|---|---|
| Điều kiện giao | Có bài (hoặc title+URL hợp lệ) + có đối tượng + ngày hợp lệ theo toggle |
| Khoá bài hết hạn | Mặc định cho nộp muộn; bật khoá → HS không bắt đầu sau deadline; tự reset khi bỏ hạn nộp |
| Trùng bài | Cảnh báo khi bài đã giao cho lớp được chọn |
| Phân quyền xem | Admin thấy mọi GV + lọc theo GV |
7Data & API — cho Developer
- GraphQL v2 ViewerCreateAssignTest/Update; job chấm nền; Zalo share chờ short-link teado.ai/b/[ID]
- Route: /assigned-tests, /assigned-tests/[id], /assigned-tests/parent
8Edge cases đã xử lý
| Case | Hành vi chuẩn |
|---|---|
| Sửa bài đã giao | Khôi phục đủ cài đặt cũ kể cả allowLateSubmit |
| Hạn nộp đã qua khi sửa | Toggle hạn nộp bị khoá đúng trạng thái |
| Link ngoài sai URL | Validate chặn ngay B1 |
| 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
- Cảnh báo trước khi giao trùng lớp
- Khoá bài: HS không bắt đầu được sau deadline
- Nhắc làm bài gửi đúng danh sách chưa nộp
- Luồng phụ huynh tách bạch bài GV giao vs tự giao
10Ngoài phạm vi / tương lai
- Hoàn thiện Zalo share (short-link + đo lượt mở)
- Push tự động phụ huynh qua Zalo OA khi có bài mới (Phase 2 PRD Zalo)
← 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.