Smart Search Platform - Overview
SharedShared Capabilities740 words4 min read
Purpose
Phần tiêu đề “Purpose”- Vấn đề: Search hiện mới mạnh trong Course Management, trong khi Home/Practice/Vocabulary/Learning đang có nhiều điểm vào và logic gợi ý rời rạc.
- Mục tiêu: Tạo một nền tảng Smart Search dùng chung toàn hệ sinh thái để mọi module dùng cùng ngôn ngữ intent, cùng contract kết quả, và cùng cơ chế điều phối hành động.
- Mục tiêu bổ sung: Mở rộng Smart Search cho cả pha
khám phá chương trình/khoáở guest/pre-login, không chỉ pha học tác vụ sau đăng nhập. - Tín hiệu thành công: User tìm nhanh đúng việc cần làm trong 1 lần search, không phải học lại cách search ở từng trang.
- Nguyên tắc dùng tài liệu: Đây là tài liệu nền tảng dùng chung, không phải bản phân việc thực thi theo team.
Scope
Phần tiêu đề “Scope”- In scope:
- Taxonomy intent dùng chung toàn nền tảng.
- Contract kết quả thống nhất (
PAGE,STEP,AI,EXEC). - Context Pack chuẩn để các trang truyền ngữ cảnh vào Search Orchestrator.
- Adapter pattern cho Course/Home/Learning/Practice/Vocabulary.
- Governance cho ranking, rollout, telemetry.
- Out of scope:
- Chi tiết UI pixel-level của từng module.
- Thay thế business logic chuyên sâu của từng module.
Core Model
Phần tiêu đề “Core Model”- Mô hình chuẩn của nền tảng:
Intent × Context × Depth (ICD).Intent: User muốn làm gì.Context: User đang ở đâu, có quyền gì, trạng thái học nào đang cần ưu tiên.Depth: Trả về mức nào để tối ưu tốc độ hành động.PAGE: Điều hướng tới trang tổng quát.STEP: Đi thẳng vào tác vụ cụ thể/deep-link.AI: Trả insight/widget tổng hợp dữ liệu.EXEC: Kích hoạt hành động trực tiếp (modal, trigger, submit flow).
Unified Principles
Phần tiêu đề “Unified Principles”Action-first: Search ưu tiên giúp user hành động ngay, không chỉ liệt kê thông tin.Progressive depth: Trả câu trả lời ngắn trước, chỉ đi sâu khi user cần.Context continuity: Giữ ngữ cảnh xuyên trang và xuyên module.Consistency over novelty: Cùng intent phải có hành vi nhất quán ở mọi nơi.Long-term maintainability: Mọi mở rộng đi qua taxonomy + contract, tránh hardcode riêng lẻ.
Platform Components
Phần tiêu đề “Platform Components”Intent Core: từ điển intent + synonym + priority dùng chung.Search Orchestrator: định tuyến intent tới adapter phù hợp và gom kết quả.Domain Adapters: connector sangCourse Management,Home & Discovery,Learning Management,Practice Flow,Vocabulary Management.Ranking Engine: xếp hạng dựa trên urgency, momentum, local-context bias và confidence.Presentation Contract: quy ước section, cap limit, badge trạng thái và CTA.Telemetry: log search quality và outcome để tối ưu dần.
Integration Map
Phần tiêu đề “Integration Map”Course Management: nguồn action-rich chính, có nhiềuSTEP/EXEC/AI.Home & Discovery: điểm vào chiến lược, gồm cả discovery pre-login và action routing post-login.Learning Management: nguồn analytics và gợi ý luyện tập theo gap/impact.Practice Flow: contract bắt buộc cho attempt/result routing (source_context,returnTo).Vocabulary Management: debt-aware review actions và sync từ PRA result payload.
Success Metrics
Phần tiêu đề “Success Metrics”search_success_rate.time_to_first_action_from_search.search_to_completion_rate(hoàn thành tác vụ sau click search).cross_module_handoff_success_rate(ví dụ: Home -> PRA, PRA -> Vocabulary).zero_result_ratevàfallback_to_ai_rate.
References
Phần tiêu đề “References”SSP_INDEX.mdSSP_Smart_Search_Logic_Explainer.mdSSP_Master_Product_Spec.mdcontracts/SSP_Intent_Taxonomy_Result_Contract.mdcontracts/SSP_Context_Pack_Adapter_Contracts.mdcontracts/SSP_Implementation_Logic_Contract.mdux-patterns/SSP_Area_Positioning_Page_Behavior.mdgovernance/SSP_Rollout_Governance.mdgovernance/SSP_Deep_Dive_and_Completion_Plan.mdux-patterns/SSP_UI_Placeholder_By_Flow.mdux-patterns/SSP_AI_Keyword_Widget_Map.mdux-patterns/SSP_AI_Innovation_By_Area.mdgovernance/SSP_Optimization_Framework.mdarea-bundles/SSP_Program_Course_Discovery_Search_Bundles.md../Course Management/CM_FEATURE_Smart_Search.md../Course Management/CM_TECH_Smart_Search_Architecture.md
Change log
Phần tiêu đề “Change log”- 2026-02-28: Bổ sung định vị Smart Search cho discovery guest/pre-login và liên kết bundle chuyên trách chương trình/khoá học.
- 2026-02-11: Tạo mới folder gốc Smart Search Platform và chốt mô hình
Intent x Context x Depthlàm chuẩn toàn nền tảng.