# pavancodenexus/skillsift architecture

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

- Interactive diagram: https://gitdiagram.com/pavancodenexus/skillsift
- Repository: https://github.com/pavancodenexus/skillsift

## Overview

SkillSift is a course-discovery application: students search for tutorials tailored to a goal, level, and language, then can watch courses and manage playlists, history, notes, and profile data. The sampled search service shows cache lookup, YouTube retrieval, ranking, and cache persistence; sampled account services show authentication, playlist, and profile operations. The README documents AI verdicts, filtering, and the broader runtime architecture, but several implementations and frontend page-to-API connections were not sampled, so those links are omitted or marked unverified.

Main entry points: [`frontend/src/App.jsx`](https://github.com/pavancodenexus/skillsift/blob/main/frontend/src/App.jsx) (React app), [`backend/src/main/java/com/skillsift/service/SearchService.java`](https://github.com/pavancodenexus/skillsift/blob/main/backend/src/main/java/com/skillsift/service/SearchService.java) (Search service), [`backend/src/main/java/com/skillsift/service/PlaylistService.java`](https://github.com/pavancodenexus/skillsift/blob/main/backend/src/main/java/com/skillsift/service/PlaylistService.java) (Playlist service), [`backend/src/main/java/com/skillsift/service/ProfileService.java`](https://github.com/pavancodenexus/skillsift/blob/main/backend/src/main/java/com/skillsift/service/ProfileService.java) (Profile and notes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Student experience"]
  node_app["React app<br/>[App.jsx]"]
end

subgraph group_discovery["Course discovery"]
  node_search["Search service<br/>[SearchService.java]"]
  node_youtube["YouTube client<br/>[YouTubeClient.java]"]
  node_ranking["AI ranking"]
  node_groq{{"Groq AI"}}
  node_cache[("Search cache<br/>[SearchCache.java]")]
end

subgraph group_identity["Identity and security"]
  node_authstate["Auth state<br/>[AuthContext.jsx]"]
  node_authapi["Auth API client<br/>[authApi.js]"]
  node_authcontroller["Auth endpoints"]
  node_authservice["Auth service<br/>[AuthService.java]"]
  node_users[("User records<br/>[User.java]")]
end

subgraph group_learning["Learning records"]
  node_playlists["Playlist service"]
  node_playlistcontroller["Playlist endpoints"]
  node_history["Watch history"]
  node_profile["Profile and notes"]
  node_database[("PostgreSQL")]
end

node_student(("Student"))

node_student -->|"uses"| node_app
node_app -->|"provides context"| node_authstate
node_authstate -->|"calls"| node_authapi
node_authapi -.->|"sends auth requests"| node_authcontroller
node_authcontroller -.->|"delegates"| node_authservice
node_authservice -->|"reads and writes"| node_users
node_app -.->|"requests courses"| node_search
node_search -->|"checks and saves"| node_cache
node_search -->|"fetches courses"| node_youtube
node_search -->|"ranks results"| node_ranking
node_ranking -.->|"evaluates courses"| node_groq
node_app -.->|"manages playlists"| node_playlistcontroller
node_playlistcontroller -->|"delegates"| node_playlists
node_playlists -->|"looks up owner"| node_users
node_app -.->|"tracks viewing"| node_history
node_app -.->|"views profile and notes"| node_profile
node_profile -->|"loads profile"| node_users
node_playlists -.->|"persists playlists"| node_database
node_history -.->|"persists history"| node_database
node_profile -.->|"persists profile data"| node_database
node_search -.->|"uses SQL cache"| node_database
node_youtube -.->|"fetches video data"| node_database

click node_app "https://github.com/pavancodenexus/skillsift/blob/main/frontend/src/App.jsx"
click node_authstate "https://github.com/pavancodenexus/skillsift/blob/main/frontend/src/context/AuthContext.jsx"
click node_authapi "https://github.com/pavancodenexus/skillsift/blob/main/frontend/src/api/authApi.js"
click node_authcontroller "https://github.com/pavancodenexus/skillsift/blob/main/backend/src/main/java/com/skillsift/controller/AuthController.java"
click node_authservice "https://github.com/pavancodenexus/skillsift/blob/main/backend/src/main/java/com/skillsift/service/AuthService.java"
click node_users "https://github.com/pavancodenexus/skillsift/blob/main/backend/src/main/java/com/skillsift/model/User.java"
click node_search "https://github.com/pavancodenexus/skillsift/blob/main/backend/src/main/java/com/skillsift/service/SearchService.java"
click node_youtube "https://github.com/pavancodenexus/skillsift/blob/main/backend/src/main/java/com/skillsift/client/YouTubeClient.java"
click node_ranking "https://github.com/pavancodenexus/skillsift/blob/main/backend/src/main/java/com/skillsift/service/RankingService.java"
click node_cache "https://github.com/pavancodenexus/skillsift/blob/main/backend/src/main/java/com/skillsift/model/SearchCache.java"
click node_playlists "https://github.com/pavancodenexus/skillsift/blob/main/backend/src/main/java/com/skillsift/service/PlaylistService.java"
click node_playlistcontroller "https://github.com/pavancodenexus/skillsift/blob/main/backend/src/main/java/com/skillsift/controller/PlaylistController.java"
click node_history "https://github.com/pavancodenexus/skillsift/blob/main/backend/src/main/java/com/skillsift/service/HistoryService.java"
click node_profile "https://github.com/pavancodenexus/skillsift/blob/main/backend/src/main/java/com/skillsift/service/ProfileService.java"

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 toneBlue
class node_search,node_youtube,node_ranking,node_groq,node_cache toneAmber
class node_authstate,node_authapi,node_authcontroller,node_authservice,node_users toneMint
class node_playlists,node_playlistcontroller,node_history,node_profile,node_database toneRose
class node_student toneIndigo
```

## Components

### Student experience

- [React app](https://github.com/pavancodenexus/skillsift/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`

### Course discovery

- [Search service](https://github.com/pavancodenexus/skillsift/blob/main/backend/src/main/java/com/skillsift/service/SearchService.java): `backend/src/main/java/com/skillsift/service/SearchService.java`
- [YouTube client](https://github.com/pavancodenexus/skillsift/blob/main/backend/src/main/java/com/skillsift/client/YouTubeClient.java): `backend/src/main/java/com/skillsift/client/YouTubeClient.java`
- [AI ranking](https://github.com/pavancodenexus/skillsift/blob/main/backend/src/main/java/com/skillsift/service/RankingService.java): `backend/src/main/java/com/skillsift/service/RankingService.java`
- **Groq AI**
- [Search cache](https://github.com/pavancodenexus/skillsift/blob/main/backend/src/main/java/com/skillsift/model/SearchCache.java): `backend/src/main/java/com/skillsift/model/SearchCache.java`

### Identity and security

- [Auth state](https://github.com/pavancodenexus/skillsift/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [Auth API client](https://github.com/pavancodenexus/skillsift/blob/main/frontend/src/api/authApi.js): `frontend/src/api/authApi.js`
- [Auth endpoints](https://github.com/pavancodenexus/skillsift/blob/main/backend/src/main/java/com/skillsift/controller/AuthController.java): `backend/src/main/java/com/skillsift/controller/AuthController.java`
- [Auth service](https://github.com/pavancodenexus/skillsift/blob/main/backend/src/main/java/com/skillsift/service/AuthService.java): `backend/src/main/java/com/skillsift/service/AuthService.java`
- [User records](https://github.com/pavancodenexus/skillsift/blob/main/backend/src/main/java/com/skillsift/model/User.java): `backend/src/main/java/com/skillsift/model/User.java`

### Learning records

- [Playlist service](https://github.com/pavancodenexus/skillsift/blob/main/backend/src/main/java/com/skillsift/service/PlaylistService.java): `backend/src/main/java/com/skillsift/service/PlaylistService.java`
- [Playlist endpoints](https://github.com/pavancodenexus/skillsift/blob/main/backend/src/main/java/com/skillsift/controller/PlaylistController.java): `backend/src/main/java/com/skillsift/controller/PlaylistController.java`
- [Watch history](https://github.com/pavancodenexus/skillsift/blob/main/backend/src/main/java/com/skillsift/service/HistoryService.java): `backend/src/main/java/com/skillsift/service/HistoryService.java`
- [Profile and notes](https://github.com/pavancodenexus/skillsift/blob/main/backend/src/main/java/com/skillsift/service/ProfileService.java): `backend/src/main/java/com/skillsift/service/ProfileService.java`
- **PostgreSQL**

### Other components

- **Student**

## Connections

- Student → React app: uses (evidence: `README.md`)
- React app → Auth state: provides context (evidence: `frontend/src/App.jsx`)
- Auth state → Auth API client: calls (evidence: `frontend/src/context/AuthContext.jsx`)
- Auth API client → Auth endpoints: sends auth requests
- Auth endpoints → Auth service: delegates
- Auth service → User records: reads and writes (evidence: `backend/src/main/java/com/skillsift/service/AuthService.java`)
- React app → Search service: requests courses
- Search service → Search cache: checks and saves (evidence: `backend/src/main/java/com/skillsift/service/SearchService.java`)
- Search service → YouTube client: fetches courses (evidence: `backend/src/main/java/com/skillsift/service/SearchService.java`)
- Search service → AI ranking: ranks results (evidence: `backend/src/main/java/com/skillsift/service/SearchService.java`)
- AI ranking → Groq AI: evaluates courses (evidence: `README.md`)
- React app → Playlist endpoints: manages playlists
- Playlist endpoints → Playlist service: delegates (evidence: `backend/src/main/java/com/skillsift/controller/PlaylistController.java`)
- Playlist service → User records: looks up owner (evidence: `backend/src/main/java/com/skillsift/service/PlaylistService.java`)
- React app → Watch history: tracks viewing
- React app → Profile and notes: views profile and notes
- Profile and notes → User records: loads profile (evidence: `backend/src/main/java/com/skillsift/service/ProfileService.java`)
- Playlist service → PostgreSQL: persists playlists (evidence: `README.md`)
- Watch history → PostgreSQL: persists history (evidence: `README.md`)
- Profile and notes → PostgreSQL: persists profile data (evidence: `README.md`)
- Search service → PostgreSQL: uses SQL cache (evidence: `README.md`)
- YouTube client → PostgreSQL: fetches video data (evidence: `README.md`)
