# dhruvplaz-web/sih-2026-skillbridge architecture

> Architecture diagram of the GitHub repository dhruvplaz-web/sih-2026-skillbridge, 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/dhruvplaz-web/sih-2026-skillbridge
- Repository: https://github.com/dhruvplaz-web/sih-2026-skillbridge

## Overview

SkillSetu is a four-sided academic-to-industry platform: students build and verify skills, recruiters find and evaluate candidates, academicians align curricula, and regulators monitor workforce needs. Its React application communicates with a TypeScript API, which persists domain data and invokes local ML and AI services. The README documents TrustLedger credentials and additional stakeholder capabilities. Several route and feature modules are represented at subsystem level because their source was not sampled; edges are limited to documented or indexed relationships.

Main entry points: [`skillbridge/frontend/src/App.tsx`](https://github.com/dhruvplaz-web/sih-2026-skillbridge/blob/master/skillbridge/frontend/src/App.tsx) (Role-based web app), [`skillbridge/backend/src/database/db.ts`](https://github.com/dhruvplaz-web/sih-2026-skillbridge/blob/master/skillbridge/backend/src/database/db.ts) (Platform data store), [`skillbridge/backend/src/routes`](https://github.com/dhruvplaz-web/sih-2026-skillbridge/tree/master/skillbridge/backend/src/routes) (REST route dispatch), [`skillbridge/backend/src/services/aiService.ts`](https://github.com/dhruvplaz-web/sih-2026-skillbridge/blob/master/skillbridge/backend/src/services/aiService.ts) (AI orchestration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Stakeholder experience"]
  node_webapp["Role-based web app<br/>[App.tsx]"]
  node_student_features["Student skills and assessment"]
  node_recruiter_features["Recruiter hiring"]
  node_academic_features["Academic curriculum"]
  node_admin_features["Admin oversight"]
end

subgraph group_api["API and workflows"]
  node_api_client["Frontend API client<br/>[api.ts]"]
  node_routes["REST route dispatch"]
  node_student_controller["Student workflows"]
  node_applications["Applications and matching"]
  node_academic_controller["Academic workflows"]
  node_recruiter_controller["Recruiter workflows"]
  node_coding["Coding assessment runner<br/>[codeRunner.ts]"]
  node_auth["Authentication and roles<br/>[auth.ts]"]
end

subgraph group_intelligence["AI and matching"]
  node_ai_service["AI orchestration<br/>[aiService.ts]"]
  node_ml["Local ML capabilities"]
  node_recommendation["Candidate recommendations"]
end

subgraph group_trust["Trust and persistence"]
  node_database[("Platform data store<br/>[db.ts]")]
  node_trustledger[("TrustLedger credentials")]
end

node_student(("Students"))
node_recruiter(("Recruiters"))
node_academician(("Academicians"))
node_regulator(("Regulators"))

node_student -->|"uses"| node_webapp
node_recruiter -->|"uses"| node_webapp
node_academician -->|"uses"| node_webapp
node_regulator -->|"uses"| node_webapp
node_webapp -->|"routes to"| node_student_features
node_webapp -->|"routes to"| node_recruiter_features
node_webapp -->|"routes to"| node_academic_features
node_webapp -->|"routes to"| node_admin_features
node_webapp -->|"requests through"| node_api_client
node_api_client -->|"calls API"| node_routes
node_routes -->|"dispatches"| node_student_controller
node_routes -->|"dispatches"| node_applications
node_routes -->|"dispatches"| node_academic_controller
node_routes -->|"authenticates"| node_auth
node_student_controller -->|"requests AI analysis"| node_ai_service
node_student_controller -->|"reads and writes"| node_database
node_applications -->|"calculates match"| node_recommendation
node_applications -->|"reads and writes"| node_database
node_academic_controller -->|"analyzes curriculum"| node_ai_service
node_academic_controller -->|"writes workflow data"| node_database
node_recruiter_controller -->|"requests AI analysis"| node_ai_service
node_recruiter_controller -->|"reads and writes"| node_database
node_ai_service -->|"invokes models"| node_ml
node_recommendation -->|"reads candidate data"| node_database
node_auth -->|"looks up user"| node_database
node_coding -->|"runs submitted code"| node_student_controller
node_ai_service -.->|"supports credential verification"| node_trustledger
node_database -.->|"stores ledger records"| node_trustledger

click node_webapp "https://github.com/dhruvplaz-web/sih-2026-skillbridge/blob/master/skillbridge/frontend/src/App.tsx"
click node_student_features "https://github.com/dhruvplaz-web/sih-2026-skillbridge/tree/master/skillbridge/frontend/src/pages/student"
click node_recruiter_features "https://github.com/dhruvplaz-web/sih-2026-skillbridge/tree/master/skillbridge/frontend/src/pages/recruiter"
click node_academic_features "https://github.com/dhruvplaz-web/sih-2026-skillbridge/tree/master/skillbridge/frontend/src/pages/academician"
click node_admin_features "https://github.com/dhruvplaz-web/sih-2026-skillbridge/tree/master/skillbridge/frontend/src/pages/admin"
click node_api_client "https://github.com/dhruvplaz-web/sih-2026-skillbridge/blob/master/skillbridge/frontend/src/services/api.ts"
click node_routes "https://github.com/dhruvplaz-web/sih-2026-skillbridge/tree/master/skillbridge/backend/src/routes"
click node_student_controller "https://github.com/dhruvplaz-web/sih-2026-skillbridge/blob/master/skillbridge/backend/src/controllers/studentFeatures.controller.ts"
click node_applications "https://github.com/dhruvplaz-web/sih-2026-skillbridge/blob/master/skillbridge/backend/src/controllers/applications.controller.ts"
click node_academic_controller "https://github.com/dhruvplaz-web/sih-2026-skillbridge/blob/master/skillbridge/backend/src/controllers/academicianFeatures.controller.ts"
click node_recruiter_controller "https://github.com/dhruvplaz-web/sih-2026-skillbridge/blob/master/skillbridge/backend/src/controllers/recruiterFeatures.controller.ts"
click node_ai_service "https://github.com/dhruvplaz-web/sih-2026-skillbridge/blob/master/skillbridge/backend/src/services/aiService.ts"
click node_ml "https://github.com/dhruvplaz-web/sih-2026-skillbridge/tree/master/skillbridge/backend/src/ml"
click node_recommendation "https://github.com/dhruvplaz-web/sih-2026-skillbridge/blob/master/skillbridge/backend/src/services/recommendation.service.ts"
click node_coding "https://github.com/dhruvplaz-web/sih-2026-skillbridge/blob/master/skillbridge/backend/src/utils/codeRunner.ts"
click node_auth "https://github.com/dhruvplaz-web/sih-2026-skillbridge/blob/master/skillbridge/backend/src/middleware/auth.ts"
click node_database "https://github.com/dhruvplaz-web/sih-2026-skillbridge/blob/master/skillbridge/backend/src/database/db.ts"
click node_trustledger "https://github.com/dhruvplaz-web/sih-2026-skillbridge/tree/master/skillbridge/backend/src/database"

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_student_features,node_recruiter_features,node_academic_features,node_admin_features toneBlue
class node_api_client,node_routes,node_student_controller,node_applications,node_academic_controller,node_recruiter_controller,node_coding,node_auth toneAmber
class node_ai_service,node_ml,node_recommendation toneMint
class node_database,node_trustledger toneRose
class node_student,node_recruiter,node_academician,node_regulator toneIndigo
```

## Components

### Stakeholder experience

- [Role-based web app](https://github.com/dhruvplaz-web/sih-2026-skillbridge/blob/master/skillbridge/frontend/src/App.tsx): `skillbridge/frontend/src/App.tsx`
- [Student skills and assessment](https://github.com/dhruvplaz-web/sih-2026-skillbridge/tree/master/skillbridge/frontend/src/pages/student): `skillbridge/frontend/src/pages/student`
- [Recruiter hiring](https://github.com/dhruvplaz-web/sih-2026-skillbridge/tree/master/skillbridge/frontend/src/pages/recruiter): `skillbridge/frontend/src/pages/recruiter`
- [Academic curriculum](https://github.com/dhruvplaz-web/sih-2026-skillbridge/tree/master/skillbridge/frontend/src/pages/academician): `skillbridge/frontend/src/pages/academician`
- [Admin oversight](https://github.com/dhruvplaz-web/sih-2026-skillbridge/tree/master/skillbridge/frontend/src/pages/admin): `skillbridge/frontend/src/pages/admin`

### API and workflows

- [Frontend API client](https://github.com/dhruvplaz-web/sih-2026-skillbridge/blob/master/skillbridge/frontend/src/services/api.ts): `skillbridge/frontend/src/services/api.ts`
- [REST route dispatch](https://github.com/dhruvplaz-web/sih-2026-skillbridge/tree/master/skillbridge/backend/src/routes): `skillbridge/backend/src/routes`
- [Student workflows](https://github.com/dhruvplaz-web/sih-2026-skillbridge/blob/master/skillbridge/backend/src/controllers/studentFeatures.controller.ts): `skillbridge/backend/src/controllers/studentFeatures.controller.ts`
- [Applications and matching](https://github.com/dhruvplaz-web/sih-2026-skillbridge/blob/master/skillbridge/backend/src/controllers/applications.controller.ts): `skillbridge/backend/src/controllers/applications.controller.ts`
- [Academic workflows](https://github.com/dhruvplaz-web/sih-2026-skillbridge/blob/master/skillbridge/backend/src/controllers/academicianFeatures.controller.ts): `skillbridge/backend/src/controllers/academicianFeatures.controller.ts`
- [Recruiter workflows](https://github.com/dhruvplaz-web/sih-2026-skillbridge/blob/master/skillbridge/backend/src/controllers/recruiterFeatures.controller.ts): `skillbridge/backend/src/controllers/recruiterFeatures.controller.ts`
- [Coding assessment runner](https://github.com/dhruvplaz-web/sih-2026-skillbridge/blob/master/skillbridge/backend/src/utils/codeRunner.ts): `skillbridge/backend/src/utils/codeRunner.ts`
- [Authentication and roles](https://github.com/dhruvplaz-web/sih-2026-skillbridge/blob/master/skillbridge/backend/src/middleware/auth.ts): `skillbridge/backend/src/middleware/auth.ts`

### AI and matching

- [AI orchestration](https://github.com/dhruvplaz-web/sih-2026-skillbridge/blob/master/skillbridge/backend/src/services/aiService.ts): `skillbridge/backend/src/services/aiService.ts`
- [Local ML capabilities](https://github.com/dhruvplaz-web/sih-2026-skillbridge/tree/master/skillbridge/backend/src/ml): `skillbridge/backend/src/ml`
- [Candidate recommendations](https://github.com/dhruvplaz-web/sih-2026-skillbridge/blob/master/skillbridge/backend/src/services/recommendation.service.ts): `skillbridge/backend/src/services/recommendation.service.ts`

### Trust and persistence

- [Platform data store](https://github.com/dhruvplaz-web/sih-2026-skillbridge/blob/master/skillbridge/backend/src/database/db.ts): `skillbridge/backend/src/database/db.ts`
- [TrustLedger credentials](https://github.com/dhruvplaz-web/sih-2026-skillbridge/tree/master/skillbridge/backend/src/database): `skillbridge/backend/src/database`

### Other components

- **Students**
- **Recruiters**
- **Academicians**
- **Regulators**

## Connections

- Students → Role-based web app: uses (evidence: `README.md`)
- Recruiters → Role-based web app: uses (evidence: `README.md`)
- Academicians → Role-based web app: uses (evidence: `README.md`)
- Regulators → Role-based web app: uses (evidence: `README.md`)
- Role-based web app → Student skills and assessment: routes to (evidence: `skillbridge/frontend/src/App.tsx`)
- Role-based web app → Recruiter hiring: routes to (evidence: `skillbridge/frontend/src/App.tsx`)
- Role-based web app → Academic curriculum: routes to (evidence: `skillbridge/frontend/src/App.tsx`)
- Role-based web app → Admin oversight: routes to (evidence: `skillbridge/frontend/src/App.tsx`)
- Role-based web app → Frontend API client: requests through (evidence: `README.md`)
- Frontend API client → REST route dispatch: calls API (evidence: `README.md`)
- REST route dispatch → Student workflows: dispatches (evidence: `skillbridge/backend/src/routes/student.routes.ts`)
- REST route dispatch → Applications and matching: dispatches (evidence: `skillbridge/backend/src/routes/applications.routes.ts`)
- REST route dispatch → Academic workflows: dispatches (evidence: `skillbridge/backend/src/routes/academician.routes.ts`)
- REST route dispatch → Authentication and roles: authenticates (evidence: `skillbridge/backend/src/routes/student.routes.ts`)
- Student workflows → AI orchestration: requests AI analysis (evidence: `skillbridge/backend/src/controllers/studentFeatures.controller.ts`)
- Student workflows → Platform data store: reads and writes (evidence: `skillbridge/backend/src/controllers/studentFeatures.controller.ts`)
- Applications and matching → Candidate recommendations: calculates match (evidence: `skillbridge/backend/src/controllers/applications.controller.ts`)
- Applications and matching → Platform data store: reads and writes (evidence: `skillbridge/backend/src/controllers/applications.controller.ts`)
- Academic workflows → AI orchestration: analyzes curriculum (evidence: `skillbridge/backend/src/controllers/academicianFeatures.controller.ts`)
- Academic workflows → Platform data store: writes workflow data (evidence: `skillbridge/backend/src/controllers/academicianFeatures.controller.ts`)
- Recruiter workflows → AI orchestration: requests AI analysis (evidence: `skillbridge/backend/src/controllers/recruiterFeatures.controller.ts`)
- Recruiter workflows → Platform data store: reads and writes (evidence: `skillbridge/backend/src/controllers/recruiterFeatures.controller.ts`)
- AI orchestration → Local ML capabilities: invokes models (evidence: `skillbridge/backend/src/services/aiService.ts`)
- Candidate recommendations → Platform data store: reads candidate data (evidence: `skillbridge/backend/src/services/recommendation.service.ts`)
- Authentication and roles → Platform data store: looks up user (evidence: `skillbridge/backend/src/middleware/auth.ts`)
- Coding assessment runner → Student workflows: runs submitted code
- AI orchestration → TrustLedger credentials: supports credential verification (evidence: `README.md`)
- Platform data store → TrustLedger credentials: stores ledger records (evidence: `README.md`)
