Smart Search Platform - Search Action Feature Traceability Matrix
SharedShared Capabilities1.021 words5 min read
Purpose
Phần tiêu đề “Purpose”- Chuẩn hóa bảng truy ngược từ nhãn card action trên Search UI về định danh kỹ thuật.
- Giảm lệch giữa 3 lớp tài liệu đang cùng tồn tại:
- canonical contracts (SSP),
- legacy action registry (Course Management),
- labels hiển thị thực tế trên Search cards.
Scope
Phần tiêu đề “Scope”- Ưu tiên cụm action cards đang hiển thị trên Search surface của lane Course/Practice/AI.
- Không thay thế taxonomy contract; file này là lớp đối chiếu để triển khai và QA trace nhanh.
Source-of-truth priority
Phần tiêu đề “Source-of-truth priority”- Canonical:
contracts/SSP_Intent_Taxonomy_Result_Contract.mdcontracts/SSP_Context_Pack_Adapter_Contracts.mdcontracts/SSP_Implementation_Logic_Contract.mdux-patterns/SSP_AI_Keyword_Widget_Map.md
- Legacy reference:
../Course Management/CM_REF_Static_Action_Library.md../Course Management/CM_FEATURE_Smart_Search.md
- UI label layer:
- Search card labels (VI/EN) tại runtime/prototype.
Coverage status definition
Phần tiêu đề “Coverage status definition”Covered: có canonical mapping rõ (intent/variant/actionKey) + adapter/routing contract khả thi.Partial: đã có mapping ở legacy hoặc proposed nhưng thiếu canonical alias/feature key/route contract rõ.Missing: chưa có mapping định danh rõ trong bộ Smart Search active docs.
Search action traceability matrix
Phần tiêu đề “Search action traceability matrix”| Search card label (UI) | Legacy action ID | Canonical mapping đề xuất/đang có | Depth chính | Coverage | Notes |
|---|---|---|---|---|---|
Xem tài liệu học tập (Slides, PDF, Handouts) | ACT_MATERIAL / ACT_MATERIALS | ACT_AI_SCHEDULE_PREP (pre-read) + facet: contentType=material + actionKey: course.open.detail_tab | PAGE/STEP | Partial | Chưa có intent canonical riêng cho material-open; cần alias + route contract rõ cho material center. |
Xem lịch học (Schedule) | ACT_SCHEDULE | ACT_SCHEDULE | PAGE/STEP | Covered | Có intent canonical và ranking/route rules theo page context. |
Xem đặt lịch 1-1 (Booking with Teacher) | ACT_BOOKING_1ON1 | ACT_BOOKING | EXEC/PAGE | Covered | Cần giữ alias legacy booking_1on1 -> ACT_BOOKING trong dictionary. |
Xem sự kiện & workshop (Events) | ACT_EVENTS | ACT_EVENTS | PAGE | Covered | Hợp lệ ở nhóm operations/global events. |
Xem xin nghỉ phép (Report Absence) | ACT_ABSENCE | ACT_ABSENCE | EXEC | Covered | Có rule confirm side-effect ở course ops. |
Xem tổng quan khóa học (Course Overview) | ACT_OVERVIEW | actionKey: course.open.dashboard + `pageContext: course.guest_overview | course.dashboard` | PAGE | Partial |
Làm bài tập về nhà (btvn) (Assignments & Deadlines) | ACT_ASSIGNMENT | ACT_ASSIGNMENT | STEP | Covered | Có trong bundle Practice actions và course ranking policy. |
Làm kiểm tra online (Tests & Quizzes) | ACT_ONLINE_TEST | ACT_TEST | STEP | Partial | Cần alias chính thức online test/tests & quizzes -> ACT_TEST. |
Làm nghe chép chính tả (Dictation Practice) | ACT_DICTATION | ACT_DICTATION | STEP/PAGE | Covered | Có trong canonical learning actions. |
Làm luyện tập (drills) | ACT_EXERCISE | ACT_EXERCISE | STEP/PAGE | Covered | Là action cốt lõi của practice bundle. |
Làm thi thử AI (mock test) | ACT_AI_MOCK_TEST | ACT_TEST + variant.inlineFeatureKey=AIF_MOCK_FULL_TEST | STEP/AI | Covered | Đã có policy canonical tránh intent sprawl. |
AI Speaking Coach | (không thấy ID active) | (chưa có canonical feature key active) | AI | Missing | Cần định danh dưới AI catalog (intent + inlineFeatureKey + CTA contract). |
AI Writing Analyser | (không thấy ID active) | (chưa có canonical feature key active) | AI | Missing | Cần contract rõ cho analysis artifact + handoff. |
AI Listening Insight | (không thấy ID active) | (chưa có canonical feature key active) | AI | Missing | Chưa có mapping explicit trong AI keyword map active. |
AI Reading Insight | (không thấy ID active) | (chưa có canonical feature key active) | AI | Missing | Chưa có mapping explicit trong AI keyword map active. |
Cẩm nang Lỗi sai (Error Bank) | AI Error Bank (legacy naming) | ACT_AI_ERROR_BANK + inlineFeatureKey=AIF_ERROR_CLUSTER_CLINIC | AI | Covered | Đã có keyword map + widget contract + fix-it flow logic. |
AI Vocab Connect | AI Vocab Connector (legacy naming) | ACT_AI_VOCAB_CONNECT + inlineFeatureKey=AIF_VOCAB_CONTEXT_BRIDGE | AI | Covered | Đã có mapping từ keyword đến card + CTA. |
AI Mistake Drill | (gần với fix-it quiz) | ACT_AI_ERROR_BANK + variant: mistake_drill (đề xuất) | AI/STEP | Partial | Có logic fix-it trong Error Bank nhưng chưa có feature key/label contract riêng. |
Alias normalization backlog (ưu tiên thấp rủi ro)
Phần tiêu đề “Alias normalization backlog (ưu tiên thấp rủi ro)”ACT_BOOKING_1ON1 -> ACT_BOOKING.ACT_ONLINE_TEST -> ACT_TEST.ACT_OVERVIEW -> actionKey(course.open.dashboard)với intent theo query context.ACT_MATERIAL/ACT_MATERIALS -> material facet + actionKey.- UI label aliases:
Assignments & Deadlines,Tests & Quizzes,Dictation Practice,Error Bank,AI Vocab Connect,mock test.
Contract gaps cần chốt qua governance
Phần tiêu đề “Contract gaps cần chốt qua governance”- Skill-specific AI cards:
AI Speaking CoachAI Writing AnalyserAI Listening InsightAI Reading Insight
- Tách hay không tách
AI Mistake DrillkhỏiACT_AI_ERROR_BANK:
- nếu tách label nhưng không tách intent, cần add
inlineFeatureKeyvariant.
- Material access card:
- chuẩn hóa route/actionKey cho
Slides/PDF/Handoutsđể không phụ thuộc legacy ID.
References
Phần tiêu đề “References”contracts/SSP_Intent_Taxonomy_Result_Contract.mdcontracts/SSP_Context_Pack_Adapter_Contracts.mdcontracts/SSP_Implementation_Logic_Contract.mdux-patterns/SSP_AI_Keyword_Widget_Map.mdarea-bundles/SSP_Course_Search_Feature_Bundles.md../Course Management/CM_REF_Static_Action_Library.md../Course Management/CM_FEATURE_Smart_Search.md../Course Management/CM_TECH_AI_Deep_Resources.md
Change log
Phần tiêu đề “Change log”- 2026-03-01: Tạo mới traceability matrix cho Search action cards (UI label -> legacy ID -> canonical mapping -> coverage status).