NOTE: Ineligible Structure Marking for Focus Investigation IS A SEPARATE SCOPING DOCUMENT

Status

Definitions

• Inactive structure: a non-valid structure that was created erroneously and should be removed from play completely (e.g., duplicate residential structure record created by accident)
  • This is effectively soft deleting the structure
• Ineligible structure: a valid structure that is ineligible to participate in an intervention for a valid reason (e.g., a residential structure where the inhabitants are not currently residing but may return in the future) 
  • This is a form field specific to the activity

Requirements

• A user in the field should be able to select a structure displayed in the Reveal map and mark it as inactive
• Q: A user on the WebUI should be able to select a structure displayed in the Reveal map and mark it as inactive
• The user should be asked to confirm this process before the operation is completed
• Tasks associated with this structure should also be marked as inactive
• Any structures that have been marked as inactive should be removed from the target denominator for all interventions
• Inactivity is not intervention-specific and applies to all interventions.
• Structures that are eligible to be marked as inactive include:
  1. Structures created during enumeration that do not actually exist in the field.
  2. Structures erroneously added in the field (e.g. duplicates of other structures, inaccurate locations of existing structures, other user-error additions, etc.).
• Workflow to determine a structure is inactive:
  1. The user navigates to the structure seen in the map view of the mobile client and determines that this structure does not exist.
  2. Tap the structure.
     1. If no household has been registered:
        1. New form (before household registration):
           1. New field - Structure registration: Select type of structure:
              1. Residential structure
              2. Non-residential structure
              3. Non-existent structure - mark as inactive
     2. If household has been registered: CR comment - this is assumed that a family has been incorrectly registered to this structure and should be moved to a correct structure
        1. Tap the three dots in the upper right-hand corner
        2. Select 'Move family registration'
        3. Search & select the relevant structure from the displayed map view or list view (note that the structure have been enumerated)
           1. Recommend having a radius of selection, i.e. can only move family registration to a structure within 100m
              1. What to do for structures outside of this radius? Is it possible to create a holding table for registered families without a structure?
           2. If no family already registered to new structure - Save
           3. If family already registered to the structure:
              1. Is this a multi-structure household?
        4. Tap the SAME structure that has been identified as inactive (now there should be no family registered)
           1. New field - Structure registration: Select type of structure:
              1. Residential structure
              2. Non-residential structure
              3. Non-existent structure - mark as inactive

Mock-Ups

Views

We anticipate the following views to be impacted on with the creation of this feature:

• Android - Add structure registration form
• Android - New options in family view to:
  • Mark as ineligible for current intervention
  • Move registered household to new structure
• Android - New form in family view to move registered household to new structure
• Android - Maps - Add colour coding for ineligible (black) & inactive structures (light grey)
• Android - Maps - Add a card view for ineligible structures
• Android - Maps - Add a card view for inactive structures
• Web - Maps - Display ineligible structures in black in the web view with ability to toggle on/off

Justification

Dependencies

Notes

• No structures are ever deleted from Reveal, they can only be marked as inactive

Questions

Test Case