How paldhaduk7-png/mini-placement-portal works
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: app.ts Placement API · auth.middleware.ts Token authentication · role.middleware.ts Role authorization · auth.routes.ts Auth routes
Components 34
Frontend portal
- Frontend app
frontend/src/app/App.tsx - Role-based pages
frontend/src/app/router.tsx - Student portal
frontend/src/pages/student - TPO portal
frontend/src/pages/tpo - API services
frontend/src/services - HTTP client
frontend/src/services/api.ts
Identity and access
- Auth routes
backend/src/routes/auth.routes.ts - Auth controller
backend/src/controllers/auth.controller.ts - Auth service
backend/src/services/auth.service.ts - Token authentication
backend/src/middleware/auth.middleware.ts - Role authorization
backend/src/middleware/role.middleware.ts
Placement workflow
- Placement API
backend/src/app.ts - Student routes
backend/src/routes/student.routes.ts - Student profiles
backend/src/controllers/student.controller.ts - Student service
backend/src/services/student.service.ts - Eligibility routes
backend/src/routes/eligibility.routes.ts - Eligibility controller
backend/src/controllers/eligibility.controller.ts - Eligibility rules
backend/src/services/eligibility.service.ts - Application routes
backend/src/routes/application.routes.ts - Application controller
backend/src/controllers/application.controller.ts - Application workflow
backend/src/services/application.service.ts
Placement operations
- Recruitment drive routes
backend/src/routes/recruitment-drive.routes.ts - Recruitment drive controller
backend/src/controllers/recruitment-drive.controller.ts - Recruitment drive service
backend/src/services/recruitment-drive.service.ts - Company routes
backend/src/routes/company.routes.ts - Company controller
backend/src/controllers/company.controller.ts - Company service
backend/src/services/company.service.ts - TPO student routes
backend/src/routes/tpo-student.routes.ts - TPO student controller
backend/src/controllers/tpo-student.controller.ts - TPO student service
backend/src/services/tpo-student.service.ts - TPO user routes
backend/src/routes/tpo-user.routes.ts - TPO user management
backend/src/controllers/tpo-user.controller.ts
Other components
- Student
- Placement officer
Connections 47
- Student → Frontend app: uses
- Placement officer → Frontend app: uses
- Frontend app → Role-based pages: renders
frontend/src/app/App.tsx - Role-based pages → Student portal: routes to
- Role-based pages → TPO portal: routes to
- API services → HTTP client: uses
frontend/src/services/application.service.ts - HTTP client → Placement API: requests
- Placement API → Auth routes: mounts
backend/src/app.ts - Placement API → Student routes: mounts
backend/src/app.ts - Placement API → Eligibility routes: mounts
backend/src/app.ts - Placement API → Application routes: mounts
backend/src/app.ts - Placement API → Recruitment drive routes: mounts
backend/src/app.ts - Placement API → Company routes: mounts
backend/src/app.ts - Placement API → TPO student routes: mounts
backend/src/app.ts - Placement API → TPO user routes: mounts
backend/src/app.ts - Auth routes → Auth controller: dispatches
backend/src/routes/auth.routes.ts - Auth routes → Token authentication: protects
backend/src/routes/auth.routes.ts - Auth routes → Role authorization: checks role
backend/src/routes/auth.routes.ts - Auth controller → Auth service: delegates
backend/src/controllers/auth.controller.ts - Auth service → Token authentication: issues tokens
- Student routes → Student profiles: dispatches
backend/src/routes/student.routes.ts - Student routes → Token authentication: protects
backend/src/routes/student.routes.ts - Student routes → Role authorization: checks role
backend/src/routes/student.routes.ts - Student profiles → Student service: delegates
backend/src/controllers/student.controller.ts - Eligibility routes → Eligibility controller: dispatches
backend/src/routes/eligibility.routes.ts - Eligibility routes → Token authentication: protects
backend/src/routes/eligibility.routes.ts - Eligibility routes → Role authorization: checks role
backend/src/routes/eligibility.routes.ts - Application routes → Application controller: dispatches
backend/src/routes/application.routes.ts - Application routes → Token authentication: protects
backend/src/routes/application.routes.ts - Application routes → Role authorization: checks role
backend/src/routes/application.routes.ts - Application controller → Application workflow: delegates
backend/src/controllers/application.controller.ts - Recruitment drive routes → Recruitment drive controller: dispatches
backend/src/routes/recruitment-drive.routes.ts - Recruitment drive routes → Token authentication: protects
backend/src/routes/recruitment-drive.routes.ts - Recruitment drive routes → Role authorization: checks role
backend/src/routes/recruitment-drive.routes.ts - Recruitment drive controller → Recruitment drive service: delegates
backend/src/controllers/recruitment-drive.controller.ts - Company routes → Company controller: dispatches
backend/src/routes/company.routes.ts - Company routes → Token authentication: protects
backend/src/routes/company.routes.ts - Company routes → Role authorization: checks role
backend/src/routes/company.routes.ts - Company controller → Company service: delegates
backend/src/controllers/company.controller.ts - TPO student routes → TPO student controller: dispatches
backend/src/routes/tpo-student.routes.ts - TPO student routes → Token authentication: protects
backend/src/routes/tpo-student.routes.ts - TPO student routes → Role authorization: checks role
backend/src/routes/tpo-student.routes.ts - TPO user routes → TPO user management: dispatches
backend/src/routes/tpo-user.routes.ts - TPO user routes → Token authentication: protects
backend/src/routes/tpo-user.routes.ts - TPO user routes → Role authorization: checks role
backend/src/routes/tpo-user.routes.ts - Application workflow → Eligibility rules: checks eligibility
backend/src/services/application.service.ts - Application workflow → Student service: uses profile