DOL English Exercise Banks - Overview

DomainsDOL EnglishUX884 words4 min read

activebyDOL Product Design

DOL English - Exercise Banks Overview (Home & Discovery)

Purpose

Vấn đề: Các bank theo chương trình khác nội dung nhưng giống khung trang, cần mô hình tài liệu tránh lặp.
Đối tượng chính: Team quản lý hệ thống tài liệu bank pages và flow vào PRA.
Tín hiệu thành công: Tài liệu bank dùng chung 1 cấu trúc; mỗi file chương trình chỉ khai báo phần khác biệt nội dung.

Reading Rule

Nếu cần full navigation canon, mở ../../ENG_Navigation_00_Overview.md trước.
File này chỉ giữ bank-layer shared structure + launcher routing, không thay feature-master của navigation.

Shell Fit

Exercise Bank là self-browse launcher/selection surface của Luyện tập bên trong lane Home & Discovery.
Bank sở hữu quyết định tự chọn bài nào trong kho, nhưng không sở hữu attempt lifecycle, result lifecycle, hay analytics owner logic.
Khi user đi sâu vào làm bài/kết quả, canonical owner flow phải chuyển sang Practice Flow.

Legacy Source Key Note

discover_menu vẫn có thể tồn tại như source key nội bộ cho backward-compatible routing.
Key này không phải nav label canon; khi mô tả UX hiện tại nên đọc nó như discovery/program entry.

Elements / Scope

Mô hình tài liệu 2 lớp:
1. Shared Structure (SSOT về layout và contract route).
2. Content Profile theo từng program/skill.
Entry routes chuẩn cho cụm bank:
- từ Self-study Hub,
- từ Program Landing,
- từ discovery/program entry (discover_menu source key),
- từ deeplink trực tiếp.
Baseline thiết kế đã xác nhận:
- Mẫu IELTS Reading Bank là chuẩn tham chiếu layout cho các bank còn lại.
- Các bank khác kế thừa cùng cấu trúc và chỉ thay nội dung/filter profile.
Program coverage:
- IELTS (confirmed/high-level)
- SAT (active baseline)
- TOEIC (active baseline)
- Communication (active baseline)
Flow phạm vi của cụm bank:
- Program Landing -> Exercise Bank -> PRA Attempt -> PRA Result.

Logic

Bank-layer owner rule:
- Program Landing trả lời ưu tiên program/module nào.
- Exercise Bank trả lời nếu muốn tự chọn thì sẽ làm bài nào trong kho này.
- Vì vậy bank không làm thay role recommendation chiến lược của landing, không làm thay owner flow Attempt -> Result của PRA, và không làm thay diagnosis của Learning Management.
Mọi bank page kế thừa cấu trúc từ HOME_ENG_Exercise_Bank_Shared_Structure.md.
File program/skill không lặp mô tả layout chung, chỉ ghi:
- title/subtitle nội dung,
- filter options,
- danh sách nhóm bài của bank đó.
Khác biệt giữa banks được khóa theo 3 biến:
- catalog_profile_id (danh mục bài),
- filter_profile_id (bộ lọc),
- skill/program semantics (ngữ nghĩa nội dung).
Canonical form contract cho toàn bộ banks:
- mỗi item/attempt phải map vào 1 assessment_form_id ổn định,
- metadata tối thiểu của form:
  - program_id,
  - skill_id,
  - scoring_family,
  - score_profile_id,
  - timing_family.
Mọi tích hợp Goal/Recommendation/Metrics đọc form-level theo assessment_form_id thay vì đọc tên filter thô.
Week-1 activation starter dependency:
- activation card của Home resolve starter theo program phải đọc từ catalog/form metadata của bank,
- step-2 activation ưu tiên continuity cùng program + assessment form gần nhất từ step-1 submission.
Entry từ discovery/program entry phải mở đúng ngữ cảnh program/skill thay vì về trang trung gian.
Đồng bộ sau result theo contract PRA (LM always-on, Vocabulary conditional).

UI / Behavior

Người dùng luôn thấy cùng một nhịp trang: Title -> Subtitle -> Filter -> Exercise List.
Khác biệt giữa banks nằm ở danh mục bài tập và labels filter.
Search/sort/view controls luôn đặt cùng một vị trí để giảm tải học lại giao diện.
User quay lại bank sau result phải giữ context gần nhất.
Dù có stats/pulse nhẹ, quyết định chính của page vẫn là chọn bài trong kho.

References

Change log

2026-02-22: Bổ sung dependency cho week-1 activation starter: Home activation card resolve starter theo form metadata của bank và giữ continuity step-2 cùng program/assessment form.
2026-02-21: Chốt canonical assessment_form_id contract cho toàn cụm bank và nâng SAT/TOEIC/Communication lên active baseline (leaf taxonomy vẫn mở rộng ở content profile layer).
2026-03-26: Làm rõ discover_menu chỉ là source key legacy; trong UX hiện tại phải đọc như discovery/program entry, không phải nav label canon.
2026-02-08: Chốt thêm route vào bank từ discovery/program entry và baseline layout theo thiết kế IELTS Reading Bank.
2026-02-08: Bổ sung nguyên tắc khác biệt theo catalog_profile_id và filter_profile_id để mô tả rõ điểm giống/khác giữa các banks.
2026-02-07: Chuyển sang mô hình tài liệu 2 lớp (Shared Structure + Content Profile) để giảm lặp.