https://github.com/yashkolte/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.
https://github.com/yashkolte/bell-curve-performance-appraisal
Last synced: 2 months ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/yashkolte/bell-curve-performance-appraisal
- Owner: yashkolte
- License: mit
- Created: 2024-12-23T11:48:20.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-01-19T10:20:27.000Z (5 months ago)
- Last Synced: 2025-01-19T11:25:37.468Z (5 months ago)
- Language: TypeScript
- Size: 178 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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)](#backend-spring-boot)
- [Frontend (Next.js)](#frontend-nextjs)
- [Installation Instructions](#installation-instructions)
- [Backend Setup](#backend-setup)
- [Frontend Setup](#frontend-setup)
- [Running the Application](#running-the-application)
- [API Endpoints](#api-endpoints)
- [Environment Variables](#environment-variables)
- [Technologies Used](#technologies-used)
- [License](#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:
```bash
git clone
cd
```
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:
```bash
mvn clean install
```
4. **Configure `application.properties`**:
Create or update the `src/main/resources/application.properties` file with the following settings:
```properties
# 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:
```bash
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:
```bash
git clone
cd
```
2. **Install dependencies**:
- Install the required packages:
```bash
npm install
```
3. **Run the application**:
- Start the Next.js development server:
```bash
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):
```bash
mvn spring-boot:run
```
2. **Start the frontend** (Next.js):
```bash
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](LICENSE) file for details.