# paldhaduk7-png/mini-placement-portal architecture

> Architecture diagram of the GitHub repository paldhaduk7-png/mini-placement-portal, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/paldhaduk7-png/mini-placement-portal
- Repository: https://github.com/paldhaduk7-png/mini-placement-portal

## Overview

Mini Placement Portal is a university placement-management product for students and placement officers (TPOs). Students register or sign in, maintain profiles, browse drives, check eligibility and apply; TPOs manage companies and drives, review applications, update outcomes and schedule interviews. The backend routes requests through role checks and controllers to domain services and Prisma. The frontend provides role-based student and TPO experiences. Some frontend-to-backend wiring and unsampled subsystem internals are not visible in the excerpts, so those relationships are omitted or marked unverified.

Main entry points: [`backend/src/app.ts`](https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/app.ts) (Placement API), [`backend/src/middleware/auth.middleware.ts`](https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/middleware/auth.middleware.ts) (Token authentication), [`backend/src/middleware/role.middleware.ts`](https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/middleware/role.middleware.ts) (Role authorization), [`backend/src/routes/auth.routes.ts`](https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/routes/auth.routes.ts) (Auth routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Frontend portal"]
  node_app["Frontend app<br/>[App.tsx]"]
  node_router["Role-based pages<br/>[router.tsx]"]
  node_student_ui["Student portal"]
  node_tpo_ui["TPO portal"]
  node_frontend_services["API services"]
  node_api["HTTP client<br/>[api.ts]"]
end

subgraph group_identity["Identity and access"]
  node_auth_routes["Auth routes<br/>[auth.routes.ts]"]
  node_auth_controller["Auth controller<br/>[auth.controller.ts]"]
  node_auth_service["Auth service<br/>[auth.service.ts]"]
  node_auth_middleware["Token authentication<br/>[auth.middleware.ts]"]
  node_role_middleware["Role authorization<br/>[role.middleware.ts]"]
end

subgraph group_placement["Placement workflow"]
  node_backend_api["Placement API<br/>[app.ts]"]
  node_student_routes["Student routes<br/>[student.routes.ts]"]
  node_student_controller["Student profiles"]
  node_student_service["Student service<br/>[student.service.ts]"]
  node_eligibility_routes["Eligibility routes"]
  node_eligibility_controller["Eligibility controller"]
  node_eligibility_service["Eligibility rules"]
  node_application_routes["Application routes"]
  node_application_controller["Application controller"]
  node_application_service["Application workflow"]
end

subgraph group_operations["Placement operations"]
  node_drive_routes["Recruitment drive routes"]
  node_drive_controller["Recruitment drive controller"]
  node_drive_service["Recruitment drive service"]
  node_company_routes["Company routes<br/>[company.routes.ts]"]
  node_company_controller["Company controller"]
  node_company_service["Company service<br/>[company.service.ts]"]
  node_tpo_student_routes["TPO student routes"]
  node_tpo_student_controller["TPO student controller"]
  node_tpo_student_service["TPO student service"]
  node_tpo_user_routes["TPO user routes<br/>[tpo-user.routes.ts]"]
  node_tpo_user_controller["TPO user management"]
end

subgraph group_storage["Persistence and integrations"]
end

node_student(("Student"))
node_tpo(("Placement officer"))

node_student -.->|"uses"| node_app
node_tpo -.->|"uses"| node_app
node_app -->|"renders"| node_router
node_router -.->|"routes to"| node_student_ui
node_router -.->|"routes to"| node_tpo_ui
node_frontend_services -->|"uses"| node_api
node_api -.->|"requests"| node_backend_api
node_backend_api -->|"mounts"| node_auth_routes
node_backend_api -->|"mounts"| node_student_routes
node_backend_api -->|"mounts"| node_eligibility_routes
node_backend_api -->|"mounts"| node_application_routes
node_backend_api -->|"mounts"| node_drive_routes
node_backend_api -->|"mounts"| node_company_routes
node_backend_api -->|"mounts"| node_tpo_student_routes
node_backend_api -->|"mounts"| node_tpo_user_routes
node_auth_routes -->|"dispatches"| node_auth_controller
node_auth_routes -->|"protects"| node_auth_middleware
node_auth_routes -->|"checks role"| node_role_middleware
node_auth_controller -->|"delegates"| node_auth_service
node_auth_service -.->|"issues tokens"| node_auth_middleware
node_student_routes -->|"dispatches"| node_student_controller
node_student_routes -->|"protects"| node_auth_middleware
node_student_routes -->|"checks role"| node_role_middleware
node_student_controller -->|"delegates"| node_student_service
node_eligibility_routes -->|"dispatches"| node_eligibility_controller
node_eligibility_routes -->|"protects"| node_auth_middleware
node_eligibility_routes -->|"checks role"| node_role_middleware
node_application_routes -->|"dispatches"| node_application_controller
node_application_routes -->|"protects"| node_auth_middleware
node_application_routes -->|"checks role"| node_role_middleware
node_application_controller -->|"delegates"| node_application_service
node_drive_routes -->|"dispatches"| node_drive_controller
node_drive_routes -->|"protects"| node_auth_middleware
node_drive_routes -->|"checks role"| node_role_middleware
node_drive_controller -->|"delegates"| node_drive_service
node_company_routes -->|"dispatches"| node_company_controller
node_company_routes -->|"protects"| node_auth_middleware
node_company_routes -->|"checks role"| node_role_middleware
node_company_controller -->|"delegates"| node_company_service
node_tpo_student_routes -->|"dispatches"| node_tpo_student_controller
node_tpo_student_routes -->|"protects"| node_auth_middleware
node_tpo_student_routes -->|"checks role"| node_role_middleware
node_tpo_user_routes -->|"dispatches"| node_tpo_user_controller
node_tpo_user_routes -->|"protects"| node_auth_middleware
node_tpo_user_routes -->|"checks role"| node_role_middleware
node_application_service -->|"checks eligibility"| node_eligibility_service
node_application_service -.->|"uses profile"| node_student_service

click node_app "https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/frontend/src/app/App.tsx"
click node_router "https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/frontend/src/app/router.tsx"
click node_student_ui "https://github.com/paldhaduk7-png/mini-placement-portal/tree/main/frontend/src/pages/student"
click node_tpo_ui "https://github.com/paldhaduk7-png/mini-placement-portal/tree/main/frontend/src/pages/tpo"
click node_frontend_services "https://github.com/paldhaduk7-png/mini-placement-portal/tree/main/frontend/src/services"
click node_api "https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/frontend/src/services/api.ts"
click node_backend_api "https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/app.ts"
click node_auth_routes "https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/routes/auth.routes.ts"
click node_auth_controller "https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/controllers/auth.controller.ts"
click node_auth_service "https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/services/auth.service.ts"
click node_auth_middleware "https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/middleware/auth.middleware.ts"
click node_role_middleware "https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/middleware/role.middleware.ts"
click node_student_routes "https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/routes/student.routes.ts"
click node_student_controller "https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/controllers/student.controller.ts"
click node_student_service "https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/services/student.service.ts"
click node_eligibility_routes "https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/routes/eligibility.routes.ts"
click node_eligibility_controller "https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/controllers/eligibility.controller.ts"
click node_eligibility_service "https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/services/eligibility.service.ts"
click node_application_routes "https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/routes/application.routes.ts"
click node_application_controller "https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/controllers/application.controller.ts"
click node_application_service "https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/services/application.service.ts"
click node_drive_routes "https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/routes/recruitment-drive.routes.ts"
click node_drive_controller "https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/controllers/recruitment-drive.controller.ts"
click node_drive_service "https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/services/recruitment-drive.service.ts"
click node_company_routes "https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/routes/company.routes.ts"
click node_company_controller "https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/controllers/company.controller.ts"
click node_company_service "https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/services/company.service.ts"
click node_tpo_student_routes "https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/routes/tpo-student.routes.ts"
click node_tpo_student_controller "https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/controllers/tpo-student.controller.ts"
click node_tpo_student_service "https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/services/tpo-student.service.ts"
click node_tpo_user_routes "https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/routes/tpo-user.routes.ts"
click node_tpo_user_controller "https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/controllers/tpo-user.controller.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_app,node_router,node_student_ui,node_tpo_ui,node_frontend_services,node_api toneBlue
class node_auth_routes,node_auth_controller,node_auth_service,node_auth_middleware,node_role_middleware toneAmber
class node_backend_api,node_student_routes,node_student_controller,node_student_service,node_eligibility_routes,node_eligibility_controller,node_eligibility_service,node_application_routes,node_application_controller,node_application_service toneMint
class node_drive_routes,node_drive_controller,node_drive_service,node_company_routes,node_company_controller,node_company_service,node_tpo_student_routes,node_tpo_student_controller,node_tpo_student_service,node_tpo_user_routes,node_tpo_user_controller toneRose
class node_student,node_tpo toneIndigo
```

## Components

### Frontend portal

- [Frontend app](https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/frontend/src/app/App.tsx): `frontend/src/app/App.tsx`
- [Role-based pages](https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/frontend/src/app/router.tsx): `frontend/src/app/router.tsx`
- [Student portal](https://github.com/paldhaduk7-png/mini-placement-portal/tree/main/frontend/src/pages/student): `frontend/src/pages/student`
- [TPO portal](https://github.com/paldhaduk7-png/mini-placement-portal/tree/main/frontend/src/pages/tpo): `frontend/src/pages/tpo`
- [API services](https://github.com/paldhaduk7-png/mini-placement-portal/tree/main/frontend/src/services): `frontend/src/services`
- [HTTP client](https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/frontend/src/services/api.ts): `frontend/src/services/api.ts`

### Identity and access

- [Auth routes](https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/routes/auth.routes.ts): `backend/src/routes/auth.routes.ts`
- [Auth controller](https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/controllers/auth.controller.ts): `backend/src/controllers/auth.controller.ts`
- [Auth service](https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/services/auth.service.ts): `backend/src/services/auth.service.ts`
- [Token authentication](https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/middleware/auth.middleware.ts): `backend/src/middleware/auth.middleware.ts`
- [Role authorization](https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/middleware/role.middleware.ts): `backend/src/middleware/role.middleware.ts`

### Placement workflow

- [Placement API](https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/app.ts): `backend/src/app.ts`
- [Student routes](https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/routes/student.routes.ts): `backend/src/routes/student.routes.ts`
- [Student profiles](https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/controllers/student.controller.ts): `backend/src/controllers/student.controller.ts`
- [Student service](https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/services/student.service.ts): `backend/src/services/student.service.ts`
- [Eligibility routes](https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/routes/eligibility.routes.ts): `backend/src/routes/eligibility.routes.ts`
- [Eligibility controller](https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/controllers/eligibility.controller.ts): `backend/src/controllers/eligibility.controller.ts`
- [Eligibility rules](https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/services/eligibility.service.ts): `backend/src/services/eligibility.service.ts`
- [Application routes](https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/routes/application.routes.ts): `backend/src/routes/application.routes.ts`
- [Application controller](https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/controllers/application.controller.ts): `backend/src/controllers/application.controller.ts`
- [Application workflow](https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/services/application.service.ts): `backend/src/services/application.service.ts`

### Placement operations

- [Recruitment drive routes](https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/routes/recruitment-drive.routes.ts): `backend/src/routes/recruitment-drive.routes.ts`
- [Recruitment drive controller](https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/controllers/recruitment-drive.controller.ts): `backend/src/controllers/recruitment-drive.controller.ts`
- [Recruitment drive service](https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/services/recruitment-drive.service.ts): `backend/src/services/recruitment-drive.service.ts`
- [Company routes](https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/routes/company.routes.ts): `backend/src/routes/company.routes.ts`
- [Company controller](https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/controllers/company.controller.ts): `backend/src/controllers/company.controller.ts`
- [Company service](https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/services/company.service.ts): `backend/src/services/company.service.ts`
- [TPO student routes](https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/routes/tpo-student.routes.ts): `backend/src/routes/tpo-student.routes.ts`
- [TPO student controller](https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/controllers/tpo-student.controller.ts): `backend/src/controllers/tpo-student.controller.ts`
- [TPO student service](https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/services/tpo-student.service.ts): `backend/src/services/tpo-student.service.ts`
- [TPO user routes](https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/routes/tpo-user.routes.ts): `backend/src/routes/tpo-user.routes.ts`
- [TPO user management](https://github.com/paldhaduk7-png/mini-placement-portal/blob/main/backend/src/controllers/tpo-user.controller.ts): `backend/src/controllers/tpo-user.controller.ts`

### Other components

- **Student**
- **Placement officer**

## Connections

- Student → Frontend app: uses
- Placement officer → Frontend app: uses
- Frontend app → Role-based pages: renders (evidence: `frontend/src/app/App.tsx`)
- Role-based pages → Student portal: routes to
- Role-based pages → TPO portal: routes to
- API services → HTTP client: uses (evidence: `frontend/src/services/application.service.ts`)
- HTTP client → Placement API: requests
- Placement API → Auth routes: mounts (evidence: `backend/src/app.ts`)
- Placement API → Student routes: mounts (evidence: `backend/src/app.ts`)
- Placement API → Eligibility routes: mounts (evidence: `backend/src/app.ts`)
- Placement API → Application routes: mounts (evidence: `backend/src/app.ts`)
- Placement API → Recruitment drive routes: mounts (evidence: `backend/src/app.ts`)
- Placement API → Company routes: mounts (evidence: `backend/src/app.ts`)
- Placement API → TPO student routes: mounts (evidence: `backend/src/app.ts`)
- Placement API → TPO user routes: mounts (evidence: `backend/src/app.ts`)
- Auth routes → Auth controller: dispatches (evidence: `backend/src/routes/auth.routes.ts`)
- Auth routes → Token authentication: protects (evidence: `backend/src/routes/auth.routes.ts`)
- Auth routes → Role authorization: checks role (evidence: `backend/src/routes/auth.routes.ts`)
- Auth controller → Auth service: delegates (evidence: `backend/src/controllers/auth.controller.ts`)
- Auth service → Token authentication: issues tokens
- Student routes → Student profiles: dispatches (evidence: `backend/src/routes/student.routes.ts`)
- Student routes → Token authentication: protects (evidence: `backend/src/routes/student.routes.ts`)
- Student routes → Role authorization: checks role (evidence: `backend/src/routes/student.routes.ts`)
- Student profiles → Student service: delegates (evidence: `backend/src/controllers/student.controller.ts`)
- Eligibility routes → Eligibility controller: dispatches (evidence: `backend/src/routes/eligibility.routes.ts`)
- Eligibility routes → Token authentication: protects (evidence: `backend/src/routes/eligibility.routes.ts`)
- Eligibility routes → Role authorization: checks role (evidence: `backend/src/routes/eligibility.routes.ts`)
- Application routes → Application controller: dispatches (evidence: `backend/src/routes/application.routes.ts`)
- Application routes → Token authentication: protects (evidence: `backend/src/routes/application.routes.ts`)
- Application routes → Role authorization: checks role (evidence: `backend/src/routes/application.routes.ts`)
- Application controller → Application workflow: delegates (evidence: `backend/src/controllers/application.controller.ts`)
- Recruitment drive routes → Recruitment drive controller: dispatches (evidence: `backend/src/routes/recruitment-drive.routes.ts`)
- Recruitment drive routes → Token authentication: protects (evidence: `backend/src/routes/recruitment-drive.routes.ts`)
- Recruitment drive routes → Role authorization: checks role (evidence: `backend/src/routes/recruitment-drive.routes.ts`)
- Recruitment drive controller → Recruitment drive service: delegates (evidence: `backend/src/controllers/recruitment-drive.controller.ts`)
- Company routes → Company controller: dispatches (evidence: `backend/src/routes/company.routes.ts`)
- Company routes → Token authentication: protects (evidence: `backend/src/routes/company.routes.ts`)
- Company routes → Role authorization: checks role (evidence: `backend/src/routes/company.routes.ts`)
- Company controller → Company service: delegates (evidence: `backend/src/controllers/company.controller.ts`)
- TPO student routes → TPO student controller: dispatches (evidence: `backend/src/routes/tpo-student.routes.ts`)
- TPO student routes → Token authentication: protects (evidence: `backend/src/routes/tpo-student.routes.ts`)
- TPO student routes → Role authorization: checks role (evidence: `backend/src/routes/tpo-student.routes.ts`)
- TPO user routes → TPO user management: dispatches (evidence: `backend/src/routes/tpo-user.routes.ts`)
- TPO user routes → Token authentication: protects (evidence: `backend/src/routes/tpo-user.routes.ts`)
- TPO user routes → Role authorization: checks role (evidence: `backend/src/routes/tpo-user.routes.ts`)
- Application workflow → Eligibility rules: checks eligibility (evidence: `backend/src/services/application.service.ts`)
- Application workflow → Student service: uses profile
