How sathwik1821/placement-readiness-system works
This is a full-stack student placement-readiness and campus-recruitment system. Students take category-based assessments, receive readiness and skill-gap analysis, practice mock interviews, and explore jobs and placement drives; officers manage drives and application stages, while recruiters review candidates and administrators govern users and questions. React routes role-specific portals and sends requests through Axios to a Spring REST backend, whose controllers implement the domain workflows over JPA-backed data. The README documents several capabilities whose specific implementation paths were not sampled, so those subsystem links are shown as unverified rather than asserted calls.
Main entry points: PlacementSystemApplication.java Spring REST API · App.jsx Role-based SPA · axios.js HTTP client · AnalysisController.java Readiness analysis
Components 24
Web experience
- Role-based SPA
frontend/src/App.jsx - Auth state
frontend/src/store/authStore.js - HTTP client
frontend/src/api/axios.js - Student portal
frontend/src/pages/student - Officer portal
frontend/src/pages/officer - Recruiter portal
frontend/src/pages/company/CompanyDashboard.jsx - Admin portal
frontend/src/pages/admin/AdminDashboard.jsx - Jobs and placement
frontend/src/pages/student
Student readiness
- Assessments
backend/src/main/java/com/placement/system/controller/AssessmentController.java - Readiness analysis
backend/src/main/java/com/placement/system/controller/AnalysisController.java - Mock interviews
backend/src/main/java/com/placement/system/controller/InterviewController.java - Learning paths
backend/src/main/java/com/placement/system/model/LearningRecommendation.java - Student records
backend/src/main/java/com/placement/system/model/Student.java
Recruitment operations
- Placement workflow
backend/src/main/java/com/placement/system/controller/PlacementController.java - Drive management
backend/src/main/java/com/placement/system/controller/OfficerController.java - Recruiter operations
backend/src/main/java/com/placement/system/controller/CompanyController.java - System governance
backend/src/main/java/com/placement/system/controller/AdminController.java
Backend platform
- Domain records
backend/src/main/java/com/placement/system/model - JPA repositories
backend/src/main/java/com/placement/system/repository - Authentication API
backend/src/main/java/com/placement/system/controller/AuthController.java - JWT service
backend/src/main/java/com/placement/system/service/JwtService.java - Spring REST API
backend/src/main/java/com/placement/system/PlacementSystemApplication.java - Persistent database
Other components
- Portal users
Connections 30
- Portal users → Role-based SPA: use portals
README.md - Role-based SPA → Auth state: checks roles
frontend/src/App.jsx - Role-based SPA → Student portal: routes students
frontend/src/App.jsx - Role-based SPA → Officer portal: routes officers
frontend/src/App.jsx - Role-based SPA → Recruiter portal: routes recruiters
frontend/src/App.jsx - Role-based SPA → Admin portal: routes admins
frontend/src/App.jsx - Student portal → HTTP client: requests data
frontend/src/pages/student/MockInterview.jsx - Officer portal → HTTP client: requests data
frontend/src/pages/officer/Applications.jsx - Recruiter portal → HTTP client: requests data
frontend/src/pages/company/CompanyDashboard.jsx - Admin portal → HTTP client: requests data
frontend/src/pages/admin/AdminDashboard.jsx - HTTP client → Spring REST API: calls REST API
frontend/src/api/axios.js - Spring REST API → Assessments: serves assessments
- Spring REST API → Readiness analysis: serves analysis
- Spring REST API → Mock interviews: serves interviews
- Spring REST API → Placement workflow: serves placement
- Spring REST API → Drive management: serves drive operations
- Spring REST API → Recruiter operations: serves recruiter portal
- Spring REST API → System governance: serves governance
- Spring REST API → Authentication API: serves authentication
- Authentication API → JWT service: issues tokens
- Assessments → Readiness analysis: scores inform
- Readiness analysis → Learning paths: maps skill gaps
backend/src/main/java/com/placement/system/controller/AnalysisController.java - Readiness analysis → Student records: reads academics
backend/src/main/java/com/placement/system/controller/AnalysisController.java - Mock interviews → Domain records: stores session data
backend/src/main/java/com/placement/system/controller/InterviewController.java - Placement workflow → Drive management: coordinates applications
- Recruiter operations → Domain records: reads and updates
backend/src/main/java/com/placement/system/controller/CompanyController.java - Domain records → JPA repositories: persisted through
backend/src/main/java/com/placement/system/repository/MockInterviewSessionRepository.java - JPA repositories → Persistent database: read and write
- Drive management → Jobs and placement: publishes opportunities
- Portal users → Jobs and placement: browse opportunities
README.md