Custom Entity Types

Ability to have custom entity types for locations and relationships, being able to edit, add or remove the existing default ones.

Detailed Feature Description

By default Cadasta supports the following location types (i.e. land_type):

• PA Parcel
• CB Community Boundary
• BU Building
• AP Apartment
• PX Project Extent
• RW Right-of-way
• NP National Park Boundary
• MI Miscellaneous

And the following relation types (i.e. tenure_type):

• CR Carbon Rights
• CO Concessionary Rights
• CU Customary Rights
• EA Easement
• ES Equitable Servitude
• FH Freehold
• GR Grazing Rights
• HR Hunting/Fishing/Harvest Rights
• IN Indigenous Land Rights
• JT Joint Tenancy
• LH Leasehold
• LL Longterm leasehold
• MR Mineral Rights
• OC Occupancy (No Documented Rights)
• TN Tenancy (Documented Sub-lease)
• TC Tenancy in Common
• UC Undivided Co-ownership
• WR Water Rights

There is a clear need from partners to be able to customize these types, for considering other location types (like points of interest within a community), and especially for relation types (to include other tenure types specific for the regulation in the country, or to specify other types of relationships not directly related to tenure).

User Stories

• As a project manager, I want to edit the existing default location types defined
• As a project manager, I want to add new location types to the existing list
• As a project manager, I want to remove location types from the existing list
• As a project manager, I want to edit the existing default relationship types defined
• As a project manager, I want to add new relationship types to the existing list
• As a project manager, I want to remove relationship types from the existing list

Requirements

XLSForm approach versus web GUI

This requirements are assuming that we will be using a web GUI for the creation of the data project schema. If that is not the case and we are still using the XLSForms when we develop this feature, the requirements will consist just in allowing the user to modify (i.e. edit/add/remove elements) the following items in the choices tabs of the XLSForm:

• land_type
• tenure_type

If the Custom Entity types are implemented within the Project Creation Wizard, we will need to integrate these requirements into the Project Creation requirements document.

Location type customization

For the location entity we are including a mandatory field (Location Type) in the Project Creation Wizard. We should allow the user (project manager) to edit this list provided by default:

1. Being able to edit the existing default location types, for both the ids (like "PA", "CB" etc) and the labels in all selected languages (like "Parcel", "Community Boundary", etc)
2. Being able to remove items from that location type list
3. Being able to add items to that location type list

Relationship type customization

For the relationship entity we are including a mandatory field (Relationship Type) in the Project Creation Wizard. We should allow the user (project manager) to edit this list provided by default:

1. Being able to edit the existing default relationship types, for both the ids (like "CR", "CO" etc) and the labels in all selected languages (like "Carbon Rights", "Concessionary Rights", etc)
2. Being able to remove items from that relationship type list
3. Being able to add items to that relationship type list

Ancillary Information

• Requirements will be integrated with the Project Creation Wizard requirements document, and with their wireframes, if we decide to go with the GUI option.

Wireframes

(To be developed)