How web-team-iiti-gymkhana/tpc-backend works
TPC Backend is a NestJS API for technical-placement operations. Users authenticate and then access role-specific workflows: students browse opportunities and manage applications, registrations, and resumes; recruiters manage jobs and provide feedback; placement staff administer seasons, companies, events, offers, and approvals. Controllers delegate to domain services, with Sequelize-backed models and shared services forming the internal data and integration layer. The README describes these architectural roles; source excerpts and the SOURCE INDEX support the shown controller-to-service calls. Several documented-by-tree capabilities are included, but their internal wiring was not sampled.
Main entry points: job.controller.ts Jobs and exports · FileService.ts File service · student.controller.ts Student portal · recruiter-view.controller.ts Recruiter portal
Components 25
API and identity
- Authentication
src/auth/auth.controller.ts
Placement operations
- Companies
src/company/company.controller.ts - Programs
src/program/program.controller.ts - Seasons
src/season/season.controller.ts - Jobs and exports
src/job/job.controller.ts - Events and applications
src/event/event.controller.ts - Offers
src/offers/offer.service.ts - External opportunities
src/externalOpportunities/externalOpportunities.controller.ts - Faculty approvals
src/facultyApproval/facultyApproval.controller.ts - Resume management
src/resume/resume.controller.ts - Season registrations
src/registrations/registrations.controller.ts - Salary data
src/salary/salary.controller.ts - Analytics dashboard
src/analytics-dashboard/analytics-dashboard.controller.ts
Role-based portals
- Student portal
src/student-view/students/student.controller.ts - Student records
src/student-view/students/student.service.ts - Recruiter portal
src/recruiter-view/recruiter-view.controller.ts - Recruiter workflows
src/recruiter-view/recruiter-view.service.ts - Faculty portal
src/faculty-view/faculty-view.controller.ts - TPC member portal
src/tpc-member-view/tpc-member-view.service.ts - Interview experiences
src/student-view/interview-experiences/ie.controller.ts
Data and shared services
- Sequelize models
src/db/models/index.ts - File service
src/services/FileService.ts - Email service
src/services/EmailService.ts - PPO synchronization
src/services/PPOSyncService.ts
Other components
- API clients
Connections 27
- API clients → Authentication: sends requests
- API clients → Companies: sends requests
- API clients → Programs: sends requests
- API clients → Seasons: sends requests
- API clients → Jobs and exports: sends requests
- API clients → Events and applications: sends requests
- API clients → Student portal: sends requests
- API clients → Recruiter portal: sends requests
- Companies → Companies: delegates to service
src/company/company.controller.ts - Programs → Programs: delegates to service
src/program/program.controller.ts - Seasons → Seasons: delegates to service
src/season/season.controller.ts - Jobs and exports → Jobs and exports: delegates to service
src/job/job.controller.ts - Jobs and exports → File service: reads files
src/job/job.controller.ts - Events and applications → Events and applications: delegates to service
src/event/event.controller.ts - External opportunities → External opportunities: delegates to service
src/externalOpportunities/externalOpportunities.controller.ts - Faculty approvals → Faculty approvals: delegates to service
src/facultyApproval/facultyApproval.controller.ts - Student portal → Student records: delegates to
src/student-view/students/student.controller.ts - Student portal → File service: deletes files
src/student-view/students/student.controller.ts - Recruiter portal → Recruiter workflows: delegates to
src/recruiter-view/recruiter-view.controller.ts - Recruiter portal → File service: uploads files
- Authentication → Email service: sends login email
src/auth/auth.controller.ts - Resume management → File service: uploads and deletes
src/resume/resume.controller.ts - Season registrations → Season registrations: delegates to service
src/registrations/registrations.controller.ts - Faculty portal → Faculty portal: delegates to service
src/faculty-view/faculty-view.controller.ts - TPC member portal → TPC member portal: delegates to service
src/tpc-member-view/tpc-member-view.controller.ts - Interview experiences → Interview experiences: delegates to service
- Salary data → Salary data: delegates to service
src/salary/salary.controller.ts