DOL English - Goal Scale Catalog (Web V2 Active)
DomainsDOL EnglishUX626 words3 min read
Reading Rule
Phần tiêu đề “Reading Rule”- File này là catalog UX active cho goal scale ở
Register,Home, vàAccount. - Nếu câu hỏi là auth shell, onboarding flow, hoặc nudge policy, đọc
REG_00_Overview.mdhoặcREG_Onboarding_Flow_Documentation.mdtrước. Discoverykhông phải reading path mặc định của file này.
Purpose
Phần tiêu đề “Purpose”- Định nghĩa thang điểm/mức năng lực chuẩn cho từng chương trình trong flow đặt mục tiêu.
- Làm nguồn dữ liệu duy nhất cho các màn goal picker ở Register, Home, Account.
Scope
Phần tiêu đề “Scope”- Chương trình áp dụng:
IELTSTOEICSATGiao tiếp
- Mỗi mục tiêu phải gắn đủ:
goal_program_idgoal_assessment_formgoal_skill_idgoal_scale_profile_idgoal_target_value
Program Scale Definitions (Active v1)
Phần tiêu đề “Program Scale Definitions (Active v1)”IELTS
Phần tiêu đề “IELTS”goal_scale_profile_id:ielts_band_0_9_step_0_5_v1- Dải điểm hợp lệ:
0.0 -> 9.0 - Bước nhảy:
0.5 - Áp dụng cho:
overalllisteningreadingwritingspeaking
- Ví dụ hợp lệ:
6.0,6.5,7.0,7.5
TOEIC
Phần tiêu đề “TOEIC”- TOEIC L&R tổng:
goal_scale_profile_id:toeic_lr_total_10_990_step_5_v1- Dải điểm:
10 -> 990 - Bước nhảy:
5
- TOEIC Listening/Reading theo kỹ năng:
goal_scale_profile_id:toeic_lr_skill_5_495_step_5_v1- Dải điểm:
5 -> 495 - Bước nhảy:
5
- TOEIC Speaking:
goal_scale_profile_id:toeic_speaking_0_200_step_10_v1- Dải điểm:
0 -> 200 - Bước nhảy:
10
- TOEIC Writing:
goal_scale_profile_id:toeic_writing_0_200_step_10_v1- Dải điểm:
0 -> 200 - Bước nhảy:
10
- Ví dụ hợp lệ:
- L&R tổng:
650,750,900 - Listening:
350 - Speaking:
140 - Writing:
160
- L&R tổng:
- SAT tổng:
goal_scale_profile_id:sat_total_400_1600_step_10_v1- Dải điểm:
400 -> 1600 - Bước nhảy:
10
- SAT theo section:
goal_scale_profile_id:sat_section_200_800_step_10_v1- Dải điểm:
200 -> 800 - Bước nhảy:
10
- Áp dụng section:
mathreading_writing
- Ví dụ hợp lệ:
- SAT tổng:
1200,1350,1500 - Math:
700 - Reading & Writing:
650
- SAT tổng:
Giao tiếp
Phần tiêu đề “Giao tiếp”goal_scale_profile_id:communication_cefr_level_v1- Dải mức năng lực hợp lệ:
A1A2B1B2C1C2
- Mapping thứ bậc nội bộ để so sánh tiến trình:
A1=1,A2=2,B1=3,B2=4,C1=5,C2=6
- Lưu ý:
- lane
Giao tiếpkhông hiển thị trường “điểm thi”. goal_target_valuelưu bằng level string (A1..C2), không ép numeric score.
- lane
UX Guardrails
Phần tiêu đề “UX Guardrails”- Goal picker phải render theo
program + assessment_form + skill, không dùng một field điểm chung cho mọi chương trình. - Chỉ hiển thị các giá trị thuộc dải hợp lệ của
goal_scale_profile_idđã chọn. - Khi dùng lane
Giao tiếp, UI dùng level picker (A1..C2) thay vì score input. - Numeric goal-gap chỉ hiển thị khi cặp
goal_scale_profile_idvàattempt_score_profile_idở trạng thái comparable (directhoặcnormalizedđã whitelist).
Source of Truth Contract
Phần tiêu đề “Source of Truth Contract”goal_scale_catalog_id = reg_goal_scale_catalog_v1goal_scale_catalog_version = 2026-03-04- Register, Home, Account phải dùng cùng catalog này để tránh lệch thang điểm.