# web-team-iiti-gymkhana/tpc-frontend architecture

> Architecture diagram of the GitHub repository web-team-iiti-gymkhana/tpc-frontend, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/web-team-iiti-gymkhana/tpc-frontend
- Repository: https://github.com/web-team-iiti-gymkhana/tpc-frontend

## Overview

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: [`src/helpers/api.ts`](https://github.com/web-team-iiti-gymkhana/tpc-frontend/blob/develop/src/helpers/api.ts) (Shared API client), [`src/helpers/student/api.ts`](https://github.com/web-team-iiti-gymkhana/tpc-frontend/blob/develop/src/helpers/student/api.ts) (Jobs and applications), [`src/middleware.ts`](https://github.com/web-team-iiti-gymkhana/tpc-frontend/blob/develop/src/middleware.ts) (Role access checks), [`src/app/(routes)/admin/jobs/[jobId]/page.tsx`](https://github.com/web-team-iiti-gymkhana/tpc-frontend/blob/develop/src/app/(routes)/admin/jobs/%5BjobId%5D/page.tsx) (Job oversight)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and access"]
  node_login["Sign-in flows<br/>[loginForm.tsx]"]
  node_auth_config["Google session config<br/>[auth.ts]"]
  node_auth_route["NextAuth route<br/>[route.ts]"]
  node_middleware["Role access checks<br/>[middleware.ts]"]
end

subgraph group_student["Student placement"]
  node_student_pages["Student portal"]
  node_student_jobs["Jobs and applications<br/>[api.ts]"]
  node_student_profile["Profile and registration<br/>[page.tsx]"]
  node_resume_pages["Resume management<br/>[page.tsx]"]
end

subgraph group_recruiter_admin["Recruiter and administration"]
  node_recruiter_pages["Recruiter portal"]
  node_recruiter_jobs["Job detail editing<br/>[page.tsx]"]
  node_recruiter_api["Recruiter operations<br/>[api.ts]"]
  node_admin_pages["Admin portal"]
  node_admin_job["Job oversight<br/>[page.tsx]"]
  node_admin_job_tools["Job analytics and clashes<br/>[JobAnalytics.tsx]"]
  node_jaf["Job approval form<br/>[JobDetails.tsx]"]
  node_faculty["Faculty workspace<br/>[page.tsx]"]
end

subgraph group_shared["Shared services"]
  node_events["Role-aware calendar<br/>[ContextWrapper.tsx]"]
  node_general_api["Shared API client<br/>[api.ts]"]
  node_jaf_schema["JAF domain types<br/>[jaf.types.ts]"]
end

node_visitor(("Portal user"))
node_backend[("Placement backend")]

node_visitor -.->|"signs in"| node_login
node_auth_route -->|"uses config"| node_auth_config
node_student_pages -->|"loads student data"| node_student_jobs
node_student_profile -->|"registers season"| node_student_jobs
node_student_pages -->|"requests profile"| node_student_jobs
node_student_jobs -->|"delegates requests"| node_general_api
node_recruiter_jobs -->|"loads job detail"| node_recruiter_api
node_recruiter_api -->|"uses API client"| node_general_api
node_admin_job -->|"loads and patches"| node_general_api
node_admin_job -->|"loads JAF details"| node_recruiter_api
node_admin_job -->|"renders tools"| node_admin_job_tools
node_faculty -->|"loads faculty data"| node_general_api
node_events -->|"fetches admin events"| node_general_api
node_events -->|"fetches student events"| node_student_jobs
node_general_api -->|"HTTP requests"| node_backend
node_jaf -->|"uses domain types"| node_jaf_schema
node_middleware -.->|"guards access"| node_student_pages
node_middleware -.->|"guards access"| node_recruiter_pages
node_middleware -.->|"guards access"| node_admin_pages
node_middleware -.->|"guards access"| node_faculty

click node_login "https://github.com/web-team-iiti-gymkhana/tpc-frontend/blob/develop/src/components/loginForms/loginForm.tsx"
click node_auth_config "https://github.com/web-team-iiti-gymkhana/tpc-frontend/blob/develop/src/helpers/auth.ts"
click node_auth_route "https://github.com/web-team-iiti-gymkhana/tpc-frontend/blob/develop/src/app/api/auth/%5B...nextauth%5D/route.ts"
click node_middleware "https://github.com/web-team-iiti-gymkhana/tpc-frontend/blob/develop/src/middleware.ts"
click node_student_pages "https://github.com/web-team-iiti-gymkhana/tpc-frontend/tree/develop/src/app/(routes)/student"
click node_student_jobs "https://github.com/web-team-iiti-gymkhana/tpc-frontend/blob/develop/src/helpers/student/api.ts"
click node_student_profile "https://github.com/web-team-iiti-gymkhana/tpc-frontend/blob/develop/src/app/(routes)/student/profile/page.tsx"
click node_resume_pages "https://github.com/web-team-iiti-gymkhana/tpc-frontend/blob/develop/src/app/(routes)/student/resumes/page.tsx"
click node_recruiter_pages "https://github.com/web-team-iiti-gymkhana/tpc-frontend/tree/develop/src/app/(routes)/recruiter"
click node_recruiter_jobs "https://github.com/web-team-iiti-gymkhana/tpc-frontend/blob/develop/src/app/(routes)/recruiter/jobs/%5BjobID%5D/page.tsx"
click node_recruiter_api "https://github.com/web-team-iiti-gymkhana/tpc-frontend/blob/develop/src/helpers/recruiter/api.ts"
click node_admin_pages "https://github.com/web-team-iiti-gymkhana/tpc-frontend/tree/develop/src/app/(routes)/admin"
click node_admin_job "https://github.com/web-team-iiti-gymkhana/tpc-frontend/blob/develop/src/app/(routes)/admin/jobs/%5BjobId%5D/page.tsx"
click node_admin_job_tools "https://github.com/web-team-iiti-gymkhana/tpc-frontend/blob/develop/src/components/Admin/Job/JobAnalytics.tsx"
click node_jaf "https://github.com/web-team-iiti-gymkhana/tpc-frontend/blob/develop/src/components/JAF/JobDetails.tsx"
click node_faculty "https://github.com/web-team-iiti-gymkhana/tpc-frontend/blob/develop/src/app/(routes)/faculty/page.tsx"
click node_events "https://github.com/web-team-iiti-gymkhana/tpc-frontend/blob/develop/src/components/Calendar/context/ContextWrapper.tsx"
click node_general_api "https://github.com/web-team-iiti-gymkhana/tpc-frontend/blob/develop/src/helpers/api.ts"
click node_jaf_schema "https://github.com/web-team-iiti-gymkhana/tpc-frontend/blob/develop/src/types/jaf.types.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_auth_config,node_auth_route,node_middleware,node_visitor toneBlue
class node_student_pages,node_student_jobs,node_student_profile,node_resume_pages,node_backend toneAmber
class node_recruiter_pages,node_recruiter_jobs,node_recruiter_api,node_admin_pages,node_admin_job,node_admin_job_tools,node_jaf,node_faculty toneMint
class node_events,node_general_api,node_jaf_schema toneRose
```

## Components

### Identity and access

- [Sign-in flows](https://github.com/web-team-iiti-gymkhana/tpc-frontend/blob/develop/src/components/loginForms/loginForm.tsx): `src/components/loginForms/loginForm.tsx`
- [Google session config](https://github.com/web-team-iiti-gymkhana/tpc-frontend/blob/develop/src/helpers/auth.ts): `src/helpers/auth.ts`
- [NextAuth route](https://github.com/web-team-iiti-gymkhana/tpc-frontend/blob/develop/src/app/api/auth/%5B...nextauth%5D/route.ts): `src/app/api/auth/[...nextauth]/route.ts`
- [Role access checks](https://github.com/web-team-iiti-gymkhana/tpc-frontend/blob/develop/src/middleware.ts): `src/middleware.ts`

### Student placement

- [Student portal](https://github.com/web-team-iiti-gymkhana/tpc-frontend/tree/develop/src/app/(routes)/student): `src/app/(routes)/student`
- [Jobs and applications](https://github.com/web-team-iiti-gymkhana/tpc-frontend/blob/develop/src/helpers/student/api.ts): `src/helpers/student/api.ts`
- [Profile and registration](https://github.com/web-team-iiti-gymkhana/tpc-frontend/blob/develop/src/app/(routes)/student/profile/page.tsx): `src/app/(routes)/student/profile/page.tsx`
- [Resume management](https://github.com/web-team-iiti-gymkhana/tpc-frontend/blob/develop/src/app/(routes)/student/resumes/page.tsx): `src/app/(routes)/student/resumes/page.tsx`

### Recruiter and administration

- [Recruiter portal](https://github.com/web-team-iiti-gymkhana/tpc-frontend/tree/develop/src/app/(routes)/recruiter): `src/app/(routes)/recruiter`
- [Job detail editing](https://github.com/web-team-iiti-gymkhana/tpc-frontend/blob/develop/src/app/(routes)/recruiter/jobs/%5BjobID%5D/page.tsx): `src/app/(routes)/recruiter/jobs/[jobID]/page.tsx`
- [Recruiter operations](https://github.com/web-team-iiti-gymkhana/tpc-frontend/blob/develop/src/helpers/recruiter/api.ts): `src/helpers/recruiter/api.ts`
- [Admin portal](https://github.com/web-team-iiti-gymkhana/tpc-frontend/tree/develop/src/app/(routes)/admin): `src/app/(routes)/admin`
- [Job oversight](https://github.com/web-team-iiti-gymkhana/tpc-frontend/blob/develop/src/app/(routes)/admin/jobs/%5BjobId%5D/page.tsx): `src/app/(routes)/admin/jobs/[jobId]/page.tsx`
- [Job analytics and clashes](https://github.com/web-team-iiti-gymkhana/tpc-frontend/blob/develop/src/components/Admin/Job/JobAnalytics.tsx): `src/components/Admin/Job/JobAnalytics.tsx`
- [Job approval form](https://github.com/web-team-iiti-gymkhana/tpc-frontend/blob/develop/src/components/JAF/JobDetails.tsx): `src/components/JAF/JobDetails.tsx`
- [Faculty workspace](https://github.com/web-team-iiti-gymkhana/tpc-frontend/blob/develop/src/app/(routes)/faculty/page.tsx): `src/app/(routes)/faculty/page.tsx`

### Shared services

- [Role-aware calendar](https://github.com/web-team-iiti-gymkhana/tpc-frontend/blob/develop/src/components/Calendar/context/ContextWrapper.tsx): `src/components/Calendar/context/ContextWrapper.tsx`
- [Shared API client](https://github.com/web-team-iiti-gymkhana/tpc-frontend/blob/develop/src/helpers/api.ts): `src/helpers/api.ts`
- [JAF domain types](https://github.com/web-team-iiti-gymkhana/tpc-frontend/blob/develop/src/types/jaf.types.ts): `src/types/jaf.types.ts`

### Other components

- **Portal user**
- **Placement backend**

## Connections

- Portal user → Sign-in flows: signs in
- NextAuth route → Google session config: uses config (evidence: `src/app/api/auth/[...nextauth]/route.ts`)
- Student portal → Jobs and applications: loads student data (evidence: `src/app/(routes)/student/page.tsx`)
- Profile and registration → Jobs and applications: registers season (evidence: `src/app/(routes)/student/profile/page.tsx`)
- Student portal → Jobs and applications: requests profile (evidence: `src/app/(routes)/student/page.tsx`)
- Jobs and applications → Shared API client: delegates requests (evidence: `src/helpers/student/api.ts`)
- Job detail editing → Recruiter operations: loads job detail (evidence: `src/app/(routes)/recruiter/jobs/[jobID]/page.tsx`)
- Recruiter operations → Shared API client: uses API client (evidence: `src/helpers/recruiter/api.ts`)
- Job oversight → Shared API client: loads and patches (evidence: `src/app/(routes)/admin/jobs/[jobId]/page.tsx`)
- Job oversight → Recruiter operations: loads JAF details (evidence: `src/app/(routes)/admin/jobs/[jobId]/page.tsx`)
- Job oversight → Job analytics and clashes: renders tools (evidence: `src/app/(routes)/admin/jobs/[jobId]/page.tsx`)
- Faculty workspace → Shared API client: loads faculty data (evidence: `src/app/(routes)/faculty/page.tsx`)
- Role-aware calendar → Shared API client: fetches admin events (evidence: `src/components/Calendar/context/ContextWrapper.tsx`)
- Role-aware calendar → Jobs and applications: fetches student events (evidence: `src/components/Calendar/context/ContextWrapper.tsx`)
- Shared API client → Placement backend: HTTP requests (evidence: `src/helpers/api.ts`)
- Job approval form → JAF domain types: uses domain types (evidence: `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
