How web-team-iiti-gymkhana/tpc-frontend works
This is a role-based campus placement management portal for students, recruiters, faculty, and placement administrators. Users authenticate, then work through role-specific placement tasks: students review jobs and offers, apply and manage profiles; recruiters maintain job applications and events; administrators oversee jobs, candidates, seasons, companies, and placement analytics. A shared API layer connects client features to the backend, while a calendar context dispatches event retrieval according to the decoded role. The README is only a generic Next.js template, and many listed feature pages were not sampled, so their internal calls are not asserted.
Main entry points: helpers/api.ts Shared API client · student/api.ts Jobs and applications · middleware.ts Role access checks · page.tsx Job oversight
Components 21
Identity and access
- Sign-in flows
src/components/loginForms/loginForm.tsx - Google session config
src/helpers/auth.ts - NextAuth route
src/app/api/auth/[...nextauth]/route.ts - Role access checks
src/middleware.ts
Student placement
- Student portal
src/app/(routes)/student - Jobs and applications
src/helpers/student/api.ts - Profile and registration
src/app/(routes)/student/profile/page.tsx - Resume management
src/app/(routes)/student/resumes/page.tsx
Recruiter and administration
- Recruiter portal
src/app/(routes)/recruiter - Job detail editing
src/app/(routes)/recruiter/jobs/[jobID]/page.tsx - Recruiter operations
src/helpers/recruiter/api.ts - Admin portal
src/app/(routes)/admin - Job oversight
src/app/(routes)/admin/jobs/[jobId]/page.tsx - Job analytics and clashes
src/components/Admin/Job/JobAnalytics.tsx - Job approval form
src/components/JAF/JobDetails.tsx - Faculty workspace
src/app/(routes)/faculty/page.tsx
Shared services
- Role-aware calendar
src/components/Calendar/context/ContextWrapper.tsx - Shared API client
src/helpers/api.ts - JAF domain types
src/types/jaf.types.ts
Other components
- Portal user
- Placement backend
Connections 20
- Portal user → Sign-in flows: signs in
- NextAuth route → Google session config: uses config
src/app/api/auth/[...nextauth]/route.ts - Student portal → Jobs and applications: loads student data
src/app/(routes)/student/page.tsx - Profile and registration → Jobs and applications: registers season
src/app/(routes)/student/profile/page.tsx - Student portal → Jobs and applications: requests profile
src/app/(routes)/student/page.tsx - Jobs and applications → Shared API client: delegates requests
src/helpers/student/api.ts - Job detail editing → Recruiter operations: loads job detail
src/app/(routes)/recruiter/jobs/[jobID]/page.tsx - Recruiter operations → Shared API client: uses API client
src/helpers/recruiter/api.ts - Job oversight → Shared API client: loads and patches
src/app/(routes)/admin/jobs/[jobId]/page.tsx - Job oversight → Recruiter operations: loads JAF details
src/app/(routes)/admin/jobs/[jobId]/page.tsx - Job oversight → Job analytics and clashes: renders tools
src/app/(routes)/admin/jobs/[jobId]/page.tsx - Faculty workspace → Shared API client: loads faculty data
src/app/(routes)/faculty/page.tsx - Role-aware calendar → Shared API client: fetches admin events
src/components/Calendar/context/ContextWrapper.tsx - Role-aware calendar → Jobs and applications: fetches student events
src/components/Calendar/context/ContextWrapper.tsx - Shared API client → Placement backend: HTTP requests
src/helpers/api.ts - Job approval form → JAF domain types: uses domain types
src/components/JAF/JobDetails.tsx - Role access checks → Student portal: guards access
- Role access checks → Recruiter portal: guards access
- Role access checks → Admin portal: guards access
- Role access checks → Faculty workspace: guards access