Talentra-Smart Student campus placement project

Talentra — Installation Guide

Prerequisites

Make sure you have the following installed before starting:

• Java JDK 17 or higher
• Node.js 18 or higher
• MySQL 8.0 or higher
• Maven 3.8 or higher

Step 1 — Extract the Zip File

• Right click on talentra.zip
• Click Extract Here or Extract to talentra/
• Open the extracted folder — you will see two folders inside:

talentra/
├── backend/
└── frontend/

Step 2 — Database Setup

1. Open MySQL and create the database:

sql

CREATE DATABASE talentra_db;

2. Navigate to:

backend/src/main/resources/application.properties

3. Update these lines with your MySQL credentials:

properties

spring.datasource.url=jdbc:mysql://localhost:3306/talentra_db
spring.datasource.username=your_mysql_username
spring.datasource.password=your_mysql_password
spring.jpa.hibernate.ddl-auto=update

Step 3 — Add Your OpenAI API Key

In the same application.properties file, find and update:

properties

openai.api.key=your_openai_api_key_here

Get your API key from platform.openai.com

Step 4 — Run the Backend

Open a terminal inside the backend/ folder and run:

bash

mvn clean install
mvn spring-boot:run

Backend will start at http://localhost:8080

Step 5 — Run the Frontend

Open a new terminal inside the frontend/ folder and run:

bash

npm install
npm start

Frontend will start at http://localhost:3000

Step 6 — Open in Browser

Once both are running, open your browser and go to:

http://localhost:3000

Step 7 — Default Login Credentials

RoleEmailPasswordAdminadmin@talentra.comadmin123Companycompany@talentra.comcompany123Studentstudent@talentra.comstudent123

⚠️ Change all passwords immediately after first login.

Step 8 — Verify Everything Works

• ✅ Backend running at http://localhost:8080
• ✅ Frontend running at http://localhost:3000
• ✅ MySQL connected successfully
• ✅ All three role logins working
• ✅ AI resume scoring working

Common Errors & Fixes

❌ Backend not starting

• Make sure JDK 17 is installed — check with java -version
• Make sure Maven is installed — check with mvn -version

❌ MySQL connection refused

• Make sure MySQL service is running
• Double check username and password in application.properties

❌ npm install fails

bash

npm cache clean --force
npm install

❌ Port 8080 already in use

bash

# Windows
netstat -ano | findstr :8080
taskkill /PID <PID> /F

# Mac/Linux
lsof -i :8080
kill -9 <PID>

❌ OpenAI not responding

• Check your API key is correct in application.properties
• Make sure you have credits on your OpenAI account

Need Help?

If you face any issue, contact via the platform you purchased from and share:

• The exact error message
• Which step you are stuck on

Talentra — Usage Instructions

Getting Started

Once the app is running at http://localhost:3000, you will land on the Login Page. Use your role credentials to log in. Each role has a completely separate dashboard and set of features.

👨‍🎓 Student — How to Use

1. Register / Login

• Click Register on the login page
• Fill in your details — name, email, password, branch, year
• Login with your credentials

2. Browse Placement Drives

• Go to Drives section from the sidebar
• View all active job openings posted by companies
• Check eligibility criteria, CTC, role, and deadline

3. Apply for a Drive

• Click on any drive to open its details
• Click Apply Now
• Your application is submitted instantly

4. AI Resume Scoring

• Go to Resume section
• Upload your resume (PDF)
• AI will analyze it against job requirements and give you a score with feedback
• Use the feedback to improve your resume

5. Track Application Status

• Go to My Applications
• See real-time status — Applied, Shortlisted, Selected, or Rejected

6. Download Offer Letter

• Once selected, go to My Applications
• Click Download Offer Letter
• A professionally formatted PDF will download instantly

7. Notifications

• Check the Notifications bell icon
• You will only receive alerts relevant to your profile and eligibility

🏢 Company — How to Use

1. Register / Login

• Click Register as Company on the login page
• Fill in company name, email, password, and details
• Wait for Admin approval before you can post drives

2. Post a Placement Drive

• Go to Post Drive from the sidebar
• Fill in job title, description, eligibility criteria, CTC, location, and deadline
• Click Submit — students will be notified automatically

3. View Applications

• Go to Applications section
• See all students who applied for your drives
• View their profile, resume, and AI score

4. Shortlist Candidates

• Click on any applicant
• Click Shortlist to move them to the next round
• Student gets notified automatically

5. Select / Reject Candidates

• After interviews, go to Shortlisted tab
• Click Select or Reject for each candidate
• Selected students automatically receive their offer letter PDF

6. Manage Your Drives

• Go to My Drives
• View, edit, or close any of your active drives anytime

🛡️ Admin — How to Use

1. Login

• Use admin credentials to log in
• You will land directly on the Admin Dashboard

2. Dashboard Overview

• See real-time stats — total students, companies, active drives, placements
• Quick summary of recent activity

3. Approve Companies

• Go to Companies section
• See all newly registered companies with status Pending
• Click Approve to activate them or Reject to decline
• Company receives a notification after approval

4. Manage Students

• Go to Students section
• View all registered students with their details
• Search and filter by branch, year, or placement status

5. Send Smart Notifications

• Go to Notifications section
• Write your message
• Add keywords to target specific students — example: CSE, 2025, CGPA > 7
• Click Send — only matching students receive the alert

6. Monitor Placements

• Go to Analytics section
• View placement rate, top hiring companies, branch-wise stats
• Export reports as needed

7. Manage Drives

• View all active and closed drives across all companies
• Step in to close or remove any drive if needed

💡 Tips for Best Experience

• Always use Google Chrome or Microsoft Edge for best compatibility
• Make sure both backend and frontend are running before using the app
• Students should upload resumes in PDF format only
• Admin should approve companies before they can post any drives
• Keep your OpenAI API key active and funded for AI features to work

Talentra — System Requirements

Minimum System Requirements

ComponentMinimumOSWindows 10 / macOS 11 / Ubuntu 20.04RAM4 GBStorage2 GB free spaceProcessorIntel Core i3 or equivalentInternetRequired (for AI features)

Recommended System Requirements

ComponentRecommendedOSWindows 11 / macOS 13 / Ubuntu 22.04RAM8 GB or higherStorage5 GB free spaceProcessorIntel Core i5 / i7 or equivalentInternetStable broadband connection

Required Software

1. Java Development Kit (JDK)

• Version — JDK 17 or higher
• Download — https://www.oracle.com/java/technologies/downloads/
• Check if installed —

bash

java -version

2. Node.js

• Version — 18.x or higher
• Download — https://nodejs.org/
• Check if installed —

bash

node -v
npm -v

3. Maven

• Version — 3.8 or higher
• Download — https://maven.apache.org/download.cgi
• Check if installed —

bash

mvn -version

4. MySQL

• Version — 8.0 or higher
• Download — https://dev.mysql.com/downloads/installer/
• Check if installed —

bash

mysql --version

5. Browser

• Google Chrome 110 or higher ✅ (Recommended)
• Microsoft Edge 110 or higher ✅
• Mozilla Firefox 110 or higher ✅
• Safari 15 or higher ✅

Required Accounts & Keys

1. OpenAI API Key

• Required for AI resume scoring feature
• Create account at platform.openai.com
• Go to API Keys section and generate a key
• Make sure your account has active credits

2. MySQL Account

• Local MySQL username and password
• Required during installation setup

Port Requirements

Make sure these ports are free and not blocked by firewall:

PortUsed For8080Spring Boot Backend3000React Frontend3306MySQL Database

Internet Requirements

FeatureInternet NeededAI Resume Scoring✅ Yes (OpenAI API call)Smart Notifications❌ No (works locally)PDF Generation❌ No (works locally)Login & Dashboard❌ No (works locally)Placement Analytics❌ No (works locally)

OS Specific Notes

Windows

• Run terminal as Administrator when installing Maven and JDK
• Make sure JAVA_HOME environment variable is set correctly

bash

# Set JAVA_HOME (example)
setx JAVA_HOME "C:\Program Files\Java\jdk-17"

macOS

• Use Homebrew for easy installation

bash

brew install openjdk@17
brew install node
brew install maven
brew install mysql

Linux (Ubuntu)

bash

sudo apt update
sudo apt install openjdk-17-jdk
sudo apt install nodejs npm
sudo apt install maven
sudo apt install mysql-server

Quick Checklist Before Installation

• ☐ JDK 17+ installed
• ☐ Node.js 18+ installed
• ☐ Maven 3.8+ installed
• ☐ MySQL 8.0+ installed and running
• ☐ Port 8080, 3000, 3306 are free
• ☐ OpenAI API key ready
• ☐ Minimum 4 GB RAM available
• ☐ Minimum 2 GB free storage