# yaswanthibai/skillbridge architecture

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

- Interactive diagram: https://gitdiagram.com/yaswanthibai/skillbridge
- Repository: https://github.com/yaswanthibai/skillbridge

## Overview

SkillBridge Ayush is a multi-role AYUSH skills, learning, clinical-practice, and recruitment platform. Students register and build profiles, assess skill readiness, receive learning recommendations, and apply to internships; recruiters manage applicants and interviews, while institutions and ministry users view analytics. The React portal calls a Spring backend, which persists platform records and proxies specialized parsing and webhook-ingestion work to FastAPI. README-described capabilities include the clinical simulator, NAMASTE CV passport, webhook job feed, and national analytics. Some subsystem links are documented rather than verified from sampled implementation excerpts.

Main entry points: [`frontend/src/services/api.js`](https://github.com/yaswanthibai/skillbridge/blob/main/frontend/src/services/api.js) (API Client), [`ai-service/app/api/endpoints.py`](https://github.com/yaswanthibai/skillbridge/blob/main/ai-service/app/api/endpoints.py) (AI API), [`backend/src/main/java/com/ayush/skillbridge/service/InternshipService.java`](https://github.com/yaswanthibai/skillbridge/blob/main/backend/src/main/java/com/ayush/skillbridge/service/InternshipService.java) (Internship Workflow), [`backend/src/main/java/com/ayush/skillbridge/model/LearningProgram.java`](https://github.com/yaswanthibai/skillbridge/blob/main/backend/src/main/java/com/ayush/skillbridge/model/LearningProgram.java) (Platform Records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portal["Web Portal"]
  node_webapp["Portal Router<br/>[App.jsx]"]
  node_authctx["Session Auth<br/>[AuthContext.jsx]"]
  node_client["API Client<br/>[api.js]"]
  node_studentui["Student Portal"]
  node_recruiterui["Recruiter Portal"]
  node_cvui["CV Parser UI<br/>[CvParserPage.jsx]"]
  node_webhookui["Webhook Sandbox"]
  node_clinicalui["Clinical Simulator"]
  node_analyticsui["Institutional Analytics"]
end

subgraph group_platform["Platform Backend"]
  node_auth["Account &amp; RBAC<br/>[AuthService.java]"]
  node_internships["Internship Workflow"]
  node_skillgap["Skill Gap Analysis"]
  node_assessment["Skill Assessments"]
  node_learning["Learning Programs"]
  node_proxy["AI Proxy"]
end

subgraph group_ai["AI Services"]
  node_fastapi["AI API<br/>[endpoints.py]"]
  node_cvparser["CV Extraction<br/>[cv_parser.py]"]
  node_clinicner["Clinic Message NER"]
  node_taxonomy["AYUSH Taxonomies"]
end

subgraph group_data["Platform Data"]
  node_usersdb[("Accounts &amp; Profiles")]
  node_applicationsdb[("Applications<br/>[Application.java]")]
  node_domainstore[("Platform Records")]
end

node_users(("Portal Users"))

node_users -->|"uses portal"| node_webapp
node_webapp -->|"provides session"| node_authctx
node_studentui -->|"requests data"| node_client
node_recruiterui -->|"requests data"| node_client
node_cvui -->|"submits CV"| node_client
node_webhookui -->|"submits message"| node_client
node_client -.->|"calls backend"| node_auth
node_client -.->|"calls backend"| node_internships
node_client -.->|"calls backend"| node_skillgap
node_client -.->|"calls backend"| node_assessment
node_client -.->|"calls backend"| node_learning
node_auth -->|"stores accounts"| node_usersdb
node_internships -->|"updates applications"| node_applicationsdb
node_skillgap -->|"recommends programs"| node_domainstore
node_assessment -.->|"records results"| node_domainstore
node_learning -->|"tracks enrollment"| node_domainstore
node_internships -->|"requests AI work"| node_proxy
node_cvui -->|"uploads PDF or text"| node_fastapi
node_webhookui -->|"submits clinic message"| node_fastapi
node_proxy -.->|"forwards requests"| node_fastapi
node_fastapi -->|"invokes parser"| node_cvparser
node_fastapi -->|"invokes extractor"| node_clinicner
node_cvparser -->|"normalizes skills"| node_taxonomy
node_cvui -->|"produces skill passport"| node_taxonomy
node_fastapi -.->|"publishes job feed"| node_internships
node_users -->|"practices cases"| node_clinicalui
node_clinicalui -.->|"evaluates case"| node_fastapi
node_users -->|"reviews analytics"| node_analyticsui
node_analyticsui -.->|"reads platform data"| node_domainstore

click node_webapp "https://github.com/yaswanthibai/skillbridge/blob/main/frontend/src/App.jsx"
click node_authctx "https://github.com/yaswanthibai/skillbridge/blob/main/frontend/src/context/AuthContext.jsx"
click node_client "https://github.com/yaswanthibai/skillbridge/blob/main/frontend/src/services/api.js"
click node_studentui "https://github.com/yaswanthibai/skillbridge/blob/main/frontend/src/pages/StudentDashboard.jsx"
click node_recruiterui "https://github.com/yaswanthibai/skillbridge/blob/main/frontend/src/pages/IndustryPortalPage.jsx"
click node_cvui "https://github.com/yaswanthibai/skillbridge/blob/main/frontend/src/pages/CvParserPage.jsx"
click node_webhookui "https://github.com/yaswanthibai/skillbridge/blob/main/frontend/src/pages/WebhookSimulatorPage.jsx"
click node_clinicalui "https://github.com/yaswanthibai/skillbridge/blob/main/frontend/src/pages/ClinicalSimulatorPage.jsx"
click node_analyticsui "https://github.com/yaswanthibai/skillbridge/blob/main/frontend/src/pages/InstitutionalAdminDashboardPage.jsx"
click node_auth "https://github.com/yaswanthibai/skillbridge/blob/main/backend/src/main/java/com/ayush/skillbridge/service/AuthService.java"
click node_internships "https://github.com/yaswanthibai/skillbridge/blob/main/backend/src/main/java/com/ayush/skillbridge/service/InternshipService.java"
click node_skillgap "https://github.com/yaswanthibai/skillbridge/blob/main/backend/src/main/java/com/ayush/skillbridge/service/SkillGapService.java"
click node_assessment "https://github.com/yaswanthibai/skillbridge/blob/main/backend/src/main/java/com/ayush/skillbridge/controller/QuizController.java"
click node_learning "https://github.com/yaswanthibai/skillbridge/blob/main/backend/src/main/java/com/ayush/skillbridge/controller/LearningProgramController.java"
click node_proxy "https://github.com/yaswanthibai/skillbridge/blob/main/backend/src/main/java/com/ayush/skillbridge/service/AIServiceClient.java"
click node_fastapi "https://github.com/yaswanthibai/skillbridge/blob/main/ai-service/app/api/endpoints.py"
click node_cvparser "https://github.com/yaswanthibai/skillbridge/blob/main/ai-service/app/services/cv_parser.py"
click node_clinicner "https://github.com/yaswanthibai/skillbridge/blob/main/ai-service/app/services/clinic_ner_extractor.py"
click node_taxonomy "https://github.com/yaswanthibai/skillbridge/blob/main/ai-service/app/data/namaste_taxonomy.py"
click node_usersdb "https://github.com/yaswanthibai/skillbridge/blob/main/backend/src/main/java/com/ayush/skillbridge/model/StudentProfile.java"
click node_applicationsdb "https://github.com/yaswanthibai/skillbridge/blob/main/backend/src/main/java/com/ayush/skillbridge/model/Application.java"
click node_domainstore "https://github.com/yaswanthibai/skillbridge/blob/main/backend/src/main/java/com/ayush/skillbridge/model/LearningProgram.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_webapp,node_authctx,node_client,node_studentui,node_recruiterui,node_cvui,node_webhookui,node_clinicalui,node_analyticsui,node_users toneBlue
class node_auth,node_internships,node_skillgap,node_assessment,node_learning,node_proxy toneAmber
class node_fastapi,node_cvparser,node_clinicner,node_taxonomy toneMint
class node_usersdb,node_applicationsdb,node_domainstore toneRose
```

## Components

### Web Portal

- [Portal Router](https://github.com/yaswanthibai/skillbridge/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Session Auth](https://github.com/yaswanthibai/skillbridge/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [API Client](https://github.com/yaswanthibai/skillbridge/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`
- [Student Portal](https://github.com/yaswanthibai/skillbridge/blob/main/frontend/src/pages/StudentDashboard.jsx): `frontend/src/pages/StudentDashboard.jsx`
- [Recruiter Portal](https://github.com/yaswanthibai/skillbridge/blob/main/frontend/src/pages/IndustryPortalPage.jsx): `frontend/src/pages/IndustryPortalPage.jsx`
- [CV Parser UI](https://github.com/yaswanthibai/skillbridge/blob/main/frontend/src/pages/CvParserPage.jsx): `frontend/src/pages/CvParserPage.jsx`
- [Webhook Sandbox](https://github.com/yaswanthibai/skillbridge/blob/main/frontend/src/pages/WebhookSimulatorPage.jsx): `frontend/src/pages/WebhookSimulatorPage.jsx`
- [Clinical Simulator](https://github.com/yaswanthibai/skillbridge/blob/main/frontend/src/pages/ClinicalSimulatorPage.jsx): `frontend/src/pages/ClinicalSimulatorPage.jsx`
- [Institutional Analytics](https://github.com/yaswanthibai/skillbridge/blob/main/frontend/src/pages/InstitutionalAdminDashboardPage.jsx): `frontend/src/pages/InstitutionalAdminDashboardPage.jsx`

### Platform Backend

- [Account & RBAC](https://github.com/yaswanthibai/skillbridge/blob/main/backend/src/main/java/com/ayush/skillbridge/service/AuthService.java): `backend/src/main/java/com/ayush/skillbridge/service/AuthService.java`
- [Internship Workflow](https://github.com/yaswanthibai/skillbridge/blob/main/backend/src/main/java/com/ayush/skillbridge/service/InternshipService.java): `backend/src/main/java/com/ayush/skillbridge/service/InternshipService.java`
- [Skill Gap Analysis](https://github.com/yaswanthibai/skillbridge/blob/main/backend/src/main/java/com/ayush/skillbridge/service/SkillGapService.java): `backend/src/main/java/com/ayush/skillbridge/service/SkillGapService.java`
- [Skill Assessments](https://github.com/yaswanthibai/skillbridge/blob/main/backend/src/main/java/com/ayush/skillbridge/controller/QuizController.java): `backend/src/main/java/com/ayush/skillbridge/controller/QuizController.java`
- [Learning Programs](https://github.com/yaswanthibai/skillbridge/blob/main/backend/src/main/java/com/ayush/skillbridge/controller/LearningProgramController.java): `backend/src/main/java/com/ayush/skillbridge/controller/LearningProgramController.java`
- [AI Proxy](https://github.com/yaswanthibai/skillbridge/blob/main/backend/src/main/java/com/ayush/skillbridge/service/AIServiceClient.java): `backend/src/main/java/com/ayush/skillbridge/service/AIServiceClient.java`

### AI Services

- [AI API](https://github.com/yaswanthibai/skillbridge/blob/main/ai-service/app/api/endpoints.py): `ai-service/app/api/endpoints.py`
- [CV Extraction](https://github.com/yaswanthibai/skillbridge/blob/main/ai-service/app/services/cv_parser.py): `ai-service/app/services/cv_parser.py`
- [Clinic Message NER](https://github.com/yaswanthibai/skillbridge/blob/main/ai-service/app/services/clinic_ner_extractor.py): `ai-service/app/services/clinic_ner_extractor.py`
- [AYUSH Taxonomies](https://github.com/yaswanthibai/skillbridge/blob/main/ai-service/app/data/namaste_taxonomy.py): `ai-service/app/data/namaste_taxonomy.py`

### Platform Data

- [Accounts & Profiles](https://github.com/yaswanthibai/skillbridge/blob/main/backend/src/main/java/com/ayush/skillbridge/model/StudentProfile.java): `backend/src/main/java/com/ayush/skillbridge/model/StudentProfile.java`
- [Applications](https://github.com/yaswanthibai/skillbridge/blob/main/backend/src/main/java/com/ayush/skillbridge/model/Application.java): `backend/src/main/java/com/ayush/skillbridge/model/Application.java`
- [Platform Records](https://github.com/yaswanthibai/skillbridge/blob/main/backend/src/main/java/com/ayush/skillbridge/model/LearningProgram.java): `backend/src/main/java/com/ayush/skillbridge/model/LearningProgram.java`

### Other components

- **Portal Users**

## Connections

- Portal Users → Portal Router: uses portal (evidence: `README.md`)
- Portal Router → Session Auth: provides session (evidence: `frontend/src/App.jsx`)
- Student Portal → API Client: requests data (evidence: `frontend/src/services/api.js`)
- Recruiter Portal → API Client: requests data (evidence: `frontend/src/services/api.js`)
- CV Parser UI → API Client: submits CV (evidence: `frontend/src/pages/CvParserPage.jsx`)
- Webhook Sandbox → API Client: submits message (evidence: `frontend/src/pages/WebhookSimulatorPage.jsx`)
- API Client → Account & RBAC: calls backend
- API Client → Internship Workflow: calls backend
- API Client → Skill Gap Analysis: calls backend
- API Client → Skill Assessments: calls backend
- API Client → Learning Programs: calls backend
- Account & RBAC → Accounts & Profiles: stores accounts (evidence: `backend/src/main/java/com/ayush/skillbridge/service/AuthService.java`)
- Internship Workflow → Applications: updates applications (evidence: `backend/src/main/java/com/ayush/skillbridge/service/InternshipService.java`)
- Skill Gap Analysis → Platform Records: recommends programs (evidence: `backend/src/main/java/com/ayush/skillbridge/service/SkillGapService.java`)
- Skill Assessments → Platform Records: records results
- Learning Programs → Platform Records: tracks enrollment (evidence: `backend/src/main/java/com/ayush/skillbridge/controller/LearningProgramController.java`)
- Internship Workflow → AI Proxy: requests AI work (evidence: `backend/src/main/java/com/ayush/skillbridge/controller/InternshipController.java`)
- CV Parser UI → AI API: uploads PDF or text (evidence: `README.md`)
- Webhook Sandbox → AI API: submits clinic message (evidence: `README.md`)
- AI Proxy → AI API: forwards requests
- AI API → CV Extraction: invokes parser (evidence: `ai-service/app/api/endpoints.py`)
- AI API → Clinic Message NER: invokes extractor (evidence: `ai-service/app/api/endpoints.py`)
- CV Extraction → AYUSH Taxonomies: normalizes skills (evidence: `ai-service/app/services/cv_parser.py`)
- CV Parser UI → AYUSH Taxonomies: produces skill passport (evidence: `README.md`)
- AI API → Internship Workflow: publishes job feed
- Portal Users → Clinical Simulator: practices cases (evidence: `README.md`)
- Clinical Simulator → AI API: evaluates case
- Portal Users → Institutional Analytics: reviews analytics (evidence: `README.md`)
- Institutional Analytics → Platform Records: reads platform data
