FLYER Học sinh (exam.flyer.us) · PRD · Sprint 110
🪐 Trang chủ hành tinh
Trang chủ exam.flyer.us là "bản đồ vũ trụ": mỗi chứng chỉ là một hành tinh (Starters, Movers, Flyers, KET, PET, TOEFL, IOE, IELTS, Study…) trên carousel 3D. Học sinh chọn hành tinh để vào luyện — kèm Cổng chọn chế độ học (Bingo Planet = phòng thi ảo, Giong Land = luyện tập).
📈 Số liệu production (15/08/2026)483.758 tài khoản học sinh51.858 học sinh active 30 ngày
1Bối cảnh & mục tiêu
Trang chủ exam.flyer.us là "bản đồ vũ trụ": mỗi chứng chỉ là một hành tinh (Starters, Movers, Flyers, KET, PET, TOEFL, IOE, IELTS, Study…) trên carousel 3D. Học sinh chọn hành tinh để vào luyện — kèm Cổng chọn chế độ học (Bingo Planet = phòng thi ảo, Giong Land = luyện tập).
- Trẻ em chọn được nơi học trong 5 giây, không cần đọc menu
- Một cửa dẫn tới mọi sản phẩm học sinh (exam/study/ielts)
- Bề mặt hiển thị gói: đảo khoá/mờ theo quyền
2Người dùng & user stories
| Vai trò | User story | Ưu tiên |
|---|---|---|
| Học sinh | Chọn hành tinh đúng chứng chỉ đang ôn để vào làm đề. | P0 |
| Học sinh mới | Được cổng chào hỏi chọn chế độ Thi ảo vs Luyện tập. | P0 |
| Phụ huynh/GV | Từ footer chuyển sang ứng dụng Phụ huynh/Giáo viên đúng vai. | P1 |
3Phạm vi & phase
| Phase | Nội dung | Trạng thái |
|---|---|---|
| Phase 1 | Carousel hành tinh + header ví/streak + footer tiện ích | Done |
| Phase 2 | Welcome Gate 2 chế độ (A/B Sprint 106) + Global Journey + đảo Trường của tôi | Done |
| Phase 3 | Hành tinh "Chó Mèo" (khối công) — trong kế hoạch A/B, chưa thấy asset trong code | Đề xuất |
4Luồng sản phẩm
- Vào exam.flyer.us → (lần đầu) Cổng chọn chế độ học → chọn hành tinh → vào bản đồ đề của đảo
- Đảo IELTS/Study mở tab ứng dụng riêng; đảo Trường của tôi → chương trình trường
5Spec UI — cho Designer
- Swiper coverflow hành tinh với Lottie riêng từng đảo; ribbon tên + mô tả; nhớ vị trí đảo gần nhất
- Header: ví Kim cương + Coin, streak, chuông thông báo, hồ sơ người chơi
- Footer: Kiểm tra trình độ · Sổ tay · lọc CEFR · gọi Bingo · Thầy cô/Phụ huynh · mời bạn · đổi thế giới
- Chuỗi modal ưu tiên khi vào home: WhatNews → nâng cấp → hoàn thiện hồ sơ → SĐT → nhắc bài tập → mời vào lớp → quà → placement → premium
- 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 |
|---|---|
| Đảo hiển thị | Lọc theo gói (activeFlyerPackages + testLevelsAllowed); đảo trường cần flag STUDENT_SCHOOL_EXAM |
| Welcome Gate | Hiện lần đầu + lặp sau 24h; tắt/bật bằng flag ENABLE_WELCOME_GATE |
| Khoá đảo | Server quyết định; hiện tại icon khoá hành tinh đang tạm tắt trong code |
7Data & API — cho Developer
- SSR /home với flags; GraphQL v2 test levels + packages; localStorage swipeIndex
- Route: / → /home; /testlevels/[slug]; cổng: study/ielts mở ứng dụng riêng
8Edge cases đã xử lý
| Case | Hành vi chuẩn |
|---|---|
| Animation nặng trên máy yếu | Fallback ExamBodyStatic khi remote config tắt animation |
| Đảo bị khoá | Có user → trang gói; khách → modal yêu cầu đăng nhập |
| 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
- Chọn hành tinh điều hướng đúng đảo/app
- Welcome Gate không hiện lại trong 24h sau khi chọn
- Đảo ngoài gói hiển thị trạng thái khoá đúng
- Chuỗi modal ưu tiên không chồng nhau
10Ngoài phạm vi / tương lai
- Hành tinh khối công ("Chó Mèo") theo phương án A/B Sprint 106
- Cá nhân hoá thứ tự đảo theo lịch sử học
← Danh mục PRD · Nguồn: quét codebase flyer-webs/apps/exam + số liệu read-replica production · 15/08/2026.