An open API service indexing awesome lists of open source software.

https://github.com/nishit3/prostaff

Employee / Human Resource Management System
https://github.com/nishit3/prostaff

admin-server angular attendance-management employee-management-system ems eureka-registry hrms human-resource-management-system leave-management leave-request-management mysql razorpay-api salary-management spring-boot spring-gateway spring-scheduler springboot-microservices

Last synced: 3 months ago
JSON representation

Employee / Human Resource Management System

Awesome Lists containing this project

README

          

# ProStaff โ€“ Enterprise HR / Employee Management System

ProStaff is a full-fledged **Human Resource Management System (HRMS)** designed with a microservices architecture using **Java Spring Boot**, **Angular**, and **MySQL**. It supports employee onboarding, department/team structuring, leave tracking, payslip generation, Razorpay-based salary payments, and admin-level control with a scalable, cloud-ready structure.

> โš™๏ธ Built to simulate real-world enterprise-grade HR solutions, focusing on modularity, scalability, and payment integration.

---

## ๐Ÿ“Œ Features

### ๐Ÿ‘จโ€๐Ÿ’ผ HR & Employee Management
- Add, update, and manage employees
- Role-based access control (Admin/HR, Employee)
- Department, Designation & team assignment

### ๐Ÿ“„ Leave & Attendance Tracking
- Leave application and approval system
- Attendance status updates

### ๐Ÿ’ณ Salary Management
- Razorpay payment integration with real-time status tracking
- Track salary payment history

### ๐Ÿงฉ Microservices Architecture
- Modular services:
- `attendance-service`
- `department-service`
- `designation-service`
- `employee-service`
- `leave-request-service`
- `gateway-service`
- `admin-manager-service`
- `organization-service`
- `notification-service`
- `team-service`
- `auth-service`
- `salary-service`
- `admin-logger-service`
- `registry-service` (Spring Cloud Eureka)

---

## ๐Ÿงฐ Tech Stack

| Layer | Technology |
|-------|------------|
| Frontend | Angular, TypeScript, Bootstrap |
| Backend | Java, Spring Boot, Spring Cloud (Eureka, Gateway) |
| Database | MySQL |
| Payment Integration | Razorpay |
| Cloud Support | AWS-ready (EC2/RDS/DynamoDB integration possible) |
| Scheduler | Spring Scheduler |
| Auth | JWT-based authentication and authorization |

---

## ๐Ÿ—๏ธ Architecture

- Gateway Service โ†’ Central routing and entry point
- Eureka Discovery โ†’ Dynamic registration and discovery of microservices
- Angular Frontend โ†’ Consumes backend APIs via Gateway
- Razorpay Integration โ†’ Connected to the backend for secure payments

---

## ๐Ÿš€ Getting Started

### ๐Ÿ”ง Prerequisites
- JDK 17+
- Node.js 18+
- MySQL 8+
- Maven
- Angular CLI
- (Optional) Docker & Docker Compose

### ๐Ÿงช Running Locally

1. **Clone the repo**
```bash
git clone https://github.com/nishit3/ProStaff.git
cd ProStaff

Class Diagram:-
![image](https://github.com/user-attachments/assets/7c88b114-f055-427f-8b7a-ab51dbfa8558)

Admin Use Case Diagram:
![image](https://github.com/user-attachments/assets/b7622a2e-e918-4fca-9a55-78ec507e5009)

Employee Use Case Diagram:
![image](https://github.com/user-attachments/assets/60039d70-5a19-4ab8-ae23-1029a9c83048)

Employee Activity Diagram:
![image](https://github.com/user-attachments/assets/1e63604e-5a04-4aa0-a9cf-3e2214b74047)

Admin Activity Diagram:
![image](https://github.com/user-attachments/assets/8c12c54c-8ec2-4f10-be28-84fc62344823)

All Sequence Diagram:-

Register Organization:-
![image](https://github.com/user-attachments/assets/b97232b7-ea68-47e5-b3b6-590c0ce1fc93)

Add Admin :-
![image](https://github.com/user-attachments/assets/c91444c3-2690-4605-8c48-76b89f1564ce)

Add Organization Fund:-
![image](https://github.com/user-attachments/assets/444c678c-2873-4cf1-a067-78a097593c98)

Grant Request:-
![image](https://github.com/user-attachments/assets/7742c0cd-9676-4b1d-9271-fbf23d95fed3)

Deny Request :-
![image](https://github.com/user-attachments/assets/1e5a050b-ec2d-4170-83ba-b7eb8699e5e6)

Add Employee :-
![image](https://github.com/user-attachments/assets/74cbc30c-3e51-4ffd-932b-a651a3a7dc36)

Add Notification:-
![image](https://github.com/user-attachments/assets/b35b8d4f-c300-4dcf-a8b8-8bf8b069e8d4)

Add Department:-
![image](https://github.com/user-attachments/assets/f24a316b-f6e2-4dc6-8a5e-1cb39a781859)

Add Teams:-
![image](https://github.com/user-attachments/assets/7ea5c5f6-fb2f-41bb-86c1-530a5c098973)

Add Designation:-
![image](https://github.com/user-attachments/assets/795b7101-3602-44bf-b9ab-09abbe1f95c9)

Add Up-Coming Event:-
![image](https://github.com/user-attachments/assets/c0ad9c35-2a27-4e05-b95d-d7d7e502f812)

Add FAQ:-
![image](https://github.com/user-attachments/assets/5135490b-cf60-4b01-97ef-8ea2cb542466)

Add Holiday:-
![image](https://github.com/user-attachments/assets/e26933e8-2f4a-4743-bdd6-fd7ea7b08383)

Remove Holiday:-
![image](https://github.com/user-attachments/assets/1dbafb26-b93c-4a80-96f8-84a07aca1959)

Salary Rollout:-
![image](https://github.com/user-attachments/assets/ecf11b66-85cd-4601-90ad-a94a87116997)

Login:-
![image](https://github.com/user-attachments/assets/ddd85ef1-c6b4-4809-a138-6c1aee997c39)

Register Organization:-
![image](https://github.com/user-attachments/assets/a2b451d4-edc0-47b3-a8d7-e0d3c42132ca)

Employee Request Leave:-
![image](https://github.com/user-attachments/assets/11a82c7a-b84c-43d8-a869-9e130edce944)

Employee Reset Password:-
![image](https://github.com/user-attachments/assets/3c871c21-8c6c-4fbd-b963-ca068e9ccb79)

Employee Check-In:-
![image](https://github.com/user-attachments/assets/7d007e7c-b28a-40d6-b7e4-71837f1852eb)

Employee Check-out:-
![image](https://github.com/user-attachments/assets/25f43754-66f3-4bab-afb6-f9318adcdd01)