Migrant Household Identification and Tracking in All Household and All Beneficiaries

XMLWordPrintable

    • Type: Story
    • Resolution: Unresolved
    • Priority: Low
    • 3.0
    • Affects Version/s: None
    • None
    • FLW Sprint 56
    • FLW Mobile App
    • All

      Component: All Household, All Beneficiaries

      Summary:
      Migrant Household Identification and Tracking in All Household and All Beneficiaries

      Description:

      We want ASHAs to register and track migrant households and their family members. These are families who have come from other states for temporary work, follow up on them, and update their status when they leave the area.

      Migrant households are families who travel from another state for seasonal work in brick kilns, farms and similar places. They stay for a period, then go home or move elsewhere.

      Refer BRD : https://pmp.piramalswasthya.org/confluence/spaces/AMRIT/pages/85753874/BRD+Sakhi+Mobile+App#BRDSakhiMobileApp-_Toc495077061MigrantHousehold

      Prototype : Kindly note that there is a protoype html link shared in attachment. The prototype is not an exact version of the app. Have a look at the flow for - 

      1. New Household Registration

      Requirements:

      1. Total No. of Family Members (same as TBMJA app) 

      • Add "Total no. of family members" as the first field in New Household Registration → Family Details
      • The field is a stepper (− / value / +) with the same UI and behaviour as TBMJA. Range 1–30, mandatory, default 1.
      • Store the value against the household record.
      • The household card shows "<registered>/<total> Members Registered" (e.g. 2/4). The count updates whenever a member is registered or the total is edited.
      • Add Member is disabled when registered = total.
      • Existing households (registered before this release): take the household’s current member count as its Total no. of family members.
        • Example: an existing household with 3 registered members gets Total = 3 and shows 3/3 Members Registered.
        • This is set automatically during migration or first sync, with no ASHA action needed.
        • The ASHA can raise the total later through Edit Household Information.

      2. Migrant Household identification

      • Add "Is this a Migrant Household?" as a Yes/No toggle, placed after Total no. of family members.
      • The default is No, and the value is stored against the household.
      • Yes → the household is saved with Migration Status = Migrant In and Migrant In date = registration date.

      3. Edit Household Information

      • The ASHA can update Total no. of family members, Is this a Migrant Household? and Migration Status.
      • The total cannot be set below the number of members already registered.
      • Raising the total must NOT auto-register any beneficiary.
      • Example: 2/4 → edit total to 5 → 2/5 → register newborn → 3/5.

      4. UI change: New Household Registration button in Household & Add Beneficiary button in Non Household :

      • Change the “New Household Registration” button at the bottom of All Household from blue to the same green as the Members and Add Member buttons on the household card.
      • Make the similar change to "Add Beneficiary" button at the bottom of Non Household. 
      • Keep its shape, size, position and text as they are. Only the background colour changes.
      • The button must look the same in all three sections: Household, Non-Household 

      5. Migrant Households section

      • All Household shows three sections: Household, Non-Household and Migrant Households.
      • Migrant Households lists active (Migrant In) migrant households by default, with a "Migrated Out" filter.
      • Migrant households use the existing household card design, with these additions:
        • Migrant icon (orange house with an outward arrow)
        • Migrant In badge
        • Members registered / total

      6. Migrant In / Migrant Out status

      • The card has a "Migrant In" toggle, which is On by default. Off = Migrant Out.
      • Switching it off opens a confirmation pop-up with:
        • "Date of moving out" (date picker, default today, not in the future, not before the registration date)
        • Cancel and Submit buttons
      • On Submit:
        • Status changes to Migrant Out and the card shows "Migrant Out · <date>" with a muted style.
        • Add Member is disabled.
        • The household is removed from the active Migrant Households list and shown under Migrated Out and Household.
      • On Cancel: no change.
      • Records must NOT be deleted. The household and its beneficiaries are kept.
      • Switching the toggle back On restores Migrant In.
      • Every status change is logged with status, date and user.

      7. All Beneficiaries indicator

      • Beneficiaries of migrant households show a migrant icon in the same slot as the Non-Household icon.
      • Icon for Migrant In & Migrant Household. Refer to this link Iconify - home of open source icons and search mdi:home-import-outline
      • Icon for Migrant Out : search mdi:home-minus-outline
      • The indicator comes from the household and stays visible after the household becomes Migrant Out.

      8. Change the icon of Non Household. Keep it same as the one in TBMJA app. 

      Acceptance Criteria:

      1. Registering a household with Total = 4 and Migrant = Yes shows it under Migrant Households with the Migrant In badge and 0/4 Members Registered.
      2. Registering 2 members updates the card to 2/4. Both beneficiaries show the migrant indicator in All Beneficiaries.
      3. Editing the total from 4 to 5 shows 2/5, and no beneficiary is created. Registering one more member shows 3/5.
      4. When registered = total, Add Member is disabled. The total cannot be saved below the registered count.
      5. Switching Migrant In Off shows the confirmation with Date of moving out. After Submit, the card shows Migrant Out with the date and leaves the active list.
      6. Migrant Out households and their beneficiaries remain available in All Household, Migrated Out and All Beneficiaries.
      7. Regular households (Migrant = No) show no migrant icon, badge or toggle.
      8. All new fields and status changes work offline and sync with the existing household sync.
      9. Non household module has a new icon
      10. All new labels are available in the supported app languages.

      Out of Scope:
      State/district of origin, expected stay duration, transfer of records to the home state, and archiving or deleting Migrant Out records.

      Note : 

      • Kindly contact Pranoti (BSA) for a short grooming session
      • Beneficiaries of Migrant Out households are removed from ASHA due lists. 

              Assignee:
              Nikhil Ananda Fegade
              Reporter:
              Pranoti Monde
              Votes:
              0 Vote for this issue
              Watchers:
              1 Start watching this issue

                Created:
                Updated: