# sayan1776/campus-career-copilot architecture

> Architecture diagram of the GitHub repository sayan1776/campus-career-copilot, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sayan1776/campus-career-copilot
- Repository: https://github.com/sayan1776/campus-career-copilot

## Overview

Campus Career Copilot connects students and placement officers through resume-based readiness assessment, skill-gap learning, peer benchmarking, and cohort interventions. The main student path is PDF upload → Gemini evaluation and saved readiness data → dashboard/radar → generated four-stage journey. Separate branches cover LaTeX resume generation, campus peer discovery, TPO analytics and push alerts, authentication, and campus mapping. Paths and relationships reflect the supplied tree, excerpts, and README; unsampled route details are represented only where documented.

Main entry points: [`app/api/resume/analyze/route.ts`](https://github.com/sayan1776/campus-career-copilot/blob/main/app/api/resume/analyze/route.ts) (Resume Analysis API), [`app/api/auth/session/route.ts`](https://github.com/sayan1776/campus-career-copilot/blob/main/app/api/auth/session/route.ts) (Session & Role APIs), [`app/(dashboard)/student/upload/page.tsx`](https://github.com/sayan1776/campus-career-copilot/blob/main/app/(dashboard)/student/upload/page.tsx) (Resume Upload), [`app/(dashboard)/student/journeys/SkillJourneyClient.tsx`](https://github.com/sayan1776/campus-career-copilot/blob/main/app/(dashboard)/student/journeys/SkillJourneyClient.tsx) (Journey Experience)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity &amp; Profiles"]
  node_login["Login &amp; Signup<br/>[page.tsx]"]
  node_firebaseauth["Firebase Auth<br/>[client.ts]"]
  node_authapi["Session &amp; Role APIs<br/>[route.ts]"]
  node_adminauth["Firebase Admin<br/>[admin.ts]"]
  node_rolecookie["Role Cookie<br/>[role-cookie.ts]"]
end

subgraph group_student["Student Readiness"]
  node_upload["Resume Upload<br/>[page.tsx]"]
  node_analysisapi["Resume Analysis API<br/>[route.ts]"]
  node_dashboard["Student Dashboard<br/>[page.tsx]"]
  node_radar["Competency Radar"]
  node_latex["LaTeX Resume Builder<br/>[ResumeBuilder.tsx]"]
end

subgraph group_learning["Skill Development"]
  node_journeyapi["Journey Generation API<br/>[route.ts]"]
  node_journeyai["Journey Generator<br/>[client.ts]"]
  node_journeyclient["Journey Experience"]
  node_journeystages["Concept, Course, Challenge, Quiz<br/>[JourneyDetail.tsx]"]
end

subgraph group_institution["Campus Intelligence"]
  node_peers["Peer Progress Hub"]
  node_peerdata["Peer Detail &amp; Directory<br/>[page.tsx]"]
  node_tpo["Cohort Diagnostics<br/>[page.tsx]"]
  node_notifyapi["Targeted Push API<br/>[route.ts]"]
  node_campusmap["Campus &amp; Drive Map<br/>[CampusMap.tsx]"]
end

subgraph group_platform["Shared Services"]
  node_gemini{{"Gemini AI"}}
  node_readiness[("Readiness Store<br/>[server.ts]")]
  node_push["Firebase Push<br/>[send-push.ts]"]
  node_departments["Department &amp; Role Catalog<br/>[departments.ts]"]
end

node_student(("Student / TPO"))

node_student -->|"signs in"| node_login
node_login -->|"authenticates with"| node_firebaseauth
node_firebaseauth -->|"sends ID token"| node_authapi
node_authapi -->|"mints session"| node_adminauth
node_authapi -->|"sets role cookie"| node_rolecookie
node_student -->|"uploads PDF"| node_upload
node_upload -->|"submits resume"| node_analysisapi
node_analysisapi -->|"evaluates resume"| node_gemini
node_analysisapi -->|"saves score and gaps"| node_readiness
node_analysisapi -->|"uses branch context"| node_departments
node_dashboard -->|"reads readiness data"| node_readiness
node_dashboard -->|"renders competency chart"| node_radar
node_student -->|"builds resume"| node_latex
node_latex -->|"generates LaTeX"| node_gemini
node_student -->|"opens learning journeys"| node_journeyclient
node_journeyclient -->|"requests journeys"| node_journeyapi
node_journeyapi -->|"requests generation"| node_journeyai
node_journeyai -->|"generates stages"| node_gemini
node_journeyclient -->|"renders learning stages"| node_journeystages
node_student -->|"browses peers"| node_peers
node_peers -->|"opens peer details"| node_peerdata
node_student -->|"reviews cohort readiness"| node_tpo
node_tpo -->|"targets workshop alert"| node_notifyapi
node_notifyapi -->|"dispatches notification"| node_push
node_push -->|"sends push alert"| node_student
node_student -->|"views campus drives"| node_campusmap
node_upload -->|"selects department"| node_departments

click node_login "https://github.com/sayan1776/campus-career-copilot/blob/main/app/(public)/login/page.tsx"
click node_firebaseauth "https://github.com/sayan1776/campus-career-copilot/blob/main/lib/firebase/client.ts"
click node_authapi "https://github.com/sayan1776/campus-career-copilot/blob/main/app/api/auth/session/route.ts"
click node_adminauth "https://github.com/sayan1776/campus-career-copilot/blob/main/lib/firebase/admin.ts"
click node_rolecookie "https://github.com/sayan1776/campus-career-copilot/blob/main/lib/auth/role-cookie.ts"
click node_upload "https://github.com/sayan1776/campus-career-copilot/blob/main/app/(dashboard)/student/upload/page.tsx"
click node_analysisapi "https://github.com/sayan1776/campus-career-copilot/blob/main/app/api/resume/analyze/route.ts"
click node_readiness "https://github.com/sayan1776/campus-career-copilot/blob/main/lib/supabase/server.ts"
click node_dashboard "https://github.com/sayan1776/campus-career-copilot/blob/main/app/(dashboard)/student/dashboard/page.tsx"
click node_radar "https://github.com/sayan1776/campus-career-copilot/blob/main/app/(dashboard)/student/dashboard/SkillRadarChart.tsx"
click node_latex "https://github.com/sayan1776/campus-career-copilot/blob/main/components/ResumeBuilder.tsx"
click node_journeyapi "https://github.com/sayan1776/campus-career-copilot/blob/main/app/api/student/journeys/route.ts"
click node_journeyai "https://github.com/sayan1776/campus-career-copilot/blob/main/lib/ai/client.ts"
click node_journeyclient "https://github.com/sayan1776/campus-career-copilot/blob/main/app/(dashboard)/student/journeys/SkillJourneyClient.tsx"
click node_journeystages "https://github.com/sayan1776/campus-career-copilot/blob/main/app/(dashboard)/student/journeys/JourneyDetail.tsx"
click node_peers "https://github.com/sayan1776/campus-career-copilot/blob/main/app/(dashboard)/campus/peers/PeerProgressClient.tsx"
click node_peerdata "https://github.com/sayan1776/campus-career-copilot/blob/main/app/(dashboard)/campus/peers/page.tsx"
click node_tpo "https://github.com/sayan1776/campus-career-copilot/blob/main/app/(dashboard)/tpo/dashboard/page.tsx"
click node_notifyapi "https://github.com/sayan1776/campus-career-copilot/blob/main/app/api/tpo/notify/route.ts"
click node_push "https://github.com/sayan1776/campus-career-copilot/blob/main/lib/firebase/send-push.ts"
click node_campusmap "https://github.com/sayan1776/campus-career-copilot/blob/main/app/(public)/about/CampusMap.tsx"
click node_departments "https://github.com/sayan1776/campus-career-copilot/blob/main/lib/departments.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_login,node_firebaseauth,node_authapi,node_adminauth,node_rolecookie toneBlue
class node_upload,node_analysisapi,node_dashboard,node_radar,node_latex toneAmber
class node_journeyapi,node_journeyai,node_journeyclient,node_journeystages toneMint
class node_peers,node_peerdata,node_tpo,node_notifyapi,node_campusmap toneRose
class node_gemini,node_readiness,node_push,node_departments,node_student toneIndigo
```

## Components

### Identity & Profiles

- [Login & Signup](https://github.com/sayan1776/campus-career-copilot/blob/main/app/(public)/login/page.tsx): `app/(public)/login/page.tsx`
- [Firebase Auth](https://github.com/sayan1776/campus-career-copilot/blob/main/lib/firebase/client.ts): `lib/firebase/client.ts`
- [Session & Role APIs](https://github.com/sayan1776/campus-career-copilot/blob/main/app/api/auth/session/route.ts): `app/api/auth/session/route.ts`
- [Firebase Admin](https://github.com/sayan1776/campus-career-copilot/blob/main/lib/firebase/admin.ts): `lib/firebase/admin.ts`
- [Role Cookie](https://github.com/sayan1776/campus-career-copilot/blob/main/lib/auth/role-cookie.ts): `lib/auth/role-cookie.ts`

### Student Readiness

- [Resume Upload](https://github.com/sayan1776/campus-career-copilot/blob/main/app/(dashboard)/student/upload/page.tsx): `app/(dashboard)/student/upload/page.tsx`
- [Resume Analysis API](https://github.com/sayan1776/campus-career-copilot/blob/main/app/api/resume/analyze/route.ts): `app/api/resume/analyze/route.ts`
- [Student Dashboard](https://github.com/sayan1776/campus-career-copilot/blob/main/app/(dashboard)/student/dashboard/page.tsx): `app/(dashboard)/student/dashboard/page.tsx`
- [Competency Radar](https://github.com/sayan1776/campus-career-copilot/blob/main/app/(dashboard)/student/dashboard/SkillRadarChart.tsx): `app/(dashboard)/student/dashboard/SkillRadarChart.tsx`
- [LaTeX Resume Builder](https://github.com/sayan1776/campus-career-copilot/blob/main/components/ResumeBuilder.tsx): `components/ResumeBuilder.tsx`

### Skill Development

- [Journey Generation API](https://github.com/sayan1776/campus-career-copilot/blob/main/app/api/student/journeys/route.ts): `app/api/student/journeys/route.ts`
- [Journey Generator](https://github.com/sayan1776/campus-career-copilot/blob/main/lib/ai/client.ts): `lib/ai/client.ts`
- [Journey Experience](https://github.com/sayan1776/campus-career-copilot/blob/main/app/(dashboard)/student/journeys/SkillJourneyClient.tsx): `app/(dashboard)/student/journeys/SkillJourneyClient.tsx`
- [Concept, Course, Challenge, Quiz](https://github.com/sayan1776/campus-career-copilot/blob/main/app/(dashboard)/student/journeys/JourneyDetail.tsx): `app/(dashboard)/student/journeys/JourneyDetail.tsx`

### Campus Intelligence

- [Peer Progress Hub](https://github.com/sayan1776/campus-career-copilot/blob/main/app/(dashboard)/campus/peers/PeerProgressClient.tsx): `app/(dashboard)/campus/peers/PeerProgressClient.tsx`
- [Peer Detail & Directory](https://github.com/sayan1776/campus-career-copilot/blob/main/app/(dashboard)/campus/peers/page.tsx): `app/(dashboard)/campus/peers/page.tsx`
- [Cohort Diagnostics](https://github.com/sayan1776/campus-career-copilot/blob/main/app/(dashboard)/tpo/dashboard/page.tsx): `app/(dashboard)/tpo/dashboard/page.tsx`
- [Targeted Push API](https://github.com/sayan1776/campus-career-copilot/blob/main/app/api/tpo/notify/route.ts): `app/api/tpo/notify/route.ts`
- [Campus & Drive Map](https://github.com/sayan1776/campus-career-copilot/blob/main/app/(public)/about/CampusMap.tsx): `app/(public)/about/CampusMap.tsx`

### Shared Services

- **Gemini AI**
- [Readiness Store](https://github.com/sayan1776/campus-career-copilot/blob/main/lib/supabase/server.ts): `lib/supabase/server.ts`
- [Firebase Push](https://github.com/sayan1776/campus-career-copilot/blob/main/lib/firebase/send-push.ts): `lib/firebase/send-push.ts`
- [Department & Role Catalog](https://github.com/sayan1776/campus-career-copilot/blob/main/lib/departments.ts): `lib/departments.ts`

### Other components

- **Student / TPO**

## Connections

- Student / TPO → Login & Signup: signs in
- Login & Signup → Firebase Auth: authenticates with (evidence: `app/(public)/login/page.tsx`)
- Firebase Auth → Session & Role APIs: sends ID token
- Session & Role APIs → Firebase Admin: mints session (evidence: `app/api/auth/session/route.ts`)
- Session & Role APIs → Role Cookie: sets role cookie (evidence: `app/api/auth/session/route.ts`)
- Student / TPO → Resume Upload: uploads PDF
- Resume Upload → Resume Analysis API: submits resume
- Resume Analysis API → Gemini AI: evaluates resume (evidence: `app/api/resume/analyze/route.ts`)
- Resume Analysis API → Readiness Store: saves score and gaps (evidence: `app/api/resume/analyze/route.ts`)
- Resume Analysis API → Department & Role Catalog: uses branch context (evidence: `app/api/resume/analyze/route.ts`)
- Student Dashboard → Readiness Store: reads readiness data (evidence: `app/(dashboard)/student/dashboard/page.tsx`)
- Student Dashboard → Competency Radar: renders competency chart (evidence: `app/(dashboard)/student/dashboard/page.tsx`)
- Student / TPO → LaTeX Resume Builder: builds resume
- LaTeX Resume Builder → Gemini AI: generates LaTeX
- Student / TPO → Journey Experience: opens learning journeys
- Journey Experience → Journey Generation API: requests journeys
- Journey Generation API → Journey Generator: requests generation (evidence: `app/api/student/journeys/route.ts`)
- Journey Generator → Gemini AI: generates stages (evidence: `lib/ai/client.ts`)
- Journey Experience → Concept, Course, Challenge, Quiz: renders learning stages (evidence: `app/(dashboard)/student/journeys/SkillJourneyClient.tsx`)
- Student / TPO → Peer Progress Hub: browses peers
- Peer Progress Hub → Peer Detail & Directory: opens peer details (evidence: `app/(dashboard)/campus/peers/PeerProgressClient.tsx`)
- Student / TPO → Cohort Diagnostics: reviews cohort readiness
- Cohort Diagnostics → Targeted Push API: targets workshop alert
- Targeted Push API → Firebase Push: dispatches notification (evidence: `app/api/tpo/notify/route.ts`)
- Firebase Push → Student / TPO: sends push alert
- Student / TPO → Campus & Drive Map: views campus drives
- Resume Upload → Department & Role Catalog: selects department (evidence: `app/(dashboard)/student/upload/page.tsx`)
