Land Service

Overview

Land service is the major service supporting bpa-services which handles the data of the land like land details, owner information, unit ,address and documents which has the complete information of the land.

Which can be used as input for the bpa-services to create and process the Building Plan Application.

Pre-requisites

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

Knowledge of Java/J2EE(preferably Java 8 version)
Knowledge of Spring Boot and spring-boot microservices.
Knowledge of Git or any version control system.
Knowledge of RESTful Web services.
Knowledge of the Lombok library will helpful.
knowledge of eGov-mdms service, eGov-persister, eGov-idgen, eGov-user, eGov-localization will be helpful.

Key Functionalities

UI integrated as part of BPA screens
Ability to create/update Land Details

Configuration Details

Application.properties File Information:

Here we are listing the configs apart from dependent service host, url’s, DB and Flyway configs.

kafka topics persister configs for eGov persister to save and update land Data
- persister.save.landinfo.topic=save-landinfo
- persister.update.landinfo.topic=update-landinfo

Land Service Specific MDMS configuration:

There is not MDMS config for Land Service exists as of now.

Access MDMS Config

Action Test : URL Actions adding

action-test.json

  {
      "id": 1988,
      "name": "BPA-Land-Create",
      "url": "/land-services/v1/land/_create",
      "displayName": "Land Create",
      "orderNumber": 0,
      "enabled": false,
      "serviceCode": "BPA",
      "code": "null",
      "path": ""
    },
    {
      "id": 1989,
      "name": "BPA-Land-Update",
      "url": "/land-services/v1/land/_update",
      "displayName": "Land Update",
      "orderNumber": 0,
      "enabled": false,
      "serviceCode": "BPA",
      "code": "null",
      "path": ""
    },
    {
      "id": 1990,
      "name": "BPA-Land-Search",
      "url": "/land-services/v1/land/_search",
      "displayName": "Land Search",
      "orderNumber": 0,
      "enabled": false,
      "serviceCode": "BPA",
      "code": "null",
      "path": ""
    },

Access to the Roles for the above Actions

roleacton.json

{
      "rolecode": "BPA_ARCHITECT",
      "actionid": 1988,
      "actioncode": "",
      "tenantId": "pb"
    },
      {
      "rolecode": "BPA_ARCHITECT",
      "actionid": 1989,
      "actioncode": "",
      "tenantId": "pb"
    },
    {
      "rolecode": "CITIZEN",
      "actionid": 1989,
      "actioncode": "",
      "tenantId": "pb"
    },
    {
      "rolecode": "BPA_VERIFIER",
      "actionid": 1989,
      "actioncode": "",
      "tenantId": "pb"
    },
    {
      "rolecode": "BPA_APPROVER",
      "actionid": 1989,
      "actioncode": "",
      "tenantId": "pb"
    },
    {
      "rolecode": "BPA_FIELD_INSPECTOR",
      "actionid": 1989,
      "actioncode": "",
      "tenantId": "pb"
    },
    {
      "rolecode": "BPA_NOC_VERIFIER",
      "actionid": 1989,
      "actioncode": "",
      "tenantId": "pb"
    },
    {
      "rolecode": "BPA_FIELD_INSPECTOR",
      "actionid": 1990,
      "actioncode": "",
      "tenantId": "pb"
    },
    {
      "rolecode": "BPA_NOC_VERIFIER",
      "actionid": 1990,
      "actioncode": "",
      "tenantId": "pb"
    },
    {
      "rolecode": "BPA_ARCHITECT",
      "actionid": 1990,
      "actioncode": "",
      "tenantId": "pb"
    }, {
      "rolecode": "BPA_VERIFIER",
      "actionid": 1990,
      "actioncode": "",
      "tenantId": "pb"
    },
    {
      "rolecode": "CEMP",
      "actionid": 1990,
      "actioncode": "",
      "tenantId": "pb"
    },
    {
      "rolecode": "BPA_APPROVER",
      "actionid": 1990,
      "actioncode": "",
      "tenantId": "pb"
    },
    {
      "rolecode": "CITIZEN",
      "actionid": 1990,
      "actioncode": "",
      "tenantId": "pb"
    }

Database Schema

Deployment Details

Add mdms configs required for Land Service and restart mdms service.
Add workflow configs required for Land Service and restart workflow service.
Deploy the latest version of Land Service.
Add Land Service persister yaml path in persister configuration and restart persister service
Add Role-Action mapping for API’s.

Integration

Integration Scope

This service is the major service supporting bpa-services which handles the data of the land like land details, owner information, unit ,address and documents which has the complete information of the land.

Steps to Integration

To integrate, host of land-services module should be overwritten in helm chart.
land-services/v1/land/_create should be added as the create endpoint for submitting land detail in land registry in BPA application .
land-services/v1/land/_search should be added as the search endpoint .This method handles all requests to search existing records depending on different search criteria
land-services/v1/land/_update should be added as the update endpoint for updating land detail in land registry in BPA application .

Reference Docs

Doc Links

Title	Link
API Swagger Documentation	Swagger Documentation
Persister Configuration	Persister Config

API List

Title	Link
land-services/v1/land/_create	https://www.getpostman.com/collections/0cf96d1b52ce68896bca
land-services/v1/land/_update	https://www.getpostman.com/collections/0cf96d1b52ce68896bca
land-services/v1/land/_search	https://www.getpostman.com/collections/0cf96d1b52ce68896bca

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