Household Register

Overview

Users are redirected to this screen once they select the Household Register tile/card on the home screen.

The Household Register tile/card is displayed to the user with COLLECTION_OPERATOR role.

Link → {base url}/mgramseva/home/householdRegister

User Interaction On Screen

• From the text field, users can search for connections by using the connection ID.

• Users can see all the connections data of the selected tenant till the current date based on their payment status (Ex: All, Paid, Pending).

• Initially, only 10 connections are loaded for the selected tab. The pagination drop-down and right arrow click enable users to view more connections.

• Selecting any connection ID redirects users to the View Consumer Details screen.

• Click on the Download button to get all the household records in PDF format.

• Click on Share to share the PDF on Whats App.

File Path

Primary Files:

https://github.com/misdwss/punjab-mgramseva/blob/develop/frontend/mgramseva/lib/screeens/HouseholdRegister/HouseholdRegister.dartgithub.com

https://github.com/misdwss/punjab-mgramseva/blob/develop/frontend/mgramseva/lib/screeens/HouseholdRegister/HouseholdSearch.dartgithub.com

https://github.com/misdwss/punjab-mgramseva/blob/develop/frontend/mgramseva/lib/screeens/HouseholdRegister/HouseholdList.dartgithub.com

https://github.com/misdwss/punjab-mgramseva/blob/develop/frontend/mgramseva/lib/screeens/HouseholdRegister/household_pdf.dartgithub.com

API Details

End Point	Request Method	Request Info
/ws-services/wc/_search	POST	tenantId : {} offset ; {} limit : {} toDate : {} isCollectionCount: {} isBillPaid connectionNumber: {} freeSearch: {} sortOrder: {} sortBy : {}
/filestore/v1/files	POST	tenantId : {} module : {}
/egov-url-shortening/shortener	POST	url : {}

Stack

1 → Home Screen. + Household Register Screen

Pop → Household Register Screen→ Home Screen

2 → Home Screen. + Household Register Screen + View Consumer Details Screen

Pop → View Consumer Details Screen → Household Register Screen

Widgets used from Library

Widgets	File Path	Description
Pagination	https://github.com/misdwss/punjab-mgramseva/blob/master/frontend/mgramseva/lib/widgets/pagination.dart	Pagination
BuildTextField	punjab-mgramseva/TextFieldBuilder.dart at master · misdwss/punjab-mgramseva	Text Field
BillsTable	punjab-mgramseva/BillsTable.dart at master · misdwss/punjab-mgramseva	Table
LabelText	punjab-mgramseva/LabelText.dart at master · misdwss/punjab-mgramseva	Title
SubLabelText	punjab-mgramseva/SubLabel.dart at master · misdwss/punjab-mgramseva	Subtitle

Role Access Mapping

case Routes.HOUSEHOLD:
    return ['COLLECTION_OPERATOR', 'SUPERUSER'];

File Path

Model → punjab-mgramseva/water_connection.dart at master · misdwss/punjab-mgramseva , punjab-mgramseva/water_connections.dart at master · misdwss/punjab-mgramseva

View → https://github.com/misdwss/punjab-mgramseva/tree/master/frontend/mgramseva/lib/screeens/HouseholdRegister

Controller -> https://github.com/misdwss/punjab-mgramseva/blob/master/frontend/mgramseva/lib/providers/household_register_provider.dart , https://github.com/misdwss/punjab-mgramseva/blob/master/frontend/mgramseva/lib/repository/search_connection_repo.dart