Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tiana-coker/employee-management-system
https://github.com/tiana-coker/employee-management-system
java spring-mvc thymeleaf-java thymeleaf-template-engine
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/tiana-coker/employee-management-system
- Owner: Tiana-Coker
- Created: 2024-06-23T03:58:43.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2024-06-24T17:05:37.000Z (7 months ago)
- Last Synced: 2024-11-06T20:25:28.786Z (3 months ago)
- Topics: java, spring-mvc, thymeleaf-java, thymeleaf-template-engine
- Language: HTML
- Homepage:
- Size: 45.9 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Employee Management System
## Description
This project is an Employee Management System built using Spring MVC and Thymeleaf. It provides different features for both employees and administrators to manage attendance, personal details, and leave requests.
## Features
### Employee Features
- **Login**: Employees can log in to their dashboard.
- **Dashboard**: Displays a welcome message with the employee's name.
- **My Profile**: Employees can view their personal details.
- **Mark Attendance**: Employees can mark their attendance using a form.
- **Request Leave**: Employees can submit a leave request using a form.
### Admin Features
- **Login**: Admin can log in to their dashboard.
- **Dashboard**: Shows a list of all employees, attendance records of each employee, and leave requests.
- **Manage Leave Requests**: Admin can approve or reject leave requests submitted by employees. The status of the request should be visible to employees.
## Color Scheme
- Dark Purple: `#20123A`
- Light Purple: `#b8adcc`
- Medium Purple: `#381280`
## Order of Creation
1. Model
2. Repository
3. Service
4. Controller
5. Templates
6. Configuration
## Dependencies
- **Spring Web MVC**: To build web applications including RESTful applications using Spring MVC.
- **Spring Data JPA**: To handle data persistence with ease.
- **MySQL Driver**: MySQL database connectivity.
- **Thymeleaf**: A modern server-side Java template engine for web and standalone environments.
- **Lombok**: A Java library that automatically plugs into your editor and build tools, spicing up your Java.
- **JDBC Driver**: For database connectivity.
## Installation
1. **Clone the repository**:
```sh
git clone https://github.com/your-username/your-repo.git
cd your-repo
```
2. **Configure the database**:
- Update the `application.properties` file with your MySQL database configuration.
```properties
spring.datasource.url=jdbc:mysql://localhost:3306/your-database
spring.datasource.username=your-username
spring.datasource.password=your-password
spring.jpa.hibernate.ddl-auto=update
```
3. **Install dependencies**:
Ensure you have Maven installed. Then, in the project directory, run:
```sh
mvn install
```
4. **Deploy the application**:
Deploy the application to your preferred web server (e.g., Tomcat).
- Ensure the `pom.xml` includes the necessary configurations for packaging the application as a WAR file.
## Usage
- Access the application at `http://localhost:8080` (or the configured server port).
- Employees and Admin can log in using their credentials to access their respective dashboards.
## Contributing
1. Fork the repository.
2. Create a new branch (`git checkout -b feature-branch`).
3. Make your changes.
4. Commit your changes (`git commit -m 'Add some feature'`).
5. Push to the branch (`git push origin feature-branch`).
6. Open a pull request.
## License
This project is licensed under the MIT License.