FLYER Học sinh (exam.flyer.us) · PRD · Sprint 110
🦘 Bingo AI — gọi & trò chuyện
Học sinh luyện nói chuyện tiếng Anh thật với Bingo (và Thánh Gióng): gọi điện realtime, chat văn bản, hội thoại theo chủ đề với mục tiêu học tập — streaming giọng + khẩu hình Rive. Đây là tính năng kéo engagement mạnh thứ hai sau làm đề.
📈 Số liệu production (15/08/2026)955.745 phiên hội thoại all-time63.080 phiên/30 ngày
1Bối cảnh & mục tiêu
Học sinh luyện nói chuyện tiếng Anh thật với Bingo (và Thánh Gióng): gọi điện realtime, chat văn bản, hội thoại theo chủ đề với mục tiêu học tập — streaming giọng + khẩu hình Rive. Đây là tính năng kéo engagement mạnh thứ hai sau làm đề.
- Môi trường nói không sợ sai cho trẻ
- Chủ đề bám giáo trình (GV giao được như bài tập)
- Kiểm soát chi phí AI qua giới hạn lượt/phút
2Người dùng & user stories
| Vai trò | User story | Ưu tiên |
|---|---|---|
| Học sinh | Gọi Bingo luyện nói tự do hoặc theo chủ đề. | P0 |
| Học sinh | Đọc gợi ý câu trả lời khi bí (freetalk có gợi ý — Sprint 104). | P0 |
| Giáo viên | Giao chủ đề hội thoại như một nhiệm vụ. | P1 |
3Phạm vi & phase
| Phase | Nội dung | Trạng thái |
|---|---|---|
| Phase 1 | Gọi thường + chat + topic talk + lịch sử | Done |
| Phase 2 | Free talk WebRTC (BETA) + nhân vật Thánh Gióng + bỏ nút dịch/end-call đỏ (104) | Done |
| Phase 3 | Giới hạn theo membership (30p/tuần, trial 5p/tuần — kế hoạch 104, FE hiện mới có 5 phút/phiên + lượt/ngày) | Đề xuất |
4Luồng sản phẩm
- Footer/home → gọi Bingo → chọn nhân vật (Bingo/Thánh Gióng) + kiểu gọi (thường/BETA liên tục) → trò chuyện → hết giờ Bingo chào tạm biệt
- Topic talk: chọn chủ đề → hội thoại theo mục tiêu → TỔNG ĐIỂM + mục tiêu đã đạt
5Spec UI — cho Designer
- Màn gọi: trạng thái "Đang gọi/đang suy nghĩ/đang chờ câu trả lời", khẩu hình sync
- Topic: mục tiêu học tập, gợi ý câu nói, ẩn/hiện câu trả lời AI, dịch nghĩa
- Badge BETA + ghi chú thử nghiệm rõ ràng
- Thiết kế "vũ trụ FLYER" cho trẻ em: nền không gian, hành tinh Lottie, mascot Bingo; vi/en (mặc định vi).
- Ứng dụng exam là Next.js Pages Router + GraphQL v2 + REST v3/v4; deep-link ứng dụng mobile flyer-exam://.
6Business rules
| Rule | Định nghĩa |
|---|---|
| Giới hạn phiên | Topic talk & Free talk: 5 phút/phiên (hardcode FE); gọi thường: N lượt/ngày (server) |
| Quota tuần | Kế hoạch 30p/tuần membership · 5p/tuần trial — chưa thấy ở FE, thuộc backend |
| Nội dung | Chủ đề sort mặc định Pre-A1 trước (after-launch 103) |
7Data & API — cho Developer
- ai_conversation_sessions 956k (source, duration, message_count, assign_test_id — nối bài giao)
- Route: /real-time-conversation(+/call,/chat,/free-talk,/topic/[id]), /bingo-subject/[id]
8Edge cases đã xử lý
| Case | Hành vi chuẩn |
|---|---|
| Hết giờ phiên | Lời chào kết thúc thân thiện + mời gọi lại |
| Hết lượt ngày | "Bạn đã sử dụng hết số lượt gọi hôm nay." |
| Đang bảo trì | Note bảo trì hiển thị trước khi gọi |
| Khách chưa đăng nhập | Được làm thử/preview; toast + modal nhắc đăng nhập để lưu kết quả |
| Mạng chậm | Cảnh báo cáp quang/network chậm (remote config); SpeedTest ở home |
9Acceptance criteria
- Phiên topic dừng đúng 5 phút với lời chào
- Điểm mục tiêu cộng đúng khi đạt
- Phiên nối từ bài giao ghi nhận assignTestCode
- Thánh Gióng dùng đúng persona (giọng riêng: backlog)
10Ngoài phạm vi / tương lai
- Quota theo membership 30p/5p per tuần (kế hoạch 104)
- Giọng riêng Thánh Gióng (backlog 107-108)
- Bingo chat theo topic (backlog 108)
← Danh mục PRD · Nguồn: quét codebase flyer-webs/apps/exam + số liệu read-replica production · 15/08/2026.