mc-intra-administration-service
Description
mc-intra-administration-service is a microservice designed to manage employee leave requests, absences, and administrative document requests. It centralizes all related tasks in one place, ensuring a streamlined process for submitting requests, validating them by the appropriate authorities, and providing full traceability throughout the organization. The service is built using Spring Boot and adheres to a microservices architecture for scalability and maintainability.
Badges
Visuals
Getting Started
Prerequisites
Ensure you have the following installed:
- JDK 17
- IDE: IntelliJ IDEA
- Database: PostgreSQL
Project Setup via Spring Initializr
- Project: Maven Project
- Language: Java
- Spring Boot Version: 3.0.6
- Group: com.marketingconfort.mcIntraAdministration
- Artifact: mc-intra-administration-service
- Name: mc-intra-administration-service
- Description: Leave, Absence, and Document Management Service
- Package Name: com.marketingconfort.mcIntraAdministration
- Packaging: Jar
- Java: 17
Dependencies
- Spring Web
- Spring Data JPA
- PostgreSQL Driver
Once configured, generate the project, extract it, and open it in your IDE (IntelliJ IDEA).
Installation
- Clone the repository:
git clone http://mc-git.com/marketing-confort/mc-intra/mc-intra-administration-service.git
- Navigate to the project directory:
cd mc-intra-administration-service
- Build the project:
./mvnw clean install
- Run the application:
./mvnw spring-boot:run
The service will be available at: http://localhost:8082
Usage
The service exposes endpoints for managing:
- Leave Requests
- Absence Declarations
- Administrative Document Requests
Features
- Role-based access control
- Leave request management
- Absence tracking
- Document request handling
- Automated workflow processes
- Email notifications
- Reporting and analytics
Support
If you need help with mc-intra-administration-service, please contact the project maintainers.
Roadmap
Future enhancements planned for this project include:
- Improved role-based access control
- Enhanced reporting and analytics on leave and absence trends
- Additional API endpoints for extended functionality
Contributing
Contributions are welcome! Please follow these guidelines:
- Fork the repository
- Create a feature branch:
git checkout -b feature/my-new-feature
- Commit your changes:
git commit -am 'Add new feature'
- Push to the branch:
git push origin feature/my-new-feature
- Open a new merge request
For detailed contribution guidelines, please refer to our CONTRIBUTING.md file.
Authors and Acknowledgment
- Developed and maintained by the Marketing Confort team
- Special thanks to everyone who contributed and supported the project
License
This project is licensed under the MIT License. See the LICENSE file for details.
Project Status
The mc-intra-administration-service is currently under active development. New features and improvements are being added regularly. If you would like to contribute, please get in touch or open an issue for discussion.