Skip to content
Extraits de code Groupes Projets
avatar de l'utilisateur
GitLab CI rédigé
d7ba7c6a

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

License

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

  1. Clone the repository:
git clone http://mc-git.com/marketing-confort/mc-intra/mc-intra-administration-service.git
  1. Navigate to the project directory:
cd mc-intra-administration-service
  1. Build the project:
./mvnw clean install
  1. 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:

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/my-new-feature
  3. Commit your changes: git commit -am 'Add new feature'
  4. Push to the branch: git push origin feature/my-new-feature
  5. 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.