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

DOL English UX Design Overview

DomainsDOL EnglishUX2.357 words12 min read
activebyDOL Product Design

DOL English - UX Design Overview

Phần tiêu đề “DOL English - UX Design Overview”

Purpose

Phần tiêu đề “Purpose”
  • Entry doc cấp workspace cho UX lane của DOL English.
  • Dùng khi idea đã rõ là UX/flow/IA/logic theo domain English.
  • Tín hiệu thành công: người đọc chọn đúng surface trong 1 hop và không phải mở nhiều overview ngang vai cùng lúc.

Doc Role

Phần tiêu đề “Doc Role”
  • Đây là workspace entry cho toàn bộ DOL English/UX Design.
  • Đọc file này trước khi chọn surface entry; sau đó mới đi tiếp vào doc chi tiết theo area/module.
  • File này không thay thế screen spec, per-program logic, hoặc shared capability canon.

Workspace Ownership Rule

Phần tiêu đề “Workspace Ownership Rule”
  • UX Design là canonical home của logic UX trong DOL English.
  • Khi feature thay đổi, ưu tiên build/update trong UX Design trước.
  • Product Discovery chỉ giữ change log, decision trail, hoặc workshop notes để support cho lane UX này.
  • IdeaFlow chỉ giữ concept UI hoặc idea delta; không phải lane chính để xây logic UX của hệ thống.

Feature Master Rule

Phần tiêu đề “Feature Master Rule”
  • Với feature lớn hoặc cross-surface, ưu tiên có 1 feature-master file để người đọc và AI có thể hiểu toàn bộ logic trong 1 hop.
  • Feature-master là file owner chính của feature; nó tóm tắt current truth, reading path, owner map, và các rule đủ để không phải ghép nhiều file mới hiểu được logic.
  • Chỉ tách thêm file rule/contracts khi feature đã đủ lớn và rule-level detail bắt đầu làm file master nặng lên rõ rệt.
  • Nếu feature còn nhỏ hoặc chỉ nằm gọn trong một surface rõ ràng, không cần ép tạo feature-master; giữ ở surface/page docs là đủ.

Document Hygiene Rule

Phần tiêu đề “Document Hygiene Rule”
  • Feature-master
    • là one-stop current truth của feature cross-surface.
    • chỉ nên có 1 file active cho mỗi feature.
  • Owner doc
    • chỉ sở hữu 1 surface hoặc 1 deep flow rõ ràng.
    • không được tự spec lại shell canon nếu shell đã có feature-master riêng.
  • Snapshot doc
    • chỉ ghi current shipped baseline.
    • phải nói rõ không override target contract.
  • Concept pack
    • chỉ là tài liệu triển khai concept hoặc inventory translation.
    • dùng Source Inputs, không tự nhận source of truth nếu canon đang ở file khác.
    • chỉ nên được tạo khi có nhu cầu concept thật sự; không duy trì bulk screen concept generation như output mặc định của lane UX.
  • Reading rule / successor note
    • là bắt buộc khi một doc có nguy cơ bị mở trực tiếp như entry point cạnh tranh.
    • phải trỏ ngược về feature-master hoặc surface overview đúng vai trò.
  • Outdated content
    • nếu đã chết hẳn: archive hoặc đánh dấu superseded.
    • nếu vẫn cần giữ vì snapshot/history: thêm note ngắn về legacy naming hoặc snapshot-only.
    • không chồng thêm current truth mới lên trên wording cũ mà không làm rõ boundary.

Agent Refinement Loop

Phần tiêu đề “Agent Refinement Loop”
  • Khi user sửa hoặc thêm insight cho một feature, agent nên coi đó là tín hiệu để rà nhanh độ đầy đủ của feature đó.
  • Rà theo hướng soft completeness, không biến mọi task thành checklist nặng.
  • Các góc nên tự nhìn:
    • entry / trigger
    • state / edge cases
    • ownership / boundary
    • cross-surface impact
    • open validation
  • Nếu phát hiện phần còn mờ nhưng chưa đủ để block:
    • cập nhật note ngắn trong owner doc,
    • hoặc gợi ý follow-up ngắn cho user,
    • không tự mở rộng scope lớn nếu chưa có tín hiệu rõ.

Domain Character

Phần tiêu đề “Domain Character”
  • DOL English hiện vẫn là baseline mạnh nhất của phần lớn UX docs trong repo.
  • Lane này ưu tiên learner tự quản, kết hợp self-study và course experience.

Workspace Contracts

Phần tiêu đề “Workspace Contracts”

Active Navigation Backbone

Phần tiêu đề “Active Navigation Backbone”
  • Logged-in DOL English hiện được đọc theo shell:
    • Program Workspace -> Deep Object,
    • với cross-program aggregate views chỉ là scoped exception.
  • Logged-in entry mặc định bây giờ là resume last meaningful program workspace; không còn Global Today Hub làm default shell destination.
  • Nếu cần đọc navigation như 1 feature hoàn chỉnh, mở ENG_Navigation_00_Overview.md trước.
  • Khi câu hỏi chạm shell rule chi tiết hoặc owner boundary sâu hơn, mở ENG_Navigation_Shell_Contracts.md rồi mới đi xuống owner docs.

Surface Entry Points

Phần tiêu đề “Surface Entry Points”

Current Area Assignment

Phần tiêu đề “Current Area Assignment”
UX surfaceCurrent source foldersNotes
Home & DiscoveryHome & Discovery/HOME_00_Overview.md, Home & Discovery/**Giữ global home overview và toàn bộ English home stack tại đây.
Identity & AccessRegister/**, Account/**English là baseline self-managed learner; cross-domain rules vẫn đọc thêm ở shared.
Self-study ExperienceLearning Management/**, Vocabulary Management/**, Practice Flow/**Practice Flow đang tạm neo ở English để split dần về sau.
Course ExperienceCourse Management/**Chỉ chứa lane course của English, không kéo Academy delivery vào.
CommercePayment/**Payment vẫn là baseline active của English trong giai đoạn hiện tại.

Current Supporting Sources

Phần tiêu đề “Current Supporting Sources”

Current Documentation Assessment

Phần tiêu đề “Current Documentation Assessment”
  • Điểm mạnh
    • UX Design đã đủ khả năng giữ current truth cho các lane active như Navigation, Home, Program Landing, Exercise Bank, Practice, CM, LM, VOC.
    • Register owner docs active giờ cũng đã đọc được ngay trong UX Design, không còn cần Product Discovery như reading path mặc định.
    • Các owner docs quan trọng đã rõ hơn về shell fit, canonical ownership, và launcher vs owner flow.
    • Reading path hiện đã bớt lệ thuộc vào Product Discovery ở nhiều owner docs đang active.
  • Điểm yếu còn lại
    • Một số feature-master hoặc specialized docs vẫn còn reference trực tiếp sang Product Discovery nhiều hơn mức cần thiết cho đọc hiểu hằng ngày, nhất là Navigation shell/contracts, LM_Metrics, và một phần Payment.
    • Nhiều snapshot/concept/leaf docs vẫn chưa được audit, nên wording cũ còn có thể tồn tại ở lớp sâu.
    • Một số area entries trong workspace map vẫn là target structure hơn là fully-migrated source tree, nên reading path chưa hoàn toàn đồng đều giữa các area.
  • Rủi ro chính
    • Nếu tiếp tục tối ưu theo file lẻ mà không có thứ tự ưu tiên, repo sẽ dễ quay lại trạng thái “đúng cục bộ nhưng rời rạc tổng thể”.
    • Nếu kéo thêm quá nhiều meta/rule docs, lane UX Design sẽ lại nặng và khó đọc.

Next Optimization Strategy

Phần tiêu đề “Next Optimization Strategy”
  • Ưu tiên 1
    • tiếp tục tối ưu các active owner docs và surface entries có tần suất đọc cao trước;
    • giữ mục tiêu: current truth phải đọc được trong UX Design mà không cần sang Product Discovery.
  • Ưu tiên 2
    • giảm dần direct Product Discovery references trong feature-master, surface-entry, và owner doc còn lại;
    • thứ tự hiện tại nên là Navigation shell/contracts -> LM_Metrics/Payment -> specialized technical docs;
    • chỉ giữ lại ở nơi thật sự cần traceability hoặc workshop replay.
  • Ưu tiên 3
    • chỉ audit xuống snapshot / concept / leaf docs khi chúng còn cạnh tranh reading path với owner docs active hoặc đang gây drift thật.
  • Nguyên tắc dừng
    • nếu một layer đã đủ rõ ở overview + owner docs, không xuống leaf docs chỉ để “đồng bộ cho đẹp”.

Shared Capability References

Phần tiêu đề “Shared Capability References”

Boundary

Phần tiêu đề “Boundary”
  • Teaching Tool, Zoom Course, Video Course, Social không thuộc lane UX của DOL English.
  • Smart Search Platform, AI Tutor Platform, Engagement Platform là shared layer.

AI Tutor UX Baseline

Phần tiêu đề “AI Tutor UX Baseline”
  • Trong mắt user, AI Tutor hoạt động như một AI Coach persona duy nhất xuyên toàn bộ DOL English.
  • Ở backend, cùng persona này có thể được orchestration qua 3 vai trò:
    • Assistant / Navigator: search, quick help, navigation, command-like support,
    • Teacher / Coach: strategy, weekly plan, daily plan, intervention,
    • Evaluator / Marker: scoring, explanation, feedback, review-item extraction.
  • UX không được render AI như cùng một chat bubble ở mọi page. AI phải page-aware theo câu hỏi chính của từng surface:
    • Home: Home Coach Card + on-demand drawer, mặc định tab Kế hoạch,
    • Program landing: Strategy Panel + on-demand drawer, mặc định tab Kế hoạch,
    • Practice result: Analysis Panel hoặc Feedback Workspace, mặc định tab Phân tích,
    • Learning Management: Weekly Recap / Intervention, tập trung fix cũ -> làm mới,
    • Course Management: Course Guide Card, mặc định tab Hỏi AI,
    • Vocabulary: Daily Vocab Coach, tập trung ôn gì hôm nay.
  • State mutation luôn theo rule confirm-before-write:
    • AI được phép phân tích, mô phỏng chiến lược, và đề xuất thay đổi,
    • chỉ được commit vào actual state sau khi user xác nhận.
  • Page continuity là bắt buộc:
    • inline card, drawer, result panel, và deep-link action phải đọc cùng learner context,
    • không được để AI trả lời mâu thuẫn chỉ vì user đổi surface.

English AI Platform Logic

Phần tiêu đề “English AI Platform Logic”
  • Trong domain English, AI không nên được hiểu như 1 chatbot hay nhiều card AI rời rạc; đúng hơn nó là một lớp operating logic đi xuyên Home -> Program -> Practice -> LM -> Course -> Vocabulary.
  • Mọi learner-facing AI surface nên cố gắng trả lời đủ 3 câu theo đúng trọng số của page:
    1. Mình đang ở trạng thái nào?
    2. Điều gì đang đáng chú ý hoặc đáng ưu tiên nhất?
    3. Mình nên làm gì ngay bây giờ?
  • Nguồn tín hiệu platform-level của AI trong English nên được đọc như một context graph chung:
    • goal / current vs target,
    • learning rhythm / weekly goal / backlog,
    • practice performance / weak skill / recent result,
    • course queue / due lesson / feedback,
    • vocabulary topic focus / review need / current level.
  • AI không cần surfacing hết mọi tín hiệu trên cùng một page. Surface chỉ nên kéo những tín hiệu thật sự đổi được quyết định chính của page đó.
  • Baseline output order của AI trong English:
    • current-state synthesis,
    • meaning hoặc diagnosis ngắn,
    • 1 next useful action,
    • deep-dive CTA nếu user muốn đi xa hơn.
  • Baseline content partition cho learner-facing inline AI:
    • Strategy / analysis / vocab diagnosis thường hợp với 3 lane: tóm tắt nhanh -> vì sao AI đánh giá vậy -> làm gì tiếp.
    • Home coach / course guide / queue-first surfaces thường chỉ cần 2 lane: snapshot -> next action.
    • Attempt coaching giữ luồng hint tuần tự; không nên ép thành dashboard 3 tab.
  • Planning là một chức năng quan trọng, nhưng không phải tư thế mặc định của mọi AI surface:
    • Program landing và recovery contexts có thể plan-first,
    • LM, Result, Vocabulary, Course queue nên ưu tiên insight/readiness/queue-first,
    • Attempt luôn ưu tiên coaching-first.

Migration Note

Phần tiêu đề “Migration Note”
  • docs/UX Design/ không còn là nơi giữ domain tree cũ của English.
  • Khi viết mới, luôn neo vào workspace này trước rồi mới tham chiếu legacy source nếu cần.

Change log

Phần tiêu đề “Change log”
  • 2026-03-27: Sync workspace backbone theo model resume last meaningful program workspace + selective aggregate views only, đồng thời retire Global Today Hub khỏi active logged-in shell canon.
  • 2026-03-26: Thêm Document Hygiene Rule để khóa ngắn gọn vai trò của feature-master / owner doc / snapshot doc / concept pack, cùng rule reading rule / successor note / outdated content.
  • 2026-03-25: Bổ sung Feature Entry Rule và thêm ENG_Navigation_00_Overview.md làm pilot one-stop file cho feature cross-surface.
  • 2026-03-25: Thêm ENG_Navigation_Shell_Contracts.md vào workspace contracts và khóa baseline shell Global Today Hub -> Program Workspace -> Deep Object cho logged-in DOL English.
  • 2026-03-20: Bổ sung English AI Platform Logic để chốt baseline state -> meaning -> next action -> deep-dive, và phân biệt rõ page nào plan-first với page nào insight/queue-first.
  • 2026-03-19: Bổ sung doc role và workspace contracts để làm rõ đây là workspace entry, không phải full UX spec hay shared canon.
  • 2026-03-13: Bổ sung baseline UX cho AI Tutor = 1 persona / 3 backend roles / page-aware surfaces / confirm-before-write để đồng bộ Home, Program, Practice, LM, Course và Vocabulary.