FLYER Teacher · PRD · Sprint 110
🏛️ Quản lý kỳ thi
Tổ chức kỳ thi tập trung chuẩn chứng chỉ (Cambridge, IELTS, khối Bộ GD): dựng buổi thi theo kỹ năng, khoá đề tới giờ thi, giám sát chống gian lận realtime, xuất chứng chỉ PDF hàng loạt kiểu Cambridge Statement of Results.
📈 Số liệu production (15/08/2026)Chưa có bảng dữ liệu trên read-replica cho tính năng này — cần thêm khi có backend/quyền đọc.
🔗 Link mẫu trên productQuản lý kỳ thi ↗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
Tổ chức kỳ thi tập trung chuẩn chứng chỉ (Cambridge, IELTS, khối Bộ GD): dựng buổi thi theo kỹ năng, khoá đề tới giờ thi, giám sát chống gian lận realtime, xuất chứng chỉ PDF hàng loạt kiểu Cambridge Statement of Results.
- Trường tự tổ chức thi thử chuẩn quốc tế
- Chống gian lận khi thi online
- Chứng chỉ đẹp làm điểm chạm với phụ huynh
2Người dùng & user stories
| Vai trò | User story | Ưu tiên |
|---|---|---|
| Trung tâm | Tạo kỳ thi thử Cambridge/IELTS cho nhiều lớp. | P0 |
| Giám thị | Theo dõi realtime, cảnh báo chuyển tab, yêu cầu làm lại. | P0 |
| Trung tâm | Xuất phổ điểm + chứng chỉ gửi phụ huynh. | P0 |
3Phạm vi & phase
| Phase | Nội dung | Trạng thái |
|---|---|---|
| Phase 1 | Tạo kỳ thi + buổi thi + monitor + report + chứng chỉ | Done |
| Phase 2 | Onboarding tạo kỳ thi (Sprint 106) | Done |
| Phase 3 | Khoá test đầu vào cho trường free-tier (backlog 108) | Đề xuất |
4Luồng sản phẩm
- Tạo kỳ thi → thêm buổi + gắn đề → thông báo lớp → thi (giám sát) → báo cáo → xuất chứng chỉ
5Spec UI — cho Designer
- Danh sách exam card: tab Tất cả/Đang hoạt động/Kết thúc + chip trạng thái
- Màn cấu hình 2 cột: buổi thi trái, Bảng điều khiển/Lớp tham gia/Quy đổi điểm phải
- Monitor: 2 tab Tổng quan · Chống gian lận (bảng cảnh báo theo HS)
- Report: phổ điểm chart + tabs hoàn thành + nút Xuất chứng chỉ nổi bật
- 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 |
|---|---|
| Trạng thái điều khiển quyền sửa | SCHEDULED sửa full → ONGOING khoá chọn đề → COMPLETED chỉ đọc |
| Khoá đề | Đề chỉ mở khi tới giờ thi |
| Quy đổi | Shields (Cambridge) / Bands (IELTS); 3 kỹ năng Starters–Flyers, 4 từ KET |
| Thông báo | Trước giờ thi 5–30 phút tuỳ cấu hình |
7Data & API — cho Developer
- REST v3 /teacher/exams (openapi); spec nội bộ CENTRALIZED_EXAM_FEATURES.md trong repo
- Route: /centralized-exam, /create, /[id], /[id]/monitor, /[id]/report, /test-library
8Edge cases đã xử lý
| Case | Hành vi chuẩn |
|---|---|
| Sửa khi đang thi | Chọn đề bị khoá, chỉ thao tác giám sát |
| HS mất mạng | Cảnh báo hiển thị, cho yêu cầu làm lại |
| Xuất chứng chỉ thiếu điểm | Bỏ qua HS chưa hoàn thành, báo danh sách |
| 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
- Đề không mở được trước giờ thi
- Cảnh báo chuyển tab đếm đúng theo HS
- Chứng chỉ PDF hàng loạt đúng template chứng chỉ
- Kỳ thi Kết thúc là chỉ-đọc
10Ngoài phạm vi / tương lai
- Khoá placement cho trường dùng miễn phí (backlog 108)
- Đề thi VSTEP/Aptis số hoá làm quà tặng (ý tưởng 106)
← 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.