FLYER Product · Phân tích nội bộ · 06/09/2026
Onboarding giáo viên — lịch sử 6 phiên bản, hiệu quả thật, và ảnh từng bước
Tài liệu dựng lại toàn bộ các phiên bản onboarding từ 2024 tới nay bằng cách đọc ngược dấu vết trong trường onboarding_info của database, kèm hiệu quả đo được của từng bản. Mục đích: chọn đúng phiên bản để khôi phục.
Kết luận ngắn: bản đang chạy (V6 — Sprint 107) là bản có hiệu quả thấp nhất trong cả sáu phiên bản ở mọi chỉ số. Bản tốt nhất về tỷ lệ giao bài là V2 — Khảo sát dài (17,0%), bản tốt nhất về tạo lớp và đưa học sinh vào hệ thống là V1 — Ghi lộ trình click (15,9% tạo lớp, 9,4% có học sinh thật). Nếu chỉ khôi phục được một bản, V3 (Freelance + Free trial) là lựa chọn cân bằng nhất: D7 15,5%, D30 cao nhất 20,3%.
Mốc đối chứng V0 — khi chưa có onboarding: cohort 2023 (4.989 giáo viên, trước khi bất kỳ luồng onboarding nào tồn tại) chỉ đạt D7 5,7% và D30 7,7%. Mọi phiên bản onboarding đều cao hơn hẳn mốc này — kể cả bản kém nhất V6 (10,9%) vẫn gần gấp đôi V0. Nghĩa là: câu hỏi không phải “có nên giữ onboarding không”, mà là “bản nào tốt nhất”. Lưu ý khi đọc con số V0: năm 2023 sản phẩm còn ít tính năng và lượng đăng ký khác hẳn hiện nay, nên đây là mốc tham chiếu chứ không phải nhóm đối chứng của một thí nghiệm.
1.So sánh sáu phiên bản — và mốc chưa có onboarding
Mỗi giáo viên được gán phiên bản theo ngày tạo tài khoản chứ không theo cờ hoàn thành, để tránh thiên lệch (cờ hoàn thành chỉ gắn cho người đi hết luồng). Đã loại tài khoản autotest, email nội bộ, tên chứa “test”/“demo”, và toàn bộ bài mẫu hệ thống tự sinh.
Giải thích cột: Giao bài D7/D30 = tỷ lệ giáo viên giao bài tập thật trong 7 và 30 ngày đầu · Tạo lớp = tạo được lớp thật trong 7 ngày (đã loại lớp Placement test và Sample Class do hệ thống tự sinh) · Có học sinh = lớp thật đó có ít nhất một học sinh. Hàng V0 là mốc đối chứng “chưa có onboarding” (cohort 2023). Bật/tắt các ô ở trên để xem từng nhóm giáo viên — mặc định loại nhóm automation/kiểm thử.
Phát hiện từ bộ lọc — vì sao V3 đáng khôi phục hơn ta tưởng: cột “Tạo lớp” của V3 là 79%, trong khi V6 chỉ 11,3%. Lý do nằm trong mã nguồn chứ không phải may mắn: V3 ép giáo viên tạo lớp ngay sau khảo sát (
Lưu ý: hai cột “Tạo lớp” và “Có học sinh” đã được tính lại bằng định nghĩa ghi ở dưới bảng (lớp thật trong 7 ngày, loại lớp hệ thống tự sinh) nên khác với con số trong bản tài liệu trước; cột “HS làm bài” đã bỏ vì không tách được theo nhóm giáo viên.
WelcomeModal gọi router.replace(PATH.ONBOARDING_CREATE_CLASS)), rồi nối tiếp bằng màn mời học sinh — xem hai ảnh cuối phần V3 bên dưới. V6 bỏ hẳn bước ép này, chỉ gợi ý trong Quick Start. Vì “tạo lớp → có học sinh” chính là nút thắt của toàn bộ phễu, đây là ứng viên số một để khôi phục, và có thể khôi phục riêng bước này mà không cần quay lại toàn bộ khảo sát dài của V3.Lưu ý: hai cột “Tạo lớp” và “Có học sinh” đã được tính lại bằng định nghĩa ghi ở dưới bảng (lớp thật trong 7 ngày, loại lớp hệ thống tự sinh) nên khác với con số trong bản tài liệu trước; cột “HS làm bài” đã bỏ vì không tách được theo nhóm giáo viên.
Điều bộ lọc cho thấy — quan trọng khi đọc bảng trên: khoảng cách giữa các nhóm giáo viên lớn hơn nhiều khoảng cách giữa các phiên bản onboarding. Ở bản đang chạy V6: giáo viên thuộc trường B2B đạt D7 38,5% và giáo viên do sales/CS tạo từ admin đạt 20,4%, trong khi giáo viên tự đăng ký chỉ 7,4%. Xu hướng này đúng ở mọi phiên bản (V3: 31,2% · 19,4% · 10,7%). Thêm nữa, cơ cấu nguồn đăng ký đã đổi hẳn: nhóm tự đăng ký chiếm 30% ở V3 nhưng lên tới 66% ở V6 — nên một phần mức sụt của V6 đến từ việc nhiều giáo viên tự đăng ký hơn, chứ không hẳn do luồng onboarding kém đi. Muốn so sánh công bằng giữa các phiên bản, hãy chỉ tick một nhóm rồi đọc lại bảng: riêng nhóm tự đăng ký, D7 là V2 6,8% · V3 10,7% · V4 3,5% · V5 8,0% · V6 7,4% — V3 vẫn tốt nhất, nhưng V6 không còn là bản tệ nhất.
Lưu ý về cách ghi nhận nguồn: trường
Lưu ý về cách ghi nhận nguồn: trường
source_domain được ghi khác nhau qua từng thời kỳ (V1 hầu như không có nhãn “tự đăng ký”), nên phần chênh lệch cơ cấu giữa V1–V2 và V5–V6 có thể một phần do cách gắn nhãn chứ không hoàn toàn do thị trường.2.Diễn biến theo tháng
Tỷ lệ giao bài trong 7 ngày, theo tháng đăng ký
Vạch dọc = mốc đổi phiên bản. Đường tím = % giáo viên giao bài trong 7 ngày.
3.Chi tiết từng phiên bản
Các bước được dựng lại từ những key thực sự xuất hiện trong onboarding_info ở khoảng thời gian đó. Nhãn xanh là câu hỏi khảo sát, xanh lá là cờ hoàn thành.
4.Hình ảnh từng bước theo phiên bản
Mỗi phiên bản dưới đây được dựng lại theo đúng thứ tự bước mà giáo viên nhìn thấy. Nhãn Ảnh chụp thật là ảnh chụp production hoặc file ảnh gốc lấy từ repo; nhãn Dựng lại từ mã nguồn là màn hình được vẽ lại theo đúng câu chữ và đúng thứ tự trường đọc từ component + file ngôn ngữ tại commit của thời kỳ đó — bố cục là tương đối, câu chữ là chính xác. Các phiên bản cũ không thể chụp lại vì đã bị gỡ khỏi production.
V0 — Chưa có onboardingDựng lại từ mã nguồn
V1 — Ghi lộ trình clickDựng lại từ mã nguồnAsset gốc trong repo
image-step-2.png lấy trực tiếp từ repo tại commit thời kỳ này.
image-step-4.png — bộ 4 hình minh hoạ đi kèm thanh Bắt đầu.Nguồn chữ: dashboard.onboarding.* trong src/locales/vi/common.json, commit 5bd852f36 (30/08/2024). Hai ảnh cuối là file gốc trong repo, không phải dựng lại.
V2 — Khảo sát dàiDựng lại từ mã nguồn
Nguồn chữ: welcome_modal.* và component WelcomeModal/steps/{ChooseRole,AboutYour,YourSchool,ReasonKnow}.tsx.
V3 — Freelance + Free trialDựng lại từ mã nguồn
is_freelance_teacher xuất hiện 3.813 lần.
isViewFreeTrialActivated (1.055) và isViewFreeTrialExpired (651) ghi lại việc giáo viên nhìn thấy banner.
router.replace(PATH.ONBOARDING_CREATE_CLASS)) — “Hành trình giảng dạy bắt đầu từ một lớp học.”
Nguồn chữ: welcome_modal.* + welcome_modal.free_trial*, commit 9640b4f0a (29/08/2025).
Chi tiết theo tháng 10 · 11 · 12 năm 2025 (bên trong V3)Dựng lại từ mã nguồn
Kết quả so sánh: phần khảo sát 4 bước hoàn toàn không đổi trong cả ba tháng. Tháng 10 → tháng 11 chỉ có một thay đổi kỹ thuật không nhìn thấy được (bỏ ghi
school_id khi giáo viên chọn “Khác”). Thay đổi thật nằm ở tháng 12: màn “Bắt đầu nhanh” được viết lại toàn bộ và bổ sung 52 chuỗi mới — trong đó có nhóm “Xem kết quả bài kiểm tra” chính là tiền thân của V4 (commit implement onboarding tour 17/12/2025), phát hành cho giáo viên mới từ 31/12/2025.
index.tsx và AboutYour.tsx đổi, và đổi ở phần xử lý dữ liệu chứ không phải phần hiển thị.
Nguồn: src/locales/vi/common.json (nhánh onboarding.quick_start.*: 75 key ở T10/T11 → 90 key ở T12) và các component trong WelcomeModal/.
V4 — Sprint 97Dựng lại từ mã nguồn
viewed_listening_reading_results (394).
viewed_writing_results (419) — loại kết quả được xem nhiều nhất trong bản này.
viewed_speaking_results (407).
viewed_create_class (670) — bước được ghi nhận nhiều nhất, nhưng chỉ 160 lớp thật được tạo.Bản này vẫn giữ khảo sát của V3 ở đầu luồng (các key khảo sát vẫn xuất hiện), phần mới là tour 4 loại kết quả.
V5 — Sprint 100 · Welcome tourDựng lại từ mã nguồn
completed_welcome_onboarding).
viewed_class_route (622).
viewed_student_route (524).
viewed_explore_route (846), chặng được xem nhiều nhất.
viewed_program_route (675).Nguồn chữ: create_class_driver_steps.*, create_student_driver_steps.*, explore_driver_steps.*, program_steps.* trong src/locales/vi/onboarding.json.
V6 — Sprint 107 · v4 (đang chạy)Ảnh chụp thậtAsset gốc trong repo
onboarding_goal (1.251).
completed_onboarding_v4).
quick-start/explore-vi.png lấy từ repo — đúng hình giáo viên đang thấy trên production.
quick-start/create-class-vi.png.
quick-start/ai-writing-vi.png — nhánh mục tiêu “Dùng AI hỗ trợ giảng dạy”.
quick-start/my-library-vi.png — nhánh mục tiêu “Số hóa đề/bài tập của tôi”.Bốn ảnh đầu và ảnh Bắt đầu nhanh là chụp thật trên teacher.teado.ai (cùng mã nguồn với teacher.flyer.us) bằng tài khoản mới; các thumbnail Quick Start là file PNG gốc trong repo tại commit c04560c76.
5.Đọc kết quả thế nào cho đúng
- Không kết luận nhân quả từ bảng này. Sáu phiên bản chạy ở sáu thời kỳ khác nhau, nên chênh lệch có thể do chất lượng nguồn đăng ký chứ không do luồng onboarding. Bằng chứng: trong cùng kỳ T7–T8/2026, nhóm hoàn thành v4 đạt D7 10,7% còn nhóm không hoàn thành đạt 10,5% — gần như bằng nhau.
- Nhưng mức sụt của V6 là thật và đủ lớn để hành động. So cùng mùa cùng quy mô: T7–T8/2025 (1.899 GV, bản V3) đạt D7 14,4%; T7–T8/2026 (1.791 GV, bản V6) chỉ 10,7%. Tỷ lệ có học sinh thật rơi từ 5–9% xuống 2,2% — đây là chỉ số xấu đi mạnh nhất.
- Nút thắt nằm ở việc nạp học sinh, không phải giao bài. Chỉ 2–9% giáo viên mới có học sinh thật, trong khi tỷ lệ giao bài là 11–17%. Học sinh khi đã được giao bài vẫn nộp bình thường (33–64%), nên phía học sinh không phải chỗ hỏng.
- Muốn biết chắc bản nào tốt hơn thì phải A/B. Cách đo đã sẵn sàng, phần cần dev làm chỉ là gắn nhãn nhánh ngay lúc tạo tài khoản: thêm
{"key":"onboarding_variant","value":"A"}hoặc"B"vàoonboarding_info. Với tỷ lệ nền ~13% và muốn phát hiện chênh lệch 3 điểm phần trăm, cần khoảng 2.500 giáo viên mỗi nhánh, tương đương 5–6 tuần ở lượng đăng ký hiện tại.
6.Đề xuất cho việc khôi phục
| Phương án | Nội dung | Cơ sở |
|---|---|---|
| 1. Khôi phục V3 an toàn nhất |
Quay lại luồng Freelance + Free trial (16/06 → 30/12/2025): giữ khảo sát ngắn, có banner dùng thử. | D30 cao nhất (20,3%), D7 15,5%, quy mô mẫu lớn (4.406 GV) nên số liệu đáng tin. |
| 2. Khôi phục V1 cho phần tạo lớp | Bỏ tour dẫn dắt, để giáo viên tự thao tác và chỉ ghi nhận hành vi. | Tạo lớp 15,9% và có học sinh thật 9,4% — cao nhất trong sáu bản, gấp 4 lần V6. |
| 3. Giữ V6 nhưng A/B với V3 khuyến nghị |
Chia ngẫu nhiên 50/50 giáo viên mới, gắn nhãn nhánh, đo D7 sau 5–6 tuần. | Chưa có bằng chứng nhân quả nào cho thấy V6 gây ra mức sụt; A/B là cách duy nhất kết luận chắc. |
Cần dev xác nhận trước khi khôi phục: tài liệu này dựng lại từ dấu vết dữ liệu, không phải từ mã nguồn. Các bước của từng bản là suy ra từ những key được ghi nhận, nên có thể thiếu bước nào không ghi log. Đề nghị đối chiếu với repo
partner-web theo số sprint 97 / 100 / 107 trước khi chốt.Nội bộ FLYER · số liệu chốt 06/09/2026 · dữ liệu chi tiết từng giáo viên: data.flyer.vn/onboarding-2026 · ← Roadmap