FLYER Teacher · PRD · Sprint 110
💬 Trợ Giảng AI
Bingo — trợ lý AI trong ứng dụng: giáo viên hỏi gì cũng được (dùng sản phẩm, soạn bài, giải thích ngữ pháp…), chat đa luồng và có gọi thoại. Đồng thời là kênh hướng dẫn sử dụng ngay tại chỗ (Sprint 104: chatbot giải đáp + chèn vào metric tooltips).
📈 Số liệu production (15/08/2026)955.745 phiên hội thoại AI all-time63.080 phiên/30 ngày
🔗 Link mẫu trên productTrợ giảng AI ↗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
Bingo — trợ lý AI trong ứng dụng: giáo viên hỏi gì cũng được (dùng sản phẩm, soạn bài, giải thích ngữ pháp…), chat đa luồng và có gọi thoại. Đồng thời là kênh hướng dẫn sử dụng ngay tại chỗ (Sprint 104: chatbot giải đáp + chèn vào metric tooltips).
- Giảm tải CS: tự phục vụ ngay trong ứng dụng
- Tăng adoption tính năng nhờ hướng dẫn ngữ cảnh
- Trợ lý soạn bài hằng ngày của GV
2Người dùng & user stories
| Vai trò | User story | Ưu tiên |
|---|---|---|
| Giáo viên | Hỏi nhanh cách dùng tính năng thay vì đọc tài liệu. | P0 |
| Giáo viên | Nhờ AI soạn ý tưởng bài giảng, giải thích kiến thức. | P1 |
3Phạm vi & phase
| Phase | Nội dung | Trạng thái |
|---|---|---|
| Phase 1 | Chat đa luồng + widget + voice call | Done |
| Phase 2 | Chèn AI giải thích vào các metric (i) trong report (Sprint 104) | Done |
| Phase 3 | Bingo chat theo topic (backlog 108) | Đề xuất |
4Luồng sản phẩm
- GV nhấn Trợ Giảng AI → hỏi → trả lời streaming → quay lại luồng cũ bất kỳ lúc nào
- Từ mọi trang: bong bóng "Hỏi chúng tôi" → chat/gọi thoại
5Spec UI — cho Designer
- Layout 2 cột: sidebar luồng (nhóm Hôm nay/7 ngày/30 ngày/Cũ hơn) + khung chat
- Composer: đính kèm ≤5MB, Enter gửi, nút dừng streaming; suggestions chip
- Widget nổi: trạng thái chat/gọi, thu nhỏ được; trang phụ hiện nút Báo lỗi thay thế
- 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 |
|---|---|
| Đính kèm | ≤5MB/file |
| Luồng | Lưu server, đổi tên/xoá được |
| Hiển thị | Ẩn menu ở Teado Lite (widget vẫn hoạt động) |
7Data & API — cho Developer
- REST chatbot API (SSE streaming) + ElevenLabs voice; luồng lưu server
- Route: /assistant, /assistant/[id]; widget mount toàn ứng dụng trừ EXCLUDE_ROUTES
8Edge cases đã xử lý
| Case | Hành vi chuẩn |
|---|---|
| Streaming đứt | Giữ phần đã nhận, cho gửi lại |
| File >5MB | Chặn kèm thông báo |
| Khách chưa đăng nhập | Guest session, nhắc đăng nhập để lưu |
| 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
- Luồng cũ mở lại đầy đủ lịch sử
- Dừng streaming không mất phần đã nhận
- Widget không che nội dung thao tác chính
10Ngoài phạm vi / tương lai
- Chat theo chủ đề giáo trình (backlog 108)
- Hành động trực tiếp từ chat (tạo lớp, giao bài… qua tool-use)
← 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.