# akashmushigeri/skillsetu architecture

> Architecture diagram of the GitHub repository akashmushigeri/skillsetu, 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/akashmushigeri/skillsetu
- Repository: https://github.com/akashmushigeri/skillsetu

## Overview

SkillSetu is a three-sided career bridge: students build skills and find opportunities, employers discover and hire talent, and colleges track readiness and coordinate partnerships. The central workflow runs from authentication/onboarding through portal-specific skill, opportunity, and placement activity, with records exchanged across portals. The README documents broader hiring, interview, challenge, MoU, and offer capabilities; those are represented at subsystem level where page paths exist. Source excerpts show key context, service, and synchronization links; unsampled features are not given speculative internal call paths.

Main entry points: [`src/context/StudentContext.tsx`](https://github.com/akashmushigeri/skillsetu/blob/main/src/context/StudentContext.tsx) (Student state), [`src/context/IndustryContext.tsx`](https://github.com/akashmushigeri/skillsetu/blob/main/src/context/IndustryContext.tsx) (Industry hiring state), [`src/lib/syncConverters.ts`](https://github.com/akashmushigeri/skillsetu/blob/main/src/lib/syncConverters.ts) (Cross-portal converters), [`src/app/industry/dashboard/page.tsx`](https://github.com/akashmushigeri/skillsetu/blob/main/src/app/industry/dashboard/page.tsx) (Industry portal)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity &amp; entry"]
  node_onboard["Onboarding<br/>[page.tsx]"]
  node_authui["Portal login"]
  node_auth["Authentication state<br/>[AuthContext.tsx]"]
end

subgraph group_student["Student experience"]
  node_studentportal["Student portal<br/>[page.tsx]"]
  node_studentstate["Student state<br/>[StudentContext.tsx]"]
  node_studentrecords["Student skills &amp; profile data<br/>[mockStudentData.ts]"]
  node_assessments["Skill assessments"]
  node_studentopps["Opportunity discovery &amp; applications<br/>[page.tsx]"]
  node_aiinterviewui["AI interview experience<br/>[page.tsx]"]
end

subgraph group_industry["Industry hiring"]
  node_industryportal["Industry portal<br/>[page.tsx]"]
  node_industrystate["Industry hiring state"]
  node_candidates["Candidate registry"]
  node_matching["Skill match engine"]
  node_jobs["Jobs &amp; internships<br/>[industryJobs.ts]"]
  node_hiring["Pipeline, interviews &amp; offers<br/>[page.tsx]"]
  node_challenges["Challenges &amp; submissions"]
  node_partnerships["Industry-college partnerships"]
end

subgraph group_college["College operations"]
  node_collegeportal["College portal<br/>[page.tsx]"]
  node_collegestate["College readiness state<br/>[CollegeContext.tsx]"]
  node_collegedata["Students &amp; readiness data<br/>[collegeData.ts]"]
end

subgraph group_platform["Shared services"]
  node_aiapi["AI interview endpoint<br/>[route.ts]"]
  node_aiinterview["Interview service"]
  node_sync["Cross-portal converters<br/>[syncConverters.ts]"]
  node_bridge["Sync bridge<br/>[syncBridge.ts]"]
  node_firebase[("Firebase services<br/>[firebase.ts]")]
  node_dataconnect["Data Connect service"]
  node_location["Location suggestions<br/>[route.ts]"]
end

node_person(("User"))
node_gemini["Gemini API"]
node_nominatim["Nominatim geocoder"]

node_person -->|"signs in"| node_authui
node_person -->|"sets up profile"| node_onboard
node_onboard -->|"completes onboarding"| node_auth
node_authui -->|"authenticates"| node_auth
node_onboard -->|"requests suggestions"| node_location
node_location -->|"queries"| node_nominatim
node_auth -->|"loads profile"| node_firebase
node_studentportal -->|"renders portal state"| node_studentstate
node_studentstate -->|"uses demo records"| node_studentrecords
node_studentrecords -->|"includes assessment data"| node_assessments
node_studentstate -->|"reads industry updates"| node_sync
node_studentstate -->|"loads remote opportunities"| node_dataconnect
node_studentstate -->|"persists profile"| node_firebase
node_studentopps -.->|"uses opportunity state"| node_studentstate
node_studentportal -.->|"offers interview practice"| node_aiinterviewui
node_aiinterviewui -.->|"submits interview turns"| node_aiapi
node_aiapi -->|"processes request"| node_aiinterview
node_aiinterview -->|"requests generation"| node_gemini
node_industryportal -.->|"renders hiring state"| node_industrystate
node_industrystate -->|"loads candidate records"| node_candidates
node_industrystate -->|"calculates match breakdown"| node_matching
node_industrystate -->|"loads remote jobs"| node_jobs
node_industryportal -.->|"supports pipeline and offers"| node_hiring
node_industryportal -.->|"supports challenge review"| node_challenges
node_industryportal -.->|"supports college partnerships"| node_partnerships
node_industrystate -->|"loads remote listings"| node_dataconnect
node_industrystate -->|"saves company profile"| node_firebase
node_collegeportal -->|"renders readiness dashboard"| node_collegestate
node_collegestate -->|"uses institutional data"| node_collegedata
node_collegestate -->|"reads and publishes records"| node_sync
node_sync -->|"converts and transfers records"| node_bridge
node_studentstate -.->|"publishes student activity"| node_sync
node_sync -.->|"shares applications and listings"| node_industrystate
node_sync -.->|"shares placements and internships"| node_collegestate
node_dataconnect -->|"uses Firebase Data Connect"| node_firebase

click node_onboard "https://github.com/akashmushigeri/skillsetu/blob/main/src/app/onboarding/page.tsx"
click node_authui "https://github.com/akashmushigeri/skillsetu/blob/main/src/components/auth/UnifiedLoginPage.tsx"
click node_auth "https://github.com/akashmushigeri/skillsetu/blob/main/src/context/AuthContext.tsx"
click node_studentportal "https://github.com/akashmushigeri/skillsetu/blob/main/src/app/student/page.tsx"
click node_studentstate "https://github.com/akashmushigeri/skillsetu/blob/main/src/context/StudentContext.tsx"
click node_studentrecords "https://github.com/akashmushigeri/skillsetu/blob/main/src/data/mockStudentData.ts"
click node_assessments "https://github.com/akashmushigeri/skillsetu/blob/main/src/data/skillAssessments.ts"
click node_studentopps "https://github.com/akashmushigeri/skillsetu/blob/main/src/app/student/opportunities/page.tsx"
click node_aiinterviewui "https://github.com/akashmushigeri/skillsetu/blob/main/src/app/student/ai-interview/page.tsx"
click node_aiapi "https://github.com/akashmushigeri/skillsetu/blob/main/src/app/api/ai-interview/route.ts"
click node_aiinterview "https://github.com/akashmushigeri/skillsetu/blob/main/src/server/ai/interviewService.ts"
click node_industryportal "https://github.com/akashmushigeri/skillsetu/blob/main/src/app/industry/dashboard/page.tsx"
click node_industrystate "https://github.com/akashmushigeri/skillsetu/blob/main/src/context/IndustryContext.tsx"
click node_candidates "https://github.com/akashmushigeri/skillsetu/blob/main/src/data/industry/industryCandidates.ts"
click node_matching "https://github.com/akashmushigeri/skillsetu/blob/main/src/lib/industryMatching.ts"
click node_jobs "https://github.com/akashmushigeri/skillsetu/blob/main/src/data/industry/industryJobs.ts"
click node_hiring "https://github.com/akashmushigeri/skillsetu/blob/main/src/app/industry/offers/page.tsx"
click node_challenges "https://github.com/akashmushigeri/skillsetu/blob/main/src/data/industry/industryChallenges.ts"
click node_partnerships "https://github.com/akashmushigeri/skillsetu/blob/main/src/data/industry/industryColleges.ts"
click node_collegeportal "https://github.com/akashmushigeri/skillsetu/blob/main/src/app/college/dashboard/page.tsx"
click node_collegestate "https://github.com/akashmushigeri/skillsetu/blob/main/src/context/CollegeContext.tsx"
click node_collegedata "https://github.com/akashmushigeri/skillsetu/blob/main/src/data/collegeData.ts"
click node_sync "https://github.com/akashmushigeri/skillsetu/blob/main/src/lib/syncConverters.ts"
click node_bridge "https://github.com/akashmushigeri/skillsetu/blob/main/src/lib/syncBridge.ts"
click node_firebase "https://github.com/akashmushigeri/skillsetu/blob/main/src/lib/firebase.ts"
click node_dataconnect "https://github.com/akashmushigeri/skillsetu/blob/main/src/lib/dataConnectService.ts"
click node_location "https://github.com/akashmushigeri/skillsetu/blob/main/src/app/api/locations/autocomplete/route.ts"

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_onboard,node_authui,node_auth,node_person toneBlue
class node_studentportal,node_studentstate,node_studentrecords,node_assessments,node_studentopps,node_aiinterviewui toneAmber
class node_industryportal,node_industrystate,node_candidates,node_matching,node_jobs,node_hiring,node_challenges,node_partnerships,node_gemini toneMint
class node_collegeportal,node_collegestate,node_collegedata toneRose
class node_aiapi,node_aiinterview,node_sync,node_bridge,node_firebase,node_dataconnect,node_location,node_nominatim toneIndigo
```

## Components

### Identity & entry

- [Onboarding](https://github.com/akashmushigeri/skillsetu/blob/main/src/app/onboarding/page.tsx): `src/app/onboarding/page.tsx`
- [Portal login](https://github.com/akashmushigeri/skillsetu/blob/main/src/components/auth/UnifiedLoginPage.tsx): `src/components/auth/UnifiedLoginPage.tsx`
- [Authentication state](https://github.com/akashmushigeri/skillsetu/blob/main/src/context/AuthContext.tsx): `src/context/AuthContext.tsx`

### Student experience

- [Student portal](https://github.com/akashmushigeri/skillsetu/blob/main/src/app/student/page.tsx): `src/app/student/page.tsx`
- [Student state](https://github.com/akashmushigeri/skillsetu/blob/main/src/context/StudentContext.tsx): `src/context/StudentContext.tsx`
- [Student skills & profile data](https://github.com/akashmushigeri/skillsetu/blob/main/src/data/mockStudentData.ts): `src/data/mockStudentData.ts`
- [Skill assessments](https://github.com/akashmushigeri/skillsetu/blob/main/src/data/skillAssessments.ts): `src/data/skillAssessments.ts`
- [Opportunity discovery & applications](https://github.com/akashmushigeri/skillsetu/blob/main/src/app/student/opportunities/page.tsx): `src/app/student/opportunities/page.tsx`
- [AI interview experience](https://github.com/akashmushigeri/skillsetu/blob/main/src/app/student/ai-interview/page.tsx): `src/app/student/ai-interview/page.tsx`

### Industry hiring

- [Industry portal](https://github.com/akashmushigeri/skillsetu/blob/main/src/app/industry/dashboard/page.tsx): `src/app/industry/dashboard/page.tsx`
- [Industry hiring state](https://github.com/akashmushigeri/skillsetu/blob/main/src/context/IndustryContext.tsx): `src/context/IndustryContext.tsx`
- [Candidate registry](https://github.com/akashmushigeri/skillsetu/blob/main/src/data/industry/industryCandidates.ts): `src/data/industry/industryCandidates.ts`
- [Skill match engine](https://github.com/akashmushigeri/skillsetu/blob/main/src/lib/industryMatching.ts): `src/lib/industryMatching.ts`
- [Jobs & internships](https://github.com/akashmushigeri/skillsetu/blob/main/src/data/industry/industryJobs.ts): `src/data/industry/industryJobs.ts`
- [Pipeline, interviews & offers](https://github.com/akashmushigeri/skillsetu/blob/main/src/app/industry/offers/page.tsx): `src/app/industry/offers/page.tsx`
- [Challenges & submissions](https://github.com/akashmushigeri/skillsetu/blob/main/src/data/industry/industryChallenges.ts): `src/data/industry/industryChallenges.ts`
- [Industry-college partnerships](https://github.com/akashmushigeri/skillsetu/blob/main/src/data/industry/industryColleges.ts): `src/data/industry/industryColleges.ts`

### College operations

- [College portal](https://github.com/akashmushigeri/skillsetu/blob/main/src/app/college/dashboard/page.tsx): `src/app/college/dashboard/page.tsx`
- [College readiness state](https://github.com/akashmushigeri/skillsetu/blob/main/src/context/CollegeContext.tsx): `src/context/CollegeContext.tsx`
- [Students & readiness data](https://github.com/akashmushigeri/skillsetu/blob/main/src/data/collegeData.ts): `src/data/collegeData.ts`

### Shared services

- [AI interview endpoint](https://github.com/akashmushigeri/skillsetu/blob/main/src/app/api/ai-interview/route.ts): `src/app/api/ai-interview/route.ts`
- [Interview service](https://github.com/akashmushigeri/skillsetu/blob/main/src/server/ai/interviewService.ts): `src/server/ai/interviewService.ts`
- [Cross-portal converters](https://github.com/akashmushigeri/skillsetu/blob/main/src/lib/syncConverters.ts): `src/lib/syncConverters.ts`
- [Sync bridge](https://github.com/akashmushigeri/skillsetu/blob/main/src/lib/syncBridge.ts): `src/lib/syncBridge.ts`
- [Firebase services](https://github.com/akashmushigeri/skillsetu/blob/main/src/lib/firebase.ts): `src/lib/firebase.ts`
- [Data Connect service](https://github.com/akashmushigeri/skillsetu/blob/main/src/lib/dataConnectService.ts): `src/lib/dataConnectService.ts`
- [Location suggestions](https://github.com/akashmushigeri/skillsetu/blob/main/src/app/api/locations/autocomplete/route.ts): `src/app/api/locations/autocomplete/route.ts`

### Other components

- **User**
- **Gemini API**
- **Nominatim geocoder**

## Connections

- User → Portal login: signs in
- User → Onboarding: sets up profile (evidence: `src/app/onboarding/page.tsx`)
- Onboarding → Authentication state: completes onboarding (evidence: `src/app/onboarding/page.tsx`)
- Portal login → Authentication state: authenticates (evidence: `src/context/AuthContext.tsx`)
- Onboarding → Location suggestions: requests suggestions (evidence: `src/app/onboarding/page.tsx`)
- Location suggestions → Nominatim geocoder: queries (evidence: `src/app/api/locations/autocomplete/route.ts`)
- Authentication state → Firebase services: loads profile (evidence: `src/context/AuthContext.tsx`)
- Student portal → Student state: renders portal state (evidence: `src/app/student/page.tsx`)
- Student state → Student skills & profile data: uses demo records (evidence: `src/context/StudentContext.tsx`)
- Student skills & profile data → Skill assessments: includes assessment data (evidence: `src/data/mockStudentData.ts`)
- Student state → Cross-portal converters: reads industry updates (evidence: `src/context/StudentContext.tsx`)
- Student state → Data Connect service: loads remote opportunities (evidence: `src/context/StudentContext.tsx`)
- Student state → Firebase services: persists profile (evidence: `src/context/StudentContext.tsx`)
- Opportunity discovery & applications → Student state: uses opportunity state
- Student portal → AI interview experience: offers interview practice
- AI interview experience → AI interview endpoint: submits interview turns
- AI interview endpoint → Interview service: processes request (evidence: `src/app/api/ai-interview/route.ts`)
- Interview service → Gemini API: requests generation (evidence: `src/server/ai/interviewService.ts`)
- Industry portal → Industry hiring state: renders hiring state
- Industry hiring state → Candidate registry: loads candidate records (evidence: `src/context/IndustryContext.tsx`)
- Industry hiring state → Skill match engine: calculates match breakdown (evidence: `src/context/IndustryContext.tsx`)
- Industry hiring state → Jobs & internships: loads remote jobs (evidence: `src/context/IndustryContext.tsx`)
- Industry portal → Pipeline, interviews & offers: supports pipeline and offers
- Industry portal → Challenges & submissions: supports challenge review
- Industry portal → Industry-college partnerships: supports college partnerships
- Industry hiring state → Data Connect service: loads remote listings (evidence: `src/context/IndustryContext.tsx`)
- Industry hiring state → Firebase services: saves company profile (evidence: `src/context/IndustryContext.tsx`)
- College portal → College readiness state: renders readiness dashboard (evidence: `src/app/college/dashboard/page.tsx`)
- College readiness state → Students & readiness data: uses institutional data (evidence: `src/app/college/dashboard/page.tsx`)
- College readiness state → Cross-portal converters: reads and publishes records (evidence: `src/context/CollegeContext.tsx`)
- Cross-portal converters → Sync bridge: converts and transfers records (evidence: `src/lib/syncConverters.ts`)
- Student state → Cross-portal converters: publishes student activity (evidence: `src/context/StudentContext.tsx`)
- Cross-portal converters → Industry hiring state: shares applications and listings (evidence: `src/context/IndustryContext.tsx`)
- Cross-portal converters → College readiness state: shares placements and internships (evidence: `src/context/CollegeContext.tsx`)
- Data Connect service → Firebase services: uses Firebase Data Connect (evidence: `src/lib/dataConnectService.ts`)
