How sayan1776/campus-career-copilot works
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: analyze/route.ts Resume Analysis API · session/route.ts Session & Role APIs · page.tsx Resume Upload · SkillJourneyClient.tsx Journey Experience
Components 24
Identity & Profiles
- Login & Signup
app/(public)/login/page.tsx - Firebase Auth
lib/firebase/client.ts - Session & Role APIs
app/api/auth/session/route.ts - Firebase Admin
lib/firebase/admin.ts - Role Cookie
lib/auth/role-cookie.ts
Student Readiness
- Resume Upload
app/(dashboard)/student/upload/page.tsx - Resume Analysis API
app/api/resume/analyze/route.ts - Student Dashboard
app/(dashboard)/student/dashboard/page.tsx - Competency Radar
app/(dashboard)/student/dashboard/SkillRadarChart.tsx - LaTeX Resume Builder
components/ResumeBuilder.tsx
Skill Development
- Journey Generation API
app/api/student/journeys/route.ts - Journey Generator
lib/ai/client.ts - Journey Experience
app/(dashboard)/student/journeys/SkillJourneyClient.tsx - Concept, Course, Challenge, Quiz
app/(dashboard)/student/journeys/JourneyDetail.tsx
Campus Intelligence
- Peer Progress Hub
app/(dashboard)/campus/peers/PeerProgressClient.tsx - Peer Detail & Directory
app/(dashboard)/campus/peers/page.tsx - Cohort Diagnostics
app/(dashboard)/tpo/dashboard/page.tsx - Targeted Push API
app/api/tpo/notify/route.ts - Campus & Drive Map
app/(public)/about/CampusMap.tsx
Shared Services
- Gemini AI
- Readiness Store
lib/supabase/server.ts - Firebase Push
lib/firebase/send-push.ts - Department & Role Catalog
lib/departments.ts
Other components
- Student / TPO
Connections 27
- Student / TPO → Login & Signup: signs in
- Login & Signup → Firebase Auth: authenticates with
app/(public)/login/page.tsx - Firebase Auth → Session & Role APIs: sends ID token
- Session & Role APIs → Firebase Admin: mints session
app/api/auth/session/route.ts - Session & Role APIs → Role Cookie: sets role cookie
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
app/api/resume/analyze/route.ts - Resume Analysis API → Readiness Store: saves score and gaps
app/api/resume/analyze/route.ts - Resume Analysis API → Department & Role Catalog: uses branch context
app/api/resume/analyze/route.ts - Student Dashboard → Readiness Store: reads readiness data
app/(dashboard)/student/dashboard/page.tsx - Student Dashboard → Competency Radar: renders competency chart
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
app/api/student/journeys/route.ts - Journey Generator → Gemini AI: generates stages
lib/ai/client.ts - Journey Experience → Concept, Course, Challenge, Quiz: renders learning stages
app/(dashboard)/student/journeys/SkillJourneyClient.tsx - Student / TPO → Peer Progress Hub: browses peers
- Peer Progress Hub → Peer Detail & Directory: opens peer details
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
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
app/(dashboard)/student/upload/page.tsx