Bỏ qua để đến nội dung
DOL Wiki

Practice Flow - Practice Types Overview

DomainsDOL EnglishUX565 words3 min read
activebyDOL Product Design

Purpose

Phần tiêu đề “Purpose”
  • Vấn đề: Practice Flow đã có contract entry/attempt/result, nhưng lớp mô tả các loại bài luyện tập còn mỏng, dễ bị đặt nhầm vào Home & Discovery hoặc các module chỉ có vai trò launcher.
  • Đối tượng chính: Team UX/Product/Content cần một chỗ đặt docs cho các loại bài luyện tập như Online Test, Exercise, Final Test, và các lane practice-adjacent khác.
  • Tín hiệu thành công: Tài liệu theo loại bài nằm đúng under Practice, không lẫn với docs giới thiệu/landing, và có thể mở rộng thêm loại bài mới mà không phá cấu trúc PRA hiện có.

Shell Fit

Phần tiêu đề “Shell Fit”
  • Practice Types là taxonomy layer bên trong destination Luyện tập, không phải primary destination riêng.
  • Các type docs giúp phân loại inventory/tool trong PRA; chúng không thay owner flow Entry -> Attempt -> Result.

Elements / Scope

Phần tiêu đề “Elements / Scope”
  • Folder area này dùng để mô tả practice types, không mô tả Home entry hay Course marketing surface.
  • Taxonomy mục tiêu của practice area:
    • Practice > Exercise
    • Practice > Online Test
    • Practice > Final Test
    • Practice > Vocabulary hoặc practice-adjacent vocabulary lane khi cần index cùng cụm luyện tập
  • Mỗi practice type nên có cấu trúc docs 3 lớp:
    1. Type Overview
    2. Domain/Program profile
    3. Skill profile
  • PRA core docs vẫn là SSOT cho:
    • Entry Routing
    • Attempt
    • Result
    • Impact Sync

Logic

Phần tiêu đề “Logic”
  • Home & Discovery chỉ mô tả điểm vào hoặc launcher vào practice; không sở hữu docs nội dung của từng loại bài luyện tập.
  • Practice type docs mô tả:
    • bản chất loại bài,
    • scoring semantics,
    • explanation semantics,
    • taxonomy nội bộ,
    • level/program differences.
  • PRA core docs mô tả:
    • attempt lifecycle,
    • submit integrity,
    • result lifecycle,
    • sync contracts.
  • Với lane có module riêng mạnh như Vocabulary Management, tài liệu vẫn có thể sống ở module riêng; overview này chỉ dùng để định vị nó trong practice umbrella khi cần nhìn theo góc độ “luyện tập”.

Current doc coverage snapshot

Phần tiêu đề “Current doc coverage snapshot”
  • Practice > Online Test > Kids (active)
    • Reading & Writing
    • Listening
    • Speaking
  • Practice > Exercise with AI (draft)
    • Speaking: đã có draft cho 7 dạng bài.
    • Writing: placeholder.
    • Reading: placeholder.
  • Course Detail > Exercises / Online Tests / AI Mock Test / Final Test
    • Hiện đã có doc ở lane Course Management như course-local launcher/view.
    • Lớp taxonomy Practice Types cho các nhánh này vẫn còn mỏng và chưa normalize đồng đều như Online Test > Kids hoặc Exercise with AI.

References

Phần tiêu đề “References”

Change log

Phần tiêu đề “Change log”
  • 2026-04-06: Thêm snapshot coverage hiện tại để phản ánh Exercise with AI đang được draft trong lane Practice Types, đồng thời ghi rõ các launcher/view course-local đã tồn tại nhưng chưa normalize đầy đủ về taxonomy.
  • 2026-03-06: Tạo Practice Types Overview để tách lớp docs loại bài luyện tập khỏi Home & Discovery.
  • 2026-03-06: Chốt rule phân vai: Home/Course/Learning là entry surfaces; Practice sở hữu docs về Online Test, Exercise, Final Test và các type tương tự.