MDMS data and preparation

This document shows the preparation of the mdms changes be to done for data loading.

1. To add data in tenant/tenants.json - For showing the tenant at login screen
   Sample Data :
   

Example : Create a json for new ulb and Add required details given.

{
    "code": "od.angul",
    "name": "Angul",
    "description": "Angul",
    "logoId": "https://digitaldesksujog051120.blob.core.windows.net/assets/Logos/odlogo.png",
    "imageId": null,
    "domainUrl": "https://sujog.odisha.gov.in",
    "type": "CITY",
    "twitterUrl": null,
    "facebookUrl": null,
    "emailId": "angulmunicipality@gmail.com",
    "OfficeTimings": {
        "Mon - Fri": "9.00 AM - 6.00 PM",
        "Sat": "9.00 AM - 12.00 PM"
    },
    "pincode": [
        759122,
        759132,
        759123,
        759143
    ],
    "city": {
        "name": "Angul",
        "localName": null,
        "districtCode": "Angul",
        "districtName": "Angul",
        "regionName": "Angul",
        "ulbGrade": "Angul Municipality",
        "longitude": 0,
        "latitude": 0,
        "shapeFileLocation": null,
        "captcha": null,
        "code": "ANG",
        "ddrName": "Angul",
        "wsBillHeaderLine1": "OFFICE OF THE AE/JE",
        "wsBillHeaderLine2": "PUBLIC HEALTH ENGINEERING ORGANIZATION : Angul",
        "districtTenantCode": "od.angul"
    },
    "address": "AT/PO-Amlapada,Dist-Angul, Pin-759122",
    "contactNumber": "",
    "helpLineNumber": "14420"
}

2. Adding in tenant/citymodule.json - To enable ulb to create application,add new tenant code in FSM module.
   

   {
       "module": "FSM",
       "code": "FSM",
       "active": true,
       "tenants": [
           {
               "code": "pg.citya"
           },
           {
               "code": "pg.angul"
           }
       ]
   }

3. Adding FSTP details in FSM/FSTPPlantInfo.json
   Required Details:

Eg.

{
    "PlantCode": "ANG_001",
    "PlantName": "ANGUL Plant",
    "active": true,
    "PlantType": "SeTP",
    "PlantLocation": "ANGUL",
    "PlusCode": "R3RW+7JQ",
    "PlantOperationalTimings": "09.00am-05.00pm",
    "PlantOperationalCapacityKLD": "18",
    "ULBS": "pg.angul"
}

• Creating Boundary data for Gram Panchayat in ULBNAME/egov-location/boundary-data.json
  The GP details will be given in Annexure-5,in hierarchyType - REVENUE ,add GP data after locality data.
  The json format of GP is :
  

  {
      "id": 6,
      "boundaryNum": 1,
      "name": "GP 1",
      "localname": "GP1",
      "longitude": null,
      "latitude": null,
      "label": "GP",
      "code": "GP1",
      "children": [
          {
              "id": 11,
              "boundaryNum": 1,
              "name": "Village 1",
              "localname": "Village local 1",
              "longitude": 74.871552,
              "latitude": 31.63089,
              "label": "Village",
              "code": "VIL1",
              "pincode": [
                  143001
              ],
              "area": "V-Area1",
              "children": []
          },
          {
              "id": 12,
              "boundaryNum": 1,
              "name": "Village 2",
              "localname": "Village local 2",
              "longitude": null,
              "latitude": null,
              "label": "Village",
              "code": "VIL2",
              "pincode": [
                  143001
              ],
              "area": "V-Area1",
              "children": []
          }
      ]
  },

Example:

{
    "tenantId": "pg.rourkela",
    "moduleName": "egov-location",
    "TenantBoundary": [
        {
            "hierarchyType": {
                "code": "REVENUE",
                "name": "REVENUE"
            },
            "boundary": {
                "id": 1,
                "boundaryNum": 1,
                "name": "Rourkela",
                "localname": "Rourkela",
                "longitude": null,
                "latitude": null,
                "label": "City",
                "code": "pg.rourkela",
                "children": [
                    {
                        "id": "2",
                        "boundaryNum": 1,
                        "name": "Pradhanpalli",
                        "localname": "Pradhanpalli",
                        "longitude": null,
                        "latitude": null,
                        "label": "Locality",
                        "code": "VIL1"
                    },
                    {
                        "id": "3",
                        "boundaryNum": 1,
                        "name": "Other",
                        "localname": "Other",
                        "longitude": null,
                        "latitude": null,
                        "label": "GP",
                        "code": "OTH1",
                        "children": []
                    }
                ]
            }
        }
    ]
}

How to create the jsons of GP data -

• The GP data is given in excel format.

• Copy all the GP’s list and make an excel with format given below
  

• The name and localname is the GP name provided

• The label is always GP and boundaryNum is 1.

• Id is unique for each GP and should be in sequential order.

• Provide a proper format of GP code according to GPname.

• Convert the excel data into json using excel-json online converter.

• Add the GP data after locality data in boundary-data.json file .

• Check the format once,change id into string if it is in integer format.

• Add "children": [] for each GP separately after converting to json.

4. Adding Slum Details in ULBNAME/FSM/Slum.json
   The name of the slums will be provided.The format of slum adding in mdms is: 

   {
               "name": "slumname",           
                "active": true,
               "code": "CODE001",
               "locality": "VIL1"
       },

How to create the jsons of Slum data :
The slum data is provided in excel format.

• Make and excel with with given format
  

• Add all the slums in name field

• change the code according to ulb name

• add locality VIL1 according to boundary-data.

• convert the excel data into json using excel to json converter.

• create a folder of a respective tenant  and inside it add slum.json file in FSM folder.

5. Adding New Vehicles in VehicleMakeModel
   Before pushing the vehicle data,new vehicle should be added in mdms.
   

Eg.  new vehicle add 

 {
            "code": "MAHINDRA",
            "name": "Mahindra",
            "active": true
        },
{
            "code": "MAHINDRA.TRUCK",
            "name": "Truck",
            "active": true,
            "make": "MAHINDRA",
            "capacity": "1000",
            "amount": "1500"
        },

The code should be different for each vehicle and in format make.name .

6. Billing-slab pricing preparation
   For adding the rate slabs(pricing) of vehicles,consider different combination of propertyType , slum and tank capacity.

   1. Required combination of property types and Sub-property types added in MDMS :

   2. RESIDENTIAL and RESIDENTIAL.SUB-PROPERTY_TYPE

   3. INSTITUTIONAL and INSTITUTIONAL.SUB-PROPERTY_TYPE

   4. COMMERCIAL and COMMERCIAL.SUB-PROPERTY_TYPE

   5. Sample Data for pricing :

Steps to make billing-slab data-
A. Create an excel file in given format

B. Consider all property types and sub-property type present in mdms with slum YES and with slum NO.

C. for capacity 1000L,the pricing is given as

For slum NO :

1. RESIDENTIAL and RESIDENTIAL.SUB-PROPERTY_TYPE - 1000

2. INSTITUTIONAL and INSTITUTIONAL.SUB-PROPERTY_TYPE - 1000

3. COMMERCIAL and COMMERCIAL.SUB-PROPERTY_TYPE - 1000

For slum YES(Per trip Pricing for Slum areas) :

1. RESIDENTIAL and RESIDENTIAL.SUB-PROPERTY_TYPE - 800

2. INSTITUTIONAL and INSTITUTIONAL.SUB-PROPERTY_TYPE - 800

3. COMMERCIAL and COMMERCIAL.SUB-PROPERTY_TYPE - 800

D. for capacity 3000L,the pricing is given as

For slum NO :

1. RESIDENTIAL and RESIDENTIAL.SUB-PROPERTY_TYPE - 2000

2. INSTITUTIONAL and INSTITUTIONAL.SUB-PROPERTY_TYPE - 2000

3. COMMERCIAL and COMMERCIAL.SUB-PROPERTY_TYPE - 3000

For slum YES(Per trip Pricing for Slum areas) :

1. RESIDENTIAL and RESIDENTIAL.SUB-PROPERTY_TYPE - 1500

2. INSTITUTIONAL and INSTITUTIONAL.SUB-PROPERTY_TYPE - 1500

3. COMMERCIAL and COMMERCIAL.SUB-PROPERTY_TYPE - 1500

E. After creating the excel file by considering the combinations,convert the excel file into json.

F. Push the same json file in billing slab api using runner.