# kavinimuthamizhvalavan/intelligent_course_discovery_system architecture

> Architecture diagram of the GitHub repository kavinimuthamizhvalavan/intelligent_course_discovery_system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kavinimuthamizhvalavan/intelligent_course_discovery_system
- Repository: https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system

## Overview

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: [`backend/app/recommend.py`](https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/backend/app/recommend.py) (Recommendation pipeline), [`frontend/src/pages/Discover.tsx`](https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/frontend/src/pages/Discover.tsx) (Discover screen), [`frontend/src/api.ts`](https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/frontend/src/api.ts) (API client), [`backend/app/main.py`](https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/backend/app/main.py) (FastAPI routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Student application"]
  node_app["App routing<br/>[App.tsx]"]
  node_discover["Discover screen<br/>[Discover.tsx]"]
  node_composer["Goal composer<br/>[Composer.tsx]"]
  node_recommend_hook["Recommendation hook<br/>[useRecommend.ts]"]
  node_api_client["API client<br/>[api.ts]"]
  node_course_results["Course results<br/>[CourseList.tsx]"]
  node_skill_chart["Skill chart<br/>[SkillChart.tsx]"]
  node_learning_path_view["Learning path view<br/>[LearningPath.tsx]"]
  node_what_if["What-If controls<br/>[WhatIfBar.tsx]"]
  node_evaluation_page["Evaluation screen<br/>[Evaluation.tsx]"]
end

subgraph group_api["Service entry"]
  node_service_routes["FastAPI routes<br/>[main.py]"]
end

subgraph group_discovery["Recommendation logic"]
  node_recommender["Recommendation pipeline<br/>[recommend.py]"]
  node_catalog["Course catalog<br/>[catalog.py]"]
  node_search["Hybrid retrieval<br/>[search.py]"]
end

subgraph group_learning["Learning models"]
  node_skill_model["Profile and gaps<br/>[skills.py]"]
  node_prerequisites["Prerequisite model<br/>[prerequisites.py]"]
  node_path_builder["Path builder<br/>[learning_path.py]"]
  node_track_designer["AI track designer<br/>[track_designer.py]"]
  node_advisor["Course explanations<br/>[advisor.py]"]
end

subgraph group_support["Feedback and evaluation"]
  node_confidence["Confidence estimates<br/>[confidence.py]"]
  node_live_eval["Per-query evaluation<br/>[live_eval.py]"]
  node_feedback["Feedback endpoint<br/>[feedback.py]"]
  node_feedback_store[("SQLite feedback<br/>[feedback.py]")]
end

node_student(("Student"))
node_llm_gateway["Course gateway"]

node_student -->|"enters goal"| node_composer
node_app -->|"routes to"| node_discover
node_discover -->|"renders"| node_composer
node_discover -->|"requests results"| node_recommend_hook
node_recommend_hook -->|"calls"| node_api_client
node_api_client -->|"sends requests"| node_service_routes
node_service_routes -->|"dispatches"| node_recommender
node_recommender -->|"uses catalog"| node_catalog
node_recommender -->|"retrieves courses"| node_search
node_recommender -->|"analyzes skills"| node_skill_model
node_recommender -->|"uses requirements"| node_prerequisites
node_recommender -->|"builds path"| node_path_builder
node_recommender -->|"may draft track"| node_track_designer
node_recommender -->|"creates advice"| node_advisor
node_recommender -->|"evaluates result"| node_live_eval
node_live_eval -->|"estimates relevance"| node_confidence
node_track_designer -.->|"requests draft"| node_llm_gateway
node_api_client -->|"posts feedback"| node_feedback
node_feedback -->|"stores labels"| node_feedback_store
node_api_client -->|"fetches report"| node_service_routes
node_app -->|"routes to"| node_evaluation_page
node_evaluation_page -->|"loads evaluation"| node_api_client
node_discover -->|"renders results"| node_course_results
node_discover -->|"renders gaps"| node_skill_chart
node_discover -->|"renders path"| node_learning_path_view
node_discover -->|"offers simulation"| node_what_if

click node_app "https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/frontend/src/App.tsx"
click node_discover "https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/frontend/src/pages/Discover.tsx"
click node_composer "https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/frontend/src/components/Composer.tsx"
click node_recommend_hook "https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/frontend/src/hooks/useRecommend.ts"
click node_api_client "https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/frontend/src/api.ts"
click node_course_results "https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/frontend/src/components/CourseList.tsx"
click node_skill_chart "https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/frontend/src/components/SkillChart.tsx"
click node_learning_path_view "https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/frontend/src/components/LearningPath.tsx"
click node_what_if "https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/frontend/src/components/WhatIfBar.tsx"
click node_evaluation_page "https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/frontend/src/pages/Evaluation.tsx"
click node_service_routes "https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/backend/app/main.py"
click node_recommender "https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/backend/app/recommend.py"
click node_catalog "https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/backend/app/catalog.py"
click node_search "https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/backend/app/search.py"
click node_skill_model "https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/backend/app/skills.py"
click node_prerequisites "https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/backend/app/prerequisites.py"
click node_path_builder "https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/backend/app/learning_path.py"
click node_track_designer "https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/backend/app/track_designer.py"
click node_advisor "https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/backend/app/advisor.py"
click node_confidence "https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/backend/app/confidence.py"
click node_live_eval "https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/backend/app/live_eval.py"
click node_feedback "https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/backend/app/feedback.py"
click node_feedback_store "https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/backend/app/feedback.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_discover,node_composer,node_recommend_hook,node_api_client,node_course_results,node_skill_chart,node_learning_path_view,node_what_if,node_evaluation_page toneBlue
class node_service_routes toneAmber
class node_recommender,node_catalog,node_search toneMint
class node_skill_model,node_prerequisites,node_path_builder,node_track_designer,node_advisor toneRose
class node_confidence,node_live_eval,node_feedback,node_feedback_store,node_student,node_llm_gateway toneIndigo
```

## Components

### Student application

- [App routing](https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Discover screen](https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/frontend/src/pages/Discover.tsx): `frontend/src/pages/Discover.tsx`
- [Goal composer](https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/frontend/src/components/Composer.tsx): `frontend/src/components/Composer.tsx`
- [Recommendation hook](https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/frontend/src/hooks/useRecommend.ts): `frontend/src/hooks/useRecommend.ts`
- [API client](https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/frontend/src/api.ts): `frontend/src/api.ts`
- [Course results](https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/frontend/src/components/CourseList.tsx): `frontend/src/components/CourseList.tsx`
- [Skill chart](https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/frontend/src/components/SkillChart.tsx): `frontend/src/components/SkillChart.tsx`
- [Learning path view](https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/frontend/src/components/LearningPath.tsx): `frontend/src/components/LearningPath.tsx`
- [What-If controls](https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/frontend/src/components/WhatIfBar.tsx): `frontend/src/components/WhatIfBar.tsx`
- [Evaluation screen](https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/frontend/src/pages/Evaluation.tsx): `frontend/src/pages/Evaluation.tsx`

### Service entry

- [FastAPI routes](https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/backend/app/main.py): `backend/app/main.py`

### Recommendation logic

- [Recommendation pipeline](https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/backend/app/recommend.py): `backend/app/recommend.py`
- [Course catalog](https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/backend/app/catalog.py): `backend/app/catalog.py`
- [Hybrid retrieval](https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/backend/app/search.py): `backend/app/search.py`

### Learning models

- [Profile and gaps](https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/backend/app/skills.py): `backend/app/skills.py`
- [Prerequisite model](https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/backend/app/prerequisites.py): `backend/app/prerequisites.py`
- [Path builder](https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/backend/app/learning_path.py): `backend/app/learning_path.py`
- [AI track designer](https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/backend/app/track_designer.py): `backend/app/track_designer.py`
- [Course explanations](https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/backend/app/advisor.py): `backend/app/advisor.py`

### Feedback and evaluation

- [Confidence estimates](https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/backend/app/confidence.py): `backend/app/confidence.py`
- [Per-query evaluation](https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/backend/app/live_eval.py): `backend/app/live_eval.py`
- [Feedback endpoint](https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/backend/app/feedback.py): `backend/app/feedback.py`
- [SQLite feedback](https://github.com/kavinimuthamizhvalavan/intelligent_course_discovery_system/blob/main/backend/app/feedback.py): `backend/app/feedback.py`

### Other components

- **Student**
- **Course gateway**

## Connections

- Student → Goal composer: enters goal (evidence: `README.md`)
- App routing → Discover screen: routes to (evidence: `frontend/src/App.tsx`)
- Discover screen → Goal composer: renders (evidence: `frontend/src/pages/Discover.tsx`)
- Discover screen → Recommendation hook: requests results (evidence: `frontend/src/pages/Discover.tsx`)
- Recommendation hook → API client: calls (evidence: `frontend/src/hooks/useRecommend.ts`)
- API client → FastAPI routes: sends requests (evidence: `frontend/src/api.ts`)
- FastAPI routes → Recommendation pipeline: dispatches (evidence: `backend/app/main.py`)
- Recommendation pipeline → Course catalog: uses catalog (evidence: `backend/app/recommend.py`)
- Recommendation pipeline → Hybrid retrieval: retrieves courses (evidence: `backend/app/recommend.py`)
- Recommendation pipeline → Profile and gaps: analyzes skills (evidence: `backend/app/recommend.py`)
- Recommendation pipeline → Prerequisite model: uses requirements (evidence: `backend/app/recommend.py`)
- Recommendation pipeline → Path builder: builds path (evidence: `backend/app/recommend.py`)
- Recommendation pipeline → AI track designer: may draft track (evidence: `backend/app/recommend.py`)
- Recommendation pipeline → Course explanations: creates advice (evidence: `backend/app/recommend.py`)
- Recommendation pipeline → Per-query evaluation: evaluates result (evidence: `backend/app/recommend.py`)
- Per-query evaluation → Confidence estimates: estimates relevance (evidence: `backend/app/live_eval.py`)
- AI track designer → Course gateway: requests draft (evidence: `backend/app/track_designer.py`)
- API client → Feedback endpoint: posts feedback (evidence: `frontend/src/api.ts`)
- Feedback endpoint → SQLite feedback: stores labels (evidence: `README.md`)
- API client → FastAPI routes: fetches report (evidence: `frontend/src/api.ts`)
- App routing → Evaluation screen: routes to (evidence: `frontend/src/App.tsx`)
- Evaluation screen → API client: loads evaluation (evidence: `frontend/src/pages/Evaluation.tsx`)
- Discover screen → Course results: renders results (evidence: `frontend/src/pages/Discover.tsx`)
- Discover screen → Skill chart: renders gaps (evidence: `frontend/src/pages/Discover.tsx`)
- Discover screen → Learning path view: renders path (evidence: `frontend/src/pages/Discover.tsx`)
- Discover screen → What-If controls: offers simulation (evidence: `frontend/src/pages/Discover.tsx`)
