FLYER Teacher · PRD · Sprint 110
📊 Báo cáo & Phân tích
Chủ trường và quản lý chi nhánh cần nhìn thấy sức khỏe vận hành hằng ngày: lớp nào học đều, giáo viên nào giao bài đủ, học sinh nào sắp bỏ cuộc. Khu Báo cáo là "phòng điều khiển" của FLYER Teacher — mọi chỉ số học tập đổ về một nơi, có drill-down tới từng lớp/giáo viên/học sinh.
📈 Số liệu production (15/08/2026)51.858 học sinh active 30 ngày1,26 triệu bài nộp/30 ngày (mọi loại)25,8 triệu lượt làm bài all-time
🔗 Link mẫu trên productBáo cáo (production) ↗Demo click được ↗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ủ trường và quản lý chi nhánh cần nhìn thấy sức khỏe vận hành hằng ngày: lớp nào học đều, giáo viên nào giao bài đủ, học sinh nào sắp bỏ cuộc. Khu Báo cáo là "phòng điều khiển" của FLYER Teacher — mọi chỉ số học tập đổ về một nơi, có drill-down tới từng lớp/giáo viên/học sinh.
- Chủ trường ra quyết định bằng số liệu trong <5 phút mỗi ngày
- Phát hiện sớm red-flag (lớp học ít, GV giao thiếu, HS điểm thấp) trước khi churn
- Tự động hoá báo cáo định kỳ cho giáo viên và phụ huynh
2Người dùng & user stories
| Vai trò | User story | Ưu tiên |
|---|---|---|
| Chủ trường | Xem KPI toàn chi nhánh theo khoảng ngày, so sánh với kỳ trước để đánh giá tăng trưởng. | P0 |
| Quản lý | Phát hiện sớm lớp/GV/HS red-flag để can thiệp. | P0 |
| Giáo viên | Nhận báo cáo tuần của lớp mình + gửi phụ huynh báo cáo tháng của từng bé. | P1 |
3Phạm vi & phase
| Phase | Nội dung | Trạng thái |
|---|---|---|
| Phase 1 | Trang tổng KPI + 18 báo cáo chi tiết + báo cáo tuần/tháng | Done |
| Phase 2 | Báo cáo điểm danh (đang prototype) hợp nhất vào khu Báo cáo | Cần build |
| Phase 3 | Gửi báo cáo định kỳ tự động qua ZNS + email cho chủ trường (Sprint 107 backlog) | Đề xuất |
4Luồng sản phẩm
- Chủ trường mở Báo cáo → quét 5 KPI → nhấn thẻ bất thường để drill-down
- Bật so sánh kỳ trước → đánh giá tăng/giảm
- Mở báo cáo red-flag → chọn học sinh → gửi thư nhắc HS + phụ huynh
- GV mở Báo cáo tuần → gửi link Báo cáo tháng cho phụ huynh
5Spec UI — cho Designer
- Trang tổng: 5 CardOverview nhấn được + MultipleDateRangePicker (range chính + range so sánh) + lưới chart 2 cột
- Chart dùng bộ màu semantic thống nhất; bảng ranking top-10 có highlight lớp thấp nhất
- Red-flag pages: bảng so sánh tuần, badge trạng thái, nút gửi thư nhắc
- Báo cáo tháng (phụ huynh): trang public responsive mobile, xếp loại Xuất sắc/Tốt/Cần cải thiệ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 |
|---|---|
| Khoảng ngày mặc định | 30 ngày gần nhất; mọi filter đều persist trên URL |
| Red-flag "học ít" | Lớp <25 phút/HS/tuần, so tuần này vs tuần trước |
| HS cần hỗ trợ | Điểm/tỷ lệ đúng thấp theo ngưỡng từng báo cáo (vd accuracy <50% ở báo cáo tuần) |
| Phạm vi dữ liệu | Theo trường (chi nhánh) đang chọn; admin thấy mọi GV, giáo viên chỉ thấy lớp mình |
7Data & API — cho Developer
- GraphQL v2: partnerOverview, partnerViewerRollupStudents/Classes + bộ query ranking/skills/teachers-performance
- Route: /report + 18 trang con; /monthly-report/[id] là trang share công khai
- Weekly digest render cả dạng modal in-app lẫn trang đầy đủ
8Edge cases đã xử lý
| Case | Hành vi chuẩn |
|---|---|
| So sánh 2 khoảng ngày lệch độ dài | Chuẩn hoá theo ngày, delta tính trên tổng kỳ |
| Lớp/GV mới chưa đủ dữ liệu | Loại khỏi ranking thay vì hiện 0% gây hiểu lầm |
| Trang tháng mở không đăng nhập | Chỉ đọc, không lộ thao tác quản trị |
| 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
- 5 thẻ KPI khớp số liệu trang drill-down tương ứng
- So sánh 2 khoảng ngày hiển thị đúng delta
- Red-flag so đúng tuần-này-vs-tuần-trước
- Thư nhắc gửi đúng danh sách HS/phụ huynh đã chọn
- Báo cáo tháng mở được không cần đăng nhập
10Ngoài phạm vi / tương lai
- Gửi báo cáo tuần/tháng tự động qua ZNS + email (đã có trong backlog Sprint 107)
- Báo cáo gộp toàn chuỗi (nhiều chi nhánh trên 1 màn)
- Cảnh báo chủ động (push) khi chỉ số vượt ngưỡng
← 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.