Skip to content

VSN-2138 : Adding feature of fetching departments identifier data as a second input of default passengers template reference.

yassine.elazami a demandé de fusionner VSN-2138 vers develop

Merge Request: VSN-2138 – Departments Identifier Data Retrieval for Passengers Template Reference

Overview

This merge request introduces a new feature that enables the retrieval of departments identifier data. The functionality is designed to serve as the second input of the default passengers template reference, complementing previously implemented contract and lot retrieval. The implementation covers service, controller, and query layers, with supporting documentation updates to ensure clarity and consistency.

Validations and Implemented Changes

Documentation

  • Updated the changelog to reflect the addition of departments identifier data retrieval.
  • Ensured that documentation highlights the purpose and scope of the new feature.

Feature Exposure

  • Added endpoint paths related to departments and cities retrieval.
  • Exposed the feature through the controller, making it accessible for integration with passengers template references.

Implementation

  • Implemented methods to handle departments and data retrieval logic.
  • Integrated the retrieval functionality into the service layer for maintainability and scalability.

Service Method

  • Introduced a new method in the department service to retrieve a specific department with its associated cities.
  • Ensured proper encapsulation and reusability of the service logic.

Query Definition

  • Defined a JPQL query to retrieve departments and their associated cities.
  • Established a JPA mapper to transform raw query results into structured department city rows.

Data Transfer Object (DTO)

  • Defined a new DTO to represent department cities.
  • Structured the DTO to assemble department names and codes along with their associated cities.

Refactoring

  • Referenced the latest common version to ensure compatibility.
  • Refactored code to align with updated DTO definitions and service methods.

Purpose

The primary goal of this merge request is to provide a reliable mechanism for retrieving departments identifier data, which will serve as a critical input for passengers template references. 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 department-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-2138

Rapports de requête de fusion