How kavinimuthamizhvalavan/intelligent_course_discovery_system works
Prior turns a student’s learning goal and known skills into course recommendations, explanations, a skill-gap chart, and an ordered learning path. The main flow runs from the Discover interface through the recommendation API and its retrieval, skill, and path logic; users can also simulate skills with What-If and submit course feedback. Evaluation is a separate screen, while Auto track drafting is an optional gateway-backed branch. Edges reflect the README and shown source references; unsampled modules are represented only where their role or connection is documented.
Main entry points: recommend.py Recommendation pipeline · Discover.tsx Discover screen · api.ts API client · main.py FastAPI routes
Components 25
Student application
- App routing
frontend/src/App.tsx - Discover screen
frontend/src/pages/Discover.tsx - Goal composer
frontend/src/components/Composer.tsx - Recommendation hook
frontend/src/hooks/useRecommend.ts - API client
frontend/src/api.ts - Course results
frontend/src/components/CourseList.tsx - Skill chart
frontend/src/components/SkillChart.tsx - Learning path view
frontend/src/components/LearningPath.tsx - What-If controls
frontend/src/components/WhatIfBar.tsx - Evaluation screen
frontend/src/pages/Evaluation.tsx
Service entry
- FastAPI routes
backend/app/main.py
Recommendation logic
- Recommendation pipeline
backend/app/recommend.py - Course catalog
backend/app/catalog.py - Hybrid retrieval
backend/app/search.py
Learning models
- Profile and gaps
backend/app/skills.py - Prerequisite model
backend/app/prerequisites.py - Path builder
backend/app/learning_path.py - AI track designer
backend/app/track_designer.py - Course explanations
backend/app/advisor.py
Feedback and evaluation
- Confidence estimates
backend/app/confidence.py - Per-query evaluation
backend/app/live_eval.py - Feedback endpoint
backend/app/feedback.py - SQLite feedback
backend/app/feedback.py
Other components
- Student
- Course gateway
Connections 26
- Student → Goal composer: enters goal
README.md - App routing → Discover screen: routes to
frontend/src/App.tsx - Discover screen → Goal composer: renders
frontend/src/pages/Discover.tsx - Discover screen → Recommendation hook: requests results
frontend/src/pages/Discover.tsx - Recommendation hook → API client: calls
frontend/src/hooks/useRecommend.ts - API client → FastAPI routes: sends requests
frontend/src/api.ts - FastAPI routes → Recommendation pipeline: dispatches
backend/app/main.py - Recommendation pipeline → Course catalog: uses catalog
backend/app/recommend.py - Recommendation pipeline → Hybrid retrieval: retrieves courses
backend/app/recommend.py - Recommendation pipeline → Profile and gaps: analyzes skills
backend/app/recommend.py - Recommendation pipeline → Prerequisite model: uses requirements
backend/app/recommend.py - Recommendation pipeline → Path builder: builds path
backend/app/recommend.py - Recommendation pipeline → AI track designer: may draft track
backend/app/recommend.py - Recommendation pipeline → Course explanations: creates advice
backend/app/recommend.py - Recommendation pipeline → Per-query evaluation: evaluates result
backend/app/recommend.py - Per-query evaluation → Confidence estimates: estimates relevance
backend/app/live_eval.py - AI track designer → Course gateway: requests draft
backend/app/track_designer.py - API client → Feedback endpoint: posts feedback
frontend/src/api.ts - Feedback endpoint → SQLite feedback: stores labels
README.md - API client → FastAPI routes: fetches report
frontend/src/api.ts - App routing → Evaluation screen: routes to
frontend/src/App.tsx - Evaluation screen → API client: loads evaluation
frontend/src/pages/Evaluation.tsx - Discover screen → Course results: renders results
frontend/src/pages/Discover.tsx - Discover screen → Skill chart: renders gaps
frontend/src/pages/Discover.tsx - Discover screen → Learning path view: renders path
frontend/src/pages/Discover.tsx - Discover screen → What-If controls: offers simulation
frontend/src/pages/Discover.tsx