1 of 57

Core Services

DIGIT building blocks (as in LEGO pieces)

Access Control Services

Configure role based user access and map actions to roles

Overview

DIGIT is an API-based platform where each API denotes a DIGIT resource. The primary job of Access Control Service (ACS) is to authorise end-users based on their roles and provide access to the DIGIT platform resources. Access control functionality is essentially based on the following points:

Actions: Actions are events performed by a user. This can be an API end-point or front-end event. This is the MDMS master.

Roles: Roles are assigned to users. A single user can hold multiple roles. Roles are defined in MDMS masters.

Role-Action: Role actions are mapped between Actions and Roles. Based on roles, the action mapping access control service identifies applicable actions for the role.

Pre-requisites

Before you proceed with the configuration, make sure the following pre-requisites are met -

Java 17
MDMS service is up and running

Key Functionalities

Serve the applicable actions for a user based on user roles.
On each action performed by a user, access control looks at the user's roles and validates actions that map with the role.
Support tenant-level role action - For instance, an employee from Amritsar can have the role of APPROVER for other ULBs like Jalandhar and hence will be authorised to act as APPROVER in Jalandhar.

Play around with the APIs: DIGIT-Playground

Deployment Details

Deploy the latest version of the Access Control Service
- Note: This video will give you an idea of how to deploy any Digit-service. Further, you can find the latest builds for each service in our latest release document here.
Deploy service to fetch the Role Action Mappings
- Note: This video will give you an idea of how to deploy any Digit-service. Further, you can find the latest builds for each service in our latest release document here.

Configuration Details

Define the roles:

{
      "code": "EMPLOYEE",
      "name": "Employee",
      "description": "Default role for all employees"
}

Add the actions (URL)

{
      "id": {{ACTION_ID}},
      "name": "Create TradeLicense",
      "url": "/tl-services/v1/_create",
      "parentModule": "",
      "displayName": "Create TradeLicense",
      "orderNumber": 0,
      "enabled": false,
      "serviceCode": "tl-services",
      "code": "null",
      "path": ""
}

Add the role action mapping

{
      "rolecode": "EMPLOYEE",
      "actionid": {{ACTION_ID}},
      "actioncode": "",
      "tenantId": "pb"
    }

The details about the fields in the configuration can be found in the Swagger contract

Integration Details

Integration Scope

Any service that requires authorisation can leverage the functionalities provided by the access control service.

Integration Benefits

To add a new service to the platform, simply update its role action mapping in the master data. The Access Control Service will handle authorisation each time the microservice API is called.

Integration Steps

To integrate with the Access Control Service the role action mapping has to be configured (added) in the MDMS service.
The service needs to call /actions/_authorize API of Access Control Service to check for authorisation of any request.

Interaction Diagram

Reference Docs

Doc Links

API List

Audit Service

Overview

The objective of the audit service is listed below -

To provide a one-stop framework for signing data i.e. creating an immutable data entry to track activities of an entity. Whenever an entity is created/updated/deleted the operation is captured in the data logs and is digitally signed to protect it from tampering.

Pre-requisites

Prior knowledge of Java/J2EE
Prior knowledge of SpringBoot
Prior knowledge of PostgreSQL
Prior knowledge of REST APIs and related concepts like path parameters, headers, JSON etc.

Setup & Key Functionalities

The audit service will be parsing all the persister configs so that it can process data received by the persister and create audit logs out of it.

Setup

Step 1: Add the following metrics to the existing persister configs -

isAuditEnabled: true
module: PGR
objecIdJsonPath: $.id
tenantIdJsonPath: $.tenantId
transactionCodeJsonPath: $.transactionCode
auditAttributeBasePath: $.service

Step 2: If a custom implementation of ConfigurableSignAndVerify interface is present, provide the signing algorithm implementation name as a part of audit.log.signing.algorithm property. For example, if the signing algorithm is HMAC, the property will be set as follows -

audit.log.signing.algorithm=HMAC

Step 3: Set egov.persist.yml.repo.path this property to the location of persister configs.

Step 4: Run the audit-service application along with the persister service.

Definitions

Config file - A YAML (xyz.yml) file which contains persister configuration for running audit service.
API - A REST endpoint to post audit logs data.

Functionalities

When audit-service create API is hit, it will validate request size, keyValueMap and operationType.
Upon successful validation, it will choose the configured signer and sign entity data.
Once audit logs are signed and ready, it will send it to audit-create topic.
Persister will listen on this topic and persist the audit logs.

Deployment Details

Add the required keys for enabling audit service in persister configs.
Deploy the latest version of the Audit service and Persister service.
Add Role-Action mapping for APIs.

Integration Details

Integration Scope

The audit service is used to push signed data for tracking each and every create/modify/delete operation done on database entities.

Integration Benefits

Can be used to have tamper-proof audit logs for all database transactions.
Replaying events in chronological order will lead to the current state of the entity in the database.

Integration Steps

To integrate, the host of the audit-service module should be overwritten in the helm chart.
audit-service/log/v1/_create should be added as the create endpoint for the config added.
audit-service/log/v1/_search should be added as the search endpoint for the config added.

API Details

1. URI: The format of the API to be used to create audit logs using the audit service is as follows: audit-service/log/v1/_create

Body: The body consists of 2 parts: RequestInfo and AuditLogs.

Sample Request Body -

{
    "RequestInfo": {
        "apiId": "asset-services",
        "ver": null,
        "ts": null,
        "action": null,
        "did": null,
        "key": null,
        "msgId": "search with from and to values",
        "authToken": "83a1cfb3-6fde-4406-9ee1-622b3ecc7dab"
    },
    "AuditLogs": [
        {
            "userUUID": "11b0e02b-0145-4de2-bc42-c97b96264807",
            "module": "PGR",
            "tenantId": "pb.amritsar",
            "transactionCode": "PGR.CREATE",
            "changeDate": 1657104693726,
            "entityName": "eg_pgr_service",
            "objectId": "c8c901da-61e9-4cd5-89f7-7560997922b7",
            "keyValueMap": {
                "id": "89651651-841a-4b8c-a503-f5d4bb10f4d5",
                "tenantId": "pb.amritsar",
                "assemblyConstituency": "AMC",
                "applicationNumber": "c8c901da-61e9-4cd5-89f7-7560997922b7",
                "applicantId": null,
                "dateSinceResidence": 1590825279,
                "createdBy": "11b0e02b-0145-4de2-bc42-c97b96264807",
                "lastModifiedBy": "11b0e02b-0145-4de2-bc42-c97b96264807",
                "createdTime": 1657104693312,
                "lastModifiedTime": 1657104693312
            },
            "operationType": "CREATE"
        },
        {
            "userUUID": "11b0e02b-0145-4de2-bc42-c97b96264807",
            "module": "PGR",
            "tenantId": "pb.amritsar",
            "transactionCode": "PGR.CREATE",
            "changeDate": 1657104693732,
            "entityName": "eg_pgr_address",
            "objectId": "c8c901da-61e9-4cd5-89f7-7560997922b7",
            "keyValueMap": {
                "id": "84cbe5d1-6ee8-4379-a0c4-0e2a5c94689d",
                "tenantId": "pb.amritsar",
                "doorNo": "1010",
                "latitude": null,
                "longitude": null,
                "buildingName": "Avigna Residence",
                "addressId": null,
                "addressNumber": "34 GA",
                "type": "RESIDENTIAL",
                "addressLine1": "KP Layout",
                "addressLine2": "",
                "landmark": "Petrol pump",
                "street": "12th Main",
                "city": "Amritsar",
                "locality": "New Amritsar Locality",
                "pincode": "143501",
                "detail": "",
                "registrationId": "89651651-841a-4b8c-a503-f5d4bb10f4d5"
            },
            "operationType": "CREATE"
        }
    ]
}

2. URI: The format of the API to be used to search audit logs using audit-service is as follows: audit-service/log/v1/_search

Body: The body consists RequestInfo and search criteria is passed as query params.

Sample curl for search -

curl --location --request POST 'https://dev.digit.org/audit-service/log/v1/_search?offset=0&limit=10&tenantId=pb.amritsar&objectId=c8c901da-61e9-4cd5-89f7-7560997922b7' \
--header 'Content-Type: application/json' \
--data-raw '{
    "RequestInfo": {
        "apiId": "asset-services",
        "ver": null,
        "ts": null,
        "action": null,
        "did": null,
        "key": null,
        "msgId": "search with from and to values",
        "authToken": "83a1cfb3-6fde-4406-9ee1-622b3ecc7dab"
    }
}'

Reference Documents

Postman Collection - Audit Service Postman Collection

Play around with the API's : DIGIT-Playground

Signed Audit Performance Testing Results

Overview

The signed audit service provides a one-stop framework for signing data i.e. creating an immutable data entry to track activities of an entity. Whenever an entity is created/updated/deleted the operation is captured in the data logs and is digitally signed to protect it from tampering.

Observations and Results

Infra configuration -

Number of concurrent users - 15000
Duration of bombarding service with requests ~ 17 minutes
Number of signed audit pod(s) - 1

API Gateway

Deployment With Spring Cloud

Overview

We are updating our core services to remove outdated dependencies and ensure long-term support for the DIGIT platform. The current API gateway uses Netflix Zuul, which has dependencies that will soon be obsolete. To address this, we are building a new gateway using Spring Cloud Gateway.

What is Spring Cloud Gateway and how is it different from Zuul?

Spring Cloud Gateway and Zuul both function as API gateways but differ in architecture and design. Spring Cloud Gateway is ideal for modern, reactive applications, while Zuul is better suited for traditional, blocking I/O environments. The choice between them depends on your specific needs.

Navigating the new Gateway codebase

The new Gateway codebase is well-organized, with each module containing similar files and names. This makes it easy to understand the tasks each part performs. Below is a snapshot of the current directory structure.

Config: It contains the configuration-related files for example Application Properties etc.

Constants: It contains the constants referenced frequently within the codebase. Add any constant string literal here and then access it via this file.

Filters: This folder is the heart of the API gateway since it contains all the PRE, POST, and ERROR filters. For those new to filters: Filters intercept incoming and outgoing requests, allowing developers to apply various functionalities such as authentication, authorisation, rate limiting, logging, and transformation to these requests and responses.

Model: contains the P.O.J.O required in the gateway.

Producer: contains code related to pushing data onto Kafka.

Rate limiters contain files for initialising the relevant bean for custom rate limiting.

Utils: contains the helper function which can be reused across the project.

The above paragraphs provide a basic overview of the gateway's functionality and project structure.

When a request is received, the gateway checks if it matches any predefined routes. If a match is found, the request goes through a series of filters, each performing specific validation or enrichment tasks. The exact order of these filters is discussed later.

The gateway also ensures that restricted routes have proper authentication and authorization. Some APIs can be whitelisted as open or mixed-mode endpoints, allowing them to bypass authentication or authorization.

Upon receiving a request, the gateway first looks for a matching route definition. If a match is found, it starts executing the pre-filters in the specified order.

Pre-Filter

RequestStartTimerFilter: Sets request start time
CorrelationIdFilter: Generate and set a correlationId in each request to help track it in the downstream service
AuthPreCheckFilter: Checks for if Authorisation has to be performed
PreHookFilter: Sends a pre-hook request
RbacPreFilter: Checks if Authentication has to be performed or not
AuthFilter: Authenticate the request
RbacFilter: Authorise the request
RequestEnrichmentFilter: Enrich the request with userInfo & correlationId

Error-Filter

This filter handles all the errors shown either during the request processing or from the downstream service.

Gateway Routes & Properties Configuration

There are two ways to configure Rate Limits in Gateway

Default Rate Limiting
Service Level Rate Limiting

Default Rate Limiting

Default rate limiting sets a standard limit on the number of requests that can be made to the gateway within a specified time frame. This limit applies to all services unless specific rate limits are configured at the service level.

Add these properties in Values.YAML of Gateway helm file and then configure the values as per the use case. Read Configuring Gateway Rate Limiting for more information about these properties.

  - name: SPRING_DATA_REDIS_DEFAULT_REPLENISHRATE
    value: "10"
  - name: SPRING_DATA_REDIS_DEFAULT_BURSTCAPACITY
    value: "10"

Service Level Rate Limiting

Service level rate limiting allows you to set specific rate limits for individual services. This means each service can have its request limits, tailored to its unique needs and usage patterns, providing more granular control over traffic management.

If you want to define rate limiting for each service differently you can do so by defining these properties in the Values.YAML of the respective service. Read Configuring Gateway Rate Limiting for more information about these properties.

Note: We currently provide two options for keyResolver and if none of them is specified the spring cloud will take a default go PrincipalNameKeyResolver which retrieves the Principal from the ServerWebExchange and calls Principal.getName().

ipKeyResolver : Resolves key based on ip address of the request
userKeyResolver : Resolves key based on use UUID of the request

service:
  additionalAnnotations: |
    gateway-burstCapacity: "1"
    gateway-keyResolver: "ipKeyResolver"
    gateway-replenishRate: "2"

To enable gateway routes, a service must activate the gateway flag in the Helm chart. Based on this flag, a Go script runs in the Init container, automatically generating the necessary properties for all services using the gateway.

ingress:
  enabled: true
  zuul: true
  context: "egov-location"

NOTE: Restart the Gateway after making changes in service Values.YAML so that it can pick up the changes.

Configuring Gateway Rate Limiting

Overview

Rate limiting in gateways is a crucial configuration to manage traffic and ensure service availability. By implementing a rate limiter, we can control the number of requests a client can make to the server within a specified time frame. This protects the underlying services from being overwhelmed by excessive traffic, whether malicious or accidental.

The configuration typically involves -

Replenish Rate: The rate at which tokens are added to the bucket. For example, if the replenish rate is 2 tokens per second, two tokens are added to the bucket every second.
Burst Capacity: The maximum number of tokens that the bucket can hold. This allows for short bursts of traffic.
KeyResolver: A KeyResolver is an interface used to determine a key for rate-limiting purposes.

NOTE: We currently provide two options for keyResolver and if none of them is specified the spring cloud will take a default go PrincipalNameKeyResolver which retrieves the Principal from the ServerWebExchange and calls Principal.getName().

ipKeyResolver : Resolves key based on ip address of the request
userKeyResolver : Resolves key based on use UUID of the request

Configuration Use Cases

Example 1: Basic Rate Limiting

Let's say we have a rate limiter configured with:

replenishRate: 2 tokens per second
burstCapacity: 5 tokens

This means:

2 tokens are added to the bucket every second.
The bucket can hold a maximum of 5 tokens.

Scenario: A user makes requests at different intervals.

Initial State: The bucket has 5 tokens (full capacity).
First Request: The user makes a request and consumes 1 token. 4 tokens remain.
Second Request: The user makes another request and consumes 1 more token. 3 tokens remain.
Third Request: The user waits 1 second (2 tokens added) and then makes a request. The bucket has 4 tokens (3 remaining + 2 added - 1 consumed).

Example 2: Handling Burst Traffic

Let's consider a scenario where a user makes multiple requests in quick succession.

Configuration:

replenishRate: 1 token per second
burstCapacity: 3 tokens

Scenario: A user makes 4 requests in rapid succession.

Initial State: The bucket has 3 tokens (full capacity).
First Request: Consumes 1 token. 2 tokens remain.
Second Request: Consumes 1 token. 1 token remains.
Third Request: Consumes 1 token. 0 tokens remain.
Fourth Request: There are no tokens left, so the request is denied. The user must wait for more tokens to be added.

After 1 second, 1 token is added to the bucket. The user can make another request.

Example 3: Applying Rate Limiting In Spring Cloud Gateway

Here’s a practical example using Spring Cloud Gateway with Redis Rate Limiting.

Configuration: In Routes.properties you can set rate limiting as

spring.cloud.gateway.routes[5].id=egov-idgen
spring.cloud.gateway.routes[5].uri=http://egov-idgen.egov:8080/
spring.cloud.gateway.routes[5].predicates[0]=Path=/egov-idgen/**
spring.cloud.gateway.routes[5].filters[0].name=RequestRateLimiter
spring.cloud.gateway.routes[5].filters[0].args.redis-rate-limiter.replenishRate=5
spring.cloud.gateway.routes[5].filters[0].args.redis-rate-limiter.burstCapacity=10

Explanation:

Replenish Rate: 5 tokens per second.
Burst Capacity: 10 tokens.

Behavior:

A user can make up to 10 requests instantly (burst capacity).
After consuming the burst capacity, the user can make 5 requests per second (replenish rate).

Example 4: Real-World Use Case

API Service Rate Limiting

An API service wants to ensure clients do not overwhelm the server with too many requests. They set up rate limits as follows:

Replenish Rate: 100 tokens per minute.
Burst Capacity: 200 tokens.

Scenario:

A client can make 200 requests instantly.
After the burst capacity is exhausted, the client can make 100 requests per minute.
If any client tries to make more requests than allowed, they receive a response indicating they are being rate-limited.

Rate Limiting - Benefits

Prevents Abuse: Limits the number of requests to prevent abuse or malicious attacks (e.g., DDoS attacks).
Fair Usage: Ensures fair usage among all users by preventing a single user from consuming all the resources.
Load Management: Helps manage server load and maintain performance by controlling the rate of incoming requests.
Improved User Experience: Prevents server overload, ensuring a smoother and more reliable experience for all users.

Conclusion

Rate limiting is crucial for traffic management, fair usage, and server resource protection. By setting parameters like replenishRate and burstCapacity, you can regulate request flow and manage traffic spikes efficiently. In Spring Cloud Gateway, the Redis Rate Limiter filter offers a robust solution for implementing rate limiting on your routes.

Boundary Service

Overview

Boundary service provides APIs to create Boundary entities, define their hierarchies, and establish relationships within those hierarchies. You can search for boundary entities, hierarchy definitions, and boundary relationships. However, you can only update boundary entities and relationships.

Pre-requisites

Prior knowledge of Java/J2EE.
Prior knowledge of Spring Boot.
Prior knowledge of REST APIs and related concepts like path parameters, headers, JSON etc.
Prior knowledge of Git.
Advanced knowledge of operating JSON data would be an added advantage to understanding the service.

Key Functionalities

Create Boundary entity: It introduces functionality to define your boundary entity with all validations and properties supported by GeoJson. Currently, only the geometry type of Polygon and Point is supported by it.
Search Boundary entity: It has APIs to search boundaries based on the tenantid & codes, both being mandatory.
Update Boundary entity: This allows updating the geometry details of a boundary entity.
Create Boundary Hierarchy-definition: It allows defining boundary hierarchy definitions against a particular tenantId and hierarchyType which then can be referenced while creating boundary relationships.
Search Boundary Hierarchy-definition: boundary-service supports searching for hierarchy definitions based on tenantId and HierarchyType where tenantId is mandatory. In case the hierarchyType is not provided, it returns all hierarchy definitions for the given tenantId.
Create Boundary Relationship: It supports defining relationships between existing boundary entities according to the established hierarchy. It requires tenantId, code, hierarchyType, boundaryType, and parent fields. Where tenantId and code uniquely combine to determine a boundary entity, tenantId and hierarchType combine to define the hierarchy used in establishing the relationship between the boundary entity and its parent. It verifies if the parent relationship is already established before creating a new one. It also checks if the specified boundaryType is a direct descendant of the parent boundaryType according to the hierarchy definition.
Search Boundary Relationship: This functionality supports searching the boundary relationships based on the given params -
1. tenantId
2. hierarchyType
3. boundaryType
4. codes
5. includeChildren
6. includeParents

where tenantId and hierarchyType are mandatory and the rest are optional.

Update Boundary Relationship: This allows updating the parent boundary relationship within the same level as per the hierarchy.

API Details

/boundary/_create - Takes RequestInfo and Boundary in the request body. boundary has all attributes which define the boundary.
/boundary/_search - Takes RequestInfo in the request body and search criteria fields (refer to the functionality above for exact fields ) as params and return the boundary based on the provided search criteria.
/boundary/_update - Takes RequestInfo and Boundary in the request body where the boundary has all the info that needs to be updated and returns the updated boundary.
/boundary-hierarchy-definition/_create - Takes RequestInfo and boundary hierarchy definition in the request body where BoundaryHierarchy object has all the information for the hierarchy definition being created.
/boundary-hierarchy-definition/_search - Takes RequestInfo and BoundaryTypeHierarchySearchCriteria in the request body to return boundary hierarchy definition based on the provided search criteria.
/boundary-relationships/_create - This API takes RequestInfo and BoundaryRelationship in the request body where BoundaryRelationship has all the info required to define a relationship between two boundaries.
/boundary-relationships/_search - This API takes RequestInfo in the request body and search criteria fields (refer to functionality for the exact fields) are passed as params to return master data based on the provided search criteria and return the response.
/boundary-relationships/_update - This API takes RequestInfo and BoundaryRelationship in the request body to update the fields given in the BoundaryRelationship and returns the updated data.

Postman Collection for Boundary Service APIs:

https://api.postman.com/collections/20755293-c145daab-6465-49a8-b316-4f56a94f186b?access_key=PMAT-01HYHWJ5DZJ6VV0BX8HP9R1DBA

Migrate Old Boundary Data - Steps

Overview

This document provides information on migrating location data from an older JSON-based configuration to a newly developed boundary service. A boundary-migration service has been created to facilitate this process. Users can migrate the data to the new boundary service by calling a single API.

Steps

Below is the step-by-step procedure for the same:-

Import the boundary migration service from in an IDE (preferably IntelliJ) and start the service after building it.
Copy the boundary-data JSON that needs to be migrated as an example we are taking . and adding RequestInfo inside this as shown below.

Open Postman and create a new HTTP endpoint with a path as

and the above as the endpoint request body.

PS: The boundary-migration service is assumed to run on port 8081. If it is running on a different port, check the active port and update the path accordingly.

Send the request and if the endpoint path and request body are correct the response would be 200 OK.

Below is a reference CURL:

Email Notification Service

Overview

The objective of this service is to create a common point to manage all the email notifications being sent out of the platform. The notification email service consumes email requests from the Kafka notification topic and processes them to send them to a third-party service. Modules like PT, TL, PGR etc make use of this service to send messages through the Kafka Queue.

Pre-requisites

Before you proceed with the documentation, make sure the following pre-requisites are met -

Prior knowledge of Java/J2EE
Prior knowledge of SpringBoot
Prior knowledge of Third party API integration
Prior knowledge of REST APIs and related concepts like path parameters, headers, JSON etc
Prior knowledge of Kafka and related concepts like Producer, Consumer, Topic etc.

Key Functionalities

Provide a common platform to send email notifications to the user
Support localised email.

Configuration Details

The egov-notification-mail is a consumer which listens to the egov.core.notification.email topic reads the message and generates email using SMTP Protocol. The services need the senders' email configured. On the other hand, if the senders' email is not configured, the services get the email id by internally calling egov-user service to fetch the email id. Once the email is generated, the content is localized by egov-localization service after which it is notified to the email id.

Deployment Details

Deploy the latest version of the notification email service.
Make sure the consumer topic name for email service is added in deployment configs

Integration Details

Integration Scope

The email notification service is used to send out email notifications for all miscellaneous/ad-hoc services which citizens avail from ULBs.

Integration Benefits

Can perform service-specific business logic without impacting the other module.
In the future, if we want to expose the application to citizens then it can be done easily.

Integration Steps

To integrate, the client service should send email requests to email notification consumer topics.

Reference Documents

Encryption Service

Overview

Encryption Service is used to secure sensitive data that is being stored in the database. The encryption services uses envelope encryption.

Pre-requisites

Before you proceed with the documentation, make sure the following pre-requisites are met -

Java 17.
Kafka server is up and running.

Key Functionalities

Encryption Service offers following features :

Encrypt - The service will encrypt the data based on given input parameters and data to be encrypted. The encrypted data will be mandatorily of type string.
Decrypt - The decryption will happen solely based on the input data (any extra parameters are not required). The encrypted data will have identity of the key used at the time of encryption, the same key will be used for decryption.
Sign - Encryption Service can hash and sign the data which can be used as unique identifier of the data. This can also be used for searching gicen value from a datastore.
Verify - Based on the input sign and the claim, it can verify if the the given sign is correct for the provided claim.
Rotate Key - Encryption Service supports changing the key used for encryption. The old key will still remain with the service which will be used to decrypt old data. All the new data will be encrypted by the new key.

Configuration Details

Following are the properties in application.properties file in egov-enc-service which are configurable.

Deployment Details

Integration

Integration Scope

The Encryption service is used to encrypt sensitive data that needs to be stored in the database. For each tenant, a different data encryption key (DEK) is used. The DEK is encrypted using Key Encryption Keys (KEK). Currently, there are two implementations of encrypting the data encryption keys available. The first one is using AWS KMS service and the second one is using a master password. For any custom implementation, the MasterKeyProvider interface in the service should be extended. Based on the master.password.provider flag in appication.properties you can enable which implementation of MasterKeyProvider interface to use

Integration Benefits

Can perform encryption without having to re-write encryption logic every time in every service.

Steps to Integration

To integrate, the host of encryption-services module should be overwritten in the helm chart.
/crypto/v1/_encrypt should be added as an endpoint for encrypting input data in the system
/crypto/v1/_decrypt should be added as the decryption endpoint.
/crypto/v1/_sign should be added as the endpoint for providing a signature for a given value.
/crypto/v1/_verify should be added as the endpoint for verifying whether the signature for the provided value is correct.
/crypto/v1/_rotatekey should be added as an endpoint to deactivate the keys and generate new keys for a given tenant.

Reference Docs

Doc Links

API List

a) POST /crypto/v1/_encrypt

Encrypts the given input value/s OR values of the object.

b) POST /crypto/v1/_decrypt

Decrypts the given input value/s OR values of the object.

c) /crypto/v1/_sign

Provide signature for a given value.

d) POST /crypto/v1/_verify

Check if the signature is correct for the provided value.

e) POST /crypto/v1/_rotatekey

Deactivate the keys for the given tenant and generate new keys. It will deactivate both symmetric and asymmetric keys for the provided tenant.

Encryption Client Library

Overview

The enc-client library is a supplementary java library provided to support encryption-related functionalities so that every service does not need to pre-process the request before calling the encryption service.

Pre-requisites

MDMS Service
Encryption Service
Kafka

Important Note

The MDMS configurations explained below are fetched by this library at boot time. So after you make changes in the MDMS repo and restart the MDMS service, you would also need to RESTART THE SERVICE which has imported the enc-client library. For example, the report service is using the enc-client library so after making configuration changes to Security Policy pertaining to any report, you will have to restart the report service.

Key Functionalities

Encrypt a JSON Object - The encryptJson function of the library takes any Java Object as an input and returns an object which has encrypted values of the selected fields. The fields to be encrypted are selected based on an MDMS Configuration.
- This function requires the following parameters:
  1. Java/JSON object - The oject whose fields will get encrypted.
  2. Model - It is used to identify the MDMS configuration to be used to select fields of the provided object.
  3. Tenant Id - The encryption key will be selected based on the passed tenantId.
Encrypt a Value - The encryptValue function of the library can be used to encrypt single values. This method also required a tenantId parameter.
Decrypt a JSON Object - The decryptJson function of the library takes any Java Object as an input and returns an object that has plain/masked or no values of the encrypted fields. The fields are identified based on the MDMS configuration. The returned value(plain/masked/null) of each of the attribute depends on the user’s role and if it is a PlainAccess request or a normal request. These configurations are part of the MDMS.
- This function required following parameters:
  1. Java/JSON object - The object containing the encrypted values that are to be decrypted.
  2. Model - It is used to select a configuration from the list of all available MDMS configurations.
  3. Purpose - It is a string parameter that passes the reason of the decrypt request. It is used for Audit purposes.
  4. RequestInfo - The requestInfo parameter serves multiple purposes:
    User Role - A list of user roles are extracted from the requestInfo parameter.
    PlainAccess Request - If the request is an explicit plain access request, it is to be passed as a part of the requestInfo. It will contain the fields that user is requesting for decryption and the id of record.
- While decrypting Java object, this method also audits the request.

Configurations

All the configurations related to enc-client library are stored in the MDMS. These master data are stored in DataSecurity module. It has two types of configurations:

Masking Patterns
Security Policy

Masking Patterns

The masking patterns for different types of attributes(mobile number, name, etc.) are configurable in MDMS. It contains the following attributes:

patternId - It is the unique pattern identifier. This id is referred to in the SecurityPolicy MDMS.
pattern - This defines the actual pattern according to which the value will be masked.

Security Policy

The Security Policy master data contains the policy used to encrypt and decrypt JSON objects. Each of the Security Policy contains the following details:

model - This is the unique identifier of the policy.
uniqueIdentifier - The field defined here should uniquely identify records passed to the decryptJson function.
attributes - This defines a list of fields from the JSON object that needs to be secured.
roleBasedDecryptionPolicy - This defines attribute-level role-based policy. It will define visibility for each attribute.

Visibility

The visibility is an enum with the following options:

PLAIN - Show text in plain form.
MASKED - The returned text will contain masked data. The masking pattern will be applied as defined in the Masking Patterns master data.
NONE - The returned text will not contain any data. It would contain string like “Confidential Information”.

It defines what level of visibility should the decryptJson function return for each attribute.

Attribute

The Attribute defines a list of attributes of the model that are to be secured. The attribute is defined by the following parameters:

name - This uniquely identifies the attribute out of the list of attributes for a given model.
jsonPath - It is the json path of the attribute from the root of the model. This jsonPath is NOT the same as Jayway JsonPath library. This uses / and * to define the json paths.
patternId - It refers to the pattern to be used for masking which is defined in the Masking Patterns master.
defaultVisibility - It is an enum configuring the default level of visibility of that attribute. If the visibility is not defined for a given role, then this defaultVisibility will apply.

Unique Identifier

This parameter is used to define the unique identifier of that model. It is used for the purpose of auditing the access logs. (This attribute’s jsonPath should be at the root level of the model.)

Role-Based Decryption Policy

It defines attribute-level access policies for a list of roles. It consists of the following parameters:

roles - It defines a list of role codes for which the policy will get applied. Please make sure not to duplicate role codes anywhere in the other policy. Otherwise, any one of the policies will get chosen for that role code.
attributeAccessList - It defines a list of attributes for which the visibility differs from the default for those roles.
1. There are two levels of visibility:
  1. First level Visibility - It applies to normal search requests. The search response could have multiple records.
  2. Second level Visibility - It is applied only when a user explicitly requests for plain access of a single record with a list of fields required in plain.

Second level visibility can be requested by passing plainAccessRequest in the RequestInfo.

Plain Access Request

Any user will be able to get plain access to the secured data(citizen’s PII) by requesting through the plainAccessRequest parameter. It takes the following parameters:

recordId - It is the unique identifier of the record that is requested for plain access.
fields - It defines a list of attributes that are requested for plain access.

Audit Service

Every decrypt request is audited. Based on the uniqueIdentifier defined as part of the Security Policy, it lists out the identifiers of the records that were decrypted as part of the request.

Each Audit Object contains the following attributes:

User Data Security Architecture

User Service stores the PII data in the database in encrypted form. So whichever service is reading that data directly from the database will have to decrypt the data before responding to the user. As of now, to the best of our knowledge following services are reading the user data from the database:

User Service
Report Service
Searcher Service

Enc-Client Library is a supplementary library with features like masking, auditing, etc. The above services call the functions from the library to decrypt the data read from the database.

Guidelines for supporting User Privacy in a module

Overview

This documents highlights the changes need to be done in a module to support the user privacy feature.

Pre-requisites

Prior Knowledge of Java/J2EE.
Prior Knowledge of Spring Boot.
MDMS Service
Encryption Service
Prior Knowledge of React Js / Javascript

Backend service changes

Update the pom.xml file.

Upgrade services-common library version.

<dependency>
    <groupId>org.egov.services</groupId>
    <artifactId>services-common</artifactId>
    <version>1.1.1-SNAPSHOT</version>
</dependency>

Upgrade tracer library version.

<dependency>
    <groupId>org.egov.services</groupId>
    <artifactId>tracer</artifactId>
    <version>2.1.2-SNAPSHOT</version>
</dependency>

After upgrading the above library version, there might be chance that an issue occur for RequestInfo creation because of change in variable type, please go through all java files including JUnit test cases before pushing the changes.

The above library version need to be upgraded in the dependant module also. For Example: If water service call the property service and property service is calling user service for owner details then the version of above library need to be upgraded in property service pom file also.

Demand generation changes:

At service level or calculator service level where demand generation process take place, there payer details value must be pass in plain form. And these user details must get through SYSTEM user.

Create a system user in the particular environment and make sure that system user has role INTERNAL_MICROSERVICE_ROLE. Use the curl mentioned below:

curl --location --request POST 'http://localhost:8081/user/users/_createnovalidate' \
--header 'Content-Type: application/json' \
--data-raw '{
    "RequestInfo": {
  "apiId": "Rainmaker",
  "authToken": "81a67bd9-3ff6-402c-ae59-d9209c9dfb3d",
  "userInfo": {
    "id": 29836,
    "uuid": "d8854322-a078-41f8-90b5-6f3a1aee9454",
    "userName": "qeroo",
    "name": "QARoo",
    "mobileNumber": "8339358368",
    "emailId": "",
    "locale": null,
    "type": "EMPLOYEE",
    "roles": [
      
      {
        "name": "Employee",
        "code": "EMPLOYEE",
        "tenantId": "pb.amritsar"
      },
      {
        "name": "Super User",
        "code": "SUPERUSER",
        "tenantId": "pb.amritsar"
      }
    ],
    "active": true,
    "tenantId": "pb.amritsar",
    "permanentCity": null
  },
  "msgId": "1653559822522|en_IN"
},
    "user": {
        "userName": "INTERNAL_MICROSERVICE_USER",
        "password": "eGov@123",
        "salutation": null,
        "name": "Internal Microservice User",
        "gender": null,
        "mobileNumber": "8888888880",
        "emailId": null,
        "altContactNumber": "",
        "pan": null,
        "aadhaarNumber": null,
        "permanentAddress": null,
        "permanentCity": null,
        "permanentPincode": null,
        "correspondenceCity": null,
        "correspondencePincode": null,
        "correspondenceAddress": null,
        "active": true,
        "dob": null,
        "pwdExpiryDate": null,
        "locale": "string",
        "type": "SYSTEM",
        "signature": null,
        "accountLocked": false,
        "fatherOrHusbandName": "null",
        "bloodGroup": null,
        "identificationMark": null,
        "photo": null,
        "otpReference": null,
        "tenantId": "pb",
        "roles": [
           {
                    "code": "INTERNAL_MICROSERVICE_ROLE",
                    "name": "Internal Microservice Role",
                    "tenantId": "pb"
            }
        ]
    }
}'

Do not create the system user with INTERNAL_MICROSERVICE_ROLE if it is already existed. Use the UUID of that user, to get plain result data.

Mention the uuid of the system user in the environment file and in the application.properties file of service example:

Environment file:

egov-internal-microservice-user-uuid: b5b2ac70-d347-4339-98f0-5349ce25f99f

Application properties file:

egov.internal.microservice.user.uuid=b5b2ac70-d347-4339-98f0-5349ce25f99f

Create a method/ function which call the user search API to get the user details in plain form, in that call pass the userInfo of the user with INTERNAL_MICROSERVICE_ROLE

For reference follow the below code snippet

private User getPlainOwnerDetails(RequestInfo requestInfo, String uuid, String tenantId){
		User userInfoCopy = requestInfo.getUserInfo();
		StringBuilder uri = new StringBuilder();
		uri.append(configs.getUserHost()).append(configs.getUserSearchEndpoint()); // URL for user search call
		Map<String, Object> userSearchRequest = new HashMap<>();
		tenantId = tenantId.split("\\.")[0];

		//Creating role with INTERNAL_MICROSERVICE_ROLE
		Role role = Role.builder()
				.name("Internal Microservice Role").code("INTERNAL_MICROSERVICE_ROLE")
				.tenantId(tenantId).build();

        //Creating userinfo with uuid and role of internal micro service role
		User userInfo = User.builder()
				.uuid(configs.getEgovInternalMicroserviceUserUuid())
				.type("SYSTEM")
				.roles(Collections.singletonList(role)).id(0L).build();

		requestInfo.setUserInfo(userInfo);

        // Setting user search criteria
		userSearchRequest.put("RequestInfo", requestInfo);
		userSearchRequest.put("tenantId", tenantId);
		userSearchRequest.put("uuid",Collections.singletonList(uuid));
		User user = null;
		try {
			LinkedHashMap<String, Object> responseMap = (LinkedHashMap<String, Object>) serviceRequestRepository.fetchResult(uri, userSearchRequest);

			List<LinkedHashMap<String, Object>> users = (List<LinkedHashMap<String, Object>>) responseMap.get("user");
			String dobFormat = "yyyy-MM-dd";
			
			// parsing the user response and coverting object into User.class pojo
			notificationUtil.parseResponse(responseMap,dobFormat);
			user = 	mapper.convertValue(users.get(0), User.class);

		} catch (Exception e) {
			throw new CustomException("EG_USER_SEARCH_ERROR", "Service returned null while fetching user");
		}
		requestInfo.setUserInfo(userInfoCopy);
		return user;
	}

Report Configuration Changes:

For the report where PII data is present and decryption is required, such report definition must have UUID values from user table in the query result. And the Source column section of the report definition must have mention of the UUID column and for that entry, showColumn flag should be set as false.

 - name: uuid
    label: reports.{moduleName}.uuid
    type: string
    source: eg_user
    showColumn: false

And the base sql query in the report config should be written in such a way that in the query it must have the user uuid.

In the config, for name: uuid Here replace uuid with the name of the column containing the user’s uuid in the query’s output.

Example:

SELECT emp_data.id as id,
      emp_data.name as name,
      emp_data.uuid as uuid,
      desigmap_def.code as designation,
      deptmap_def.code as department,
      emp_data.employeestatus as status
    FROM emp_data ehe
    inner join eg_user eu ON ehe.uuid = eu.uuid

In the report config where PII data is present and decryption is required, add this new filed in the report config decryptionPathId. And in the Security Policy mdms file, must have the model configuration from the particular report. And the value of key model in Security Policy mdms file and decryptionPathId in a report must be same.

Example:-

{
  "model": "EmployeeReport",
  "uniqueIdentifier": {
    "name": "uuid",
    "jsonPath": "uuid"
  },
  "attributes": [
    {
      "name": "name",
      "jsonPath": "name",
      "patternId": "002",
      "defaultVisibility": "PLAIN"
    }
  ],
  "roleBasedDecryptionPolicy": [
    {
      "roles": [
        "CEMP"
      ],
      "attributeAccessList": [
        {
          "attribute": "name",
          "firstLevelVisibility": "MASKED",
          "secondLevelVisibility": "PLAIN"
        }
      ]
    }
  ]
}

Searcher Configuration changes:

For the searcher result where PII data is present and decryption is required, such searcher definition must have UUID values from user table in the query result. The base sql query in the searcher config should be written in such a way that in the query it must have the user uuid.

I searcher result, where data are coming from user table and to get those value in decrypted form, then in searcher config these following filed decryptionPathIdmust be present. And the Security Policy mdms file, must have the model configuration from the particular searcher config. And the value of key model in Security Policy mdms file and decryptionPathId in searcher config must be same.

For details information on Security Policy MDMS file refer this document.

Frontend Changes:

To Do

FileStore Service

Overview

An eGov core application which handles uploading different kinds of files to server including images and different document types.

Pre-requisites

Prior Knowledge of Java/J2EE.
Prior Knowledge of Spring Boot.
Prior Knowledge of REST APIs and related concepts like path parameters, headers, JSON etc.
Prior knowledge of aws and azure

Key Functionalities

The filestore application takes in a request object which contains an image/document or any kind of file and stores them in a disk/AWS/azure depending upon the configurations, additional implementations can be written for the app interface to interact with any other remote storages.

The request file to be uploaded is taken in form of multipart file part then saved to the storage and a uuid will returned as a unique identifier for that resource, which can be used to fetch the documents later.

Incase of images, the application will create three more additional copies of the file in the likes of large, medium and small for the usage of thumbnails or low quality images incase of mobile applications.

The search api takes the uuid, tenantid as mandatory url params and a few optional parameters and returns the presigned url of the files from the server, In case of images a single string containing multiple urls separated by commas will be returned representing different sizes of images stored.

Setup And Configuration

The Application is present among the core group of applications available in the eGov-services git repository. The spring boot application but needs lombok extension added in your ide to load it. Once the application is up and running API requests can be posted to the url and ids can be generated.

NOTE : In case of intellij the plugin can be installed directly, for eclipse the lombok jar location has to be added in eclipse.ini file in this format -javaagent:lombok.jar.

For the API information please refer the swagger YAML

NOTE : The application needs at least one type of storage available for it to store the files either file-storage, AWS S3 or azure. More storage types can be added by extending the application interface also.

IMPORTANT : To work work any of the file storage there are some application properties which needs to be configured.

DiskStorage:

The mount path of the disk should be provided in the following variable to save files in the disc. file.storage.mount.path=path.

Following are the variables that needs to be populated based on the aws/azure account you are integrating with.

How to enable Minio SDC:

isS3Enabled = true(Should be true)
aws.secretkey = {minio_secretkey}
aws.key = {minio_accesskey}
fixed.bucketname = egov-rainmaker(Minio bucket name)
minio.source = minio

How to enable AWS S3:

isS3Enabled = true(Should be true)
aws.secretkey = {s3_secretkey}
aws.key = {s3_accesskey}
fixed.bucketname = egov-rainmaker(S3 bucket name)
minio.source = minio

AZURE:

isAzureStorageEnabled - informing the application whether Azure is available or not
azure.defaultEndpointsProtocol - type of protocol https
azure.accountName - name of the user account
azure.accountKey - secret key of the user account

NFS :

isnfsstorageenabled-informing the application whether NFS is available or not <True/False>
file.storage.mount.path - <NFS location, example /filestore>
source.disk - diskStorage - name of storage
disk.storage.host.url=<Main Domain URL>

Allowed formats to be uploaded The default format of the files is the use of set brackets with strings inside it - {"jpg", "png"}. Make sure to follow the same.

allowed.formats.map: {jpg:{'image/jpg','image/jpeg'},jpeg:{'image/jpeg','image/jpg'},png:{'image/png'},pdf:{'application/pdf'},odt:{'application/vnd.oasis.opendocument.text'},ods:{'application/vnd.oasis.opendocument.spreadsheet'},docx:{'application/x-tika-msoffice','application/x-tika-ooxml','application/vnd.oasis.opendocument.text'},doc:{'application/x-tika-msoffice','application/x-tika-ooxml','application/vnd.oasis.opendocument.text'},dxf:{'text/plain'},csv:{'text/plain'},txt:{'text/plain'},xlsx:{'application/x-tika-ooxml','application/x-tika-msoffice'},xls:{'application/x-tika-ooxml','application/x-tika-msoffice'}}

The key in the map is the visible extension of the file types, the values on the right in curly braces are the respective tika types of the file. these values can be found in tika website or by passing the file through tika functions.

Features

Upload POST API to save the files in the server
Search Files GET API to retrieve files based only on id and tenantid
Search URLs GET API to retrieve pre-signed URLs for a given array of ids

Deployment Details

Deploy the latest version of Filestore Service.
Add role-action mapping for APIs.

Integration Details

Integration Scope

The filestore service is used to upload and store documents which citizens add while availing of services from ULBs.

Integration Benefits

Can perform file upload independently without having to add fileupload specific logic in each module.

Integration Steps

To integrate, the host of the filestore module should be overwritten in the helm chart.
/filestore/v1/files should be added as the endpoint for uploading files in the system
/filestore/v1/files/url should be added as the search endpoint. This method handles all requests to search existing files depending on different search criteria

Postman Collection

ID Generation Service

Overview

In a bid to avoid unnecessary repetition of codes which generate ids and to have central control over the logic so that the burden of maintenance is reduced from the developers. To create a config-based application which can be used without writing even a single line of coding.

Pre-requisites

Prior knowledge of Java/J2EE.
Prior knowledge of Spring Boot and Flyway.
Prior knowledge of REST APIs and related concepts like path parameters, headers, JSON etc.

Key Functionalities

The application exposes a Rest API to take in requests and provide the ids in response in the requested format. The request format varies from current date information, , random number, and sequence generated number. Id can be generated by providing a request with any of the above-mentioned information.

For example:

The Id Amritsar-PT-2019/09/12-000454-99 contains

Amritsar - which is the name of the city
PT - a fixed string representing the module code(PROPERTY TAX)
2019/09/12 - date
000454 - sequence generated number
99 - random number

The id generated in the above-mentioned eg needs the following format

[city]-PT-[cy:yyyy/mm/dd]-[SEQ_SEQUENCE_NAME]-[d{4}]

Everything in the square brackets will be replaced with the appropriate values by the app.

ID-FORMAT Configuration

By default, the IDGen service will now read its configuration from MDMS. DB Configuration requires access to the DB, so the new preferred method for the configuration is MDMS. The configuration needs to be stored in common-masters/IdFormat.json in MDMS

It is recommended to have the IdFormat as a state-level master. To disable the configuration to be read from DB instead, the environment variable IDFORMAT_FROM_MDMS should be set to false.

ID-FORMAT-REPLACEABLES:

[FY:] - represents the financial year, the string will be replaced by the value of starting year and the last two numbers of the ending year separated by a hyphen. For instance: 2018-19 in case of the financial year 2018 to 2019.
[cy:] - any string that starts with cy will be considered as the date format. The values after the cy: is the format using which output will be generated.
[d{5}] - d represents the random number generator, the length of the random number can be specified in flower brackets next to d. If the value is not provided then the random length of 2 will be assigned.
[city] - The string city will be replaced by the city code provided by the respective ULB in location services.
[SEQ_*] - String starting with seq will be considered as sequence names, which will be queried to get the next seq number. If your sequence does not start with the namespace containing “SEQ” then the application will not consider it as a sequence. In the absence of the sequence from DB error will be thrown.
[tenantid] - replaces the placeholder with the tenantid passed in the request object.
[tenant_id] - replaces the placeholder with the tenantid passed in the request object. Replaces all `.` with `_`
[TENANT_ID] - replaces the placeholder with the tenantid passed in the request object. Replaces all `.` with `_`, and changes the case to upper case.

idName v/s format:

When you use both idName and format in a request. IDGEN will first try to see if the format for the given idName exists, if not then the format will be used.

STATE v/s ULB Level Sequences:

If you want a state-level sequence then you need to use a fixed sequence name

But if you want a ULB level sequence, the sequence name should be dynamic based on the tenantid as given in the below example.

Sequences & Its Creation

The SEQ_* replaceable used in id generation are by default expected for the sequence to already exist in the DB. But this behaviour can be changed and controlled using two environmental variables while deploying the service

AUTOCREATE_NEW_SEQ: Default to false. When set to true, this will auto-create sequences when the format has been derived using provided idName. Since the idName format comes from DB or MDMS, it is a trusted value and this value should be set to true. This will make sure that no DB configuration needs to be done as long as MDMS has been configured. It is recommended that each service using idgen should generate an ID using idName instead of just using passing the format directly. This will make sure that no DB configuration needs to be done for creating sequences.
AUTOCREATE_REQUEST_SEQ: Default to false. When set to true, this will auto-create sequences when the format has been derived using the format parameter from the request. This is recommended to keep as false, as anyone with access to idgen can create any number of sequences in DB and overload the DB. Though during the initial setup of an environment, this variable can be kept as true to create all the sequences when the initial flows are run from the UI to generate the sequences. And afterwards, the flags should be disabled.

Deployment Details

Add MDMS configs required for ID Gen service and restart the MDMS service.
Deploy the latest version of the ID generation service.
Add role-action mapping for APIs.

Integration Details

Integration Scope

The ID Gen service is used to generate unique ID numbers for all miscellaneous/ad-hoc services which citizens avail from ULBs.

Integration Benefits

Can perform service-specific business logic without impacting the other module.
Provides the capability of generating the unique identifier of the entity calling ID Gen service.

Integration Steps

To integrate, the host of idgen-services module should be overwritten in the helm chart.
/egov-idgen/id/_generate should be added as the endpoint for generating ID numbers in the system

API Contract

Indexer Service

Overview

The Indexer Service operates independently and is responsible for all indexing tasks on the DIGIT platform. It processes records from specific Kafka topics and utilizes the corresponding index configuration defined in YAML files by each module.

Objectives:

Efficiently read and process records from Kafka topics.
Retrieve and apply appropriate index configurations from YAML files.
To provide a one-stop framework for indexing the data to Elasticsearch.
To create provisions for indexing live data, reindexing from one index to the other and indexing legacy data from the data store.

Pre-requisites

Before you proceed with the configuration, make sure the following pre-requisites are met -

Prior knowledge of Java/J2EE
Prior knowledge of SpringBoot
Prior knowledge of Elasticsearch
Prior knowledge of REST APIs and related concepts like path parameters, headers, JSON etc.
Prior knowledge of Kafka and related concepts like Producer, Consumer, Topic etc.

Key Functionalities

Performs three major tasks namely: LiveIndex, Reindex and LegacyIndex.
- LiveIndex: Task of indexing the live transaction data on the platform. This keeps the es data in sync with the DB.
- Reindex: Task of indexing data from one index to the other. ES already provides this feature, the indexer does the same but with data transformation.
- LegacyIndex: Task of indexing legacy data from the tables to ES.
Provides flexibility to index the entire object, a part of the object or an entirely different custom object all using one input JSON from modules.
Provides features for customizing index JSON by field mapping, field masking, data enrichment through external APIs and data denormalization using MDMS.
One-stop shop for all the es index requirements with easy-to-write and easy-to-maintain configuration files.
Designed as a consumer to save API overhead. The consumer configs are written from scratch for complete control over consumer behaviour.

Deployment Details

Step 1: Write the configuration as per your requirement. The structure of the config file is explained later in the same doc.
Step 3: Provide the absolute path of the checked-in file to the DevOps team. They will add it to the file-read path of egov-indexer by updating the environment manifest file, ensuring it is read at the time of the application's startup.
Step 4: Run the egov-indexer app. Since it is a consumer, it starts listening to the configured topics and indexes the data.

Interaction Diagram

Configuration Details

API Details

a) POST /{key}/_index

Receive data and index. There should be a mapping with the topic as {key} in index config files.

b) POST /_reindex

This is used to migrate data from one index to another index

c) POST /_legacyindex

This is to run the LegacyIndex job to index data from DB. In the request body, the URL of the service which would be called by the indexer service to pick data must be mentioned.

In legacy indexing and for collection-service records LiveIndex kafka-connect is used to do part of pushing records to elastic search. For more details please refer to the document mentioned in the document list.

Reference Docs

Doc Links

Indexer Configuration

Overview

Indexer uses a config file per module to store all the configurations pertaining to that module. The Indexer reads multiple such files at start-up to support indexing for all the configured modules. In config, we define source and, destination elastic search index names, custom mappings for data transformation and mappings for data enrichment.

Sample Configuration

Below is the sample configuration for indexing TL application creation data into elastic search.

ServiceMaps:
  serviceName: Trade License
  version: 1.0.0
  mappings:
  - topic: save-tl-tradelicense
    configKey: INDEX
    indexes:
    - name: tlindex-v1
      type: licenses
      id: $.id, $.tenantId
      isBulk: true
      timeStampField: $.auditDetails.createdTime
      jsonPath: $.Licenses
      customJsonMapping:
        indexMapping: {"Data":{"tradelicense":{},"ward":{},"tenantData":{}, "history":{}}}
        fieldMapping:
        - inJsonPath: $
          outJsonPath: $.Data.tradelicense
        externalUriMapping:
        - path: http://egov-location.egov:8080/egov-location/location/v11/boundarys/_search
          queryParam: hierarchyTypeCode=REVENUE,boundaryType=locality,codes=$.tradeLicenseDetail.address.locality.code,tenantId=$.tenantId
          apiRequest: {"RequestInfo":{"apiId":"org.egov.pt","ver":"1.0","ts":1502890899493,"action":"asd","did":"4354648646","key":"xyz","msgId":"654654","requesterId":"61","authToken":"d9994555-7656-4a67-ab3a-a952a0d4dfc8","userInfo":{"id":1,"uuid":"1fec8102-0e02-4d0a-b283-cd80d5dab067","type":"EMPLOYEE","tenantId":"pb.amritsar","roles":[{"name":"Employee","code":"EMPLOYEE","tenantId":"pb.amritsar"}]}}}
          uriResponseMapping:
          - inJsonPath: $.TenantBoundary[0].boundary[0]
            outJsonPath: $.Data.ward
        - path: http://egov-workflow-v2.egov:8080/egov-workflow-v2/egov-wf/process/_search
          queryParam: businessIds=$.applicationNumber,history=true,tenantId=$.tenantId
          apiRequest: {"RequestInfo":{"apiId":"org.egov.pt","ver":"1.0","ts":1502890899493,"action":"asd","did":"4354648646","key":"xyz","msgId":"654654","requesterId":"61","authToken":"d9994555-7656-4a67-ab3a-a952a0d4dfc8","userInfo":{"id":1,"uuid":"1fec8102-0e02-4d0a-b283-cd80d5dab067","type":"EMPLOYEE","tenantId":"pb.amritsar","roles":[{"name":"Employee","code":"EMPLOYEE","tenantId":"pb.amritsar"}]}}}
          uriResponseMapping:
          - inJsonPath: $.ProcessInstances
            outJsonPath: $.Data.history
        mdmsMapping:
        - path: http://egov-mdms-service.egov:8080/egov-mdms-service/v1/_search
          moduleName: tenant
          masterName: tenants
          tenantId: pb
          filter: "[?(@.code == $tenant)]"
          filterMapping:
          - variable: $tenant
            valueJsonpath: $.tenantId
          uriResponseMapping:
          - inJsonPath: $.MdmsRes.tenant.tenants
            outJsonPath: $.Data.tenantData

Variable List

The table below lists the key configuration variables.

Internal Gateway

Overview

The Internal Gateway is a simplified Zuul service which provides an easy integration of services running different namespaces of a multistate instance, the clients need not know about all the details of microservices and their namespace in the K8s setup.

Pre-requisites

Before you proceed with the documentation, make sure the following pre-requisites are met -

Java 17
API Gateway

Key Functionalities

Provides an easier API interface between services running in different tenants(namespaces) where direct access between microservices is blocked by default.
Allows refactoring microservices independently without forcing the clients to refactor integrating logic with other tenants.

Zuul Components

Route filter - a single route filter enables the routing based on tenatId from the HTTP header of the incoming requests.

Configuration Details

Routing Property

For each service, the below-mentioned property has to be added in internal-gateway.json

{
  "/egov-mdms-service/.*": {
    "in.statea": "http://egov-mdms-service.statea:8080",
    "in.stateb": "http://egov-mdms-service.stateb:8080",
    "in": "http://egov-mdms-service:8080"
  },
  "/pt-calculator-v2/.*": {
    "in.statea": "http://pt-calculator-v2.statea:8080",
    "in.stateb": "http://pt-calculator-v2.stateb:8080",
    "in": "http://pt-calculator-v2.digit:8080"
  },
  "/property-services/.*": {
    "in.stateb": "http://property-services.digit:8080",
    "in.statea": "http://property-services.digit:8080"
  },
  "/billing-service/.*": {
    "in.stateb": "http://billing-service.digit:8080",
    "in.statea": "http://billing-service.digit:8080"
  },
  "/egov-searcher/.*": {
    "in.statea": "http://egov-searcher.statea:8080",
    "in.stateb": "http://egov-searcher.stateb:8080"
  },
  "/dashboard-analytics/.*": {
    "in.statea": "http://dashboard-analytics.statea:8080",
    "in.stateb": "http://dashboard-analytics.stateb:8080"
  }
}

Sequence Diagram

Open

Location

Configure service to enable fetch and share of location details

Overview

A core application that provides location details of the tenant for which the services are being provided.

API's Playground : DIGIT-Playground

Pre-requisites

Before you proceed with the documentation, make sure the following pre-requisites are met -

Java 17
PostgreSQL server is running and the DB is created
- Follow this guide to see how to setup and create DB in postgreSQL.
Working Knowledge of egov-mdms service to add location data in master data.
egov-mdms service is running and all the required MDMS masters are loaded in it

Key Functionalities

The location information is also known as the boundary data of ULB
Boundary data can be of different hierarchies - ADMIN or ELECTION hierarchy defined by the Administrators and Revenue hierarchy defined by the Revenue department.
The election hierarchy has the locations divided into several types like zone, election wards, blocks, streets and localities. The Revenue hierarchy has the locations divided into a zone, ward, block and locality.
The model which defines the localities like zone, ward and etc is a boundary object which contains information like name, lat, long, parent or children boundary if any. The boundaries come under each other in a hierarchy. For instance, a zone contains wards, a ward contains blocks, and a block contains locality. The order in which the boundaries are contained in each other differs based on the tenants.

Deployment Details

Add/Update the MDMS master file which contains boundary data of ULBs.
Add Role-Action mapping for the egov-location APIs.
Deploy/Redeploy the latest version of the egov-mdms service.
Fill the above environment variables in the egov-location with proper values.
Deploy the latest version of the egov-location service.

Configuration Details

The boundary data has been moved to MDMS from the master tables in DB. The location service fetches the JSON from MDMS and parses it to the structure of the boundary object as mentioned above. A sample master would look like below.

{
  "tenantId": "pg.cityA",
   "moduleName": "egov-location",
  "TenantBoundary": [
  {
      "hierarchyType": {
              "code": "ADMIN",
              "name": "ADMIN"
      },
       "boundary": {
                "id": 1,
                "boundaryNum": 1,
                "name": "CityA",
                "localname": "CityA",
                "longitude": null,
                "latitude": null,
                "label": "City",
                "code": "pg.cityA",
                "children": []
        }

    }
 ]
}

Integration Details

Integration Scope

The egov-location APIs can be used by any module which needs to store the location details of the tenant.

Integration Benefits

Get the boundary details based on boundary type and hierarchy type within the tenant boundary structure.
Get the geographical boundaries by providing appropriate GeoJson.
Get the tenant list in the given latitude and longitude.

Integration Steps

To integrate, the host of egov-location should be overwritten in the helm chart.
/boundarys/_search should be added as the search endpoint for searching boundary details based on tenant Id, Boundary Type, Hierarchy Type etc.
/geography/_search should be added as the search endpoint. This method handles all requests related to geographical boundaries by providing appropriate GeoJson and other associated data based on tenantId or lat/long etc.
/tenant/_search should be added as the search endpoint. This method tries to resolve a given lat, long to a corresponding tenant, provided there exists a mapping between the reverse geocoded city to the tenant.
The MDMS tenant boundary master file should be loaded in the MDMS service.

Reference Docs

Doc Links

API List

Please refer to the Swagger API contract for the location service to understand the structure of APIs and to have a visualisation of all internal APIs.

Localization Service

Overview

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

Pre-requisites

Prior knowledge of Java/J2EE.
Prior knowledge of Spring Boot.
Prior knowledge of REST APIs and related concepts like path parameters, headers, JSON etc.
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. The 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 the localization service is permanently stored in the database and loaded into the Redis cache for easy access and every time new data is added to the application the Redis cache will be refreshed.

Deployment Details

Deploy the latest version of the Localization Service.
Add role-action mapping for APIs.

Integration Details

Integration Scope

The localization service is used to store key-value pairs of metadata in different languages for all miscellaneous/ad-hoc 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 the module.

Integration Steps

To integrate, the host of the localization-services module should be overwritten in the helm chart.
/localization/messages/v1/_upsert should be added as the create endpoint for creating localization key-value pairs in the system
/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

Play around with the API's : DIGIT-Playground

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

Configuring Localization

Learn how to configure Localization service.

Setup Base Product Localisation

Overview

DIGIT supports multiple languages. To enable this feature begin with setting up the base product localisation. The multilingual UI support makes it easier for users to understand the DIGIT operations.

Pre-requisites

Before you proceed with the configuration, make sure the following pre-requisites are met -

Before starting the localisation setup one should know the React and eGov FrameWork.
Before setting up localisation, make sure that all the keys are pushed to the Create API and also get prepared with the values that need to be added to the Localisation key specific to particular languages that are being added to the product.
Make sure you know where to add the localisation in the code.

Key Functionalities

After localisation, users can view DIGIT screens in their preferred language. Completing the application is simple as the DIGIT UI allows easy language selection.

Deployment Details

Once the key is added to the code as per requirement, the deployment can be done in the same way as the code is deployed.

Configuration Details

Select a label that needs to be localised from the Product code. Here is the example code for a header before setting up Localisation.

As we see the above which supports only the English language, To set up Localisation to that header we need to the code in the following manner.

When comparing the code before and after the Localisation setup, we can see that the following code has been added.

{

labelName: "Trade Unit ",

labelKey: "TL_NEW_TRADE_DETAILS_TRADE_UNIT_HEADER"

The values here can be added to the key using two methods: either via the newly developed localisation screen or by updating the key values through the Postman application to create an API.

Reference Docs

Doc Links

Configure SMS and Email

Overview

Notification service can notify the user through SMS and email for there action on DIGIT as an acknowledgement that their action has been successfully completed.
ex: actions like property create, TL create, etc.
To send SMS we need the help of 2 services, one on which the user is taking action and the second SMS service.
To send an email we need the help of 2 services, one on which the user is taking action and second email service.

Pre-requisites

Before you proceed with the configuration, make sure the following pre-requisites are met -

Prior Knowledge of Spring boot.
Prior Knowledge of Kafka.
Prior Knowledge of localization service.

Key Functionalities

For a specific action of the user, he/she will get a SMS and email as an acknowledgment.
Users can get SMS and email based on the localization language.

Configuration Details

If you want to take action for a specific action on that action the service has to listen to a particular topic so that each time any record comes to the topic consumer will know that action has been taken and can trigger a notification for it.
- ex: if you want to trigger a notification for Property create then the property service’s NotificationConsumer class should listen to topic egov.pt.assessment.create.topic so that each time any record comes to the topic egov.pt.assessment.create.topic NotificationConsumer will know that Property creates action that has been taken and can trigger a notification for it.
when any record comes into the topic first the service will fetch all the required data like user name, property id, mobile number, tenant id, etc from the record which we fetched from the topic.
Then we will fetch the message contain from localization and the service replaces the placeholders with the actual data.
Then put the record in SMS topic in which SMS service is listening.
email service is also listening to the same topic which SMS service is listening.

Reference Docs

Doc Links

MDMS V2 (Master Data Management Service)

Overview

MDMS v2 provides APIs for defining schemas, searching schemas, and adding master data against these defined schemas. All data is now stored in PostgreSQL tables instead of GitHub. MDMS v2 currently also includes v1 search API for fetching data from the database in the same format as MDMS v1 search API to ensure backward compatibility.

Pre-requisites

Prior knowledge of Java/J2EE.
Prior knowledge of Spring Boot.
Prior knowledge of REST APIs and related concepts like path parameters, headers, JSON etc.
Prior knowledge of Git.
Advanced knowledge of operating JSON data would be an added advantage to understanding the service.

Functionalities

Create schema: MDMS v2 introduces functionality to define your schema with all validations and properties supported by JSON schema draft 07. Below is a sample schema definition for your reference -

"SchemaDefinition": {
        "tenantId": "pb",
        "code": "TradeLicense.TradeSubType",
        "description": "Trade sub-type which is a child of Trade type",
        "definition": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
                "name": {
                    "type": "string",
                    "pattern": "^[A-Za-z]+$"
                },
                "code": {
                    "type": "string"
                },
                "tradeTypeCode": {
                    "type": "string"
                }
            },
            "required": [
                "name",
                "code",
                "tradeTypeCode"
            ],
            "x-unique": [
                "name"
            ],
            "x-ref-schema": [
                {
                    "fieldPath": "tradeTypeCode",
                    "schemaCode": "TradeLicense.TradeType"
                }
            ]
        },
        "isActive": true
    }

To create a basic schema definition, use the following keywords:

$schema: specifies which draft of the JSON Schema standard the schema adheres to.
title and description: state the intent of the schema. These keywords don’t add any constraints to the data being validated.
type: defines the first constraint on the JSON data.

Additionally, we have two keys which are not part of standard JSON schema attributes -

x-unique: specifies the fields in the schema utilizing which a unique identifier for each master data will be created.
x-ref-schema: specifies referenced data. This is useful in scenarios where the parent-child relationship needs to be established in master data. For example, Trade Type can be a parent master data to Trade Sub Type. In the example above, the field path represents the JsonPath of the attribute in the master data which contains the unique identifier of the parent which is being referenced. Schema code represents the schema under which the referenced master data needs to be validated for existence.

Search schema: MDMS v2 has API to search schema based on the tenantid, schema code, and unique identifier.
Create data: MDMS v2 enables data creation according to the defined schema. Below is an example of data based on the mentioned schema:

"Mdms": {
    "tenantId": "pb",
    "schemaCode": "TradeLicense.TradeSubType",
    "data": {
      "name": "Electronics",
      "code": "ELECTRONICS",
      "tradeTypeCode": "GOODS.MANUFACTURE"
      },
    "isActive": true
}

Search data: MDMS v2 exposes two search APIs - v1 and v2 search where v1 search API is completely backward compatible.
Update data: MDMS v2 allows the updation of master data fields.
Fallback functionality: Both the search APIs have fallback implemented where if data is not found for a particular tenant, the services fall back to the parent tenant(s) and return the response. If data is not found even for the parent tenant, an empty response is sent to the user.

API Details

/mdms-v2/schema/v1/_create - Takes RequestInfo and SchemaDefinition in the request body. SchemaDefinition has all attributes which define the schema.
/mdms-v2/schema/v1/_search - Takes RequestInfo and SchemaDefSearchCriteria in the request body and returns schemas based on the provided search criteria.
/mdms-v2/v2/_create/{schemaCode} - Takes RequestInfo and Mdms in the request body where the MDMS object has all the information for the master being created and it takes schemaCode as path param to identify the schema against which data is being created.
/mdms-v2/v2/_search - Takes RequestInfo and MdmsCriteria in the request body to return master data based on the provided search criteria. It also has a fallback functionality where if data is not found for the tenant which is sent, the services fall back to the parent tenant(s) to look for the data and return it.
/mdms-v2/v2/_update/{schemaCode} - Takes RequestInfo and Mdms in the request body where the MDMS object has all the information for the master being updated and it takes schemaCode as path param to identify the schema against which data is being updated.
/mdms-v2/v1/_search - This is a backwards-compatible API which takes RequestInfo and MdmsCriteria in the request body to return master data based on the provided search criteria and returns the response in MDMS v1 format. It also has fallback functionality where if data is not found for the tenant which is sent, the services fall back to the parent tenant(s) to look for the data and return it.

Postman Collection

https://api.postman.com/collections/12892142-771842a6-fe9d-4ba7-93ba-2fffdb525055?access_key=PMAT-01H5PA8YTK7H1357VGDQ4YMW7W

Adopt New MDMS - Steps

Follow the steps below to adopt the new MDMS -

Define the schema for the master that you want to promote to MDMS v2.
Ensure that the schema has a unique field (a unique field can also be composite) to enforce data integrity.
In case the data does not have unique identifiers e.g. complex masters like the one mentioned here, consider adding a redundant field which can serve as the unique identifier.
Use the following API endpoint to create a schema - /mdms-v2/schema/v1/_create
Search and verify the created schema using the following API endpoint - /mdms-v2/schema/v1/_search
Once the schema is in place, add the data using the following API endpoint - /mdms-v2/v2/_create/{schemaCode}
Verify the data by using the following API endpoint - /mdms-v2/v2/_search

MDMS (Master Data Management Service)

Configure master data management service

Overview

The MDMS service aims to reduce the time spent by developers on writing codes to store and fetch master data (primary data needed for module functionality) which doesn’t have any business logic associated with them. Instead of writing APIs and creating tables in different services to store and retrieve data that is seldom changed, the MDMS service keeps them in a single location for all modules and provides data on demand with the help of no more than three lines of configuration.

Pre-requisites

Prior knowledge of Java/J2EE
Prior knowledge of Spring Boot
Prior knowledge of REST APIs and related concepts like path parameters, headers, JSON etc.
Prior knowledge of Git
Advanced knowledge of how to operate JSON data would be an added advantage to understanding the service

Key Functionalities

Adds master data for usage without the need to create master data APIs in every module.
Reads data from GIT directly with no dependency on any database services.

Environment Variables

Description

Deployment Details

Deploy the latest version of the MDMS-service
1. Note: This video will give you an idea of how to deploy any Digit-service. Further you can find the latest builds for each service in out latest release document here.
Add conf path for the file location
Add master config JSON path

Note : See the Reference Docs for the values of conf path and master config.

Integration Details

Integration Scope

The MDMS service provides ease of access to master data for any service.

Integration Benefits

No time spent writing repetitive codes with no business logic.

Integration Steps

To integrate, the host of egov-mdms-service should be overwritten in the helm chart
egov-mdms-service/v1/_search should be added as the search endpoint for searching master data.
MDMS client from eGov snapshots should be added as mvn entity in pom.xml for ease of access since it provides MDMS request pojos.

Reference Docs

Doc Links

API List

Access to all the API's at : DIGIT-Playground

Setting up Master Data

Learn how to setup DIGIT master data.

MDMS Overview

Overview

MDMS stands for Master Data Management Service. MDMS is one of the applications in the eGov DIGIT core group of services. This service aims to reduce the time spent by developers on writing codes to store and fetch master data (primary data needed for module functionality ) which doesn’t have any business logic associated with them.

Pre-requisites

Before you proceed with the configuration, make sure the following pre-requisites are met -

Prior knowledge of Java/J2EE.
Prior knowledge of Spring Boot.
Prior knowledge of REST APIs and related concepts like path parameters, headers, JSON, etc.
Prior knowledge of Git.
Advanced knowledge of how to operate JSON data would be an added advantage to understanding the service.

Key Functionalities

The MDMS service reads the data from a set of JSON files from a pre-specified location.
It can either be an online location (readable JSON files from online) or offline (JSON files stored in local memory).
The JSON files are in a prescribed format and store the data on a map. The tenantID of the file serves as a key and a map of master data details as values.
Once the data is stored in the map the same can be retrieved by making an API request to the MDMS service. Filters can be applied in the request to retrieve data based on the existing fields of JSON.

Deployment Details

For deploying the changes in MDMS data, the service needs to be restarted.
The changes in MDMS data could be adding new data, updating existing data, or deleting it.

Configuration Details

The config JSON files to be written should follow the listed rules

The config files should have JSON extension
The file should mention the tenantId, module name, and master name first before defining the data

{
  "tenantId": "uk",
  "moduleName": "BillingService",
  "{$MasterName}":[ ]
}

Example config JSON for “Billing Service”

{
  "tenantId": "pb",
  "moduleName": "BillingService",
 "BusinessService": 
 [
    {
      "businessService": "PropertyTax",
      "code": "PT",
      "collectionModesNotAllowed": [ "DD" ],
      "partPaymentAllowed": true,
      "isAdvanceAllowed": true,
      "isVoucherCreationEnabled": true
    }
]
}

Reference Docs

Doc Links

API List

MDMS Rewritten

Overview

Master Data Management Service is a core service made available on the DIGIT platform. It encapsulates the functionality surrounding Master Data Management. The service creates, updates and fetches Master Data pertaining to different modules. This eliminates the overhead of embedding the storage and retrieval logic of Master Data into other modules. The functionality is exposed via REST API.

Pre-requisites

Prior Knowledge of Java/J2EE, Spring Boot, and advanced knowledge of operating JSON data would be an added advantage to understanding the service.

Functionality

The MDM service reads the data from a set of JSON files from a pre-specified location. It can either be an online location (readable JSON files from online) or offline (JSON files stored in local memory). The JSON files should conform to a prescribed format. The data is stored in a map and tenantID of the file serves as the key.

Once the data is stored in the map the same can be retrieved by making an API request to the MDM service. Filters can be applied in the request to retrieve data based on the existing fields of JSON.

Setup and Usage

The spring boot application needs lombok extension added to your IDE to load it. Once the application is up and running API requests can be posted to the URL.

Configuration & Structure

The config JSON files to be written should follow the listed rules

The config files should have JSON extension.
The file should mention the tenantId, module name, and master name first before defining the data.

{
  "tenantId": "pb",
  "moduleName": "BillingService",
  "{$MasterName}":[ ]
}

The Master Name in the above sample will be substituted by the actual name of the master data. The array succeeding it will contain the actual data.

Example config JSON for “Billing Service”

{
  "tenantId": "pb",
  "moduleName": "BillingService",
 "BusinessService": 
 [
    {
      "businessService": "PropertyTax",
      "code": "PT",
      "collectionModesNotAllowed": [ "DD" ],
      "partPaymentAllowed": true,
      "isAdvanceAllowed": true,
      "isVoucherCreationEnabled": true
    }
]
}

API Reference Documentation

APIs are available to create, update and fetch master data pertaining to different modules. Refer to the segment below for quick details.

BasePath:/mdms/v1/[API endpoint] Method

POST /_create

Creates or Updates Master Data on GitHub as JSON files

MDMSCreateRequest Request Info + MasterDetail — Details of the master data to be created or updated on GitHub.

MasterDetail

MdmsCreateResponse Response Info

Method

POST /_search

This method fetches a list of masters for a specified module and tenantId.

MDMSCriteriaReq (mdms request) - Request Info + MdmsCriteria — Details of module and master which need to be searched using MDMS.

MdmsCriteria

MdmsResponse Response Info + Mdms

MDMS

Common Request/Response/Error Structures:

RequestInfo should be used to carry meta information about the requests to the server as described in the fields below. All DIGIT APIs will use requestinfo as a part of the request body to carry this meta information. Some of this information will be returned back from the server as part of the ResponseInfo in the response body to ensure correlation.

ResponseInfo should be used to carry metadata information about the response from the server. apiId, ver, and msgId in ResponseInfo should always correspond to the same values in the respective request's RequestInfo.

ErrorRes

All DIGIT APIs will return ErrorRes in case of failure which will carry ResponseInfo as metadata and Error object as an actual representation of the error. When the request processing status in the ResponseInfo is ‘FAILED’ the HTTP status code 400 is returned.

Configuring Tenants

Overview

Tenant represents a body in a system. In the municipal system, a state and its ULBs (Urban local bodies) are tenants. ULB represents a city or a town in a state. Tenant configuration is done in MDMS.

Pre-requisites

Before proceeding with the configuration, the following pre-requisites are met -

Knowledge of json and how to write a json is required.
Knowledge of MDMS is required.
User with permission to edit the git repository where MDMS data is configured.

Key Functionalities

On the login page, city name selection is required. Tenant added in MDMS shows in the city drop-down of the login page.
In reports or in the employee inbox page the details related to ULB are displayed from the fetched ULB data added in MDMS.
Modules i.e., TL, PT, MCS can be enabled based on the requirement of the tenant.

Deployment Details

After adding the new tenant, the MDMS service needs to be restarted to read the newly added data.

Configuration Details

Tenant is added in tenant.json. In MDMS, file tenant.json, under the tenant folder holds the details of the state and ULBs to be added in that state.

{
  "tenantId": "uk",  //<ReplaceWithDesiredTenantId>
  "moduleName": "tenant",
  "tenants": [ {
      "code": "uk.citya", //<state.ulbname>
      "name": "City A",  //<name of the ulb>
      "description": "City A", //<ulb description>
      "logoId": "https://s3.ap-south-1.amazonaws.com/uk-egov-assets/uk.citya/logo.png",  //<ulb logo path - To display ulb logo on login>
      "imageId": null,
      "domainUrl": "", //<ulb website url>
      "type": "CITY",
      "twitterUrl": null,
      "facebookUrl": null,
      "emailId": "complaints.citya@gmail.com",  //<ulb email id>
      "OfficeTimings": {
        "Mon - Sat": "10.00 AM - 5.00 PM"
      },
"city": {
"name": "City A",
"localName": null,
"districtCode": "CITYA",
"districtName": null,
"regionName": null,
"ulbGrade": "Municipal Corporation",
"longitude": 78.0322,
"latitude": 30.3165,
"shapeFileLocation": null,
"captcha": null,
"code": "248430"
},
"address": "City A Municipal Coronation Address",
"contactNumber": "91 (135) 2653572"
}]}

To enable tenants the above data should be pushed in tenant.json file. Here "ULB Grade" and City "Code" are important fields. ULB Grade can have a set of allowed values that determines the ULB type, (Municipal corporation (Nagar Nigam), Municipality (municipal council, municipal board, municipal committee) (Nagar Parishad), etc). City "Code" has to be unique to each tenant. This city-specific code is used in all transactions. Not permissible to change the code. If changed we will lose the data of the previous transactions done.

Naming Convention for Tenants Code

“Code”:“uk.citya” is StateTenantId.ULBTenantName"

"logoId": "https://s3.ap-south-1.amazonaws.com/uk-egov-assets/uk.citya/logo.png", Here the last section of the path should be "/<tenantId>/logo.png". If we use anything else, the logo will not be displayed on the UI. <tenantId> is the tenant code ie “uk.citya”.

Localization should be pushed for ULB grade and ULB name. The format is given below.

Localization for ULB Grade

{
     "code": "ULBGRADE_MUNICIPAL_CORPORATION",
     "message": "MUNICIPAL CORPORATION",
     "module": "rainmaker-common",
     "locale": "en_IN"
  }

Localization for ULB Name

{
     "code": "TENANT_TENANTS_UK_HALDWANI",    
     "message": "Haldwani",
     "module": "rainmaker-tl",
     "locale": "en_IN"
}

Format of localization code for tenant name <MDMS_State_Tenant_Folder_Name>_<Tenants_Fille_Name>_<Tenant_Code> (replace dot with underscore)

Boundary data should be added for the new tenant.

Reference Docs

Doc Links

Configuring Master Data

Overview

Configuring master data for a new module requires creating a new module in the master config file and adding master data. For better organizing, create all the master data files belonging to the module in the same folder. Organizing in the same folder is not mandatory it is based on the moduleName in the master data file.

Pre-requisites

Before you proceed with the configuration, make sure the following pre-requisites are met -

User with permission to edit the git repository where MDMS data is configured.

Key Functionalities

These data can be used to validate the incoming data.

Deployment Details

After adding the new module data, the MDMS service needs to be restarted to read the newly added data.

Configuration Details

Add New Module

The master config file is structured as below. Each key in the master config is a module and each key in the module is a master.

The new module can be added below the existing modules in the master config file.

Create Masters Data

Reference Docs

Doc Links

Adding New Master

Overview

For creating a new master in MDMS, create the JSON file with the master data and configure the newly created master in the master config file.

Pre-requisites

Before proceeding with the configuration, make sure the following pre-requisites are met -

User with permission to edit the git repository where MDMS data is configured.

Deployment Details

After adding the new master, the MDMS service needs to be restarted to read the newly added data.

Configuration Details

Creating Master JSON

The new JSON file needs to contain 3 keys as shown in the below code snippet. The new master can be created either State-wise or ULB-wise. Tenant ID and config in the master config file determine this.

Configuring Master Config File

The master config file is structured as below. Each key in the master config is a module and each key in the module is a master.

Each master contains the following data and the keys are self-explanatory

Reference Docs

Doc Links

State Level Vs City Level Master

Overview

MDMS supports the configuration of data at different levels. While we enable a state there can be data that is common to all the ULBs of the state and data specific to each ULB. The data further can be configured at each module level as state-specific or ULB’s specific.

Pre-requisites

Before you proceed with the configuration, make sure the following pre-requisites are met -

Prior Knowledge of Java/J2EE.
Prior Knowledge of Spring Boot.
Prior Knowledge of REST APIs and related concepts like path parameters, headers, JSON, etc.
Prior knowledge of Git.
Advanced knowledge of operating JSON data would be an added advantage to understanding the service.

Key Functionalities

State Level Masters are maintained in a common folder.
ULB Level Masters are maintained in separate folders named after the ULB.
Module Specific State Level Masters are maintained by a folder named after the specific module that is placed outside the common folder.

Deployment Details

For deploying the changes(adding new data, updating existing data or deletion) in MDMS, the MDMS service needs to be restarted.

Configuration Details

State Level Master Configuration

The common master data across all ULBs and modules like department, designation, etc are placed under the common-masters folder which is under the tenant folder of the MDMS repository.

The common master data across all ULBs and are module-specific are placed in a folder named after each module. These folders are placed directly under the tenant folder.

ULB Level Master Configuration

Module data that are specific to each ULB like boundary data, interest, penalty, etc are configured at the ULB level. There will be a folder per ULB under the tenant folder and all the ULB’s module-specific data are placed under this folder.

Reference Docs

Doc Links

API List

MDMS Migration

Steps to migrate MDMS data to enable use of workbench UI v1.0

Overview

Follow the steps below to migrate the MDMS data to enable the use of Workbench UI v1.0.

Steps

1. Generate Schema

Follow the steps below to generate the schema for Workbench UI v1.0:

Clone the migration utility: Start by cloning the migration utility from this .
Clone the MDMS Repository: Start by cloning the MDMS repository on your local machine.
Configure application.properties: Open the application.properties file in the workbench utility and configure it as follows:
- Add the hostname of the environment.
- Add the MDMS cloned folder path in the egov.mdms.conf.path.
- Add master-config.json in masters.config.url.
- Specify the output folder path for the created schema in master.schema.files.dir.
Port-forward MDMSv2 Service: Port-forward the MDMSv2 service to port 8094.
Run the Curl Command:
This command generates the schema and saves it in the path specified by master.schema.files.dir.

2. Update Schema

After generating the schema, you may need to update it with additional attributes:

Add x-unique Attribute: This defines unique fields in the schema.
Add x-ref-schema Attribute: Use this attribute if a field within MDMS data needs to refer to another schema.
Set Default Value for a Field: Use the default keyword to set default values.

3. Migrate Schema

To migrate the schema, use the following curl command:

4. Migrate Data

To migrate data for a specific master/module name, use the following curl command:

5. Schema Sample

Here is an example of a schema:

NOTE: To migrate data for a specific master/module name, use the following code changes in migrateMasterData

OTP Service

Overview

OTP Service is a core service that is available on the DIGIT platform. The service is used to authenticate the user in the platform. The functionality is exposed via REST API.

Pre-requisites

Before you proceed with the documentation, make sure the following pre-requisites are met -

Java 17

Key Functionalities

egov-otp is called internally by the user-otp service that fetches the mobile number and feeds to egov-otp to generate the 'n' DIGIT OTP.

Configuration Details

The below properties define the OTP configurations -

a) egov.otp.length : Number of digits in the OTP

b) egov.otp.ttl : Controls the validity time frame of the OTP. The default value is 900 seconds. Another OTP generated within this time frame is also allowed.

c) egov.otp.encrypt : Controls if the OTP is encrypted and stored in the table.

Deployment Details

Deploy the latest version of egov-otp service.
Add role-action mapping for APIs.

Integration Details

Integration Scope

The egov-otp service is used to authenticate the user in the platform.

Integration Benefits

Can perform user authentication without impacting the other module.
In the future, this application can be used in a standalone manner in any other platforms that require a user authentication system.

Integration Steps

To integrate, the host of egov-otp module should be overwritten in the helm chart.
/otp/v1/_create should be added as the create endpoint. Create OTP configuration API is an internal call from v1/_send endpoint. This endpoint is present in the user-otp service and removes the need for explicit calls.
/otp/v1/_validate should be added as the validate endpoint. The OTP configuration end point validates the OTP with respect to the mobile number.
/otp/v1/_search should be added as the search endpoint. This API searches the mobile number and OTP using uuid - mapping uuid to OTP reference number.

Reference Docs

Doc Links

API Details

BasePath /egov-otp/v1

Egov-otp service APIs - contains create, validate and search endpoints

a) POST /otp/v1/_create - create OTP configuration this API is an internal call from v1/_send endpoint. This endpoint present in the user-otp service removes the need for explicit calls.

b) POST /otp/v1/_validate - validate OTP configuration this endpoint is to validate the OTP with respect to the mobile number

c) POST /otp/v1/_search - Search the mobile number and OTP using uuid, uuid using the OTP reference number

Payment Gateway Service

Overview

eGov Payment Gateway acts as a liaison between eGov apps and external payment gateways facilitating payments, reconciliation of payments and lookup of transactions' status'.

Pre-requisites

Before you proceed with the documentation, make sure the following pre-requisites are met -

Java 17
Kafka server is up and running
service is running and has pg service added in it
PSQL server is running and the database is created to store transaction data.
- Note : You can follow this to setup postgreSQL locally and create a DB in it.

Key Functionalities

Create or initiate a transaction, to make a payment against a bill.
Make payment for multiple bill details [multi module] for a single consumer code at once.
Transaction to initiate a call to the transaction/_create API, various validations are carried out to ensure the sanctity of the request.
The response includes a generated transaction id and a redirect URL to the payment gateway itself.
Various validations are carried out to verify the authenticity of the request and the status is updated accordingly. If the transaction is successful, a receipt is generated for the same.

Payment Flow

Reconciliation

Reconciliation is carried out by two jobs scheduled via a Quartz clustered scheduler.
The early Reconciliation job is set to run every 15 minutes [configurable via app properties] and is aimed at reconciling transactions which were created 15 - 30 minutes ago and are in a PENDING state.
The daily Reconciliation job is set to run once per day and is aimed at reconciling all transactions that are in a PENDING state, except for ones which were created 30 minutes ago.

Extensions

Axis, Phonepe and Paytm payment gateways are implemented.

Configuration Details

The following properties in the application.properties file in egov-pg-service have to be added and set to default value after integrating with the new payment gateway. In the below table properties for AXIS bank, payment gateway is shown the same relevant property needs to be added for other payment gateways.

Deployment Details

Deploy the latest version of egov-pg-service.
Add pg service persister yaml path in persister configuration.

Integration Details

Integration Scope

The egov-pg-service acts as communication/contact between eGov apps and external payment gateways.

Integration Benefits

Record every transaction against a bill.
Record of payment for multiple bill details for a single consumer code at once.

Integration Steps

To integrate, the host of egov-pg-service should be overwritten in helm chart
/pg-service/transaction/v1/_create should be added in the module to initiate a new payment transaction, on successful validation
/pg-service/transaction/v1/_update should be added as the update endpoint to updates an existing payment transaction. This endpoint is issued only by payment gateways to update the status of payments. It verifies the authenticity of the request with the payment gateway and forwards all query params received from a payment gateway
/pg-service/transaction/v1/_search should be added as the search endpoint for retrieving the current status of a payment in our system.

Reference Docs

Doc Links

API List

(Note: All the APIs are in the same postman collection therefore the same link is added in each row)

PDF Generation Service

Configure bulk generation of PDF documents

Overview

The objective of the PDF generation service is to bulk generate pdf as per requirement.

Pre-requisites

Before proceeding with the documentation, ensure the following prerequisites are met:

NPM
Ensure the Kafka server is operational
Confirm that the service is running and configured with a persister
Verify that the PostgreSQL (PSQL) server is running, and a database is created to store filestore IDs and job IDs of generated PDFs
- Note : Refer to this to know how to install postgreSQL locally and then creating a DB

Key Functionalities

Provide a common framework to generate PDFs
Provide flexibility to customise the PDF as per the requirement
Provide functionality to add an image or QR code in a PDF
Provide functionality to generate PDFs in bulk
Provide functionality to specify the maximum number of records to be written in one PDF

External libraries used :

Interaction Diagram

Deployment Details

Create data config and format config for a PDF according to product requirements.
Add data config and format config files in PDF configuration.
Add the file path of data and format config in the environment yaml file.
Deploy the latest version of pdf-service in a particular environment.

Configuration Details

Integration Details

Integration Scope

The PDF configuration can be used by any module which needs to show particular information in PDF format that can be printed/downloaded by the user.

Integration Benefits

Functionality to generate PDFs in bulk.
Avoid regeneration.
Support QR codes and Images.
Functionality to specify the maximum number of records to be written in one PDF.
Uploading generated PDF to filestore and return filestore id for easy access.

Integration Steps

To download and print the required PDF _create API has to be called with the required key (For Integration with UI, please refer to the links in Reference Docs)

Reference Docs

Doc Links

API List

Note: All the APIs are in the same Postman collection, therefore, the same link is added in each row.

Persister Service

Overview

Persister service provides a framework to persist data in transactional fashion with low latency based on a config file. Removes repetitive and time consuming persistence code from other services.

Pre-requisites

Before you proceed with the documentation, make sure the following pre-requisites are met -

Prior Knowledge of Java/J2EE.
Prior Knowledge of SpringBoot.
Prior Knowledge of PostgresSQL.
Prior Knowledge of JSONQuery in Postgres. (Similar to PostgresSQL with a few aggregate functions.).
Kafka server is up and running.

Key Functionalities

Persist data asynchronously using kafka providing very low latency
Data is persisted in batch
All operations are transactional
Values in prepared statement placeholder are fetched using JsonPath
Easy reference to parent object using ‘{x}’ in jsonPath which substitutes the value of the variable x in the JsonPath with value of x for the child object.(explained in detail below in doc)
Supported data types ARRAY("ARRAY"), STRING("STRING"), INT("INT"),DOUBLE("DOUBLE"), FLOAT("FLOAT"), DATE("DATE"), LONG("LONG"),BOOLEAN("BOOLEAN"),JSONB("JSONB")

Configuration Details

Persister uses configuration file to persist data. The key variables are described below:

serviceName: Name of the service to which this configuration belongs.
description: Description of the service.
version: the version of the configuration.
fromTopic: The kafka topic from which data is fetched
queryMaps: Contains the list of queries to be executed for the given data.
query: The query to be executed in form of prepared statement:
- basePath: base of json object from which data is extrated
- jsonMaps: Contains the list of jsonPaths for the values in placeholders.
- jsonPath: The jsonPath to fetch the variable value.

Bulk Persister:

To persist large quantity of data bulk setting in persister can be used. It is mainly used when we migrate data from one system to another. The bulk persister have the following two settings:

Any kafka topic containing data which has to be bulk persisted should have '-batch' appended at the end of topic name example: save-pt-assessment-batch.

Persister Config Versioning:

Every incoming request [via kafka] is expected to have a version attribute set, [jsonpath, $.RequestInfo.ver] if versioning is to be applied.
If the request version is absent or invalid [not semver] in the incoming request, then a default version defined by the following property in application.propertiesdefault.version=1.0.0 is used.
The request version is then matched against the loaded persister configs and applied appropriately.

Deployment Details

Write configuration as per the requirement. Refer the example given earlier.
In the environment file, mention the file path of configuration under the variable egov.persist.yml.repo.path while mentioning the file path we have to add file:///work-dir/ as prefix. for example: egov.persist.yml.repo.path = file:///work-dir/configs/egov-persister/abc-persister.yml. If there are multiple file separate it with comma (,) .
Deploy latest version of egov-persister service and push data on kafka topic specified in config to persist it in DB.

Integration

Integration Scope

The persister configuration can be used by any module to store records in particular table of database.

Integration Benefits

Insert/Update Incoming Kafka messages to Database.
Add Modify kafka message before putting it into database.
Persist data asynchronously.
Data is persisted in batch.

Steps to Integration

Write configuration as per your requirement. Structure of the config file is explained above in the same document.
Check-in the config file to a remote location preferably github.
Provide the absolute path of the checked-in file to DevOps, to add it to the file-read path of egov-persister. The file will be added to egov-persister's environment manifest file for it to be read at start-up of the application.
Run the egov-persister app and push data on kafka topic specified in config to persist it in DB

Reference Docs

Libraries

Accelerators

curl --location 'http://localhost:8081/boundary/_migrate' \
--header 'Content-Type: application/json' \
--data '{
    "RequestInfo": {
        "apiId": "string",
        "ver": "string",
        "ts": 0,
        "action": "string",
        "did": "string",
        "key": "string",
        "msgId": "string",
        "requesterId": "string",
        "authToken": "string",
        "userInfo": {
            "tenantId": "string",
            "id": 0,
            "uuid": "string"
        }
    },
    "tenantId": "pb.phagwara",
    "moduleName": "egov-location",
    "TenantBoundary": [
        {
            "hierarchyType": {
                "code": "ADMIN",
                "name": "ADMIN"
            },
            "boundary": {
                "id": 1,
                "boundaryNum": 1,
                "name": "Phagwara",
                "localname": "Phagwara",
                "longitude": null,
                "latitude": null,
                "label": "City",
                "code": "pb.phagwara",
                "children": [
                    {
                        "id": "4b486f04-4f31-4cf7-bf03-62d725ace784",
                        "boundaryNum": 1,
                        "name": "Phagwara",
                        "localname": "Phagwara",
                        "longitude": null,
                        "latitude": null,
                        "label": "Zone",
                        "code": "PZN1",
                        "children": [
                            {
                                "id": "2583e7a6-140d-4f3c-9543-d7693849ed24",
                                "boundaryNum": 1,
                                "name": "WARD_1",
                                "localname": "WARD_1",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD1",
                                "children": []
                            },
                            {
                                "id": "b0b952ee-f53c-4c73-8063-be718fd93cdd",
                                "boundaryNum": 1,
                                "name": "WARD_2",
                                "localname": "WARD_2",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD2",
                                "children": [
                                    {
                                        "id": "3b0cdbae-b942-42fa-a03b-70c04e00d53d",
                                        "boundaryNum": 1,
                                        "name": "Asha Park Colony",
                                        "localname": "Asha Park Colony",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC10",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "ecf7079e-d3a4-4732-ad87-0b00b7b725bc",
                                        "boundaryNum": 1,
                                        "name": "Bhai Ghanaiya Ji Enclave",
                                        "localname": "Bhai Ghanaiya Ji Enclave",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC25",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "6d7d2816-f299-4618-b351-fa0699f246c7",
                                        "boundaryNum": 1,
                                        "name": "Bhai Ghanaiya Ji Nagar",
                                        "localname": "Bhai Ghanaiya Ji Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC26",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "170d78ed-726c-46a0-a8dc-242a7c81c038",
                                        "boundaryNum": 1,
                                        "name": "Chahal Nagar",
                                        "localname": "Chahal Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC33",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "91c96922-e36a-4a56-b2da-5a9c28787c07",
                                        "boundaryNum": 1,
                                        "name": "Dashmesh Nagar",
                                        "localname": "Dashmesh Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC40",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "307a4bc9-d238-4159-8727-32481c1514a6",
                                        "boundaryNum": 1,
                                        "name": "Green Park",
                                        "localname": "Green Park",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC65",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "98c41dd3-e192-415d-b225-1ddd48e6dbb8",
                                        "boundaryNum": 1,
                                        "name": "MANAV ENCLAVE",
                                        "localname": "MANAV ENCLAVE",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC109",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "deb0e5fe-aafe-436c-823c-9bc1d0c5d330",
                                        "boundaryNum": 1,
                                        "name": "N.R.I Enclave",
                                        "localname": "N.R.I Enclave",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC124",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "ea4caa8b-abe5-4526-8ec6-21fb9573989a",
                                        "boundaryNum": 1,
                                        "name": "New Vishwakarma Nagar",
                                        "localname": "New Vishwakarma Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC138",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "72614980-5782-4671-8080-95deecd28012",
                                        "boundaryNum": 1,
                                        "name": "Raja Garden Colony",
                                        "localname": "Raja Garden Colony",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC164",
                                        "area": "",
                                        "children": []
                                    }
                                ]
                            },
                            {
                                "id": "5e19000e-7fa1-48d0-9f56-8e16d47919dc",
                                "boundaryNum": 1,
                                "name": "WARD_3",
                                "localname": "WARD_3",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD3",
                                "children": [
                                    {
                                        "id": "9bf79ce5-5bf9-44fd-a769-8a2b5258d3a9",
                                        "boundaryNum": 1,
                                        "name": "Ashok Vihar",
                                        "localname": "Ashok Vihar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC11",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "5fddef40-00ab-406d-9b10-26bc24d8b9c8",
                                        "boundaryNum": 1,
                                        "name": "DR. SATISH NAGAR",
                                        "localname": "DR. SATISH NAGAR",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC48",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "78717620-b84b-4514-bc49-294bf3129e3b",
                                        "boundaryNum": 1,
                                        "name": "Green Avenue",
                                        "localname": "Green Avenue",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC62",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "6a3431c3-82b3-4509-a600-9f05e0682f27",
                                        "boundaryNum": 1,
                                        "name": "Green Valley",
                                        "localname": "Green Valley",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC66",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "a83f4eaf-41b3-43c7-9959-aafb4192b6ce",
                                        "boundaryNum": 1,
                                        "name": "Guru Nanak Nagar",
                                        "localname": "Guru Nanak Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC71",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "818b618b-de9e-4e21-9004-ef0fb0cc027c",
                                        "boundaryNum": 1,
                                        "name": "Hajipur",
                                        "localname": "Hajipur",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC76",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "2dc07769-a1b3-4505-9462-f6d9dc9bff30",
                                        "boundaryNum": 1,
                                        "name": "HARGOBIND ENCLAVE",
                                        "localname": "HARGOBIND ENCLAVE",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC80",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "1d600e07-0c64-45b9-9ae3-bba018d3d8c9",
                                        "boundaryNum": 1,
                                        "name": "Jeewan Nagar",
                                        "localname": "Jeewan Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC89",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "b8b69483-47e9-4c34-aac8-ca8ff851996a",
                                        "boundaryNum": 1,
                                        "name": "Khera Masit",
                                        "localname": "Khera Masit",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC99",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "2427abd1-031f-48e6-9451-3b9c84bf2e7c",
                                        "boundaryNum": 1,
                                        "name": "Kirti Nagar",
                                        "localname": "Kirti Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC103",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "940b4fad-9d75-43a0-b5de-ab4085293ff5",
                                        "boundaryNum": 1,
                                        "name": "MAIN KHALWARA ROAD",
                                        "localname": "MAIN KHALWARA ROAD",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC108",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "8976b9d9-a131-4e86-8854-e11d58f915b0",
                                        "boundaryNum": 1,
                                        "name": "NORTH AVENUE",
                                        "localname": "NORTH AVENUE",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC140",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "28303ef9-6448-46c4-8846-3d7d353d095b",
                                        "boundaryNum": 1,
                                        "name": "Palahi Road",
                                        "localname": "Palahi Road",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC145",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "01e9ee24-6012-4646-b5fa-b50d69ee9deb",
                                        "boundaryNum": 1,
                                        "name": "Parmar Colony",
                                        "localname": "Parmar Colony",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC148",
                                        "area": "",
                                        "children": []
                                    }
                                ]
                            },
                            {
                                "id": "87a38051-b43f-4791-949a-157e332f33b2",
                                "boundaryNum": 1,
                                "name": "WARD_4",
                                "localname": "WARD_4",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD4",
                                "children": [
                                    {
                                        "id": "48a2fbe5-ad7f-437d-9c42-6fded5532e02",
                                        "boundaryNum": 1,
                                        "name": "Dharam Kot",
                                        "localname": "Dharam Kot",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC44",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "5b8ee409-ac4c-4355-bc8f-a615b0839d60",
                                        "boundaryNum": 1,
                                        "name": "G T Road To Hoshiarpur Road",
                                        "localname": "G T Road To Hoshiarpur Road",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC52",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "946d6577-622d-40eb-96e8-ed05c68f414e",
                                        "boundaryNum": 1,
                                        "name": "Guru Nanak Avenue",
                                        "localname": "Guru Nanak Avenue",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC69",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "ce998365-0449-4420-b1c9-ebc0cde22b10",
                                        "boundaryNum": 1,
                                        "name": "Pritam Nagar",
                                        "localname": "Pritam Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC156",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "4315333c-eb5d-4755-9a3f-28a37ab527d7",
                                        "boundaryNum": 1,
                                        "name": "S.P Colony",
                                        "localname": "S.P Colony",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC172",
                                        "area": "",
                                        "children": []
                                    }
                                ]
                            },
                            {
                                "id": "f2dbff50-dd13-4ae0-ba14-4e5957f040c4",
                                "boundaryNum": 1,
                                "name": "WARD_5",
                                "localname": "WARD_5",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD5",
                                "children": [
                                    {
                                        "id": "2f05cf03-cbdc-4d1c-8989-4ef8be7a5dac",
                                        "boundaryNum": 1,
                                        "name": "Baba Gadhia To Dana Mandi",
                                        "localname": "Baba Gadhia To Dana Mandi",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC15",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "01b014f3-e54f-4472-a0df-8b513127ced9",
                                        "boundaryNum": 1,
                                        "name": "Bhularai Road",
                                        "localname": "Bhularai Road",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC28",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "23d91c85-332c-4efe-9b41-0507063ab65f",
                                        "boundaryNum": 1,
                                        "name": "City Heart Colony",
                                        "localname": "City Heart Colony",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC36",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "2c1891e0-adef-47e9-8e5e-77e4f2e0174c",
                                        "boundaryNum": 1,
                                        "name": "Guru Nanak Enclave",
                                        "localname": "Guru Nanak Enclave",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC70",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "23bdace2-452c-4b86-aca8-0f6123453487",
                                        "boundaryNum": 1,
                                        "name": "Purewal Nagar",
                                        "localname": "Purewal Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC161",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "ba7454af-1e75-463a-bd92-8b8aeb43261f",
                                        "boundaryNum": 1,
                                        "name": "Ranjit Nagar",
                                        "localname": "Ranjit Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC166",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "d09b83b0-824b-4b91-8401-29d496264911",
                                        "boundaryNum": 1,
                                        "name": "Ru Pinjni Mohalla",
                                        "localname": "Ru Pinjni Mohalla",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC171",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "7eb5cb43-e1d9-405f-813c-394812bb2372",
                                        "boundaryNum": 1,
                                        "name": "Sahibzada Ajit Singh Nagar",
                                        "localname": "Sahibzada Ajit Singh Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC175",
                                        "area": "",
                                        "children": []
                                    }
                                ]
                            },
                            {
                                "id": "3de89762-d4c6-482f-b571-d5e77d024f6f",
                                "boundaryNum": 1,
                                "name": "WARD_6",
                                "localname": "WARD_6",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD6",
                                "children": [
                                    {
                                        "id": "c90172a0-9b37-4aa0-8b17-a6f3d162f773",
                                        "boundaryNum": 1,
                                        "name": "Amar Nagar",
                                        "localname": "Amar Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC5",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "1339d160-8180-4db0-b551-f34438407988",
                                        "boundaryNum": 1,
                                        "name": "Gaunspur",
                                        "localname": "Gaunspur",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC56",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "b6afc7e5-5b43-4784-a2b8-d7078c8d628b",
                                        "boundaryNum": 1,
                                        "name": "Guru Ravidas Nagar",
                                        "localname": "Guru Ravidas Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC73",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "8d75a617-1f5d-4d41-83f0-fb70b606b1bc",
                                        "boundaryNum": 1,
                                        "name": "Harkrishan Nagar",
                                        "localname": "Harkrishan Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC81",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "d111f1a9-94c2-424b-b521-119ce6f6377b",
                                        "boundaryNum": 1,
                                        "name": "Kaulsar Mohalla",
                                        "localname": "Kaulsar Mohalla",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC96",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "444a1f25-ada9-4d43-a278-1c60fc8ffafa",
                                        "boundaryNum": 1,
                                        "name": "New Guru Harkrishan Nagar",
                                        "localname": "New Guru Harkrishan Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC132",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "152d261c-17e5-45ba-9f1a-233c84cb55f1",
                                        "boundaryNum": 1,
                                        "name": "New Sukhchain Nagar",
                                        "localname": "New Sukhchain Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC137",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "31a34d66-975e-4b62-ada2-837dd1053d44",
                                        "boundaryNum": 1,
                                        "name": "Ravinder Nagar",
                                        "localname": "Ravinder Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC168",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "5f05b1a8-ad9d-4e86-8614-52f3dfb583ac",
                                        "boundaryNum": 1,
                                        "name": "Shahid Joginder Singh Nagar",
                                        "localname": "Shahid Joginder Singh Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC186",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "64973403-9a02-4972-b567-2ef4e0e4b98b",
                                        "boundaryNum": 1,
                                        "name": "Taru Ka Wara",
                                        "localname": "Taru Ka Wara",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC206",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "5662f090-03d7-478c-98ba-f88b97a5e74d",
                                        "boundaryNum": 1,
                                        "name": "Vishwakarma Colony",
                                        "localname": "Vishwakarma Colony",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC213",
                                        "area": "",
                                        "children": []
                                    }
                                ]
                            },
                            {
                                "id": "d8b26439-9b40-4529-8cc2-1083a947a52b",
                                "boundaryNum": 1,
                                "name": "WARD_7",
                                "localname": "WARD_7",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD7",
                                "children": [
                                    {
                                        "id": "8e2cc725-b4f9-4d11-9e3a-f2ba18bd4f86",
                                        "boundaryNum": 1,
                                        "name": "Sukhchain Sahib Road",
                                        "localname": "Sukhchain Sahib Road",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC201",
                                        "area": "",
                                        "children": []
                                    }
                                ]
                            },
                            {
                                "id": "5a7548af-e9c4-491e-93dc-4987910197fc",
                                "boundaryNum": 1,
                                "name": "WARD_8",
                                "localname": "WARD_8",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD8",
                                "children": [
                                    {
                                        "id": "72ddd32d-2f81-4e64-9aa3-f926f4c4b29f",
                                        "boundaryNum": 1,
                                        "name": "Baba Fateh Singh Nagar",
                                        "localname": "Baba Fateh Singh Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC13",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "747d8981-54a1-4e2c-ac8f-24726ca47ade",
                                        "boundaryNum": 1,
                                        "name": "Basra Palace To Khothra Road",
                                        "localname": "Basra Palace To Khothra Road",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC23",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "31ac775c-b472-48df-926b-512022ff7e28",
                                        "boundaryNum": 1,
                                        "name": "Guru Hargobind Nagar",
                                        "localname": "Guru Hargobind Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC68",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "109d00d3-d57b-40fa-beee-6dd8bc144722",
                                        "boundaryNum": 1,
                                        "name": "Patel Nagar",
                                        "localname": "Patel Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC149",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "7178f938-e1df-46f7-82cf-77b90f4dcae5",
                                        "boundaryNum": 1,
                                        "name": "Sukhchain Nagar",
                                        "localname": "Sukhchain Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC200",
                                        "area": "",
                                        "children": []
                                    }
                                ]
                            },
                            {
                                "id": "47febeee-7ae4-4a4f-9e65-e0d3194709aa",
                                "boundaryNum": 1,
                                "name": "WARD_9",
                                "localname": "WARD_9",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD9",
                                "children": [
                                    {
                                        "id": "9d081b9f-a25e-4c0f-9191-eb148d1c3448",
                                        "boundaryNum": 1,
                                        "name": "Baba Gadhia",
                                        "localname": "Baba Gadhia",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC14",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "c9146974-f410-4e19-b4a5-9f2d40a75519",
                                        "boundaryNum": 1,
                                        "name": "Mohalla Subhash Nagar",
                                        "localname": "Mohalla Subhash Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC121",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "f6a1a4de-bbff-4a79-a695-8e4e8f8ece91",
                                        "boundaryNum": 1,
                                        "name": "New Professor Colony",
                                        "localname": "New Professor Colony",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC135",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "8c75e22c-4615-432a-b0b5-8f9a2e49c336",
                                        "boundaryNum": 1,
                                        "name": "Nri Colony",
                                        "localname": "Nri Colony",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC141",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "8494d7a6-d6ac-4602-8822-90fd7d016981",
                                        "boundaryNum": 1,
                                        "name": "Professor Colony",
                                        "localname": "Professor Colony",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC157",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "bfd0706f-911d-4a7a-9bc1-545c4aa1f704",
                                        "boundaryNum": 1,
                                        "name": "Saini Mohalla",
                                        "localname": "Saini Mohalla",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC176",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "8a03f7a6-50a6-4813-97f0-157f24aaedae",
                                        "boundaryNum": 1,
                                        "name": "Shiva Ji Nagar",
                                        "localname": "Shiva Ji Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC192",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "e7859953-e88e-4b5d-9405-03f5c056fc13",
                                        "boundaryNum": 1,
                                        "name": "Taki Mohalla",
                                        "localname": "Taki Mohalla",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC205",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "a9fc9918-e7d7-4123-9b74-8c0bedca779f",
                                        "boundaryNum": 1,
                                        "name": "Varinder Nagar",
                                        "localname": "Varinder Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC211",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "fa86ff48-9f41-4567-8b7d-77c3f702f22e",
                                        "boundaryNum": 1,
                                        "name": "Vikas Nagar",
                                        "localname": "Vikas Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC212",
                                        "area": "",
                                        "children": []
                                    }
                                ]
                            },
                            {
                                "id": "9f36c495-f1d9-45a9-a0a7-a54854fc1255",
                                "boundaryNum": 1,
                                "name": "WARD_10",
                                "localname": "WARD_10",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD10",
                                "children": [
                                    {
                                        "id": "e73d206e-1421-4bb4-aa5c-cdbbe0a3d74f",
                                        "boundaryNum": 1,
                                        "name": "Ankhi Nagar",
                                        "localname": "Ankhi Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC7",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "659869f5-ea47-49d9-bb95-cf0550f7fef5",
                                        "boundaryNum": 1,
                                        "name": "Kabir Nagar",
                                        "localname": "Kabir Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC92",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "4414d37b-d873-4369-a0f1-e72f38069947",
                                        "boundaryNum": 1,
                                        "name": "KHALSA ENCLAVE",
                                        "localname": "KHALSA ENCLAVE",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC97",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "a46e4140-e10a-469b-8c11-2bfeec8250a5",
                                        "boundaryNum": 1,
                                        "name": "Khalwara Gate",
                                        "localname": "Khalwara Gate",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC98",
                                        "area": "",
                                        "children": []
                                    }
                                ]
                            },
                            {
                                "id": "2b37c059-ded4-44dc-afc8-c77f634decaf",
                                "boundaryNum": 1,
                                "name": "WARD_11",
                                "localname": "WARD_11",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD11",
                                "children": [
                                    {
                                        "id": "c662b590-6427-4ac1-bbd6-6daba0f11f14",
                                        "boundaryNum": 1,
                                        "name": "Navi Dana Mandi",
                                        "localname": "Navi Dana Mandi",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC129",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "53f696e9-a1e5-4ba3-9208-7b80c479d218",
                                        "boundaryNum": 1,
                                        "name": "Plahi Gate",
                                        "localname": "Plahi Gate",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC152",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "73364e65-143d-4bf3-ad46-34a06899fb8d",
                                        "boundaryNum": 1,
                                        "name": "Sabzi Mandi",
                                        "localname": "Sabzi Mandi",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC173",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "b86f59fe-1541-4950-b1e6-673ad021722e",
                                        "boundaryNum": 1,
                                        "name": "Soond Colony",
                                        "localname": "Soond Colony",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC195",
                                        "area": "",
                                        "children": []
                                    }
                                ]
                            },
                            {
                                "id": "f4217655-10c6-4787-b3a8-19bb1ebd49af",
                                "boundaryNum": 1,
                                "name": "WARD_12",
                                "localname": "WARD_12",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD12",
                                "children": [
                                    {
                                        "id": "04c1fc6b-1567-4ae5-961a-1f0bc9e1abad",
                                        "boundaryNum": 1,
                                        "name": "Anand Nagar",
                                        "localname": "Anand Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC6",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "aadb1ce2-6a3b-4c4e-a28b-cf275da80a44",
                                        "boundaryNum": 1,
                                        "name": "Arjun Pura",
                                        "localname": "Arjun Pura",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC8",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "9ebd1986-8462-47c7-bd0a-411316b4c6ee",
                                        "boundaryNum": 1,
                                        "name": "Shahid Bhagat Singh Nagar",
                                        "localname": "Shahid Bhagat Singh Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC185",
                                        "area": "",
                                        "children": []
                                    }
                                ]
                            },
                            {
                                "id": "f8951d9f-311d-47bb-ab15-ada48db8af4f",
                                "boundaryNum": 1,
                                "name": "WARD_13",
                                "localname": "WARD_13",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD13",
                                "children": [
                                    {
                                        "id": "bb7ffa64-5a50-47ef-b85f-bdfd4f67bc41",
                                        "boundaryNum": 1,
                                        "name": "chora Khoo",
                                        "localname": "chora Khoo",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC34",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "e078fce2-4fac-489f-a514-a6d0f88a5b6e",
                                        "boundaryNum": 1,
                                        "name": "Naiya Wala Chowk",
                                        "localname": "Naiya Wala Chowk",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC125",
                                        "area": "",
                                        "children": []
                                    }
                                ]
                            },
                            {
                                "id": "404b5d49-0623-4d6a-8625-761a985a0494",
                                "boundaryNum": 1,
                                "name": "WARD_14",
                                "localname": "WARD_14",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD14",
                                "children": [
                                    {
                                        "id": "88de4f92-ea13-454d-905a-300f4b6177bb",
                                        "boundaryNum": 1,
                                        "name": "Daddal Mohalla",
                                        "localname": "Daddal Mohalla",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC38",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "c4b8c94b-a27f-4152-98c5-629db1c57c5c",
                                        "boundaryNum": 1,
                                        "name": "Lamian Mohalla",
                                        "localname": "Lamian Mohalla",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC106",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "88c486cf-59f4-437b-85cb-6959538c192c",
                                        "boundaryNum": 1,
                                        "name": "Purana Thanna",
                                        "localname": "Purana Thanna",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC158",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "a1fd1347-34d8-4893-b316-41ec5d0ff6c9",
                                        "boundaryNum": 1,
                                        "name": "Sachra Mohalla",
                                        "localname": "Sachra Mohalla",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC174",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "979d01f9-50a8-42f1-b579-f27b4ebb5c39",
                                        "boundaryNum": 1,
                                        "name": "Sarafa Bazar",
                                        "localname": "Sarafa Bazar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC182",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "8a3b208c-b984-4ffe-bea6-f2dcd0a44a2e",
                                        "boundaryNum": 1,
                                        "name": "Sudan Mohalla",
                                        "localname": "Sudan Mohalla",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC196",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "8fb3725d-0108-47ac-8442-54ffb4ef2946",
                                        "boundaryNum": 1,
                                        "name": "Sufia Mohalla",
                                        "localname": "Sufia Mohalla",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC198",
                                        "area": "",
                                        "children": []
                                    }
                                ]
                            },
                            {
                                "id": "39b65c52-d718-423b-b2c1-7354187da50f",
                                "boundaryNum": 1,
                                "name": "WARD_15",
                                "localname": "WARD_15",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD15",
                                "children": [
                                    {
                                        "id": "d748ca91-b717-43f4-a54a-66254bd4e2a2",
                                        "boundaryNum": 1,
                                        "name": "Ahluwalia Mohalla",
                                        "localname": "Ahluwalia Mohalla",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC4",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "50825d48-8d89-4230-866e-75584b1da514",
                                        "boundaryNum": 1,
                                        "name": "Bagh Sudan",
                                        "localname": "Bagh Sudan",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC17",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "c12e61ff-2967-42b9-bcad-ade13f7f1e10",
                                        "boundaryNum": 1,
                                        "name": "Sikha Mohalla",
                                        "localname": "Sikha Mohalla",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC193",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "4145cf2a-21a8-418c-97bc-f017fe57e2fa",
                                        "boundaryNum": 1,
                                        "name": "Tabacco Kutta Mohalla",
                                        "localname": "Tabacco Kutta Mohalla",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC203",
                                        "area": "",
                                        "children": []
                                    }
                                ]
                            },
                            {
                                "id": "81653fdc-688d-4ec2-a43c-e41237067a14",
                                "boundaryNum": 1,
                                "name": "WARD_16",
                                "localname": "WARD_16",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD16",
                                "children": [
                                    {
                                        "id": "5eac43ba-07fa-4db9-9113-2c4d1e1f5326",
                                        "boundaryNum": 1,
                                        "name": "Mehli Gate",
                                        "localname": "Mehli Gate",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC113",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "7efad2f8-b5b3-468e-8c16-d5628b2d030b",
                                        "boundaryNum": 1,
                                        "name": "Mohalla Karbala",
                                        "localname": "Mohalla Karbala",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC117",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "abb1070c-af44-4e34-bbe7-46abe3d550dc",
                                        "boundaryNum": 1,
                                        "name": "NIGAHAN MOHALLA",
                                        "localname": "NIGAHAN MOHALLA",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC139",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "e8ff961d-506c-4cab-9141-43a49d03ff26",
                                        "boundaryNum": 1,
                                        "name": "Shastri Nagar",
                                        "localname": "Shastri Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC189",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "d8aeefdb-dfd9-4bd3-8e6c-fc1743cb07a7",
                                        "boundaryNum": 1,
                                        "name": "Thanedar Mohalla",
                                        "localname": "Thanedar Mohalla",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC208",
                                        "area": "",
                                        "children": []
                                    }
                                ]
                            },
                            {
                                "id": "9a574042-1196-4775-a09b-806d9e7cc4c1",
                                "boundaryNum": 1,
                                "name": "WARD_17",
                                "localname": "WARD_17",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD17",
                                "children": [
                                    {
                                        "id": "181cb55f-3896-4f22-b1b3-84c211388f5e",
                                        "boundaryNum": 1,
                                        "name": "Aatisbaja Mohalla",
                                        "localname": "Aatisbaja Mohalla",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC1",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "f79c0d1a-10c0-41f4-89f2-5f0fa65fcb45",
                                        "boundaryNum": 1,
                                        "name": "Balmik Mohalla",
                                        "localname": "Balmik Mohalla",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC19",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "6de24561-b233-41ef-9a35-406da0a6102d",
                                        "boundaryNum": 1,
                                        "name": "Katehra Chowk",
                                        "localname": "Katehra Chowk",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC94",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "32fb89fb-f53e-4c7e-a3b6-75edb2f0e6f8",
                                        "boundaryNum": 1,
                                        "name": "Korhian Mohalla",
                                        "localname": "Korhian Mohalla",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC104",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "4a3de197-30b1-45c1-92e8-2f43bdcf929b",
                                        "boundaryNum": 1,
                                        "name": "Purbian Mohalla",
                                        "localname": "Purbian Mohalla",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC160",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "3d088be1-eb75-4e00-a0ae-37a4c947b29a",
                                        "boundaryNum": 1,
                                        "name": "Sandhura Mandir",
                                        "localname": "Sandhura Mandir",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC178",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "dc726240-5f54-4c12-bf42-3796f8dce0a7",
                                        "boundaryNum": 1,
                                        "name": "Sarabha Nagar",
                                        "localname": "Sarabha Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC181",
                                        "area": "",
                                        "children": []
                                    }
                                ]
                            },
                            {
                                "id": "d903c265-de9e-4395-b65e-49ce89924ca6",
                                "boundaryNum": 1,
                                "name": "WARD_18",
                                "localname": "WARD_18",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD18",
                                "children": [
                                    {
                                        "id": "9ead5fa0-cb6d-4f21-a6b3-1e4982728b76",
                                        "boundaryNum": 1,
                                        "name": "AROHYA MOHALLA",
                                        "localname": "AROHYA MOHALLA",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC9",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "28f5ff3e-0a3e-40d5-ab84-00705c3eadd2",
                                        "boundaryNum": 1,
                                        "name": "Avtar Nagar",
                                        "localname": "Avtar Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC12",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "71c89281-d450-44a1-8d3a-b3704b6ec8e2",
                                        "boundaryNum": 1,
                                        "name": "Cinema Road",
                                        "localname": "Cinema Road",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC35",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "c3b87a17-c17e-4996-ba8f-ad2f63f353c2",
                                        "boundaryNum": 1,
                                        "name": "G T Road Jal. To Ldh.",
                                        "localname": "G T Road Jal. To Ldh.",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC51",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "3014d968-a4a5-4a46-993c-127896012bba",
                                        "boundaryNum": 1,
                                        "name": "Gandhi Nagar",
                                        "localname": "Gandhi Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC55",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "01651392-82fb-4949-85b1-04e06da5101e",
                                        "boundaryNum": 1,
                                        "name": "JAINIA MOHALA",
                                        "localname": "JAINIA MOHALA",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC86",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "7da0f4c7-0552-453b-995c-01467187ab7f",
                                        "boundaryNum": 1,
                                        "name": "Mohalla Ohrian",
                                        "localname": "Mohalla Ohrian",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC119",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "e715b971-8d17-458f-8772-1e3aaeef2584",
                                        "boundaryNum": 1,
                                        "name": "Moti Bazar",
                                        "localname": "Moti Bazar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC123",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "e4b19c57-e909-41ff-80aa-d7c7480e000c",
                                        "boundaryNum": 1,
                                        "name": "Old Civil Hospital To Banga Road",
                                        "localname": "Old Civil Hospital To Banga Road",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC142",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "3d88ec8b-d97c-4936-a076-77abb4d0d84c",
                                        "boundaryNum": 1,
                                        "name": "Sarai Road",
                                        "localname": "Sarai Road",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC183",
                                        "area": "",
                                        "children": []
                                    }
                                ]
                            },
                            {
                                "id": "4aa27bfb-e11d-47fb-b5b5-241b8c4ad8ac",
                                "boundaryNum": 1,
                                "name": "WARD_19",
                                "localname": "WARD_19",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD19",
                                "children": [
                                    {
                                        "id": "8fe926ea-fa98-4afa-b787-a00dd59d059d",
                                        "boundaryNum": 1,
                                        "name": "Babbar Akali Market",
                                        "localname": "Babbar Akali Market",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC16",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "007712f5-46f7-4472-afc8-933f6beb0b9a",
                                        "boundaryNum": 1,
                                        "name": "Bansa Wala Bazar Road To Masit",
                                        "localname": "Bansa Wala Bazar Road To Masit",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC20",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "25e8b6fb-e36d-4325-ad28-57afbebcce7d",
                                        "boundaryNum": 1,
                                        "name": "Chadha Market",
                                        "localname": "Chadha Market",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC32",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "cea86efb-e5c4-41fa-89db-9e2f2e00ae3b",
                                        "boundaryNum": 1,
                                        "name": "Gandhi Chowk To Loha Mandi",
                                        "localname": "Gandhi Chowk To Loha Mandi",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC54",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "b735fbf3-49f5-4323-be08-15cd6cd9fd9b",
                                        "boundaryNum": 1,
                                        "name": "Gur Mandi Road",
                                        "localname": "Gur Mandi Road",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC67",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "30d4c060-2ceb-4905-a2c1-1ca8a9913609",
                                        "boundaryNum": 1,
                                        "name": "Handa Complex",
                                        "localname": "Handa Complex",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC78",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "0db8848b-7e82-4db1-ac9e-fdf0fede7e19",
                                        "boundaryNum": 1,
                                        "name": "Handa Markit",
                                        "localname": "Handa Markit",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC79",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "0fc4de79-4a57-43de-9b50-31afc181e534",
                                        "boundaryNum": 1,
                                        "name": "Improvement Trust Shahid Bhagat Singh Nagar Scheme No 3",
                                        "localname": "Improvement Trust Shahid Bhagat Singh Nagar Scheme No 3",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC82",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "ea192af6-4db5-4507-9687-f72b1cb11770",
                                        "boundaryNum": 1,
                                        "name": "Jalandhria Colony",
                                        "localname": "Jalandhria Colony",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC87",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "4dbcf906-51d9-4301-beff-814a090ca4ca",
                                        "boundaryNum": 1,
                                        "name": "Jalotian Mohalla",
                                        "localname": "Jalotian Mohalla",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC88",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "b60ee23c-6554-4968-a04d-9f5c65ffaa7e",
                                        "boundaryNum": 1,
                                        "name": "Jhatkaian Chowk",
                                        "localname": "Jhatkaian Chowk",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC90",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "a65bf2b2-7ef0-4e2d-9a1f-c10f34df832c",
                                        "boundaryNum": 1,
                                        "name": "Joshian Mohalla",
                                        "localname": "Joshian Mohalla",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC91",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "e70b1677-dd2e-4940-b0c4-7dfd1e3912a2",
                                        "boundaryNum": 1,
                                        "name": "Mohalla Thathiara",
                                        "localname": "Mohalla Thathiara",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC122",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "ddc39de9-80a0-4531-b500-c2914a4e5ed0",
                                        "boundaryNum": 1,
                                        "name": "New Hargobind Nagar",
                                        "localname": "New Hargobind Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC133",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "b92756e4-35b3-41bc-b1d1-cc33cad3e69e",
                                        "boundaryNum": 1,
                                        "name": "Old Post Office",
                                        "localname": "Old Post Office",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC143",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "c7cd4241-f5eb-47c0-abfd-56df5fe522b8",
                                        "boundaryNum": 1,
                                        "name": "Paper Chowk To Old Civil Hospital Both Side",
                                        "localname": "Paper Chowk To Old Civil Hospital Both Side",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC146",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "0382d9f7-1450-4a84-b6b4-6349806c8125",
                                        "boundaryNum": 1,
                                        "name": "Purani Dana Mandi",
                                        "localname": "Purani Dana Mandi",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC159",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "ecbdec29-34e8-4fe2-a231-29f842edebe8",
                                        "boundaryNum": 1,
                                        "name": "Singla Markit",
                                        "localname": "Singla Markit",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC194",
                                        "area": "",
                                        "children": []
                                    }
                                ]
                            },
                            {
                                "id": "1953cdb3-f939-4098-9a47-84c427e2a241",
                                "boundaryNum": 1,
                                "name": "WARD_20",
                                "localname": "WARD_20",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD20",
                                "children": [
                                    {
                                        "id": "c501d6e9-f283-4a14-a69a-fe6f4984733b",
                                        "boundaryNum": 1,
                                        "name": "Friend Colony (Railway Line)",
                                        "localname": "Friend Colony (Railway Line)",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC50",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "c0afb00f-9c82-4b42-a5d1-b8170c431e4a",
                                        "boundaryNum": 1,
                                        "name": "Prem Pura",
                                        "localname": "Prem Pura",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC155",
                                        "area": "",
                                        "children": []
                                    }
                                ]
                            },
                            {
                                "id": "8cdff150-c215-4882-aeaa-070a5f65bfac",
                                "boundaryNum": 1,
                                "name": "WARD_21",
                                "localname": "WARD_21",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD21",
                                "children": [
                                    {
                                        "id": "b3a51bb7-3d0a-4e0a-bc31-e06a1e73b8df",
                                        "boundaryNum": 1,
                                        "name": "Central Town",
                                        "localname": "Central Town",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC30",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "c553d400-0381-46e3-a725-5bc9c942301b",
                                        "boundaryNum": 1,
                                        "name": "Indira Nagar",
                                        "localname": "Indira Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC83",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "b23e4c2b-5d16-47b5-a5d6-bce64f1a0ce1",
                                        "boundaryNum": 1,
                                        "name": "J.C.T Mill",
                                        "localname": "J.C.T Mill",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC85",
                                        "area": "",
                                        "children": []
                                    }
                                ]
                            },
                            {
                                "id": "e56dc42f-8796-4d89-b2d8-2cb52d8dbfa7",
                                "boundaryNum": 1,
                                "name": "WARD_22",
                                "localname": "WARD_22",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD22",
                                "children": [
                                    {
                                        "id": "042e03d2-52ac-4917-a47e-589176ddc035",
                                        "boundaryNum": 1,
                                        "name": "New Model Town",
                                        "localname": "New Model Town",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC134",
                                        "area": "",
                                        "children": []
                                    }
                                ]
                            },
                            {
                                "id": "8562f68e-8294-4b04-950c-f8cdfad34ffb",
                                "boundaryNum": 1,
                                "name": "WARD_23",
                                "localname": "WARD_23",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD23",
                                "children": [
                                    {
                                        "id": "4e083cea-096d-465e-8fbe-f97fe58db11c",
                                        "boundaryNum": 1,
                                        "name": "Green Model Town Colony",
                                        "localname": "Green Model Town Colony",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC64",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "3f436742-61fd-4b94-8873-39dc8a766fd2",
                                        "boundaryNum": 1,
                                        "name": "Pipa Rangi",
                                        "localname": "Pipa Rangi",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC151",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "732bb0bc-3b0e-4615-870c-70231fbe6676",
                                        "boundaryNum": 1,
                                        "name": "ROYAL COLONY",
                                        "localname": "ROYAL COLONY",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC170",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "e3079a39-990d-4a4a-9f38-18f71691264c",
                                        "boundaryNum": 1,
                                        "name": "Sham Nagar",
                                        "localname": "Sham Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC188",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "d2809606-04a2-4d7f-8541-8c60e3f7c127",
                                        "boundaryNum": 1,
                                        "name": "SWAMI PARAM NAGAR",
                                        "localname": "SWAMI PARAM NAGAR",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC202",
                                        "area": "",
                                        "children": []
                                    }
                                ]
                            },
                            {
                                "id": "1cfb0c84-baae-4d4b-80ae-b80eb501fe1b",
                                "boundaryNum": 1,
                                "name": "WARD_24",
                                "localname": "WARD_24",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD24",
                                "children": [
                                    {
                                        "id": "8d86bf8e-2f31-4325-826b-505ad7ee1e06",
                                        "boundaryNum": 1,
                                        "name": "Kaulsar Colony",
                                        "localname": "Kaulsar Colony",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC95",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "73758d70-4ca8-4191-a890-e18815eacedc",
                                        "boundaryNum": 1,
                                        "name": "Khothran Road",
                                        "localname": "Khothran Road",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC101",
                                        "area": "",
                                        "children": []
                                    }
                                ]
                            },
                            {
                                "id": "5a75191a-f725-4faf-ae29-f0dfd3ea1eec",
                                "boundaryNum": 1,
                                "name": "WARD_25",
                                "localname": "WARD_25",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD25",
                                "children": [
                                    {
                                        "id": "59ed0253-d93c-455f-8c1c-f0ad760f9775",
                                        "boundaryNum": 1,
                                        "name": "C.R.P Colony",
                                        "localname": "C.R.P Colony",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC29",
                                        "area": "",
                                        "children": []
                                    }
                                ]
                            },
                            {
                                "id": "06c419cd-6f12-4e27-9d39-d66d8a1a8a3e",
                                "boundaryNum": 1,
                                "name": "WARD_26",
                                "localname": "WARD_26",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD26",
                                "children": [
                                    {
                                        "id": "f342a16a-27b8-4eec-a49e-00187947d80d",
                                        "boundaryNum": 1,
                                        "name": "Kirpa Nagar",
                                        "localname": "Kirpa Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC102",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "41e88dea-4320-4d84-9fa7-a660eff14a80",
                                        "boundaryNum": 1,
                                        "name": "Urban Estate",
                                        "localname": "Urban Estate",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC210",
                                        "area": "",
                                        "children": []
                                    }
                                ]
                            },
                            {
                                "id": "459fd571-a587-443f-b20f-21a36e197036",
                                "boundaryNum": 1,
                                "name": "WARD_27",
                                "localname": "WARD_27",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD27",
                                "children": [
                                    {
                                        "id": "0d9551ec-d0d3-43e0-9ef2-363be02d0a60",
                                        "boundaryNum": 1,
                                        "name": "Shiv Puri",
                                        "localname": "Shiv Puri",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC191",
                                        "area": "",
                                        "children": []
                                    }
                                ]
                            },
                            {
                                "id": "a1c1ba1d-9731-4179-abb4-485bc9dcae82",
                                "boundaryNum": 1,
                                "name": "WARD_28",
                                "localname": "WARD_28",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD28",
                                "children": [
                                    {
                                        "id": "cf484d3c-1b14-4fab-8bae-d273a29ffd79",
                                        "boundaryNum": 1,
                                        "name": "Dhank Chachoki",
                                        "localname": "Dhank Chachoki",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC43",
                                        "area": "",
                                        "children": []
                                    }
                                ]
                            },
                            {
                                "id": "cc21b530-f18f-4106-8f5a-0f319ebe16df",
                                "boundaryNum": 1,
                                "name": "WARD_29",
                                "localname": "WARD_29",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD29",
                                "children": [
                                    {
                                        "id": "e04454ed-0a76-4c83-9811-4c4ac079ab88",
                                        "boundaryNum": 1,
                                        "name": "Ek Jot Colony",
                                        "localname": "Ek Jot Colony",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC49",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "d51b44cc-d79a-450f-b94c-126516e593ee",
                                        "boundaryNum": 1,
                                        "name": "G.I Appartment",
                                        "localname": "G.I Appartment",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC53",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "17b12936-f2d5-4ccf-bfba-e3c39513fbc9",
                                        "boundaryNum": 1,
                                        "name": "Greater Enclave Khothran Road",
                                        "localname": "Greater Enclave Khothran Road",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC60",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "77eabb8b-f716-4cb8-a2d0-37763131ab7b",
                                        "boundaryNum": 1,
                                        "name": "Greater Kailash Colony",
                                        "localname": "Greater Kailash Colony",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC61",
                                        "area": "",
                                        "children": []
                                    }
                                ]
                            },
                            {
                                "id": "38a73763-e128-40cd-8f9d-749aff47fb0e",
                                "boundaryNum": 1,
                                "name": "WARD_30",
                                "localname": "WARD_30",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD30",
                                "children": [
                                    {
                                        "id": "6f236225-ac4b-44d4-b312-f43194437f4e",
                                        "boundaryNum": 1,
                                        "name": "Phagwara To Khera Road Crossing",
                                        "localname": "Phagwara To Khera Road Crossing",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC150",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "0a2003ae-6804-4742-a0b4-180017bfb05a",
                                        "boundaryNum": 1,
                                        "name": "Regency Colony (JCT)",
                                        "localname": "Regency Colony (JCT)",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC169",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "eeab00f2-bf5f-4483-9b82-35ef92545c77",
                                        "boundaryNum": 1,
                                        "name": "Sugar Mill Colony",
                                        "localname": "Sugar Mill Colony",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC199",
                                        "area": "",
                                        "children": []
                                    }
                                ]
                            },
                            {
                                "id": "b3246b01-4b10-44c1-919c-cfe4ee0a0333",
                                "boundaryNum": 1,
                                "name": "WARD_31",
                                "localname": "WARD_31",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD31",
                                "children": [
                                    {
                                        "id": "424f1f0f-26eb-493b-b1ca-a9bc3136e371",
                                        "boundaryNum": 1,
                                        "name": "Chachoki",
                                        "localname": "Chachoki",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC31",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "1ab64f5f-531f-4b83-a340-e5d52d86d75e",
                                        "boundaryNum": 1,
                                        "name": "Dashmesh Enclave",
                                        "localname": "Dashmesh Enclave",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC39",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "f24fa462-25c2-4af3-8916-6d72817692ba",
                                        "boundaryNum": 1,
                                        "name": "Onkar Nagar",
                                        "localname": "Onkar Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC144",
                                        "area": "",
                                        "children": []
                                    }
                                ]
                            },
                            {
                                "id": "9bc6cdce-d5e2-46a4-95d8-2a481e3bfcce",
                                "boundaryNum": 1,
                                "name": "WARD_32",
                                "localname": "WARD_32",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD32",
                                "children": [
                                    {
                                        "id": "c12a7c1a-c5c5-41dd-83b7-9aec7ca27e96",
                                        "boundaryNum": 1,
                                        "name": "Mahinder Nagar",
                                        "localname": "Mahinder Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC107",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "a8d197a2-4f91-49cd-9ee8-840ec9ccd109",
                                        "boundaryNum": 1,
                                        "name": "NANGAL KHERA",
                                        "localname": "NANGAL KHERA",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC127",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "77ea2744-d194-452b-ba05-673335b6b2bb",
                                        "boundaryNum": 1,
                                        "name": "Sant Nagar",
                                        "localname": "Sant Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC179",
                                        "area": "",
                                        "children": []
                                    }
                                ]
                            },
                            {
                                "id": "d7da539a-751b-408b-bb88-ffefdc4a57ab",
                                "boundaryNum": 1,
                                "name": "WARD_33",
                                "localname": "WARD_33",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD33",
                                "children": [
                                    {
                                        "id": "d4560be7-1730-4428-87c0-b8ce4b2200bc",
                                        "boundaryNum": 1,
                                        "name": "Govt. Labour Colony",
                                        "localname": "Govt. Labour Colony",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC59",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "2f7cc4a8-8ee1-48ef-8d91-1371e1cf5051",
                                        "boundaryNum": 1,
                                        "name": "Industrial Area",
                                        "localname": "Industrial Area",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC84",
                                        "area": "",
                                        "children": []
                                    }
                                ]
                            },
                            {
                                "id": "f013d21c-6cad-4348-acab-16b3a80fb3d2",
                                "boundaryNum": 1,
                                "name": "WARD_34",
                                "localname": "WARD_34",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD34",
                                "children": [
                                    {
                                        "id": "f3103634-6939-418e-ae55-afaa1bfeed88",
                                        "boundaryNum": 1,
                                        "name": "Guru Teg Bhadhur Nagar Tibbi",
                                        "localname": "Guru Teg Bhadhur Nagar Tibbi",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC74",
                                        "area": "",
                                        "children": []
                                    }
                                ]
                            },
                            {
                                "id": "c6aaaf8b-3885-43ec-a5f9-2560e6982cbb",
                                "boundaryNum": 1,
                                "name": "WARD_35",
                                "localname": "WARD_35",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD35",
                                "children": [
                                    {
                                        "id": "bf9bcfed-b774-42db-8e79-d124148c2310",
                                        "boundaryNum": 1,
                                        "name": "Mohalla Kishanpura",
                                        "localname": "Mohalla Kishanpura",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC118",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "c963cf41-f784-462e-83d4-02898cfef457",
                                        "boundaryNum": 1,
                                        "name": "Mohalla Sadhu Ram",
                                        "localname": "Mohalla Sadhu Ram",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC120",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "0a4c59f3-58d7-4e73-9b1d-0dbf8863893c",
                                        "boundaryNum": 1,
                                        "name": "Ratan Pura",
                                        "localname": "Ratan Pura",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC167",
                                        "area": "",
                                        "children": []
                                    }
                                ]
                            },
                            {
                                "id": "5670fa7b-6085-4d5a-b2f8-084b56b0478a",
                                "boundaryNum": 1,
                                "name": "WARD_36",
                                "localname": "WARD_36",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD36",
                                "children": [
                                    {
                                        "id": "c41adb85-5656-4989-baee-1e29083e7212",
                                        "boundaryNum": 1,
                                        "name": "Guru Nanak Pura",
                                        "localname": "Guru Nanak Pura",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC72",
                                        "area": "",
                                        "children": []
                                    }
                                ]
                            },
                            {
                                "id": "f2858cc5-6394-4268-ba8c-4ff4196df355",
                                "boundaryNum": 1,
                                "name": "WARD_37",
                                "localname": "WARD_37",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD37",
                                "children": [
                                    {
                                        "id": "7678aa46-a830-438a-a7a6-924708effefa",
                                        "boundaryNum": 1,
                                        "name": "Dev Nagar",
                                        "localname": "Dev Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC42",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "04c2af78-e308-439b-b256-1d3a664e8601",
                                        "boundaryNum": 1,
                                        "name": "KHERA ROAD",
                                        "localname": "KHERA ROAD",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC100",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "087d4ace-7d1d-427b-8c59-1529676b7086",
                                        "boundaryNum": 1,
                                        "name": "Model Town",
                                        "localname": "Model Town",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC114",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "c40b563d-2a34-4a78-ae12-81fbdb9f2cf0",
                                        "boundaryNum": 1,
                                        "name": "Railway Road",
                                        "localname": "Railway Road",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC163",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "2058cb80-e830-46ca-b286-bb9ebca493fc",
                                        "boundaryNum": 1,
                                        "name": "Sandhu Nagar",
                                        "localname": "Sandhu Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC177",
                                        "area": "",
                                        "children": []
                                    }
                                ]
                            },
                            {
                                "id": "180c0479-4951-48b3-bdb2-c9022d7191d8",
                                "boundaryNum": 1,
                                "name": "WARD_38",
                                "localname": "WARD_38",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD38",
                                "children": [
                                    {
                                        "id": "b10e0620-114d-4fd0-8fcf-afe2531ebc27",
                                        "boundaryNum": 1,
                                        "name": "Nehru Nagar",
                                        "localname": "Nehru Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC130",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "3b15a223-eb99-4f18-93e3-551f55d85d55",
                                        "boundaryNum": 1,
                                        "name": "Prem Nagar",
                                        "localname": "Prem Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC154",
                                        "area": "",
                                        "children": []
                                    }
                                ]
                            },
                            {
                                "id": "3eb55dfd-0cd4-4c85-87f9-3036c54c5c8b",
                                "boundaryNum": 1,
                                "name": "WARD_39",
                                "localname": "WARD_39",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD39",
                                "children": [
                                    {
                                        "id": "5f451b6e-7f73-4ac2-a201-c3dd37e7b11f",
                                        "boundaryNum": 1,
                                        "name": "Bhagat Pura",
                                        "localname": "Bhagat Pura",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC24",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "b48d07fd-a063-4bde-8dac-91e772bdbef8",
                                        "boundaryNum": 1,
                                        "name": "Satnam Pura",
                                        "localname": "Satnam Pura",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC184",
                                        "area": "",
                                        "children": []
                                    }
                                ]
                            },
                            {
                                "id": "976abf52-f6db-4264-80df-5cd592e1f547",
                                "boundaryNum": 1,
                                "name": "WARD_40",
                                "localname": "WARD_40",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD40",
                                "children": [
                                    {
                                        "id": "1855687d-283d-4bee-95ff-789ac2251251",
                                        "boundaryNum": 1,
                                        "name": "Basant Nagar",
                                        "localname": "Basant Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC22",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "ee9671a2-8e37-4567-8080-1704fd69fff8",
                                        "boundaryNum": 1,
                                        "name": "Preet Nagar",
                                        "localname": "Preet Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC153",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "a7ef0e80-4163-412a-a64b-c516f4859beb",
                                        "boundaryNum": 1,
                                        "name": "Rampura",
                                        "localname": "Rampura",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC165",
                                        "area": "",
                                        "children": []
                                    }
                                ]
                            },
                            {
                                "id": "65301710-b3b5-49f6-8d7a-6486f7b6d4e5",
                                "boundaryNum": 1,
                                "name": "WARD_41",
                                "localname": "WARD_41",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD41",
                                "children": []
                            },
                            {
                                "id": "c92bb27c-503b-4aa8-aacb-ada05a67c4bd",
                                "boundaryNum": 1,
                                "name": "WARD_42",
                                "localname": "WARD_42",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD42",
                                "children": [
                                    {
                                        "id": "c51a79c9-1e80-44de-8c34-077dc9ad78f2",
                                        "boundaryNum": 1,
                                        "name": "Gobind Pura",
                                        "localname": "Gobind Pura",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC58",
                                        "area": "",
                                        "children": []
                                    }
                                ]
                            },
                            {
                                "id": "4d8c63ac-db60-49f9-a7c1-b09f47d9c1c2",
                                "boundaryNum": 1,
                                "name": "WARD_43",
                                "localname": "WARD_43",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD43",
                                "children": [
                                    {
                                        "id": "532cba6a-db8e-4e3d-aa94-8b5d9de6a067",
                                        "boundaryNum": 1,
                                        "name": "Colony Dhian Singh",
                                        "localname": "Colony Dhian Singh",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC37",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "d3e1b430-bd8a-42bd-b6b6-9aa3b970d4ee",
                                        "boundaryNum": 1,
                                        "name": "Gaushala Road",
                                        "localname": "Gaushala Road",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC57",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "7f13a4b8-89d5-43b5-a407-6585eb446131",
                                        "boundaryNum": 1,
                                        "name": "Kot Rani",
                                        "localname": "Kot Rani",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC105",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "7e4d5364-5952-4436-b7ef-38856f5db545",
                                        "boundaryNum": 1,
                                        "name": "New Adarsh Nagar",
                                        "localname": "New Adarsh Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC131",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "42252013-3af5-41a8-9039-caf88fc1d1f9",
                                        "boundaryNum": 1,
                                        "name": "Shahid Udham Singh Nagar",
                                        "localname": "Shahid Udham Singh Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC187",
                                        "area": "",
                                        "children": []
                                    }
                                ]
                            },
                            {
                                "id": "da9344c7-99a7-495f-bead-c86c4bf43fdd",
                                "boundaryNum": 1,
                                "name": "WARD_44",
                                "localname": "WARD_44",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD44",
                                "children": [
                                    {
                                        "id": "ded3e68c-2f53-4af5-85c4-8596c50c0f7b",
                                        "boundaryNum": 1,
                                        "name": "Dhian Singh Colony",
                                        "localname": "Dhian Singh Colony",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC45",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "59b57fe0-c114-46de-bf73-ccd09ee4ab29",
                                        "boundaryNum": 1,
                                        "name": "Dhillon Nagar",
                                        "localname": "Dhillon Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC46",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "3a7bf83a-22a4-4142-be70-f0616647172d",
                                        "boundaryNum": 1,
                                        "name": "Nakodar Road To Chungi",
                                        "localname": "Nakodar Road To Chungi",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC126",
                                        "area": "",
                                        "children": []
                                    }
                                ]
                            },
                            {
                                "id": "00f82e0d-a529-499c-8031-82359b094b6a",
                                "boundaryNum": 1,
                                "name": "WARD_45",
                                "localname": "WARD_45",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD45",
                                "children": [
                                    {
                                        "id": "62e67128-53e6-4090-a1ea-a9f27d374617",
                                        "boundaryNum": 1,
                                        "name": "Green Land Colony",
                                        "localname": "Green Land Colony",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC63",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "ffd60164-b2a7-4ed6-b37a-d18a0377c358",
                                        "boundaryNum": 1,
                                        "name": "Mohalla Agnihotri",
                                        "localname": "Mohalla Agnihotri",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC115",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "aba2f091-de77-4680-b07b-e67c50f87c81",
                                        "boundaryNum": 1,
                                        "name": "Parbhakar Mohalla",
                                        "localname": "Parbhakar Mohalla",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC147",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "c62ea024-e282-48eb-b98d-8dcf3b95af11",
                                        "boundaryNum": 1,
                                        "name": "Sudhiran Mohalla",
                                        "localname": "Sudhiran Mohalla",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC197",
                                        "area": "",
                                        "children": []
                                    }
                                ]
                            },
                            {
                                "id": "a539dbd3-01c0-47f1-b08f-bd22b11b2af2",
                                "boundaryNum": 1,
                                "name": "WARD_46",
                                "localname": "WARD_46",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD46",
                                "children": [
                                    {
                                        "id": "69690d38-f907-411f-8dca-fcde12701936",
                                        "boundaryNum": 1,
                                        "name": "AggFaka",
                                        "localname": "AggFaka",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC3",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "88aa8167-47c4-4c7d-9c02-71d186e672b2",
                                        "boundaryNum": 1,
                                        "name": "Bakhshish Enclave",
                                        "localname": "Bakhshish Enclave",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC18",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "b30fc84f-599d-48aa-a401-82ea949ff652",
                                        "boundaryNum": 1,
                                        "name": "DR AMBEDKAR CHOWK",
                                        "localname": "DR AMBEDKAR CHOWK",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC47",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "e126fb7e-cdb2-4511-a37a-3a2195636ca3",
                                        "boundaryNum": 1,
                                        "name": "Hadiabad",
                                        "localname": "Hadiabad",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC75",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "2f95b5bf-3d3e-4b59-8f20-1a09e358210a",
                                        "boundaryNum": 1,
                                        "name": "HakuPura",
                                        "localname": "HakuPura",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC77",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "40520a54-5396-4bfa-b894-136d953f483d",
                                        "boundaryNum": 1,
                                        "name": "MANAWALI",
                                        "localname": "MANAWALI",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC111",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "bed68814-9c17-4115-8a03-84ff854cbbe6",
                                        "boundaryNum": 1,
                                        "name": "Mohalla Jagat Pura",
                                        "localname": "Mohalla Jagat Pura",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC116",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "89337e45-9077-42ad-91dd-ad0aff67ba5f",
                                        "boundaryNum": 1,
                                        "name": "Naurang Shahpur",
                                        "localname": "Naurang Shahpur",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC128",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "10ba4988-c69b-407b-94c4-567af667e781",
                                        "boundaryNum": 1,
                                        "name": "Qilla Mohalla",
                                        "localname": "Qilla Mohalla",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC162",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "1c762b3a-a45c-49c5-9449-7c58ef5f037e",
                                        "boundaryNum": 1,
                                        "name": "Sherwood Colony",
                                        "localname": "Sherwood Colony",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC190",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "0d04f8d3-719a-458b-9be3-fa208022baa5",
                                        "boundaryNum": 1,
                                        "name": "Taj Colony",
                                        "localname": "Taj Colony",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC204",
                                        "area": "",
                                        "children": []
                                    }
                                ]
                            },
                            {
                                "id": "30fc4146-64a2-4145-b41b-44d50b5b1b2c",
                                "boundaryNum": 1,
                                "name": "WARD_47",
                                "localname": "WARD_47",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD47",
                                "children": [
                                    {
                                        "id": "fe923b14-1895-4462-921d-006e1b830756",
                                        "boundaryNum": 1,
                                        "name": "Manav Nagar",
                                        "localname": "Manav Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC110",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "677bba9e-518d-40a5-8def-5b9b4be28596",
                                        "boundaryNum": 1,
                                        "name": "UPPAS MOHALA",
                                        "localname": "UPPAS MOHALA",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC209",
                                        "area": "",
                                        "children": []
                                    }
                                ]
                            },
                            {
                                "id": "a2289ba6-d37f-4e10-a4b3-0fb2a98e17a3",
                                "boundaryNum": 1,
                                "name": "WARD_48",
                                "localname": "WARD_48",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD48",
                                "children": [
                                    {
                                        "id": "1301f9a3-422b-470a-b7e7-405ecf88626f",
                                        "boundaryNum": 1,
                                        "name": "Basant Bagh",
                                        "localname": "Basant Bagh",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC21",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "763818ed-fa65-40e3-9ca1-5c37df6f1cb4",
                                        "boundaryNum": 1,
                                        "name": "Mansa Devi Nagar",
                                        "localname": "Mansa Devi Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC112",
                                        "area": "",
                                        "children": []
                                    }
                                ]
                            },
                            {
                                "id": "383f247a-c660-4ae6-98e5-16b866f2234e",
                                "boundaryNum": 1,
                                "name": "WARD_49",
                                "localname": "WARD_49",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD49",
                                "children": [
                                    {
                                        "id": "a8e57d20-9e4f-4115-8d4b-9f0928e64c84",
                                        "boundaryNum": 1,
                                        "name": "Kartar Estate",
                                        "localname": "Kartar Estate",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC93",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "274786ad-38ba-4fcd-9f77-595ff63b33fd",
                                        "boundaryNum": 1,
                                        "name": "Santokh Pura Mohalla",
                                        "localname": "Santokh Pura Mohalla",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC180",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "5c7519fd-d645-4a7f-8c14-9e67d2b67c07",
                                        "boundaryNum": 1,
                                        "name": "Teacher Colony",
                                        "localname": "Teacher Colony",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC207",
                                        "area": "",
                                        "children": []
                                    }
                                ]
                            },
                            {
                                "id": "46bb4f97-91a7-4135-a866-72cc1fc96ad1",
                                "boundaryNum": 1,
                                "name": "WARD_50",
                                "localname": "WARD_50",
                                "longitude": null,
                                "latitude": null,
                                "label": "Block",
                                "code": "WARD50",
                                "children": [
                                    {
                                        "id": "a19a68c9-cc8e-4ac1-a33a-42c8c3ad7765",
                                        "boundaryNum": 1,
                                        "name": "Adarsh Nagar",
                                        "localname": "Adarsh Nagar",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC2",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "df5ef036-f16e-4eea-9da7-f0fe1c85256c",
                                        "boundaryNum": 1,
                                        "name": "Bhanoki Road",
                                        "localname": "Bhanoki Road",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC27",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "19ed8f43-d190-4830-b333-010b6876a9b7",
                                        "boundaryNum": 1,
                                        "name": "Dashmesh Puri",
                                        "localname": "Dashmesh Puri",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC41",
                                        "area": "",
                                        "children": []
                                    },
                                    {
                                        "id": "b90543d6-637c-4012-a01d-1f80f0d562e5",
                                        "boundaryNum": 1,
                                        "name": "New Satnampura",
                                        "localname": "New Satnampura",
                                        "longitude": null,
                                        "latitude": null,
                                        "label": "Locality",
                                        "code": "PLC136",
                                        "area": "",
                                        "children": []
                                    }
                                ]
                            }
                        ]
                    }
                ]
            }
        }
    ]
}



'