Localization Service

Owned by Shashwat Mishra
Last updated: Jan 12, 2022

Overview

An eGov core application which provides locale-specific components and translating text for the eGov group of applications.

Pre-requisites

  1. Prior Knowledge of Java/J2EE.

  2. Prior Knowledge of Spring Boot.

  3. Prior Knowledge of REST APIs and related concepts like path parameters, headers, JSON etc.

  4. Prior knowledge of Redis and postgres.

Key Functionalities

The localization application stores the locale data in the format of key and value along with the module, tenantid and locale. Module defines which application of eGov owns the locale data and tenantId does the same for the tenant, locale is the specific locale for which data is being added.  

 

The request can be posted through the post API with the above mentioned variables in the request body.

 

Once posted the same data can be searched based on the module, locale and tenantId as keys.

 

The Data posted to localization service will be permanently stored in the database and will be loaded in to redis cache for easy access and every time new data is added in to the application the redis cache will be refreshed.

Deployment Details

  1. Deploy the latest version of Localization Service.

  2. Add Role-Action mapping for API’s.

Integration

Integration Scope

The Localization service is used to store key-value pairs of meta data in different languages for all miscellaneous / adhoc services which citizens avail from ULBs.

Integration Benefits

  • Can perform service-specific business logic without impacting the other module.

  • Provides the capability of having multiple languages in module.

Steps to Integration

  1. To integrate, host of localization-services module should be overwritten in helm chart.

  2. /localization/messages/v1/_upsert should be added as the create endpoint for creating localization key value pairs in the system

  3. /localization/messages/v1/_search should be added as the search endpoint .This method handles all requests to search existing records depending on different search criteria

 

Postman Collection

https://www.getpostman.com/collections/a140e7426ab4419ed5b5

Swagger Contract

https://editor.swagger.io/?url=https://raw.githubusercontent.com/egovernments/DIGIT-OSS/master/core-services/docs/localisation-contract.yml