FLYER Học sinh (exam.flyer.us) · PRD · Sprint 110
👤 Tài khoản & hồ sơ người chơi
Một tài khoản (SĐT/username/Google) chứa nhiều "người chơi" (learner profiles) — đúng mô hình gia đình nhiều con. Kèm onboarding 5 bước có cốt truyện "Viên Đá Trí Tuệ", OTP, captcha, và cầu chuyển vai sang ứng dụng Giáo viên/Phụ huynh.
📈 Số liệu production (15/08/2026)483.758 tài khoản1,68 triệu hồ sơ người chơi
1Bối cảnh & mục tiêu
Một tài khoản (SĐT/username/Google) chứa nhiều "người chơi" (learner profiles) — đúng mô hình gia đình nhiều con. Kèm onboarding 5 bước có cốt truyện "Viên Đá Trí Tuệ", OTP, captcha, và cầu chuyển vai sang ứng dụng Giáo viên/Phụ huynh.
- Đăng ký không ma sát cho phụ huynh lẫn trẻ
- Nhiều con dùng chung 1 tài khoản, dữ liệu tách bạch
- Onboarding gieo thói quen học ngay ngày đầu
2Người dùng & user stories
| Vai trò | User story | Ưu tiên |
|---|---|---|
| Phụ huynh | Tạo tài khoản, thêm hồ sơ cho từng con. | P0 |
| Học sinh | Chọn người chơi của mình khi vào học. | P0 |
| Người mới | Được dẫn dắt 5 bước + tour sản phẩm. | P1 |
3Phạm vi & phase
| Phase | Nội dung | Trạng thái |
|---|---|---|
| Phase 1 | Login/signup + OTP + profiles + edit hồ sơ | Done |
| Phase 2 | Onboarding wizard 5 bước + driver tour (flag STUDENT_ONBOARDING) + luồng cập nhật SĐT (104) | Done |
| Phase 3 | Guest mode ứng dụng (backlog 108) | Đề xuất |
4Luồng sản phẩm
- Đăng ký (SĐT+OTP / Google) → tạo hồ sơ đầu (tên + ngày sinh) → onboarding chọn cấp độ/mục tiêu → tour → vào học
- Nhà nhiều con: /profiles → Đổi người chơi
- Là GV/PH: ChooseRoleModal → chuyển đúng ứng dụng
5Spec UI — cho Designer
- Màn login tối giản + Google Sign-in; signup bản mới (signup-new + ứng dụng signup riêng)
- /profiles dạng chọn avatar người chơi kiểu Netflix; edit hồ sơ có Kim cương/Kinh nghiệm/Điểm chuyên cần
- Onboarding: cốt truyện Viên Đá Trí Tuệ, chọn Tiểu học/THCS/THPT, kỹ năng muốn cải thiện, thời lượng học/ngày
- 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 |
|---|---|
| OTP | Giới hạn tần suất; lỗi số dùng quá nhiều lần có message riêng |
| Hồ sơ ẩn danh | Có giới hạn tạo; nhắc đăng nhập khi chạm trần |
| Vai trò | GV/PH được điều hướng sang ứng dụng tương ứng (redirect /partner/*, /parent/*) |
7Data & API — cho Developer
- users 484k · learner_profiles 1,68M (1 user nhiều profile); onboardingInfo persist TOUR_COMPLETED
- Route: /login, /signup(+-new), /recover, /profiles, /create-profile, /edit-profile, /verify-account
8Edge cases đã xử lý
| Case | Hành vi chuẩn |
|---|---|
| Quên mật khẩu | /recover qua OTP |
| Link lời mời có sẵn lớp/đề | Giữ redirect qua toàn luồng đăng ký |
| Đổi người chơi giữa chừng | Dữ liệu học tách theo profile, không lẫn |
| 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
- 1 tài khoản tạo/quản lý nhiều hồ sơ
- OTP giới hạn đúng và có đếm ngược
- Onboarding hoàn tất không lặp lại (persist)
- Chuyển vai GV/PH đúng ứng dụng đích
10Ngoài phạm vi / tương lai
- Guest mode trên ứng dụng (backlog 108)
- Đăng nhập bằng Zalo (phù hợp phụ huynh VN)
← Danh mục PRD · Nguồn: quét codebase flyer-webs/apps/exam + số liệu read-replica production · 15/08/2026.