A full-stack web application for connecting employers with employees. Employers can post job opportunities, and employees can browse and apply for jobs.

• Java 17 with Javalin (lightweight web framework)
• Hibernate ORM for database operations
• MySQL database
• JWT (JSON Web Tokens) for authentication
• BCrypt for password hashing
• Maven for dependency management

• React 18 with functional components and hooks
• React Router for navigation
• Axios for API calls
• CSS for styling

job-platform/
├── backend/
│   ├── src/
│   │   ├── main/
│   │   │   ├── java/com/jobplatform/
│   │   │   │   ├── controller/     # API controllers
│   │   │   │   ├── dao/            # Data Access Objects
│   │   │   │   ├── dto/            # Data Transfer Objects
│   │   │   │   ├── model/          # Entity models
│   │   │   │   ├── util/           # Utility classes
│   │   │   │   └── App.java        # Main application
│   │   │   └── resources/
│   │   │       ├── hibernate.cfg.xml
│   │   │       └── schema.sql
│   └── pom.xml
└── frontend/
    ├── public/
    ├── src/
    │   ├── components/          # Reusable components
    │   ├── context/            # React context
    │   ├── pages/              # Page components
    │   ├── services/           # API services
    │   ├── App.js
    │   └── index.js
    └── package.json

• Java 17 or higher
• Maven 3.6+
• MySQL 8.0+
• Node.js 16+ and npm

1. Start your MySQL server

2. Create the database:

CREATE DATABASE job_platform_db;

3. Run the schema script located at backend/src/main/resources/schema.sql or let Hibernate create the tables automatically.

4. Update database credentials in backend/src/main/resources/hibernate.cfg.xml:

<property name="hibernate.connection.username">your_username</property>
<property name="hibernate.connection.password">your_password</property>

1. Navigate to the backend directory:

cd backend

2. Install dependencies and build:

mvn clean install

3. Run the application:

mvn exec:java -Dexec.mainClass="com.jobplatform.App"

The backend server will start on http://localhost:7070

1. Navigate to the frontend directory:

cd frontend

2. Install dependencies:

npm install

3. Start the development server:

npm start

The frontend will start on http://localhost:3000

POST /api/auth/register
Content-Type: application/json

{
  "name": "John Doe",
  "email": "john@example.com",
  "password": "password123",
  "role": "EMPLOYEE"  // or "EMPLOYER"
}

Response: 201 Created
{
  "token": "jwt-token",
  "userId": 1,
  "name": "John Doe",
  "email": "john@example.com",
  "role": "EMPLOYEE"
}

POST /api/auth/login
Content-Type: application/json

{
  "email": "john@example.com",
  "password": "password123"
}

Response: 200 OK
{
  "token": "jwt-token",
  "userId": 1,
  "name": "John Doe",
  "email": "john@example.com",
  "role": "EMPLOYEE"
}

GET /api/jobs

Response: 200 OK
[
  {
    "id": 1,
    "title": "Software Developer",
    "description": "Looking for a skilled developer...",
    "pay": 75000.00,
    "location": "New York, NY",
    "category": "Technology",
    "status": "OPEN",
    "employerId": 2,
    "employerName": "Tech Company",
    "employerEmail": "company@example.com",
    "createdAt": "2025-10-05T10:00:00"
  }
]

GET /api/jobs/{id}

Response: 200 OK
{
  "id": 1,
  "title": "Software Developer",
  ...
}

POST /api/jobs
Authorization: Bearer {token}
Content-Type: application/json

{
  "title": "Software Developer",
  "description": "Looking for a skilled developer...",
  "pay": 75000.00,
  "location": "New York, NY",
  "category": "Technology"
}

Response: 201 Created
{
  "id": 1,
  "title": "Software Developer",
  ...
}

PUT /api/jobs/{id}/assign
Authorization: Bearer {token}

Response: 200 OK
{
  "id": 1,
  "status": "ASSIGNED",
  ...
}

GET /api/users/{id}/jobs
Authorization: Bearer {token}

Response: 200 OK
[
  // For employers: jobs they posted
  // For employees: jobs they applied to
]

• ✅ Register and login as an employer
• ✅ Post new job opportunities with details
• ✅ View all posted jobs
• ✅ Track job status (Open, Assigned, Completed)

• ✅ Register and login as an employee
• ✅ Browse all available jobs
• ✅ View detailed job information
• ✅ Apply for jobs
• ✅ View applied jobs in dashboard

• ✅ JWT-based authentication
• ✅ Password hashing with BCrypt
• ✅ Protected API routes
• ✅ Role-based access control

• id (BIGINT, PK, AUTO_INCREMENT)
• name (VARCHAR(100))
• email (VARCHAR(100), UNIQUE)
• password (VARCHAR(255))
• role (ENUM: 'EMPLOYER', 'EMPLOYEE')
• created_at (TIMESTAMP)

• id (BIGINT, PK, AUTO_INCREMENT)
• title (VARCHAR(200))
• description (TEXT)
• pay (DECIMAL(10,2))
• location (VARCHAR(200))
• category (VARCHAR(100))
• employer_id (BIGINT, FK → users.id)
• status (ENUM: 'OPEN', 'ASSIGNED', 'COMPLETED')
• created_at (TIMESTAMP)

• id (BIGINT, PK, AUTO_INCREMENT)
• job_id (BIGINT, FK → jobs.id)
• employee_id (BIGINT, FK → users.id)
• status (ENUM: 'PENDING', 'ACCEPTED', 'COMPLETED')
• applied_at (TIMESTAMP)

• Port: 7070 (can be changed in App.java)
• JWT Secret: Change in JWTUtil.java for production
• Database: Configure in hibernate.cfg.xml

• API Base URL: Set in src/services/api.js
• Port: 3000 (default React port)

1. Start both backend and frontend servers
2. Navigate to http://localhost:3000
3. Register as an employer and post some jobs
4. Register as an employee and apply for jobs
5. Check the dashboards to see posted/applied jobs

1. Register with role "EMPLOYER"
2. Login to your account
3. Go to Dashboard
4. Click "Post New Job"
5. Fill in job details and submit
6. View your posted jobs in the dashboard

1. Register with role "EMPLOYEE"
2. Login to your account
3. Browse jobs from the Jobs page
4. Click on a job to view details
5. Click "Apply Now" to apply
6. View applied jobs in your dashboard

⚠️ Important for Production:

• Change the JWT secret key in JWTUtil.java
• Use environment variables for sensitive data
• Enable HTTPS
• Implement rate limiting
• Add input validation and sanitization
• Use proper error handling
• Implement refresh tokens
• Add CSRF protection

• Port already in use: Change the port in App.java
• Database connection failed: Check MySQL credentials in hibernate.cfg.xml
• Hibernate errors: Ensure database tables are created

• API calls failing: Check if backend is running on port 7070
• CORS errors: Ensure CORS is enabled in Javalin configuration
• Login not working: Check JWT token is being stored in localStorage

This project is open source and available for educational purposes.

Built as a demonstration of a full-stack Java + React application.