This is an HRMS module for an ERP system. The module provides opportunities or HR department to manage employees and vacancies of the company. Such as view the list of all employees with using filters, for example view a list of employees of a particular department. Create, delete or edit employee record in the system. Manage the company position, such as create, update or delete the job offers. Manage payrolls of employee.
The system is primarily designed to properly organize the work of the department, speed up the processes of hiring employees or opening vacancies necessary for the company.
In this project, only the backend of the system is going to be implemented, although the frontend is included in the design to describe the entire system.
- First, install Java on your system.
- Install the latest maven dependency manager.
- Install mysql.
- Update all spring boot configurations inside resources folder in /src/main/resources/application.properties file according to your own system configurations.
- mvn spring-boot:run
- Run migrations.sql file in the database.
Run the eureka -> gateway -> auth -> db-service -> [employee, payroll, position, recruitment]. Go to individual subdirectories and run mvn spring-boot:run
Each service is a separate microservice.
Eureka: server, all the other services register to it.
Gateway: entry point for other services. Protects other routes and validates tokens.
Auth: authentication server, used for signing up and issuing tokens.
Employee: employee service.
So, you should register with Auth first, request a token, and use it for every request for which you need to be authenticated.
Every request will hit the Gateway first, if need be, it will validate the token and grant you access to the service.
POST http://localhost:8762/auth/signup
{
"firstName": "Kaushik",
"lastName": "Samanta",
"dateOfBirth": "24-08-1994",
"hiringDate": "15-12-2016",
"province": "QUEBEC",
"postalCode": "H3H1P4",
"username" : "kaushik23",
"email": "kaushiksamanta23@gmail.com",
"password": "1234567890"
}
POST http://localhost:8762/auth/login
{
"username" : "kaushik23",
"password" : "1234567890"
}
To get the token, look at the Headers tab in Postman, take the value of the Bearer key.
Later, when you need to authenticate for a service, use the token and put it in the "Authorization" tab of Postman, then select Bearer token as Type.
GET http://localhost:8762/employee/
[
{
"createdAt": "2018-11-19T00:31:58.000+0000",
"updatedAt": "2018-11-19T00:31:58.000+0000",
"id": 1,
"firstName": "Kaushik",
"lastName": "Samanta",
"dateOfBirth": "24-08-1994",
"hiringDate": "15-12-2017",
"province": "QUEBEC",
"postalCode": "H3H1P4",
"username": "kaushik23",
"email": "kaushiksamanta23@gmail.com",
"password": "$2a$10$dWJThXJxkp69MYzfSmu.O.qWm7IomNIckZK5MSGNDivlSW7j5ppuq",
"roles": [
{
"id": 1,
"name": "ROLE_EMPLOYEE"
}
],
"jobpostings": []
},
{
"createdAt": "2018-11-25T20:22:57.000+0000",
"updatedAt": "2018-11-25T20:22:57.000+0000",
"id": 2,
"firstName": "Kaushik",
"lastName": "Samanta",
"dateOfBirth": "24-08-1994",
"hiringDate": "15-12-2016",
"province": "QUEBEC",
"postalCode": "H3H1P4",
"username": "kaushik233",
"email": "kaushiksamanta233@gmail.com",
"password": "$2a$10$/i0rg7WxVZJC3cvQzKPZ4e2ZR0rjRa3iWKVujvcGHHEs179NOkefq",
"roles": [
{
"id": 1,
"name": "ROLE_EMPLOYEE"
}
],
"jobpostings": []
}
]
GET http://localhost:8762/employee/1
{
"createdAt": "2018-11-19T00:31:58.000+0000",
"updatedAt": "2018-11-19T00:31:58.000+0000",
"id": 1,
"firstName": "Kaushik",
"lastName": "Samanta",
"dateOfBirth": "24-08-1994",
"hiringDate": "15-12-2017",
"province": "QUEBEC",
"postalCode": "H3H1P4",
"username": "kaushik23",
"email": "kaushiksamanta23@gmail.com",
"password": "$2a$10$dWJThXJxkp69MYzfSmu.O.qWm7IomNIckZK5MSGNDivlSW7j5ppuq",
"roles": [
{
"id": 1,
"name": "ROLE_EMPLOYEE"
}
],
"jobpostings": []
}
[
{
"id": 1,
"minSalary": 50000,
"maxSalary": 10000,
"applicationStatus": "OPEN",
"jobDescription": "CEO",
"noOfOpenings": "3",
"contractType": "test",
"contractPeriod": 6
},
]
POST http://localhost:8762/job
{
"minSalary": "50000",
"maxSalary": "10000",
"jobDescription": "CEO",
"noOfOpenings": "3",
"contractType": "test",
"contractPeriod": "6",
"applicationStatus": "OPEN"
}
PUT http://localhost:8762/job/1
{
"minSalary": "50000",
"maxSalary": "10000",
"jobDescription": "CEO",
"noOfOpenings": "1",
"contractType": "test",
"contractPeriod": "6",
"applicationStatus": "OPEN"
}
GET http://localhost:8762/job/1
GET http://localhost:8762/job/status/OPEN
http://localhost:8762/job/status/CLOSED
GET http://localhost:8762/job/description/CEO
DELETE http://localhost:8762/job/1
GET http://localhost:8762/job/applicant
POST http://localhost:8762/job/applicant
{
"firstName": "Adrien",
"lastName": "Poupa",
"email": "adrien@poupa.fr",
"status": "OPEN"
}
GET http://localhost:8762/job/applicant/1
PUT http://localhost:8762/job/applicant/1
{
"firstName": "Adrien",
"lastName": "Poupa",
"email": "adrien@poupa.fr",
"status": "CLOSED"
}
DELETE http://localhost:8762/job/applicant/1
GET http://localhost:8762/job/application
POST http://localhost:8762/job/application
{
"applicantId": 1,
"jobPostingId": 1
}
GET http://localhost:8762/job/application/applicant/1
GET http://localhost:8762/job/application/job/1
DELETE http://localhost:8762/job/application
{
"applicantId": 9,
"jobPostingId": 2
}
GET http://localhost:8762/position/
[
{
"id": 0,
"createdAt":"2018-11-27T00:35:58.000+0000",
"updatedAt":"2018-11-27T00:35:58.000+0000",
"designation": "designation",
"departmentName": "HR",
"startDate": "2014-12-12T00:31:58.000+0000",
"endDate": "2016-10-26T00:31:58.000+0000",
"employee": 1
},
{
"id": 1,
"createdAt":"2018-11-27T00:31:58.000+0000",
"updatedAt":"2018-11-27T00:31:58.000+0000",
"designation": "designation",
"departmentName": "IT",
"startDate": "2014-10-10T00:31:58.000+0000",
"endDate": "2016-05-06T00:31:58.000+0000",
"employee": 2
}
]
GET http://localhost:8762/position/1
{
"id": 1,
"createdAt":"2018-11-27T00:31:58.000+0000",
"updatedAt":"2018-11-27T00:31:58.000+0000",
"designation": "designation",
"departmentName": "IT",
"startDate": "2014-10-10T00:31:58.000+0000",
"endDate": "2016-05-06T00:31:58.000+0000",
"employee": 1
}
DELETE http://localhost:8762/position/1
{
"message": "Position deleted successfully."
}
POST http://localhost:8762/position/
{
"designation": "designation",
"departmentName": "IT",
"startDate": "2014-10-10",
"endDate": "2016-05-06",
"employee": 1
}
PUT http://localhost:8762/position/1
{
"designation": "designation",
"departmentName": "HR",
"startDate": "2014-10-10",
"endDate": "2016-05-06",
"employee": 1
}