DOL Kid LMS - Exercise Home

DOL Kid - Exercise Home

Purpose

• Vấn đề: Sau khi vào Course Detail, user cần một màn list riêng cho Exercise để thấy toàn bộ bài tập làm thêm / bài về nhà của khóa offline, trạng thái hiện tại, và điểm của bài đã xong trước khi đi vào từng bài cụ thể.
• Đối tượng chính: Học viên chọn bài cần làm; phụ huynh nhìn nhanh bài nào đã xong, bài nào còn thiếu.
• Tín hiệu thành công: User vào đúng list exercise của khóa, thấy ngay bài nào cần làm, bài nào đã xong, điểm hiện có, rồi mở đúng Exercise Detail.

Scope Gate

• File này sở hữu Exercise Home (list) trong lane KID LMS.
• File này bao gồm:
  • danh sách exercise theo khóa,
  • trạng thái từng bài,
  • score/progress summary ở mức list,
  • CTA vào Exercise Detail.
• File này không sở hữu:
  • player làm bài,
  • scoring logic sâu,
  • filter/search kiểu bank,
  • dashboard tổng hợp ngoài course context.

Role In Flow

• Canonical flow:
  • LMS Home -> Course List -> Course Detail -> Exercise Home -> Exercise Detail.
• Exercise Home trả lời:
  • có những bài tập làm thêm / homework nào trong khóa offline,
  • bài nào cần làm ngay,
  • bài nào đã xong,
  • điểm đang ở mức nào.

Required Sections

• Exercise Header
  • course name,
  • lesson/unit context nếu đang đứng trong một cụm cụ thể,
  • CTA quay lại Course Detail.
• Progress Summary
  • tổng số bài,
  • số bài đã xong,
  • số bài đang làm dở,
  • score summary gọn nếu đã có dữ liệu.
• Exercise List
  • list card cho từng bài.
• Continue / Recommended Block
  • tối đa 1-2 item ưu tiên ở đầu list nếu cần.

Exercise Card Model

• title
• lesson / unit context
• estimated time
• status
• score hoặc completion chip nếu đã xong
• one primary CTA

State Model

• locked
  • chưa mở; có label lý do.
• not_started
  • có thể bắt đầu.
• in_progress
  • đang làm dở; CTA Làm tiếp.
• done_has_score
  • đã xong và có điểm; CTA Xem điểm.
• done_reviewable
  • đã xong, có thể xem lại hoặc làm lại.

Sorting Rules

1. Bài bắt buộc chưa làm
2. Bài đang làm dở
3. Bài vừa làm xong
4. Bài ôn lại / làm thêm

UX Rules

• Không biến Exercise Home thành exercise bank.
• Đây là màn companion practice list của khóa offline, không phải hub tự học độc lập.
• Không dùng filter/sort phức tạp ở baseline.
• User phải thấy score của bài đã xong ngay trên list nếu bài đó đã có điểm.
• Mỗi card chỉ có 1 CTA chính:
  • Bắt đầu,
  • Làm tiếp,
  • Xem điểm,
  • hoặc Làm lại.

Content Allocation Rule

• Exercise Header chỉ giữ course/lesson context.
• Continue / Recommended Block chỉ gợi ý 1-2 bài ưu tiên nhất.
• Progress Summary chỉ phản ánh mức hoàn thành của cụm homework hiện tại.
• Exercise Card chỉ trả lời bài này là gì và giờ nên làm gì với nó.
• Không để một card hoặc summary block đồng thời ôm:
  • course progress,
  • review đáp án chi tiết,
  • test-bank browsing,
  • hoặc leaderboard.

Progress Update Contract

• Sau khi user hoàn thành Exercise Detail:
  • card tương ứng trong list phải đổi state ngay,
  • score/completion chip được cập nhật,
  • summary block của Exercise Home cập nhật theo,
  • Course Detail cũng phản ánh lại progress mới của exercise lane.

References

• ./KID_LMS_Course_Management_Flow.md
• ./KID_LMS_Exercise_00_Overview.md
• ./KID_LMS_Exercise_Home_Content_Allocation.md
• ./KID_LMS_Exercise_Flow.md

Change log

• 2026-03-16: Tạo Exercise Home (list) làm lớp trung gian rõ giữa Course Detail và Exercise Detail.
• 2026-03-18: Làm rõ Exercise Home là list homework / bài tập làm thêm của khóa offline, không phải hub browse tự do.
• 2026-03-24: Thêm Content Allocation Rule và nối sang canon Exercise Home Content Allocation.