How 23f2000448/placement-portal-application works
Placement Portal is a campus recruitment platform for students, companies, and placement administrators. Students register, maintain profiles, discover eligible approved drives, apply, track application and interview outcomes, and view placements; companies manage drives and candidates, while administrators approve companies and moderate drives. The Vue portals use a Flask REST backend, whose services implement recruitment rules over relational models. Celery jobs provide reminders, reports, and exports. The README documents these capabilities; several frontend-to-API links and unsampled task wiring are shown as unverified rather than asserted.
Main entry points: api.js API client · models Recruitment records · student.py Student routes · company.py Company routes
Components 27
User portals
- Student portal
frontend/src/views/student - Company portal
frontend/src/views/company - Admin portal
frontend/src/views/admin - Sign-in and registration
frontend/src/views/auth - Auth state and routing
frontend/src/stores/auth.js - API client
frontend/src/services/api.js
Backend API
- Authentication routes
backend/app/routes/auth.py - Student routes
backend/app/routes/student.py - Drive routes
backend/app/routes/drives.py - Application routes
backend/app/routes/applications.py - Company routes
backend/app/routes/company.py - Admin routes
backend/app/routes/admin.py - Validation and serialization
backend/app/schemas - Role authorization
backend/app/utils/decorators.py - API responses
backend/app/utils/responses.py
Recruitment domain
- Student workflows
backend/app/services/student_service.py - Company workflows
backend/app/services/company_service.py - Admin management
backend/app/services/admin_service.py - Recruitment records
backend/app/models
Background work
- Celery task setup
backend/app/tasks/celery_app.py - Interview reminders
backend/app/tasks/reminders.py - Reports and exports
backend/app/tasks
Other components
- Student
- Company
- Administrator
- SQL database
- Redis cache
Connections 35
- Student → Student portal: uses
README.md - Company → Company portal: uses
README.md - Administrator → Admin portal: uses
README.md - Student portal → API client: requests
- Company portal → API client: requests
- Admin portal → API client: requests
- Sign-in and registration → Auth state and routing: updates session
- Auth state and routing → Authentication routes: authenticates
- API client → Student routes: calls REST
- API client → Company routes: calls REST
- API client → Admin routes: calls REST
- Student routes → Role authorization: checks roles
backend/app/routes/student.py - Company routes → Role authorization: checks roles
backend/app/routes/company.py - Admin routes → Role authorization: checks roles
backend/app/routes/admin.py - Student routes → Student workflows: delegates to
backend/app/routes/student.py - Drive routes → Student workflows: gets approved drives
backend/app/routes/drives.py - Company routes → Company workflows: delegates to
backend/app/routes/company.py - Admin routes → Admin management: delegates to
backend/app/routes/admin.py - Student routes → Validation and serialization: serializes inputs
backend/app/routes/student.py - Company routes → Validation and serialization: serializes inputs
backend/app/routes/company.py - Admin routes → Validation and serialization: serializes results
backend/app/routes/admin.py - Application routes → Validation and serialization: serializes application
backend/app/routes/applications.py - Application routes → Recruitment records: loads application
backend/app/routes/applications.py - Application routes → API responses: returns response
backend/app/routes/applications.py - Student workflows → Recruitment records: reads and writes
backend/app/services/student_service.py - Company workflows → Recruitment records: reads and writes
backend/app/services/company_service.py - Admin management → Recruitment records: reads and writes
backend/app/services/admin_service.py - Recruitment records → SQL database: persists records
README.md - Student workflows → Redis cache: caches drives
backend/app/services/student_service.py - Company workflows → Redis cache: caches company drives
backend/app/services/company_service.py - Admin management → Redis cache: caches admin queries
backend/app/services/admin_service.py - Celery task setup → Interview reminders: runs jobs
backend/app/tasks/reminders.py - Celery task setup → Reports and exports: runs jobs
backend/app/tasks/reminders.py - Interview reminders → Recruitment records: reads schedules
backend/app/tasks/reminders.py - Reports and exports → SQL database: generates reports