Practice Flow - Overview

DomainsDOL EnglishUX746 words4 min read

activebyDOL Product Design

Practice Flow - Overview (Exercise Attempt and Result)

Nếu câu hỏi là toàn bộ shell/navigation/owner map của DOL English, đọc ../ENG_Navigation_00_Overview.md trước.
File này chỉ giữ PRA core logic; chỉ mở child docs khi cần đi sâu vào entry, attempt, result, hoặc impact sync.

Vấn đề: Flow làm bài và xem kết quả hiện đang xuất hiện từ nhiều điểm vào khác nhau, cần một module tài liệu chung để tránh lệch logic.
Đối tượng chính: Team UX/Product/Engineering triển khai flow làm bài tập xuyên module.
Tín hiệu thành công: Tất cả điểm vào đều dùng chung contract Attempt -> Result và đồng bộ dữ liệu nhất quán.

Practice Flow là owner overview của destination Luyện tập trong Program Workspace.
Program Workspace root / Hôm nay, Khóa học, search, notification, và recommendation surfaces chỉ launch hoặc resurface PRA objects; chúng không tự định nghĩa lại logic Attempt -> Result.
Attempt và Result là deep owner flows của Luyện tập, không phải destination ngang hàng trong shell.

Phạm vi module Practice Flow:
- Entry routing từ Home/Exercise Bank/Course Detail.
- Attempt flow khi user làm bài.
- Result flow sau khi nộp bài.
- Result impact contracts sang Learning Management và Vocabulary.
Nguồn entry chính hiện tại:
- Home & Discovery -> Program Landing -> Exercise Bank.
- Course Management -> Course Detail.
Ngoài phạm vi:
- Thiết kế pixel/UI component chi tiết cho mọi biến thể bài.

Pipeline chuẩn: Entry -> Attempt -> Result -> Impact Sync.
Kết quả bài tập dùng contract thống nhất và luôn mang source_context để phân biệt self_study và course.
Đồng bộ sau result:
- luôn cập nhật Learning Management,
- chỉ trigger Vocabulary khi bài có block gợi ý từ vựng.

Entry screens chỉ điều hướng vào PRA, không tự định nghĩa lại logic Attempt/Result.
Attempt screen tập trung hoàn thành bài trong phiên hiện tại.
AI Tutor baseline trong PRA là page-aware theo hai mode rất khác nhau:
- Attempt: AI chỉ đóng vai exercise coaching với integrity guardrail,
- Result: AI phải chuyển thành Analysis Panel / Feedback Workspace để biến score thành review và next step.
Attempt baseline:
- hỗ trợ untimed (default) và timed (simulation/full-test),
- có draft safety + resume,
- untimed draft giữ 7 ngày; timed draft chỉ trong cửa sổ timer,
- timed mode không manual pause; timer vẫn chạy khi background,
- submit non-blocking kèm review nhẹ,
- submit idempotent để tránh double-submit,
- submit lỗi transient có auto-retry (3 lần) trước khi hiển thị support CTA.
Result screen tập trung phản hồi kết quả và CTA hành động tiếp theo.

2026-03-19: Repoint Smart Search references sang canonical shared capability path.
2026-03-13: Bổ sung baseline AI Tutor cho Practice Flow: Attempt = coaching với guardrail, Result = analysis/feedback surface để tránh dùng cùng một AI behavior cho hai trạng thái khác nhau.
2026-03-06: Bổ sung tham chiếu Practice Types để tách lớp docs loại bài luyện tập ra khỏi Home & Discovery và đặt Kids Online Test vào đúng lane Practice.
2026-02-21: Bổ sung deep defaults vào overview: draft TTL, timed no-pause/background timer, auto-retry threshold + support CTA.
2026-02-21: Đồng bộ overview với attempt execution baseline (timed/untimed, draft safety, submit integrity).
2026-02-11: Liên kết PRA Overview với Smart Search Platform để thống nhất contract tìm kiếm và handoff vào Attempt/Result.
2026-02-07: Khởi tạo module Practice Flow và chốt pipeline chuẩn Entry -> Attempt -> Result.
2026-02-07: Chốt contract đồng bộ sau result sang Learning Management và Vocabulary.