Localization Service

Overview

An eGov core application that provides locale-specific components and translation of 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 do the same for the tenant. Locale refers to the specific location where 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 the localization service is permanently stored in the database and is loaded into the Redis cache for easy access. Each time the new data is added to the application the Redis cache is refreshed.

Deployment Details

1. Deploy the latest version of Localization Service.

2. Add Role-Action mapping for APIs.

Integration

Integration Scope

The Localization service is used to store key-value pairs of metadata 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 modules.

Steps to Integration

1. To integrate, a host of localization-services modules should be overwritten in the 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

Resources

Postman Collection

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

Swagger Contract

SwaggerEditoreditor.swagger.io