# nithishkumarkumar16-jpg/sih-sgp architecture

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

- Interactive diagram: https://gitdiagram.com/nithishkumarkumar16-jpg/sih-sgp
- Repository: https://github.com/nithishkumarkumar16-jpg/sih-sgp

## Overview

This is a scholarship guidance and administration platform: students discover schemes, assess eligibility and readiness, submit applications and documents, then college and ministry staff review applications through payment and completion. The graph follows the evidenced UI-to-API flow and major documented modules. Several feature components and backend route files were not excerpted; their role is represented at directory level where needed, and uncertain connections are omitted. It is based on the README, file tree and sampled source rather than a full inspection of every module.

Main entry points: [`src/App.js`](https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/src/App.js) (Route application), [`src/utils/api.js`](https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/src/utils/api.js) (API client), [`scholarship-backend/server.js`](https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/scholarship-backend/server.js) (HTTP server), [`src/components/EligibilityEngine/EligibilityEngine.js`](https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/src/components/EligibilityEngine/EligibilityEngine.js) (Eligibility experience)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Student guidance"]
  node_app["Route application<br/>[App.js]"]
  node_authui["Sign-in and roles<br/>[AuthContext.js]"]
  node_dashboard["Student guidance<br/>[Dashboard.js]"]
  node_eligibilityui["Eligibility experience"]
  node_nspui["NSP readiness<br/>[NSPReadiness.js]"]
  node_applicationui["Student applications"]
  node_documents["Document submission<br/>[DocumentUpload.js]"]
  node_studentstatus["Status and deficiencies"]
  node_chat["Scholarship assistance<br/>[ScholarshipChat.js]"]
end

subgraph group_review["Application review"]
  node_collegeui["College review"]
  node_ministryui["Ministry oversight"]
end

subgraph group_backend["Platform services"]
  node_api["API client<br/>[api.js]"]
  node_server["HTTP server<br/>[server.js]"]
  node_authroutes["Authentication routes<br/>[authRoutes.js]"]
  node_studentroutes["Student routes<br/>[studentRoutes.js]"]
  node_collegeroutes["College routes<br/>[collegeRoutes.js]"]
  node_ministryroutes["Ministry routes<br/>[ministryRoutes.js]"]
  node_models[("Domain records")]
  node_authmw["Access control<br/>[auth.js]"]
  node_audit["Audit logging<br/>[audit.js]"]
end

subgraph group_domain["Eligibility and documents"]
  node_search["Scholarship search<br/>[searchEngine.js]"]
  node_profile["Profile normalization<br/>[profileAdapter.js]"]
  node_eligibility["Eligibility rules"]
  node_schemes["Scheme knowledge<br/>[scholarships.js]"]
  node_readiness["Readiness rules"]
  node_parsing["Document parsing<br/>[fieldParsers.js]"]
  node_verify["Document verification"]
end

node_student(("Student"))

node_student -->|"uses"| node_app
node_app -->|"provides auth"| node_authui
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_eligibilityui
node_app -->|"routes to"| node_nspui
node_app -->|"routes to"| node_applicationui
node_app -->|"routes to"| node_studentstatus
node_authui -->|"requests session"| node_api
node_eligibilityui -->|"builds profile"| node_profile
node_eligibilityui -->|"evaluates schemes"| node_eligibility
node_eligibilityui -->|"uses scheme data"| node_schemes
node_nspui -->|"calculates readiness"| node_readiness
node_readiness -->|"uses eligibility"| node_eligibility
node_search -->|"normalizes input"| node_profile
node_search -->|"checks eligibility"| node_eligibility
node_search -->|"searches schemes"| node_schemes
node_documents -.->|"extracts fields"| node_parsing
node_documents -->|"checks consistency"| node_verify
node_verify -->|"normalizes values"| node_profile
node_applicationui -.->|"submits requests"| node_api
node_documents -->|"uploads documents"| node_api
node_studentstatus -->|"loads deficiencies"| node_api
node_dashboard -->|"loads guidance"| node_api
node_collegeui -->|"loads reviews"| node_api
node_ministryui -->|"loads oversight"| node_api
node_chat -.->|"finds schemes"| node_search
node_api -->|"HTTP requests"| node_server
node_server -->|"mounts routes"| node_authroutes
node_server -->|"mounts routes"| node_studentroutes
node_server -->|"mounts routes"| node_collegeroutes
node_server -->|"mounts routes"| node_ministryroutes
node_authroutes -->|"reads and writes"| node_models
node_studentroutes -->|"reads and writes"| node_models
node_collegeroutes -->|"reads and writes"| node_models
node_ministryroutes -->|"reads and writes"| node_models
node_authroutes -->|"authenticates requests"| node_authmw
node_collegeroutes -->|"checks access"| node_authmw
node_ministryroutes -->|"checks access"| node_authmw
node_collegeroutes -->|"records actions"| node_audit
node_ministryroutes -->|"records actions"| node_audit

click node_app "https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/src/App.js"
click node_authui "https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/src/context/AuthContext.js"
click node_dashboard "https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/src/components/Dashboard/Dashboard.js"
click node_eligibilityui "https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/src/components/EligibilityEngine/EligibilityEngine.js"
click node_nspui "https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/src/components/NSPReadiness/NSPReadiness.js"
click node_applicationui "https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/src/components/Student/StudentApplication.js"
click node_documents "https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/src/components/DocumentUpload/DocumentUpload.js"
click node_studentstatus "https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/src/components/Student/DeficiencyManager.js"
click node_collegeui "https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/src/components/College/CollegeDashboard.js"
click node_ministryui "https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/src/components/Ministry/MinistryDashboard.js"
click node_chat "https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/src/components/ScholarshipChat/ScholarshipChat.js"
click node_search "https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/src/engine/searchEngine.js"
click node_profile "https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/src/adapters/profileAdapter.js"
click node_eligibility "https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/src/engine/eligibilityEngine.js"
click node_schemes "https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/src/knowledge/scholarships.js"
click node_readiness "https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/src/engine/nspReadinessEngine.js"
click node_parsing "https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/src/utils/fieldParsers.js"
click node_verify "https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/src/utils/verificationEngine.js"
click node_api "https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/src/utils/api.js"
click node_server "https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/scholarship-backend/server.js"
click node_authroutes "https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/scholarship-backend/routes/authRoutes.js"
click node_studentroutes "https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/scholarship-backend/routes/studentRoutes.js"
click node_collegeroutes "https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/scholarship-backend/routes/collegeRoutes.js"
click node_ministryroutes "https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/scholarship-backend/routes/ministryRoutes.js"
click node_models "https://github.com/nithishkumarkumar16-jpg/sih-sgp/tree/main/scholarship-backend/models"
click node_authmw "https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/scholarship-backend/middleware/auth.js"
click node_audit "https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/scholarship-backend/middleware/audit.js"

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_authui,node_dashboard,node_eligibilityui,node_nspui,node_applicationui,node_documents,node_studentstatus,node_chat toneBlue
class node_collegeui,node_ministryui toneAmber
class node_api,node_server,node_authroutes,node_studentroutes,node_collegeroutes,node_ministryroutes,node_models,node_authmw,node_audit toneMint
class node_search,node_profile,node_eligibility,node_schemes,node_readiness,node_parsing,node_verify toneRose
class node_student toneIndigo
```

## Components

### Student guidance

- [Route application](https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/src/App.js): `src/App.js`
- [Sign-in and roles](https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/src/context/AuthContext.js): `src/context/AuthContext.js`
- [Student guidance](https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/src/components/Dashboard/Dashboard.js): `src/components/Dashboard/Dashboard.js`
- [Eligibility experience](https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/src/components/EligibilityEngine/EligibilityEngine.js): `src/components/EligibilityEngine/EligibilityEngine.js`
- [NSP readiness](https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/src/components/NSPReadiness/NSPReadiness.js): `src/components/NSPReadiness/NSPReadiness.js`
- [Student applications](https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/src/components/Student/StudentApplication.js): `src/components/Student/StudentApplication.js`
- [Document submission](https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/src/components/DocumentUpload/DocumentUpload.js): `src/components/DocumentUpload/DocumentUpload.js`
- [Status and deficiencies](https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/src/components/Student/DeficiencyManager.js): `src/components/Student/DeficiencyManager.js`
- [Scholarship assistance](https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/src/components/ScholarshipChat/ScholarshipChat.js): `src/components/ScholarshipChat/ScholarshipChat.js`

### Application review

- [College review](https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/src/components/College/CollegeDashboard.js): `src/components/College/CollegeDashboard.js`
- [Ministry oversight](https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/src/components/Ministry/MinistryDashboard.js): `src/components/Ministry/MinistryDashboard.js`

### Platform services

- [API client](https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/src/utils/api.js): `src/utils/api.js`
- [HTTP server](https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/scholarship-backend/server.js): `scholarship-backend/server.js`
- [Authentication routes](https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/scholarship-backend/routes/authRoutes.js): `scholarship-backend/routes/authRoutes.js`
- [Student routes](https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/scholarship-backend/routes/studentRoutes.js): `scholarship-backend/routes/studentRoutes.js`
- [College routes](https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/scholarship-backend/routes/collegeRoutes.js): `scholarship-backend/routes/collegeRoutes.js`
- [Ministry routes](https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/scholarship-backend/routes/ministryRoutes.js): `scholarship-backend/routes/ministryRoutes.js`
- [Domain records](https://github.com/nithishkumarkumar16-jpg/sih-sgp/tree/main/scholarship-backend/models): `scholarship-backend/models`
- [Access control](https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/scholarship-backend/middleware/auth.js): `scholarship-backend/middleware/auth.js`
- [Audit logging](https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/scholarship-backend/middleware/audit.js): `scholarship-backend/middleware/audit.js`

### Eligibility and documents

- [Scholarship search](https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/src/engine/searchEngine.js): `src/engine/searchEngine.js`
- [Profile normalization](https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/src/adapters/profileAdapter.js): `src/adapters/profileAdapter.js`
- [Eligibility rules](https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/src/engine/eligibilityEngine.js): `src/engine/eligibilityEngine.js`
- [Scheme knowledge](https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/src/knowledge/scholarships.js): `src/knowledge/scholarships.js`
- [Readiness rules](https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/src/engine/nspReadinessEngine.js): `src/engine/nspReadinessEngine.js`
- [Document parsing](https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/src/utils/fieldParsers.js): `src/utils/fieldParsers.js`
- [Document verification](https://github.com/nithishkumarkumar16-jpg/sih-sgp/blob/main/src/utils/verificationEngine.js): `src/utils/verificationEngine.js`

### Other components

- **Student**

## Connections

- Student → Route application: uses (evidence: `src/App.js`)
- Route application → Sign-in and roles: provides auth (evidence: `src/App.js`)
- Route application → Student guidance: routes to (evidence: `src/App.js`)
- Route application → Eligibility experience: routes to (evidence: `src/App.js`)
- Route application → NSP readiness: routes to (evidence: `src/App.js`)
- Route application → Student applications: routes to (evidence: `src/App.js`)
- Route application → Status and deficiencies: routes to (evidence: `src/App.js`)
- Sign-in and roles → API client: requests session (evidence: `src/context/AuthContext.js`)
- Eligibility experience → Profile normalization: builds profile (evidence: `src/components/EligibilityEngine/EligibilityEngine.js`)
- Eligibility experience → Eligibility rules: evaluates schemes (evidence: `src/components/EligibilityEngine/EligibilityEngine.js`)
- Eligibility experience → Scheme knowledge: uses scheme data (evidence: `src/components/EligibilityEngine/EligibilityEngine.js`)
- NSP readiness → Readiness rules: calculates readiness (evidence: `src/components/NSPReadiness/NSPReadiness.js`)
- Readiness rules → Eligibility rules: uses eligibility (evidence: `src/engine/nspReadinessEngine.js`)
- Scholarship search → Profile normalization: normalizes input (evidence: `src/engine/searchEngine.js`)
- Scholarship search → Eligibility rules: checks eligibility (evidence: `src/engine/searchEngine.js`)
- Scholarship search → Scheme knowledge: searches schemes (evidence: `src/engine/searchEngine.js`)
- Document submission → Document parsing: extracts fields (evidence: `src/utils/fieldParsers.js`)
- Document submission → Document verification: checks consistency (evidence: `src/components/DocumentUpload/DocumentUpload.js`)
- Document verification → Profile normalization: normalizes values (evidence: `src/utils/verificationEngine.js`)
- Student applications → API client: submits requests
- Document submission → API client: uploads documents (evidence: `src/components/DocumentUpload/DocumentUpload.js`)
- Status and deficiencies → API client: loads deficiencies (evidence: `src/components/Student/DeficiencyManager.js`)
- Student guidance → API client: loads guidance (evidence: `src/components/Dashboard/Dashboard.js`)
- College review → API client: loads reviews (evidence: `src/components/College/CollegeDashboard.js`)
- Ministry oversight → API client: loads oversight (evidence: `src/components/Ministry/MinistryDashboard.js`)
- Scholarship assistance → Scholarship search: finds schemes
- API client → HTTP server: HTTP requests (evidence: `src/utils/api.js`)
- HTTP server → Authentication routes: mounts routes (evidence: `scholarship-backend/server.js`)
- HTTP server → Student routes: mounts routes (evidence: `scholarship-backend/server.js`)
- HTTP server → College routes: mounts routes (evidence: `scholarship-backend/server.js`)
- HTTP server → Ministry routes: mounts routes (evidence: `scholarship-backend/server.js`)
- Authentication routes → Domain records: reads and writes (evidence: `scholarship-backend/routes/authRoutes.js`)
- Student routes → Domain records: reads and writes (evidence: `scholarship-backend/routes/studentRoutes.js`)
- College routes → Domain records: reads and writes (evidence: `scholarship-backend/routes/collegeRoutes.js`)
- Ministry routes → Domain records: reads and writes (evidence: `scholarship-backend/routes/ministryRoutes.js`)
- Authentication routes → Access control: authenticates requests (evidence: `scholarship-backend/routes/authRoutes.js`)
- College routes → Access control: checks access (evidence: `scholarship-backend/routes/collegeRoutes.js`)
- Ministry routes → Access control: checks access (evidence: `scholarship-backend/routes/ministryRoutes.js`)
- College routes → Audit logging: records actions (evidence: `scholarship-backend/routes/collegeRoutes.js`)
- Ministry routes → Audit logging: records actions (evidence: `scholarship-backend/routes/ministryRoutes.js`)
