Deep Resource Integration (Feature Spec)

Context: Enhancing Smart Search AI Results with deep, diverse, and interactive data widgets (replacing generic chat inputs). Parent Document: CM_FEATURE_Smart_Search.md

1. Concept: Deep Resource Integration

Instead of returning a generic text summary, each AI Action now maps to a specialized “Intel Widget” that visualizes deep database resources.

2. AI Persona & Data Matrix

AI Persona	Action ID	Data Widget Strategy	Data Points Needed (Deep Resource)
Performance Deep Dive	ACT_AI_STATS	Unified Stats HUD (Radar + Trend + Mastery)	- Skill Balance (Radar) - 4-Week Trend (Line Cloud) - Weakness/Strength Tags
Effort Tracker	ACT_AI_PRACTICE_PROCESS	Streak & Heatmap	- 30-day Activity Heatmap - Current Streak Count - XP / Effort Velocity
Class Prep Assistant	ACT_AI_SCHEDULE_PREP	Timeline Card	- Next Class Context (Topic, Room) - Recommended Pre-read Materials (PDF Links) - Required Tasks (Tickbox)
Smart Lecture Notes	ACT_AI_SESSION_SUMMARY	Smart Note Deck	- Key Takeaways (Bullet points) - Teacher’s Annotation Snapshot - Linked Homework IDs
Mistake Clinic	ACT_AI_ERROR_BANK	Error Analysis Table	- Top 3 Recurring Errors (Grammar/Vocab) - “Fix-it” Mini Quiz Data - Frequency Count
Rescue Mission	ACT_AI_PLAN	Recovery Timeline	- Absent Sessions Context - “Must-Watch” Video Clips - MVP Tasks (High priority only)
Concept Clarifier	ACT_AI_EXPLAIN	Contrast Card	- Concept Definition - “Bad vs Good” Examples - Related Concepts List

3. Implementation Plan

3.1. Widget Hierarchy (Legacy runtime snapshot)

Ensure these widgets exist and consume specialized props:

• UnifiedStatsWidget.tsx (Ready to enhance)
• PracticeJourneyWidget.tsx (Needs Heatmap logic)
• SchedulePrepWidget.tsx (Needs Resource Links)
• SessionRecapEnhancedWidget.tsx (Needs Smart Note logic)
• InlineErrorBankWidget.tsx (New - to replace generic Vocab)
• AICatchUpPlanWidget.tsx (New - Rescue Mission)
• AIConceptClarifierWidget.tsx (New - Concept Clarifier)

3.2. Data Interface

Mock data should be structured to simulate real API responses for “Deep Resources”.

// Example: Deep Resource for Schedule
interface ScheduleDeepResource {
    nextSession: {
        title: "Unit 5: Linear Thinking",
        time: "19:30 Today",
        room: "302"
    },
    prepMaterials: [
        { type: 'pdf', title: 'Task 1 Template', url: '...' },
        { type: 'vocab', title: 'Unit 5 Wordlist', count: 20 }
    ],
    requiredTasks: [
        { id: 't1', text: 'Watch Pre-class Video', done: false }
    ]
}