DOL Kid LMS - Exercise Flow

DOL Kid - Exercise Flow

Purpose

• Vấn đề: KID cần flow làm exercise đủ ngắn và rõ để đi từ khóa học sang bài tập rồi quay lại đúng context mà không lạc route.
• Đối tượng chính: Học viên làm homework exercise; phụ huynh kiểm tra nhanh trạng thái và giao đúng việc cần làm.
• Tín hiệu thành công: User đi từ course/lesson vào đúng exercise, làm xong, và được trả về đúng lesson / practice / course với bước tiếp theo rõ ràng.

Scope Gate

• File này sở hữu end-to-end flow cho Exercise trong KID LMS.
• File này bao gồm:
  • điểm vào,
  • Exercise Home (list),
  • Exercise Detail,
  • contract route tối thiểu,
  • hành vi attempt,
  • result và return path.
• File này không sở hữu:
  • engine chi tiết của từng mini-game,
  • online test,
  • browse logic kiểu bank,
  • report/analytics sâu sau bài.

Product Assumption

• KID Exercise v1 ưu tiên auto-scored objective exercise.
• Các biến thể subjective hoặc AI-heavy không phải baseline hiện tại.
• Mục tiêu trước mắt là xây flow chắc cho homework và reinforcement ngắn.

Entry Sources

1. LMS Home > Next Action Hero

• Khi việc cần làm ngay là homework exercise; CTA đưa vào Course List hoặc course đã highlight.

2. LMS Home > Today / This Week Tasks

• Khi exercise đang đến hạn hoặc đang làm dở.

3. Course Detail > Overview

• Khi block Homework / practice gần nhất deeplink vào exercise.

4. Course Detail > Learn

• Đây là entry quan trọng nhất.
• Lesson item có homework CTA đi vào Exercise Home của khóa với bài cần làm được highlight.

5. Course Detail > Practice

• Dùng khi user chủ động mở lane exercise trong khóa; đích đến là Exercise Home.

6. Result next step

• Sau khi hoàn thành một activity liên quan, hệ thống có thể gợi ý exercise kế tiếp hoặc review exercise.

Required Routing Context

• child_id
• course_id
• exercise_id
• source_context
• returnTo

Optional Routing Context

• lesson_id
• unit_id
• practice_group_id
• attempt_resume_key
• homework_type = required | optional

Flow Summary

1. User thấy CTA Làm bài tập từ một source surface hợp lệ.
2. Nếu vào từ LMS Home, user có thể đi qua Course List và Course Detail.
3. Nếu đã ở Course Detail > Overview / Learn / Practice hoặc từ Result next step, flow có thể vào thẳng Exercise Home.
4. User vào Exercise Home.
5. Chọn 1 bài trong list.
6. Hệ thống xác định child + course + exercise + source_context + returnTo.
7. Vào Exercise Detail.
8. User làm bài.
9. Submit thành công.
10. Hiển thị done / xem điểm trong Exercise Detail.
11. Quay lại Exercise Home.
12. Progress và score sync lại về Exercise Home và Course Detail.

Screen-Level Logic

1. Source Surface

• LMS Home, Course List, và Course Detail chỉ đóng vai trò điều hướng.
• Các card/row ở tầng này phải trả lời đủ:
  • đây là bài gì,
  • có bắt buộc không,
  • mất khoảng bao lâu,
  • CTA chính là gì.
• Không nhảy thẳng vào attempt trong canonical flow mới.

2. Exercise Home

• Đây là list screen bắt buộc trước Exercise Detail.
• Mỗi card cần có:
  • title,
  • lesson context,
  • status,
  • score nếu đã xong,
  • CTA chính.
• Nếu user vào từ lesson homework:
  • bài liên quan được highlight ở đầu list.

3. Exercise Detail

• Exercise Detail sở hữu cả 2 state:
  • Do exercise,
  • Done / Xem điểm.

4. Do Exercise

• Ưu tiên một vùng làm bài rõ ràng, ít nhiễu.
• Header tối thiểu gồm:
  • tên bài,
  • lesson context ngắn,
  • progress,
  • exit nhẹ.
• Baseline behavior:
  • scene ngắn, task rõ, ưu tiên 2-4 micro activities,
  • auto-save draft,
  • có thể thoát và làm tiếp,
  • submit chỉ finalize một lần,
  • mặc định untimed.

5. Done / Xem điểm

• Sau submit thành công, Exercise Detail chuyển sang state hoàn thành.
• State này phải ngắn hơn result của English practice.
• Nội dung ưu tiên:
  • Bạn đã xong bài,
  • điểm hoặc mức hoàn thành,
  • 1 điều cần nhớ,
  • bước tiếp theo.
• CTA chính chỉ nên là một trong ba lựa chọn:
  • Quay lại danh sách bài,
  • Xem bài tiếp theo,
  • Làm lại.

Attempt Rules For KID

• List before detail
  • User luôn đi qua Exercise Home trước khi mở bài chi tiết.
• Resume over restart
  • Nếu có draft hợp lệ, CTA đổi thành Làm tiếp.
• Gentle submit
  • Bài rất ngắn không cần review screen nặng.
  • Nếu còn câu bỏ trống, dùng nhắc ngắn thay vì chặn cứng.
• No formal-test pressure
  • Không dùng ngôn ngữ hoặc UI giống test formal.

Result Rules For KID

• Immediate result first
  • Exercise baseline nên trả kết quả ngay sau submit.
• Celebration before analysis
  • Result state nên mở bằng cảm giác xong rồi hoặc reward nhẹ trước khi user đọc score.
  • Nếu có score, score hiển thị rõ nhưng đứng sau completion signal.
• Same-context return
  • CTA chính sau khi xong bài là quay lại Exercise Home.
  • Exercise Home sau đó phản ánh lại điểm và trạng thái mới.
  • Course Detail cũng phải nhận update progress ở lane exercise.
• Next action clarity
  • Chỉ hiển thị 1 bước tiếp theo ưu tiên, không liệt kê quá nhiều gợi ý song song.

Priority Rules

1. Required homework exercise
2. Exercise đang làm dở
3. Exercise lesson reinforcement
4. Exercise review / retry

State Model / Edge Cases

• exercise_locked
  • Hiển thị lý do lock ngắn + CTA quay lại lesson/course.
• exercise_not_found
  • Fallback về Exercise Home của khóa; nếu không còn context đủ thì về Course Detail.
• expired_returnTo
  • Fallback về Exercise Home; nếu không đủ context thì về Course Detail > Practice.
• draft_exists
  • Resume vào đúng draft mới nhất hợp lệ.
• submit_retry_needed
  • Giữ nguyên đáp án và cho retry, không mất tiến độ.
• just_completed_required_homework
  • Bước tiếp theo ưu tiên quay lại Exercise Home, sau đó gợi ý homework kế tiếp trong cùng khóa.
• no_more_related_exercise
  • CTA về Exercise Home hoặc Course Detail, không để dead-end.

UI / Behavior

• Copy ngắn, rõ, thân thiện với trẻ.
• Hit area lớn, tiến độ dễ đọc, trạng thái đang lưu / đã xong / làm tiếp phải rõ.
• Giữ breadcrumb ngắn theo course > lesson > exercise.
• Không đẩy user sang hub khác sau khi submit.

Integration Contracts

• Course Detail > Learn là source ưu tiên cho homework exercise, nhưng đích đến vẫn là Exercise Home.
• Course Detail > Practice là source tổng quát để mở lane exercise trong khóa.
• Exercise Home là source trực tiếp để mở Exercise Detail.
• Practice Flow giữ contract draft/save/submit/result ở tầng engine chung.
• returnTo sau submit mặc định quay về Exercise Home.
• Progress update sau submit phải phản ánh ở cả Exercise Home và Course Detail.

Metrics / Analytics

• kid_exercise_open_rate
• kid_exercise_start_rate
• kid_exercise_completion_rate
• kid_exercise_resume_rate
• kid_exercise_result_to_return_rate

References

• ./KID_LMS_Exercise_00_Overview.md
• ./KID_LMS_Course_Management_Flow.md
• ./KID_LMS_Practice_Launcher.md
• ./KID_LMS_Exercise_Home.md
• ../../../../DOL English/UX Design/Practice Flow/PRA_Entry_Routing_Contracts.md
• ../../../../DOL English/UX Design/Practice Flow/PRA_Attempt_Flow.md
• ../../../../DOL English/UX Design/Practice Flow/PRA_Result_Flow.md

Change log

• 2026-03-16: Tạo flow Exercise cho KID LMS với baseline course-linked -> attempt -> short result -> same-context return.
• 2026-03-16: Cập nhật canonical flow thành LMS Home -> Course List -> Course Detail -> Exercise Home -> Exercise Detail -> Done/Xem điểm -> Progress sync.