Domains - Area to Domain Migration Map

Purpose

• Chốt cách đọc các area hiện có trong docs/Domains/**/UX Design/** theo góc nhìn domain-first.
• Giúp team và AI biết area nào nên đi vào domain, area nào nên giữ shared, và area nào phải tách kiểu hybrid.

Core Decision Types

• Domain baseline:
  • area hiện đang phản ánh chủ yếu một domain cụ thể.
  • hướng đi: neo nội dung mới vào domain surface tương ứng trước, rồi dùng area cũ như supporting structure bên trong workspace UX.
• Hybrid split:
  • area có một lõi dùng chung nhưng đã có khác biệt domain rõ.
  • hướng đi: giữ core/shared contract ngắn, còn decision narrative đặt ở domain surfaces.
• Shared platform:
  • area là nền tảng dùng chung cho nhiều area/domain.
  • hướng đi: không ép vào một domain; đặt ở Shared Capabilities và chỉ tham chiếu xuống domain khi cần.

Current Read of Existing Areas

Area	Current reality	Recommended target	Migration mode	Priority
Home & Discovery	Đã được tách vật lý sang DOL English / DOL Academy / DOL Kid	English/Home & Discovery, Academy/Home & Discovery, Kid/Home & Discovery	Hybrid split	P0
Practice Flow	Core attempt/result dùng chung, nhưng KID slice còn gài nhiều relative refs nên đang neo tạm ở English	English/Self-study Experience trước, rồi tách Kid/Learning Experience dần	Hybrid split	P0
Account	Đang có core canon đa domain nhưng baseline active vẫn nghiêng English	English/Identity & Access, Academy/Identity & Access, Kid/Identity & Access + Shared/Account Lifecycle	Hybrid split	P0
Register	Đang có canon login đa domain, nhưng supporting docs vẫn bridge từ area cũ	English/Identity & Access, Academy/Identity & Access, Kid/Identity & Access + Shared/Identity & Access	Hybrid split	P0
Payment	Scope gate hiện là DOL English Web V2, KID bị defer	English/Commerce, Academy/Commerce, Kid/Commerce + Shared/Payment & Commerce	Hybrid split	P0
Course Management	Rõ ràng là learner/course hub của DOL English	English/Course Experience	Domain baseline	P1
Learning Management	Chủ yếu là learner analytics của English; có dấu vết program khác (DGNL, K12)	English/Self-study Experience trước; tách nhánh Academy/Program Experience sau khi thật sự mở rộng	Domain baseline -> Hybrid later	P1
Vocabulary Management	Chủ yếu là self-study learner loop của English	English/Self-study Experience	Domain baseline	P1
Teaching Tool	Overview ghi rõ DOL Academy	Academy/Course Delivery	Domain baseline	P1
Zoom Course	Overview ghi rõ DOL Academy	Academy/Course Delivery	Domain baseline	P1
Video Course	Overview ghi rõ DOL Academy	Academy/Course Delivery	Domain baseline	P1
Social	Overview ghi rõ DOL Academy, nhưng rule nền phụ thuộc Engagement Platform	Academy/Community & Engagement + Shared/Engagement Governance	Hybrid split	P1
Engagement Platform	Governance chung xuyên nhiều area/module	Shared/Engagement Governance	Shared platform	P1
Smart Search Platform	Nền tảng dùng chung toàn hệ	Shared/Search & Orchestration	Shared platform	P1
AI Tutor Platform	Lớp hướng dẫn học tập xuyên module	Shared/AI Guidance	Shared platform	P1
UX_00_Overview.md	North-star của cả ecosystem	docs/Shared/Shared Capabilities/Ecosystem Experience/**	Shared platform	P0

Folder Plan by Domain

DOL English

• Home & Discovery
  • nhận Home & Discovery/**
• Identity & Access
  • nhận logic chính từ Register, Account
• Self-study Experience
  • nhận Learning Management, Vocabulary Management, phần English của Practice Flow
• Course Experience
  • nhận Course Management
• Commerce
  • nhận Payment

DOL English - Current Skeleton Assignment

Domain surface	Current legacy folders	Status	Boundary note
Home & Discovery	Home & Discovery/**	ready	Dùng Home & Discovery root như strategic bridge, nhưng decision của English phải chốt tại surface domain này.
Identity & Access	Register/**, Account/**	ready	English giữ self-managed learner; không chứa guardian-managed của KID.
Self-study Experience	Learning Management/**, Vocabulary Management/**, phần English của Practice Flow/**	ready	Practice Flow vẫn giữ core attempt/result, còn meaning self-study của English nằm ở surface này.
Course Experience	Course Management/**	ready	Không nhận Zoom Course/**, Video Course/**, Teaching Tool/**; các area đó là Academy.
Commerce	Payment/**	ready	Payment là baseline English hiện tại; shared rules chỉ tham chiếu thêm khi cần cross-domain.

DOL Academy

• Home & Discovery
  • nhận Home & Discovery/**
• Identity & Access
  • nhận delta Academy từ Register, Account
• Program Experience
  • nhận các logic roadmap/program hub của Academy
• Course Delivery
  • nhận Teaching Tool, Zoom Course, Video Course
• Community & Engagement
  • nhận Social và local semantics của engagement trong Academy
• Commerce
  • giữ skeleton cho commerce Academy khi mở rộng

DOL Kid

• Home & Discovery
  • nhận Home & Discovery/**
• Identity & Access
  • nhận guardian-managed, child code access, continuity grow-up
• Parent Experience
  • nhận các quyết định phụ huynh quản lý việc học của con
• Learning Experience
  • nhận Kids Online Test và các learning surfaces riêng của KID
• Commerce
  • giữ skeleton cho family purchase / household model

Folder Plan by Shared Capability

• Identity & Access
  • rule dùng chung về login continuity, access boundary
• Account Lifecycle
  • continuity xuyên domain, guardian -> self-managed transition
• Payment & Commerce
  • checkout continuity và entitlement boundary dùng chung
• Search & Orchestration
  • Smart Search và routing/search contracts toàn hệ
• AI Guidance
  • AI Tutor như lớp guidance xuyên module
• Engagement Governance
  • leaderboard, reward, mission, badge, anti-abuse ở mức rule chung

Migration Sequence

Phase 1: Lock the map

• Chốt mapping này như nguồn quyết định chính.
• Cập nhật skeleton/domain router để phản ánh đúng các target mới.

Phase 2: Move the entry points, not the heavy logic

• Đã di chuyển vật lý các folder area UX sang docs/Domains/**/UX Design/** hoặc docs/Shared/Shared Capabilities/**.
• Giữ mỗi surface có Current Supporting Sources để AI và contributor lần ngược được về area source phù hợp.
• Không tạo lại root docs/UX Design/; mọi UX canon mới phải đi thẳng vào docs/Domains/**/UX Design/** hoặc docs/Shared/Shared Capabilities/**.

Phase 3: Resolve the biggest mismatches

• Academy: bổ sung Course Delivery và Community & Engagement.
• Shared: bổ sung chỗ đứng cho Smart Search, AI Tutor, Engagement.
• English: giữ các area baseline lớn ở vai trò nguồn chính trong giai đoạn đầu.

Phase 4: Hybrid area split

• Home & Discovery: giữ overview area đã move theo domain; decision mới tiếp tục viết ở domain surfaces.
• Practice Flow: hiện tạm neo ở English; split Kids Online Test sang DOL Kid khi path/reference ổn định.
• Payment, Register, Account: giữ core canon ngắn ở baseline English/shared; domain delta tiếp tục gom về domain surfaces.

Phase 5: Gradual deep migration

• Chỉ khi một domain surface đủ rõ và có thêm logic mới, mới tiếp tục tách nhỏ docs từ area gốc vào domain.
• Không rewrite screen-level docs hàng loạt nếu chưa có nhu cầu sử dụng thực tế.

Guardrails

• Không cố ép mọi area vào một domain.
• Không dùng domain doc để lặp lại nguyên văn toàn bộ area doc cũ.
• Không để shared layer phình thành nơi chứa narrative chính của domain.
• Khi chưa chắc area thuộc domain nào, đọc overview area + domain root trước khi quyết định.

Change log

• 2026-03-07: Cập nhật map để phản ánh trạng thái mới: area folders UX đã được move vật lý vào domain/shared tương ứng.