Bingo Bay — trợ lý Bingo cho học sinh và giáo viên
Bingo bay ra, đậu cạnh nội dung đang làm, trả lời bằng chữ hoặc giọng nói và đưa người dùng tới đúng màn. Phía học sinh trên Phòng thi ảo, phía giáo viên trên teacher.flyer.us.
Xuất xứ / Prompt / Giới hạn
anh muốn Bingo sẽ bay ra ở homepage luôn https://phongthiao.com — Chiều bay sẽ là bạn Bingo ở góc 6pm — Và khi tắt đi thì Bingo cũng sẽ bay về đây nhé
Build PRD tính năng Bingo Bay này lên https://roadmap.flyer.vn/sprint-115, format các tab y hệt thế này https://roadmap.flyer.vn/sprint-112/bingo-auto-assign. Mô tả ngắn gọn và có đủ 2 phần Bingo Bay ở phía học sinh, và Bingo bay ở phía giáo viên nha
Tài liệu do trợ lý AI soạn trong một phiên làm việc. Nguồn: mã nguồn hai bản chạy thử (nhánh feat/bingo-companion của flyer/webs; ~/partner-web-demo của partner-web), ảnh chụp và quay màn hình ngày 28/10/2026 trên https://phongthiao.com (tài khoản học sinh thật, đã che tên và ảnh đại diện) và https://giaovien.phongthiao.com (dữ liệu mẫu).
Giới hạn: chưa có số liệu sử dụng thật, nên mục Chỉ số chỉ nêu cách đo. Phía học sinh chạy trên bản v1.39.4 kèm Bingo, chậm 6 bản vá so với production (v1.39.6). Phía giáo viên chạy trên dữ liệu mẫu, chưa nối tài khoản thật. Video quay dạng WebM, không có tiếng.
1 · Trang chủ: Bingo bay ra từ Bingo ở góc 6 giờ
Trang tải xong, Bingo rời Bingo đứng trên logo FLYER, bay vòng lên rồi đậu ở góc trên bên phải.
2 · Trợ lý AI trên trang chủ
Học sinh hỏi bằng chữ hoặc giọng nói. Bingo gợi ý cấp độ, rồi mở đúng màn (bài tập về nhà, thi thử, luyện nói…) sau 2,6 giây, kèm nút "Mở ngay" và "Ở lại".
3 · Trong bài thi: Bingo ở góc 1 giờ
Đọc nội dung trên màn hình để trả lời. Thi thử: chỉ gợi ý. Luyện tập: gợi ý trước, hỏi lại mới có đáp án.
4 · Đổi cỡ và nút Tắt
Kéo nút tròn trên viền để đổi cỡ (56–220 px), kéo thân Bingo để đổi chỗ. Cỡ và vị trí được ghi nhớ.
5 · Tắt: Bingo bay về Bingo ở góc 6 giờ
Có thông báo kèm "Hoàn tác". Bật lại bằng nút "Bingo đồng hành" trong trang Hồ sơ.
6 · Onboarding giáo viên mới
Bingo bay vào, đọc lời hướng dẫn từng bước của luồng onboarding hiện tại (V7) bằng giọng thu sẵn, chúc mừng khi tạo lớp xong.
7 · Trong ứng dụng: Bingo trợ giảng ở mọi màn
Đậu ở góc dưới bên phải, phía trên nút "Hỏi chúng tôi". Lần đầu vào mỗi màn, Bingo giới thiệu màn đó; bảng trợ giúp có hỏi đáp AI và nút mở màn liên quan.
1Vấn đề và mục tiêu
- Bingo hiện là hình tĩnh: học sinh kẹt giữa bài không có ai hỏi, giáo viên mới phải tự tìm cách dùng sản phẩm.
- Mục tiêu: một nhân vật Bingo dùng chung, xuất hiện đúng lúc, trả lời theo ngữ cảnh màn hình, đưa tới đúng màn, và tắt được bất cứ lúc nào.
2Phía học sinh
| Nơi | Bingo làm gì | Quy tắc |
|---|---|---|
| Trang chủ | Bay ra từ Bingo ở góc 6 giờ, đậu góc trên phải. Trợ lý AI : gợi ý nên học gì, mở đúng màn. | Hỏi trình độ trước khi gợi ý cấp độ; tự mở màn sau 2,6 giây, có "Ở lại" |
| Bài thi, luyện tập, bài học | Đậu góc 1 giờ, trả lời bằng chữ và giọng, đọc nội dung đang hiện trên màn | Thi thử: chỉ gợi ý. Luyện tập: lần hỏi thứ hai mới có đáp án (kiểm ở máy chủ) |
| Onboarding học sinh | Bay vào chào, mấp máy môi theo lời thu sẵn của từng bước | Dùng đúng kịch bản và giọng đang chạy trên production |
| Mọi nơi | Kéo đổi chỗ, đổi cỡ 56–220 px; rê chuột: "Xin chào, mình là Bingo…" | "Tắt" → bay về Bingo góc 6 giờ, thông báo có Hoàn tác; bật lại ở Hồ sơ |
3Phía giáo viên
| Nơi | Bingo làm gì | Quy tắc |
|---|---|---|
| Onboarding (V7) | Bay vào, đọc lời từng bước (chọn vai trò → thông tin → tạo lớp → mời học sinh), chúc mừng khi tạo lớp | Giọng thu sẵn vi/en; trình duyệt chặn tự phát âm thì hiện "Bấm để nghe" |
| 24 màn trong ứng dụng | Đậu góc dưới phải; lần đầu vào màn thì giới thiệu màn đó; hỏi đáp AI và nút mở màn liên quan | Mỗi màn chỉ nói lần đầu; câu hỏi ngoài phạm vi (giá…) → chuyển "Hỏi chúng tôi" |
| Mọi nơi | Kéo đổi chỗ; nút "Ẩn" trong phiên; bật/tắt trong Cài đặt › Bingo trợ giảng | Không hiện trên đăng nhập, đăng ký, thanh toán |
4Quy tắc chung
- Không chặn trang: Bingo chờ trang tải xong mới bay, không đè lên hộp thoại của sản phẩm.
- Giọng: trình duyệt chặn âm thanh trước lần chạm đầu tiên → Bingo chỉ mấp máy môi.
- An toàn: không hỏi và không nhắc lại thông tin cá nhân; không đưa link ngoài; giới hạn số câu hỏi mỗi ngày.
- Tắt là tắt: lựa chọn được ghi nhớ, áp dụng cho mọi màn.
5Kỹ thuật
| Phần | Học sinh (exam) | Giáo viên (partner-web) |
|---|---|---|
| Nhân vật | Bingo Rive production (bingo.riv, môi theo lời nói) trong ô tròn; ảnh bay toàn thân khi cất cánh | |
| Thành phần | BingoBuddy, BingoArrival, BingoOnboardingGuide | BingoGuide, BingoHelper (24 màn trong screens.json) |
| AI | Workers AI (llama-3.3-70b) qua /api/bingo-buddy/* | Workers AI qua /api/bingo-help |
| Giọng | TTS production /api/tts; Whisper cho giọng nói vào | Bản thu sẵn ElevenLabs theo bước và theo màn |
| Lưu bật/tắt | Trên trình duyệt (theo hồ sơ học sinh / theo giáo viên). Bản phát hành cần lưu trên hồ sơ ở máy chủ. | |
6Chỉ số thành công
| Chỉ số | Cách đo |
|---|---|
| Tỉ lệ học sinh mở Bingo trong bài | Phiên có mở bảng / phiên làm bài |
| Tỉ lệ hoàn thành bài khi có hỏi Bingo | So với nhóm không hỏi, cùng bài |
| Tỉ lệ tắt Bingo | Số hồ sơ tắt / số hồ sơ thấy Bingo; theo dõi theo tuần |
| Hoàn thành onboarding giáo viên | Tỉ lệ tạo lớp và mời học sinh trong ngày đầu, trước và sau khi bật |
| Chi phí AI | Số câu hỏi × chi phí Workers AI mỗi tháng |
7Câu hỏi mở
- Lưu bật/tắt Bingo trên hồ sơ học sinh và giáo viên ở máy chủ (đi theo tài khoản, không theo trình duyệt)?
- Giọng Bingo phía giáo viên dùng chung giọng production phía học sinh hay giữ giọng riêng?
- Giới hạn số câu hỏi mỗi ngày cho học sinh gói miễn phí và gói trả phí.
Bingo co cỡ theo màn hình: 60 px trên điện thoại, 84 px trên máy tính; bảng trò chuyện chiếm gần hết chiều ngang điện thoại.
Máy tính bảng
Học sinh · trang chủ · 820 × 1180
| Phía | Bản chạy thử | Production |
|---|---|---|
| Học sinh | phongthiao.com — dữ liệu production, chạy trên Cloudflare | Chưa lên |
| Giáo viên | giaovien.phongthiao.com — dữ liệu mẫu, cần mã truy cập | Chưa lên |
Việc cần làm để lên production
| Việc | Phía |
|---|---|
Đưa nhánh feat/bingo-companion lên bản mới nhất (v1.39.6), mở PR vào dev | Học sinh |
Commit mã Bingo trong ~/partner-web-demo thành nhánh riêng, tách khỏi phần dữ liệu mẫu | Giáo viên |
| API Bingo (hỏi đáp, nhận giọng) chạy trong cụm production, thay cho bản trên roadmap và Worker thử | Cả hai |
| Lưu bật/tắt Bingo trên hồ sơ ở máy chủ | Cả hai |
| Ghi sự kiện: mở Bingo, câu hỏi, mở màn, tắt (phục vụ mục Chỉ số) | Cả hai |
VQuay màn hình bản chạy thử
Học sinh · Bingo bay ra từ góc 6 giờ, mở trợ lý, nhận yêu cầu "Mở thi thử Movers", rồi bị tắt và bay về chỗ cũ.
Giáo viên · Bingo chào giáo viên mới ở onboarding, sau đó bay vào màn Bắt đầu nhanh và giới thiệu màn.