# selvendran-b/skillpulse-analytics architecture

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

- Interactive diagram: https://gitdiagram.com/selvendran-b/skillpulse-analytics
- Repository: https://github.com/selvendran-b/skillpulse-analytics

## Overview

SkillPulse Analytics combines authenticated career-source ingestion with a dashboard and an AI assistant grounded in a user’s connected data. Source-specific routes and services process Resume, LinkedIn, GitHub, and LeetCode information; synchronization builds searchable knowledge, embeddings, and project links. For questions, routing selects sources and retrieval strategies before retrieval supplies context for AI responses. The graph retains the documented comparison and dashboard capabilities. Some links come from the README or source-index references; unsampled implementation details are not assumed.

Main entry points: [`frontend/src/App.jsx`](https://github.com/selvendran-b/skillpulse-analytics/blob/main/frontend/src/App.jsx) (Web application), [`backend/models.py`](https://github.com/selvendran-b/skillpulse-analytics/blob/main/backend/models.py) (PostgreSQL data), [`backend/services/ai_orchestrator.py`](https://github.com/selvendran-b/skillpulse-analytics/blob/main/backend/services/ai_orchestrator.py) (AI data sync), [`backend/main.py`](https://github.com/selvendran-b/skillpulse-analytics/blob/main/backend/main.py) (API application)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_web["Web application<br/>[App.jsx]"]
  node_resume_ui["Resume page<br/>[Resume.jsx]"]
  node_linkedin_ui["LinkedIn page<br/>[LinkedIn.jsx]"]
  node_github_ui["GitHub page<br/>[GitHub.jsx]"]
  node_leetcode_ui["LeetCode page<br/>[LeetCode.jsx]"]
  node_comparison_ui["Comparison page<br/>[Comparison.jsx]"]
  node_assistant_ui["AI assistant page<br/>[AIAssistant.jsx]"]
end

subgraph group_ingestion["Career data"]
  node_api["API application<br/>[main.py]"]
  node_resume["Resume processing<br/>[resume.py]"]
  node_linkedin["LinkedIn processing"]
  node_github["GitHub integration<br/>[github_service.py]"]
  node_leetcode["LeetCode integration"]
  node_career_profile["Career profile<br/>[profile_builder.py]"]
end

subgraph group_knowledge["Knowledge preparation"]
  node_sync["AI data sync<br/>[ai_orchestrator.py]"]
  node_knowledge_builder["Knowledge builder<br/>[builder.py]"]
  node_project_linker["Project linking<br/>[project_linker.py]"]
  node_embeddings["Embedding service"]
end

subgraph group_assistant["AI answering"]
  node_ai_router["AI API routes<br/>[router.py]"]
  node_query_router["Question routing<br/>[query_router.py]"]
  node_retrieval["Context retrieval"]
  node_cross_source["Cross-source retrieval"]
  node_llm["LLM client<br/>[llm_client.py]"]
end

subgraph group_storage["Persistence"]
  node_postgres[("PostgreSQL data<br/>[models.py]")]
  node_vector_store[("Vector store")]
end

node_user(("Career user"))
node_llm_provider["Groq service"]

node_user -.->|"uses"| node_web
node_web -->|"routes"| node_resume_ui
node_web -->|"routes"| node_linkedin_ui
node_web -->|"routes"| node_github_ui
node_web -->|"routes"| node_leetcode_ui
node_web -->|"routes"| node_comparison_ui
node_web -->|"routes"| node_assistant_ui
node_web -.->|"requests"| node_api
node_api -->|"registers"| node_resume
node_api -->|"registers"| node_linkedin
node_api -->|"registers"| node_leetcode
node_api -->|"registers"| node_github
node_resume -->|"synchronizes"| node_sync
node_linkedin -->|"synchronizes"| node_sync
node_github -->|"synchronizes"| node_sync
node_leetcode -->|"synchronizes"| node_sync
node_resume -->|"stores profile"| node_postgres
node_linkedin -->|"stores profile"| node_postgres
node_leetcode -->|"stores profile"| node_postgres
node_github -->|"stores data"| node_postgres
node_resume -.->|"builds profile"| node_career_profile
node_sync -->|"builds knowledge"| node_knowledge_builder
node_sync -->|"builds links"| node_project_linker
node_sync -->|"updates vectors"| node_embeddings
node_knowledge_builder -.->|"writes chunks"| node_postgres
node_embeddings -->|"reads chunks"| node_postgres
node_embeddings -->|"writes vectors"| node_vector_store
node_ai_router -.->|"routes question"| node_query_router
node_query_router -->|"selects retrieval"| node_retrieval
node_retrieval -->|"retrieves context"| node_cross_source
node_retrieval -->|"queries records"| node_postgres
node_retrieval -.->|"searches vectors"| node_vector_store
node_ai_router -.->|"generates answers"| node_llm
node_llm -.->|"sends prompts"| node_llm_provider
node_ai_router -->|"loads data"| node_postgres

click node_web "https://github.com/selvendran-b/skillpulse-analytics/blob/main/frontend/src/App.jsx"
click node_resume_ui "https://github.com/selvendran-b/skillpulse-analytics/blob/main/frontend/src/pages/Resume.jsx"
click node_linkedin_ui "https://github.com/selvendran-b/skillpulse-analytics/blob/main/frontend/src/pages/LinkedIn.jsx"
click node_github_ui "https://github.com/selvendran-b/skillpulse-analytics/blob/main/frontend/src/pages/GitHub.jsx"
click node_leetcode_ui "https://github.com/selvendran-b/skillpulse-analytics/blob/main/frontend/src/pages/LeetCode.jsx"
click node_comparison_ui "https://github.com/selvendran-b/skillpulse-analytics/blob/main/frontend/src/pages/Comparison.jsx"
click node_assistant_ui "https://github.com/selvendran-b/skillpulse-analytics/blob/main/frontend/src/pages/AIAssistant.jsx"
click node_api "https://github.com/selvendran-b/skillpulse-analytics/blob/main/backend/main.py"
click node_resume "https://github.com/selvendran-b/skillpulse-analytics/blob/main/backend/routes/resume.py"
click node_linkedin "https://github.com/selvendran-b/skillpulse-analytics/blob/main/backend/linkedin/linkedin_service.py"
click node_github "https://github.com/selvendran-b/skillpulse-analytics/blob/main/backend/github/github_service.py"
click node_leetcode "https://github.com/selvendran-b/skillpulse-analytics/blob/main/backend/leetcode/leetcode_service.py"
click node_career_profile "https://github.com/selvendran-b/skillpulse-analytics/blob/main/backend/career/profile_builder.py"
click node_sync "https://github.com/selvendran-b/skillpulse-analytics/blob/main/backend/services/ai_orchestrator.py"
click node_knowledge_builder "https://github.com/selvendran-b/skillpulse-analytics/blob/main/backend/knowledge/builder.py"
click node_project_linker "https://github.com/selvendran-b/skillpulse-analytics/blob/main/backend/project_link/project_linker.py"
click node_embeddings "https://github.com/selvendran-b/skillpulse-analytics/blob/main/backend/embeddings/embedding_service.py"
click node_ai_router "https://github.com/selvendran-b/skillpulse-analytics/blob/main/backend/ai/router.py"
click node_query_router "https://github.com/selvendran-b/skillpulse-analytics/blob/main/backend/ai/query_router.py"
click node_retrieval "https://github.com/selvendran-b/skillpulse-analytics/blob/main/backend/rag/retrieval_router.py"
click node_cross_source "https://github.com/selvendran-b/skillpulse-analytics/blob/main/backend/rag/cross_source_retriever.py"
click node_llm "https://github.com/selvendran-b/skillpulse-analytics/blob/main/backend/ai/llm_client.py"
click node_postgres "https://github.com/selvendran-b/skillpulse-analytics/blob/main/backend/models.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_web,node_resume_ui,node_linkedin_ui,node_github_ui,node_leetcode_ui,node_comparison_ui,node_assistant_ui,node_user toneBlue
class node_api,node_resume,node_linkedin,node_github,node_leetcode,node_career_profile toneAmber
class node_sync,node_knowledge_builder,node_project_linker,node_embeddings toneMint
class node_ai_router,node_query_router,node_retrieval,node_cross_source,node_llm toneRose
class node_postgres,node_vector_store,node_llm_provider toneIndigo
```

## Components

### User experience

- [Web application](https://github.com/selvendran-b/skillpulse-analytics/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Resume page](https://github.com/selvendran-b/skillpulse-analytics/blob/main/frontend/src/pages/Resume.jsx): `frontend/src/pages/Resume.jsx`
- [LinkedIn page](https://github.com/selvendran-b/skillpulse-analytics/blob/main/frontend/src/pages/LinkedIn.jsx): `frontend/src/pages/LinkedIn.jsx`
- [GitHub page](https://github.com/selvendran-b/skillpulse-analytics/blob/main/frontend/src/pages/GitHub.jsx): `frontend/src/pages/GitHub.jsx`
- [LeetCode page](https://github.com/selvendran-b/skillpulse-analytics/blob/main/frontend/src/pages/LeetCode.jsx): `frontend/src/pages/LeetCode.jsx`
- [Comparison page](https://github.com/selvendran-b/skillpulse-analytics/blob/main/frontend/src/pages/Comparison.jsx): `frontend/src/pages/Comparison.jsx`
- [AI assistant page](https://github.com/selvendran-b/skillpulse-analytics/blob/main/frontend/src/pages/AIAssistant.jsx): `frontend/src/pages/AIAssistant.jsx`

### Career data

- [API application](https://github.com/selvendran-b/skillpulse-analytics/blob/main/backend/main.py): `backend/main.py`
- [Resume processing](https://github.com/selvendran-b/skillpulse-analytics/blob/main/backend/routes/resume.py): `backend/routes/resume.py`
- [LinkedIn processing](https://github.com/selvendran-b/skillpulse-analytics/blob/main/backend/linkedin/linkedin_service.py): `backend/linkedin/linkedin_service.py`
- [GitHub integration](https://github.com/selvendran-b/skillpulse-analytics/blob/main/backend/github/github_service.py): `backend/github/github_service.py`
- [LeetCode integration](https://github.com/selvendran-b/skillpulse-analytics/blob/main/backend/leetcode/leetcode_service.py): `backend/leetcode/leetcode_service.py`
- [Career profile](https://github.com/selvendran-b/skillpulse-analytics/blob/main/backend/career/profile_builder.py): `backend/career/profile_builder.py`

### Knowledge preparation

- [AI data sync](https://github.com/selvendran-b/skillpulse-analytics/blob/main/backend/services/ai_orchestrator.py): `backend/services/ai_orchestrator.py`
- [Knowledge builder](https://github.com/selvendran-b/skillpulse-analytics/blob/main/backend/knowledge/builder.py): `backend/knowledge/builder.py`
- [Project linking](https://github.com/selvendran-b/skillpulse-analytics/blob/main/backend/project_link/project_linker.py): `backend/project_link/project_linker.py`
- [Embedding service](https://github.com/selvendran-b/skillpulse-analytics/blob/main/backend/embeddings/embedding_service.py): `backend/embeddings/embedding_service.py`

### AI answering

- [AI API routes](https://github.com/selvendran-b/skillpulse-analytics/blob/main/backend/ai/router.py): `backend/ai/router.py`
- [Question routing](https://github.com/selvendran-b/skillpulse-analytics/blob/main/backend/ai/query_router.py): `backend/ai/query_router.py`
- [Context retrieval](https://github.com/selvendran-b/skillpulse-analytics/blob/main/backend/rag/retrieval_router.py): `backend/rag/retrieval_router.py`
- [Cross-source retrieval](https://github.com/selvendran-b/skillpulse-analytics/blob/main/backend/rag/cross_source_retriever.py): `backend/rag/cross_source_retriever.py`
- [LLM client](https://github.com/selvendran-b/skillpulse-analytics/blob/main/backend/ai/llm_client.py): `backend/ai/llm_client.py`

### Persistence

- [PostgreSQL data](https://github.com/selvendran-b/skillpulse-analytics/blob/main/backend/models.py): `backend/models.py`
- **Vector store**

### Other components

- **Career user**
- **Groq service**

## Connections

- Career user → Web application: uses
- Web application → Resume page: routes (evidence: `frontend/src/App.jsx`)
- Web application → LinkedIn page: routes (evidence: `frontend/src/App.jsx`)
- Web application → GitHub page: routes (evidence: `frontend/src/App.jsx`)
- Web application → LeetCode page: routes (evidence: `frontend/src/App.jsx`)
- Web application → Comparison page: routes (evidence: `frontend/src/App.jsx`)
- Web application → AI assistant page: routes (evidence: `frontend/src/App.jsx`)
- Web application → API application: requests
- API application → Resume processing: registers (evidence: `backend/main.py`)
- API application → LinkedIn processing: registers (evidence: `backend/main.py`)
- API application → LeetCode integration: registers (evidence: `backend/main.py`)
- API application → GitHub integration: registers (evidence: `backend/main.py`)
- Resume processing → AI data sync: synchronizes (evidence: `backend/routes/resume.py`)
- LinkedIn processing → AI data sync: synchronizes (evidence: `backend/linkedin/linkedin_service.py`)
- GitHub integration → AI data sync: synchronizes (evidence: `backend/github/github_service.py`)
- LeetCode integration → AI data sync: synchronizes (evidence: `backend/leetcode/leetcode_service.py`)
- Resume processing → PostgreSQL data: stores profile (evidence: `backend/routes/resume.py`)
- LinkedIn processing → PostgreSQL data: stores profile (evidence: `backend/linkedin/linkedin_routes.py`)
- LeetCode integration → PostgreSQL data: stores profile (evidence: `backend/leetcode/leetcode_routes.py`)
- GitHub integration → PostgreSQL data: stores data (evidence: `backend/routes/github.py`)
- Resume processing → Career profile: builds profile
- AI data sync → Knowledge builder: builds knowledge (evidence: `backend/services/ai_orchestrator.py`)
- AI data sync → Project linking: builds links (evidence: `backend/services/ai_orchestrator.py`)
- AI data sync → Embedding service: updates vectors (evidence: `backend/services/ai_orchestrator.py`)
- Knowledge builder → PostgreSQL data: writes chunks (evidence: `backend/knowledge/builder.py`)
- Embedding service → PostgreSQL data: reads chunks (evidence: `backend/embeddings/embedding_service.py`)
- Embedding service → Vector store: writes vectors (evidence: `backend/embeddings/embedding_service.py`)
- AI API routes → Question routing: routes question
- Question routing → Context retrieval: selects retrieval (evidence: `backend/rag/retrieval_router.py`)
- Context retrieval → Cross-source retrieval: retrieves context (evidence: `backend/rag/retrieval_router.py`)
- Context retrieval → PostgreSQL data: queries records (evidence: `backend/rag/retrieval_router.py`)
- Context retrieval → Vector store: searches vectors
- AI API routes → LLM client: generates answers
- LLM client → Groq service: sends prompts
- AI API routes → PostgreSQL data: loads data (evidence: `backend/ai/router.py`)
