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
{
"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
{
"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 criterialand-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 | |
Persister Configuration |
API List
Title | Link |
land-services/v1/land/_create | |
land-services/v1/land/_update | |
land-services/v1/land/_search |
(Note: All the API’s are in the same postman collection therefore same link is added in each row)