Bell Curve Performance Appraisal

This project is a web application for analyzing employee performance data using the Bell Curve methodology. The application includes a backend powered by Spring Boot for handling API requests and a frontend built with Next.js for the user interface.

Table of Contents

• Backend (Spring Boot)
• Frontend (Next.js)
• Installation Instructions
  • Backend Setup
  • Frontend Setup
• Running the Application
• API Endpoints
• Environment Variables
• Technologies Used
• License

Backend (Spring Boot)

The backend is built with Spring Boot and provides API endpoints to handle employee data, perform the Bell Curve analysis, and suggest performance adjustments.

Requirements

• Java 17 or higher
• Maven
• MySQL database (or another RDBMS)

Backend Setup

1. Clone the repository:

   git clone <repository-url>
   cd <project-folder>

2. Set up MySQL database:

   • Create a MySQL database (e.g., assignment).
   • Update application.properties with your database credentials.

3. Install dependencies:

   • If you haven't installed Maven, you can install it globally or use the Maven wrapper:

     mvn clean install

4. Configure application.properties: Create or update the src/main/resources/application.properties file with the following settings:

   # Replace Username & Password with actual credential
   
   # Database connection details
   # URL to connect to the MySQL database named 'assignment'
   spring.datasource.url=jdbc:mysql://localhost:3306/assignment
   # Username for the database connection
   spring.datasource.username=your_username
   # Password for the database connection
   spring.datasource.password=your_password

5. Run the application:

   • Start the Spring Boot application:

     mvn spring-boot:run

   • The backend will be available at http://localhost:8080.

API Endpoints

• GET /api/bell-curve/analyze: Get the Bell Curve analysis results (actual percentages, deviation, and suggested adjustments).
• POST /api/bell-curve/add: Add a new employee.
• POST /api/bell-curve/add-all: Add multiple employees.
• GET /api/bell-curve/employees: Get a list of all employees.

Frontend (Next.js)

The frontend is built with Next.js and provides a user interface for adding employees and viewing the Bell Curve analysis.

Requirements

• Node.js (version 16 or higher)
• npm (Node package manager)

Frontend Setup

1. Clone the repository:

   git clone <repository-url>
   cd <frontend-folder>

2. Install dependencies:

   • Install the required packages:

     npm install

3. Run the application:

   • Start the Next.js development server:

     npm run dev

   • The frontend will be available at http://localhost:3000.

Running the Application

To run the application locally, follow these steps:

1. Start the backend (Spring Boot):

   mvn spring-boot:run

2. Start the frontend (Next.js):

   npm run dev

Now, you can access the application at http://localhost:3000 and interact with the Bell Curve performance appraisal system.

Environment Variables

Backend

In the backend, you need to configure the following environment variables in application.properties:

• spring.datasource.url: Database URL
• spring.datasource.username: Database username
• spring.datasource.password: Database password

Technologies Used

• Backend:

  • Spring Boot
  • MySQL
  • Hibernate
  • RESTful API
  • Java 17

• Frontend:

  • Next.js
  • React
  • TailwindCSS
  • Shadcn
  • Zod (for form validation)
  • Axios / Fetch API (for making HTTP requests)

License

This project is licensed under the MIT License - see the LICENSE file for details.