[FHIR Road Map]: Add the Administrative level for each Location created on OpenSRP web

[dubdabasoduba]

Issue Context?

• OpenSRP web creates locations in a hierarchy perspective i.e. locations have parent and children nodes. It's somewhat complicated to fetch the locations at a certain level without having to build the location hierarchy and then traverse it.
• We would like to introduce the concept of an administrative level for each location in the hierarchy.
• The Root location would always have level 0 then all the children would have level parent_level + 1

Issue Implemetation details?

• Add an administrative level for every location resource created on OpenSRP web. If a location does not have a parent selected then the administrative level will be 0. All the children in the hierarchy will have an administrative level of parent_level + 1
• This level is to be added to the type property of the Location resource.
• The CodeSystems to be used should have the following properties
  • system : - https://smartregister.org/codes/administrative-level
  • code : - administrative level e.g 0, 1, 2
  • Display : - The text "Level" + the administrative level e.g. Level 0, Level 1
• Display the Administrative level on the view details page

Issue Acceptance criteria?

• All Locations created by OpenSRP web should automatically have an administrative level added to them.

FHIR resources to be used?

No response

Relevant Information

Sample Codes

[
  {
    "system" : "https://smartregister.org/codes/administrative-level",
    "code"   : "0"                                                   ,
    "display": "Level 0"
  },
  {
    "system" : "https://smartregister.org/codes/administrative-level",
    "code"   : "1"                                                   ,
    "display": "Level 1"
  }
]

[ciremusyoka]

Here is a sample of payload with type and administrative level included

{
    "resourceType": "Location",
    "status": "active",
    "name": "Test location",
    "partOf": {
        "reference": "Location/138396",
        "display": "World"
    },
    "identifier": [
        {
            "use": "official",
            "value": "c71eeae5-ba17-4083-9626-81b62a18680b"
        }
    ],
    "physicalType": {
        "coding": [
            {
                "system": "http://terminology.hl7.org/CodeSystem/location-physical-type",
                "code": "jdn",
                "display": "Jurisdiction"
            }
        ]
    },
    "type": [
        {
            "coding": [
                {
                    "system": "https://smartregister.org/codes/administrative-level",
                    "code": "1",
                    "display": "Level 1"
                }
            ]
        }
    ],
    "id": "fe85f1b3-8ce3-40b0-9fdf-89e97d5f246a"
}

[peterMuriuki]

For consistency patterns I think we should set the system url to http://smartregister.org/CodeSystem/administrative-level. As it currently is for service point types, of-course it is something we can always review and change later. cc @dubdabasoduba @ciremusyoka