Author: Kudzai P Matizirofa
EMP - Employment Management System
EMP is an Employment Management System designed to streamline the management of employees, projects, and tasks within an organization. This system facilitates CRUD (Create, Read, Update, Delete) operations for employees and projects, enables task management, and provides functionalities to monitor and export employee performance. The system features a robust backend powered by Spring Boot, a dynamic frontend built with Angular, and uses PostgreSQL as its database.
The primary objectives of the EMP project are:
- Manage Employees: Perform CRUD operations on employee records.
- Manage Projects: Create, update, and manage project details.
- Manage Tasks: Track and update tasks associated with projects and employees.
- Monitor Performance: Analyze and export reports related to employee performance.
The project is organized into two main folders:
emp_frontend
: Contains the Angular application for the frontend interface.emp_backend
: Contains the Spring Boot application for the backend services.
To get started with the project, follow these instructions for setting up the frontend and backend components:
- Navigate to the
emp_frontend
directory. - Install the required dependencies:
npm install
- Run the Angular application:
ng serve
- Open your browser and go to
http://localhost:4200
to view the application.
- Navigate to the
emp_backend
directory. - Build and run the Spring Boot application:
./mvnw spring-boot:run
- The backend server will start on
http://localhost:8080
.
If you want to contribute to or update the project, follow these guidelines:
- Fork the Repository: Create a personal fork of the repository on GitHub.
- Clone Your Fork: Clone the forked repository to your local machine.
git clone https://github.com/kudzaiprichard/employee-management-system.git
- Create a Branch: Create a new branch for your changes.
git checkout -b feature/your-feature
- Make Changes: Implement your changes in the appropriate directory (frontend or backend).
- Commit Changes: Commit your changes with a descriptive message.
git add . git commit -m "Add a descriptive message about your changes"
- Push Changes: Push your changes to your forked repository.
git push origin feature/your-feature
- Create a Pull Request: Open a pull request from your forked repository to the main repository and describe your changes.
For a visual demonstration of the application, refer to the following screenshots and GIFs showcasing the app's features:
- Screenshot 1: Employee Management
- Screenshot 2: Project Management
- Screenshot 3: Project Management
- Screenshot 4: Project Management
For more details, visit the following README files in the respective project folders:
- Frontend README: Detailed information about the Angular frontend setup and usage.
- Backend README: Detailed information about the Spring Boot backend setup and usage.
Feel free to explore and contribute to the project!