VSN-2135 : Adding feature of fetching contracts with their associated lots labels as a first input of passengers templates exportation.
Merge Request: VSN-2135 – Contracts and Lots Retrieval for Passengers Templates Exportation
Overview
This merge request introduces a new feature that enables the retrieval of contracts along with their associated lots. The functionality is designed to serve as the initial input for passengers templates exportation, ensuring that the data structure is consistent and comprehensive. The implementation spans across service, controller, and data transfer layers, with supporting documentation updates.
Validations and Implemented Changes
Documentation
- Updated the changelog to reflect the newly added feature.
- Ensured that the documentation captures the scope and purpose of the retrieval functionality.
Feature Exposure
- Defined an adequate endpoint to handle the retrieval of contracts and their associated lots.
- Exposed the feature through the controller, making it accessible for integration with passengers templates exportation.
Implementation
- Developed the core method responsible for fetching contracts and their linked lots.
- Integrated the retrieval logic into the service layer, ensuring proper encapsulation and reusability.
Query Definition
- Established a query to retrieve contract and associated lots data.
- Implemented a JPA response mapper to transform raw query results into structured responses.
Service Method
- Added a dedicated service method to streamline the retrieval process.
- Ensured that the method adheres to best practices for maintainability and scalability.
Data Transfer Object (DTO)
- Defined a new DTO to represent contract lots in the response.
- Structured the DTO to support clear and consistent data exchange between layers.
Purpose
The primary goal of this merge request is to provide a reliable mechanism for retrieving contracts and their associated lots, which will serve as the foundational input for passengers templates exportation. This ensures that the export process is based on accurate and well-structured data, improving both functionality and user experience.
Conclusion
With the introduction of this feature, the system gains the ability to seamlessly fetch and expose contract-related data. The changes are well-documented, modular, and designed to integrate smoothly into existing workflows, paving the way for enhanced passenger template export capabilities.
Closes VSN-2135