Smart Search Platform - Deep Dive and Completion Plan

Purpose

• Đào sâu trạng thái hiện tại của Smart Search.
• Chốt backlog hoàn thiện theo thứ tự ưu tiên dài hạn.
• Đảm bảo nhất quán giữa Home, Course, Learning, Practice, Vocabulary.
• Đây là tài liệu tham chiếu tối ưu hệ thống; không ràng buộc timeline triển khai cụ thể của từng team.

1. Current State Deep Dive

1.1 Strengths (đang có)

• Action-first: Search tập trung kích hoạt hành động, không chỉ trả list thông tin.
• Intent + Prefix: đã có nền tảng cho query tự nhiên VI/EN và gợi ý theo từng ký tự.
• Depth model: đã có 4 mức PAGE | STEP | AI | EXEC.
• AI 2 tầng: inline snapshot và portal tutor đã có concept rõ.
• Context-aware multi-course: đã có mô hình forking kết quả theo khóa học/context.

1.2 Gaps (cần hoàn thiện)

• Intent resolver còn thiên về single-intent; chưa có multi-intent blending cho query phức.
• Adapter orchestration mới ở mức kiến trúc; chưa có contract vận hành chung end-to-end cho mọi module.
• Result ranking chưa có trọng số nhất quán xuyên module và chưa có confidence governance.
• Placeholder UX chưa chuẩn hóa theo từng flow/module nên dễ lệch tone và hành vi.
• AI keyword mapping chưa có SSOT riêng cho trigger -> widget -> data -> CTA.
• Telemetry mới baseline, chưa có acceptance threshold theo từng phase rollout.

2. Completion Strategy

2.1 Objective by Layer

• L1 Core: ổn định taxonomy, ranking, context pack, adapter contract.
• L2 Experience: chuẩn hóa UI placeholder + section layout + keyboard/empty/error states.
• L3 Intelligence: chuẩn hóa AI keyword map, widget contract, data freshness policy.
• L4 Operations: telemetry + A/B + governance + rollback.

2.2 Priority Backlog (Recommended)

P0 - Foundation Stability

• Chốt Intent Registry v1.1 với synonym VI/EN + de-dup intent rules.
• Chốt Result Contract v1.1 với field bắt buộc confidence, freshnessAt, sourceModule.
• Chốt Ranking Formula v1.1 với context bias và cap/pivot policy.
• Chốt Fallback Policy: timeout, no-result, entitlement lock.

P1 - Cross-module UX Consistency

• Chuẩn hóa Search States: closed, focus, zero-state, typing, results, inline-ai, no-result, error.
• Chuẩn hóa Hero Action và Group Cap theo mọi flow.
• Chuẩn hóa placeholder text/chips theo module nhưng cùng tone hành động.

P2 - AI Readability and Actionability

• Chốt AI Keyword -> Action -> Widget map.
• Chuẩn hóa layout widget: Summary, Evidence, Primary CTA, Secondary CTA.
• Chốt handoff payload sang AI Tutor portal.

P3 - Optimization Loop

• Telemetry thresholds theo module.
• A/B test cho zero-state lane và AI fallback lane.
• Context personalization theo cohort (new, returning, high-risk, exam-near).

3. Acceptance Criteria (Definition of Done)

• Search query phổ biến có kết quả hành động trong <= 1.2s p95.
• time_to_first_action_from_search giảm tối thiểu 20% so với baseline module.
• zero_result_rate giảm còn <= 8% sau phase tối ưu đầu tiên.
• cross_module_handoff_success_rate >= 95% cho PRA và VOC flows.
• User không cần học lại hành vi search khi chuyển module.

4. Delivery Phases (Reference Maturity Sequence)

1. Phase A (2 tuần): Intent v1.1 + ranking + result contract + telemetry schema.
2. Phase B (2 tuần): UI state/placeholder standardization cho Home + Course.
3. Phase C (2 tuần): LM/PRA/VOC integration + route contract validation.
4. Phase D (2 tuần): AI keyword map productionization + widget QA + handoff QA.
5. Phase E (liên tục): A/B optimization và governance cadence.

5. Risks and Mitigation

• Rủi ro “quá nhiều kết quả”: khóa cứng cap/pivot theo state.
• Rủi ro mismatch context giữa modules: bắt buộc context pack validation trước dispatch.
• Rủi ro AI insight stale: áp dụng freshnessAt + stale badge + manual refresh CTA.
• Rủi ro taxonomy drift: intent review board hàng sprint.

References

• SSP_Master_Product_Spec.md
• SSP_00_Overview.md
• contracts/SSP_Intent_Taxonomy_Result_Contract.md
• contracts/SSP_Context_Pack_Adapter_Contracts.md
• ux-patterns/SSP_Area_Positioning_Page_Behavior.md
• governance/SSP_Rollout_Governance.md
• ux-patterns/SSP_UI_Placeholder_By_Flow.md
• ux-patterns/SSP_AI_Keyword_Widget_Map.md

Change log

• 2026-02-28: title: “Smart Search Platform - Deep Dive and Completion Plan”