# rajshekharbind/tnpaiplateform architecture

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

- Interactive diagram: https://gitdiagram.com/rajshekharbind/tnpaiplateform
- Repository: https://github.com/rajshekharbind/tnpaiplateform

## Overview

TnP AI is a college placement-management platform. Students enter through the React application to maintain profiles, discover jobs and companies, and track applications; coordinators manage recruiters, policies, readiness, and placement analytics. Interview practice, resume ATS analysis, and live coding extend the student workflow. The backend exposes REST APIs, with some documented/demo routes backed by in-memory data and separate service-based modules. Source excerpts establish only selected calls; many feature-to-API connections are therefore not asserted.

Main entry points: [`frontend/src/app/App.tsx`](https://github.com/rajshekharbind/tnpaiplateform/blob/main/frontend/src/app/App.tsx) (Application shell), [`frontend/src/services/api.ts`](https://github.com/rajshekharbind/tnpaiplateform/blob/main/frontend/src/services/api.ts) (REST API client), [`backend/src/modules/companies/controllers/CompaniesController.ts`](https://github.com/rajshekharbind/tnpaiplateform/blob/main/backend/src/modules/companies/controllers/CompaniesController.ts) (Company management), [`frontend/src/app/components/ResumeAtsAnalysis.tsx`](https://github.com/rajshekharbind/tnpaiplateform/blob/main/frontend/src/app/components/ResumeAtsAnalysis.tsx) (Resume analysis UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Student and admin app"]
  node_app["Application shell<br/>[App.tsx]"]
  node_jobsui["Job discovery<br/>[Jobs.tsx]"]
  node_companyui["Company insights<br/>[CompanyDetail.tsx]"]
  node_profileui["Student profiles<br/>[Profile.tsx]"]
  node_analyticsui["Placement dashboards<br/>[Analytics.tsx]"]
  node_authui["Authentication UI<br/>[Auth.tsx]"]
end

subgraph group_placement["Placement operations"]
  node_adminui["Admin policy tools"]
  node_companies["Company management"]
  node_jobs["Job management<br/>[JobsController.ts]"]
  node_recruiters["Recruiter management"]
  node_readiness["Student readiness"]
  node_policy["Offer and placement policies"]
end

subgraph group_preparation["Student preparation"]
  node_resumeui["Resume analysis UI"]
  node_resumeapi["Resume ATS routes"]
  node_resumesvc["Resume analysis service"]
  node_interview["Mock interview practice<br/>[MockInterview.tsx]"]
  node_livecoding["Live coding rooms"]
end

subgraph group_backend["Backend APIs"]
  node_authapi["Authentication routes<br/>[AuthController.ts]"]
  node_profileapi["Profile management"]
  node_server["Express API server<br/>[server.js]"]
end

subgraph group_foundation["Shared services"]
  node_authservice["Authentication state<br/>[auth.ts]"]
  node_api["REST API client<br/>[api.ts]"]
  node_datastore[("Database and local storage")]
end

node_user(("Student or coordinator"))
node_external{{"Clerk authentication"}}

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_jobsui
node_app -->|"routes to"| node_companyui
node_app -->|"routes to"| node_analyticsui
node_companies -->|"imports"| node_jobs
node_app -->|"routes to"| node_profileui
node_user -->|"manages placement"| node_adminui
node_user -->|"analyzes resume"| node_resumeui
node_user -->|"practices interviews"| node_interview
node_user -->|"joins coding rooms"| node_livecoding
node_authservice -->|"calls"| node_api
node_authapi -->|"delegates to"| node_authservice
node_resumeapi -->|"saves analysis"| node_resumesvc
node_resumeui -.->|"uses API client"| node_api
node_api -.->|"requests REST APIs"| node_server
node_profileapi -.->|"uses storage"| node_datastore
node_external -->|"provides sign-in"| node_app
node_server -.->|"serves routes"| node_companies

click node_app "https://github.com/rajshekharbind/tnpaiplateform/blob/main/frontend/src/app/App.tsx"
click node_jobsui "https://github.com/rajshekharbind/tnpaiplateform/blob/main/frontend/src/app/components/Jobs.tsx"
click node_companyui "https://github.com/rajshekharbind/tnpaiplateform/blob/main/frontend/src/app/components/CompanyDetail.tsx"
click node_profileui "https://github.com/rajshekharbind/tnpaiplateform/blob/main/frontend/src/app/components/Profile.tsx"
click node_analyticsui "https://github.com/rajshekharbind/tnpaiplateform/blob/main/frontend/src/app/components/Analytics.tsx"
click node_adminui "https://github.com/rajshekharbind/tnpaiplateform/tree/main/frontend/src/app/components/admin"
click node_companies "https://github.com/rajshekharbind/tnpaiplateform/blob/main/backend/src/modules/companies/controllers/CompaniesController.ts"
click node_jobs "https://github.com/rajshekharbind/tnpaiplateform/blob/main/backend/src/modules/jobs/controllers/JobsController.ts"
click node_recruiters "https://github.com/rajshekharbind/tnpaiplateform/blob/main/backend/src/modules/recruiters/controllers/RecruitersController.ts"
click node_readiness "https://github.com/rajshekharbind/tnpaiplateform/blob/main/backend/src/modules/student-readiness/controllers/StudentReadinessController.ts"
click node_policy "https://github.com/rajshekharbind/tnpaiplateform/blob/main/backend/src/modules/one-offer-policy/controllers/OneOfferPolicyController.ts"
click node_authui "https://github.com/rajshekharbind/tnpaiplateform/blob/main/frontend/src/app/components/Auth.tsx"
click node_authservice "https://github.com/rajshekharbind/tnpaiplateform/blob/main/frontend/src/services/auth.ts"
click node_authapi "https://github.com/rajshekharbind/tnpaiplateform/blob/main/backend/src/modules/auth/controllers/AuthController.ts"
click node_profileapi "https://github.com/rajshekharbind/tnpaiplateform/blob/main/backend/src/modules/user/controllers/UserProfileController.ts"
click node_resumeui "https://github.com/rajshekharbind/tnpaiplateform/blob/main/frontend/src/app/components/ResumeAtsAnalysis.tsx"
click node_resumeapi "https://github.com/rajshekharbind/tnpaiplateform/blob/main/backend/src/modules/resume-ats/controllers/ResumeAtsController.ts"
click node_resumesvc "https://github.com/rajshekharbind/tnpaiplateform/blob/main/backend/src/modules/resume-ats/services/ResumeAnalysisService.ts"
click node_interview "https://github.com/rajshekharbind/tnpaiplateform/blob/main/frontend/src/app/components/MockInterview.tsx"
click node_livecoding "https://github.com/rajshekharbind/tnpaiplateform/blob/main/backend/src/api/routes/live-coding.routes.ts"
click node_api "https://github.com/rajshekharbind/tnpaiplateform/blob/main/frontend/src/services/api.ts"
click node_datastore "https://github.com/rajshekharbind/tnpaiplateform/tree/main/backend/src/core/database"
click node_server "https://github.com/rajshekharbind/tnpaiplateform/blob/main/backend/server.js"

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_app,node_jobsui,node_companyui,node_profileui,node_analyticsui,node_authui toneBlue
class node_adminui,node_companies,node_jobs,node_recruiters,node_readiness,node_policy toneAmber
class node_resumeui,node_resumeapi,node_resumesvc,node_interview,node_livecoding toneMint
class node_authapi,node_profileapi,node_server toneRose
class node_authservice,node_api,node_datastore,node_user,node_external toneIndigo
```

## Components

### Student and admin app

- [Application shell](https://github.com/rajshekharbind/tnpaiplateform/blob/main/frontend/src/app/App.tsx): `frontend/src/app/App.tsx`
- [Job discovery](https://github.com/rajshekharbind/tnpaiplateform/blob/main/frontend/src/app/components/Jobs.tsx): `frontend/src/app/components/Jobs.tsx`
- [Company insights](https://github.com/rajshekharbind/tnpaiplateform/blob/main/frontend/src/app/components/CompanyDetail.tsx): `frontend/src/app/components/CompanyDetail.tsx`
- [Student profiles](https://github.com/rajshekharbind/tnpaiplateform/blob/main/frontend/src/app/components/Profile.tsx): `frontend/src/app/components/Profile.tsx`
- [Placement dashboards](https://github.com/rajshekharbind/tnpaiplateform/blob/main/frontend/src/app/components/Analytics.tsx): `frontend/src/app/components/Analytics.tsx`
- [Authentication UI](https://github.com/rajshekharbind/tnpaiplateform/blob/main/frontend/src/app/components/Auth.tsx): `frontend/src/app/components/Auth.tsx`

### Placement operations

- [Admin policy tools](https://github.com/rajshekharbind/tnpaiplateform/tree/main/frontend/src/app/components/admin): `frontend/src/app/components/admin`
- [Company management](https://github.com/rajshekharbind/tnpaiplateform/blob/main/backend/src/modules/companies/controllers/CompaniesController.ts): `backend/src/modules/companies/controllers/CompaniesController.ts`
- [Job management](https://github.com/rajshekharbind/tnpaiplateform/blob/main/backend/src/modules/jobs/controllers/JobsController.ts): `backend/src/modules/jobs/controllers/JobsController.ts`
- [Recruiter management](https://github.com/rajshekharbind/tnpaiplateform/blob/main/backend/src/modules/recruiters/controllers/RecruitersController.ts): `backend/src/modules/recruiters/controllers/RecruitersController.ts`
- [Student readiness](https://github.com/rajshekharbind/tnpaiplateform/blob/main/backend/src/modules/student-readiness/controllers/StudentReadinessController.ts): `backend/src/modules/student-readiness/controllers/StudentReadinessController.ts`
- [Offer and placement policies](https://github.com/rajshekharbind/tnpaiplateform/blob/main/backend/src/modules/one-offer-policy/controllers/OneOfferPolicyController.ts): `backend/src/modules/one-offer-policy/controllers/OneOfferPolicyController.ts`

### Student preparation

- [Resume analysis UI](https://github.com/rajshekharbind/tnpaiplateform/blob/main/frontend/src/app/components/ResumeAtsAnalysis.tsx): `frontend/src/app/components/ResumeAtsAnalysis.tsx`
- [Resume ATS routes](https://github.com/rajshekharbind/tnpaiplateform/blob/main/backend/src/modules/resume-ats/controllers/ResumeAtsController.ts): `backend/src/modules/resume-ats/controllers/ResumeAtsController.ts`
- [Resume analysis service](https://github.com/rajshekharbind/tnpaiplateform/blob/main/backend/src/modules/resume-ats/services/ResumeAnalysisService.ts): `backend/src/modules/resume-ats/services/ResumeAnalysisService.ts`
- [Mock interview practice](https://github.com/rajshekharbind/tnpaiplateform/blob/main/frontend/src/app/components/MockInterview.tsx): `frontend/src/app/components/MockInterview.tsx`
- [Live coding rooms](https://github.com/rajshekharbind/tnpaiplateform/blob/main/backend/src/api/routes/live-coding.routes.ts): `backend/src/api/routes/live-coding.routes.ts`

### Backend APIs

- [Authentication routes](https://github.com/rajshekharbind/tnpaiplateform/blob/main/backend/src/modules/auth/controllers/AuthController.ts): `backend/src/modules/auth/controllers/AuthController.ts`
- [Profile management](https://github.com/rajshekharbind/tnpaiplateform/blob/main/backend/src/modules/user/controllers/UserProfileController.ts): `backend/src/modules/user/controllers/UserProfileController.ts`
- [Express API server](https://github.com/rajshekharbind/tnpaiplateform/blob/main/backend/server.js): `backend/server.js`

### Shared services

- [Authentication state](https://github.com/rajshekharbind/tnpaiplateform/blob/main/frontend/src/services/auth.ts): `frontend/src/services/auth.ts`
- [REST API client](https://github.com/rajshekharbind/tnpaiplateform/blob/main/frontend/src/services/api.ts): `frontend/src/services/api.ts`
- [Database and local storage](https://github.com/rajshekharbind/tnpaiplateform/tree/main/backend/src/core/database): `backend/src/core/database`

### Other components

- **Student or coordinator**
- **Clerk authentication**

## Connections

- Student or coordinator → Application shell: uses (evidence: `README.md`)
- Application shell → Job discovery: routes to (evidence: `frontend/src/app/App.tsx`)
- Application shell → Company insights: routes to (evidence: `frontend/src/app/App.tsx`)
- Application shell → Placement dashboards: routes to (evidence: `frontend/src/app/App.tsx`)
- Company management → Job management: imports (evidence: `backend/src/modules/companies/controllers/CompaniesController.ts`)
- Application shell → Student profiles: routes to (evidence: `frontend/src/app/App.tsx`)
- Student or coordinator → Admin policy tools: manages placement (evidence: `README.md`)
- Student or coordinator → Resume analysis UI: analyzes resume (evidence: `README.md`)
- Student or coordinator → Mock interview practice: practices interviews (evidence: `README.md`)
- Student or coordinator → Live coding rooms: joins coding rooms (evidence: `backend/src/api/routes/live-coding.routes.ts`)
- Authentication state → REST API client: calls (evidence: `frontend/src/services/auth.ts`)
- Authentication routes → Authentication state: delegates to (evidence: `backend/src/modules/auth/controllers/AuthController.ts`)
- Resume ATS routes → Resume analysis service: saves analysis (evidence: `backend/src/modules/resume-ats/controllers/ResumeAtsController.ts`)
- Resume analysis UI → REST API client: uses API client
- REST API client → Express API server: requests REST APIs
- Profile management → Database and local storage: uses storage
- Clerk authentication → Application shell: provides sign-in
- Express API server → Company management: serves routes
