NOTE: Inactive Structure Marking IS A SEPARATE SCOPING DOCUMENT

...

• 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 structureCR comment: Correct. 
• 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

Overview

This functionality was requested by the Thai team for Focus Investigation.

This is also needed for MDA when the family module is used.

Fields workers should be able to mark a structure as ineligible for household registration, and therefore  subsequent tasks should be marked: task.businessStatus = Not Eligible

...

QUESTION: Should we be marking ineligibility at the household level or at the task level? This document assumes household level but I'm not sure if that is correct.

Requirements

• Users should be able to mark a structure as ineligible during household registration or within the family module for a house already registered
• This should be an option in the household registration form similar to IRS (screenshot below); for a house that has never been registered, eligibility questions should come after inactive qusetions
• Marking the structure as ineligible should turn the structure

...

• grey, hide/skip subsequent questions in the form and set all tasks assigned to the structure as Not Eligible
• Any structures that have been marked as ineligible should be removed from the target denominator for the FI (Number of Structures)
  • Q: Although this structure will still have been visited and number of structures visited may be a

...

• • metric
    • Typically we would not count ineligible structures in the visited metric as we are most interested in how many eligible structures were visited.
  • Any task linked to the structures that have been marked as ineligible should be removed from the target denominator for the FI (Number of Households registered)
  • Any subsequent tasks (RACD, bednets etc) that have been marked as ineligible should be removed from the target denominator for the FI (Number of bednets to distribute)
• A structure cannot be marked ineligible if a household has been registered, or has had any tasks associated with it that are not in an initial state (IN_PROGRESS as BusinessStatus?)
  • Structure may have been previously registered but during this visit the house is ineligible
• A structure cannot be marked as eligible if it has been already marked as ineligible within this plan (this would mean that all tasks would have to be changed from Not Eligible to In Progress - is this valid?)
• If an ineligible structure is clicked/touched a card is displayed indicating that the structure is ineligible with the date it was marked ineligible
• LIFECYCLE: Restricted to the plan. Ineligibility will not persist across interventions (an IRS plan in the same OA will not have the structure marked as ineligible) and ineligibility will not extend to the following FI
• Both enumerated and field-added structures may be marked as ineligible

Workflow

1. Workflow to determine a structure is ineligible:
   1. The user visits the structure seen in the map view of the mobile client and determines that this structure is not eligible for the intervention.
   2. Tap the structure.
      1. If no household has been registered:
         1. First see questions for inactive structure Inactive Structure Marking
            1. If structure is residential (not inactive), present next questions. Note that if structure is marked as non-residential, it is automatically not eligible for certain interventions and may not reach this stage:
         2. New field: Is this structure eligible for the intervention? (These options could be expanded e.g. Ineligible - Non-residential, Ineligible - Does not exist, Ineligible - Other)
            1. Eligible structure
            2. Ineligible structure
         3. A follow on question should ask "What type of structure is this?"
            1. "Kitchen", "Animal shelter", "Food storage", "School", "Lodge", "Shop", "Office", "Hospital", "Clinic", "No structure here", "Not habitable", "Other"

Image Removed

Views

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

...

1. 1. 2. If household has been registered
         1. Tap the three dots in the upper right-hand corner
         2. Select 'Mark as inelgible for this plan'

Image Added

Suggested MVP

Full Workflow specified above

Views:

• Android - Maps - Add a card view for ineligible structures
• Android - Ineligible structure marking form
• Web - Maps - Display ineligible structures in grey in the web view with ability to toggle on/off
• Android - Maps - Add colour coding for ineligible (grey)
• Android - New options in family view to:
  • Mark as ineligible for current household (for this intervention i.e. FI)
• Android - Maps - Add colour coding for ineligible (black)
• Android - Maps - Add a card view for ineligible structures
Web - Maps - Display ineligible structures in black in the web view

Suggested not in MVP

View:

• Web - Maps - Ability to show/hide or filter the ineligible structures  for a given task view (nice-to-have - will be part of a larger ticket for filtering of task types and statuses) . 

...