Create Consumer

Enables employees to create new Consumers or Connections - The process of onboarding the end-users.

Link

→ {base url}/mgramseva/home/consumercreate

The Create Consumer card is available on the home screen as per the defined user role.

Click on the Consumer Create card navigates the user to the consumer creation screen.

Users enter the required details for the creation of Consumer.

If a user logs in for the first time then a walkthrough is populated following the same logic as in the home screen.

File Path

Primary Files - punjab-mgramseva/WalkFlowContainer.dart at develop · egovernments/punjab-mgramseva , punjab-mgramseva/walkthrough.dart at develop · egovernments/punjab-mgramseva

Fields	Validations
consumer Name*	[A-Za-z ]
Gender*	None
Spouse/Parent’s Name*	[A-Za-z ]
Phone Number*	[0-9]
Old Connection No	None
Door Number	None
Street Name/Number	None
Gram Panchayat Name*	None- Disabled
Propert Type*	None
Service Type*	None
Meter Id	[a-zA-Z0-9]
Meter Reading	[0-9]
Billing Cycle	None
Arrears	[0-9.]

Note: All fields are validated on Submit except the Phone number which gets validated on change.

API details

API	Params	Description
/egov-mdms-service/v1/_search	[{"moduleName":"ws-services-masters","masterDetails":[{"name":"connectionType"}]},{"moduleName":"PropertyTax","masterDetails":[{"name":"PropertyType"}]},{"moduleName":"BillingService","masterDetails":[{"name":"TaxPeriod","filter":"[?(@.service=='WS' && @.fromDate <= 1631989800000 && @.toDate >= 1631989800000)]	To get the Property Type and service Type and billing cycle values for the Dropdown
egov-location/location/v11/boundarys/_search?	hierarchyTypeCode=REVENUE&boundaryType=Locality&tenantId={tenantID}	To get the values for Locality DropDow

Consumer creation involves 2 sequential Process

1. Property Creation

2. Water connection Creation

After creating a property, the Property ID is linked to the WaterConnection Request JSON.

Water connection creation is of two types:

A metered connection that requires Meter ID and meter installation Date/ Last Meter Reading Date and an optional field to capture meter reading.

Non-Metered Connection which requires the last billing cycle as mandatory params captured in the field as shown below.

Users can switch between connection types by selecting a desired value from the Service Type DropDown.

API	Description
property-services/property/_create	Property Creation Request JSON defined in punjab-mgramseva/property.dart at develop · egovernments/punjab-mgramseva
ws-services/wc/_create	Water Connection Request JSON defined in punjab-mgramseva/water_connection.dart at develop · egovernments/punjab-mgramseva

Role Access Mapping

    case Routes.CONSUMER_CREATE:
        return ['GP_ADMIN', 'SUPERUSER'];

Components utilised from Widgets Library

Components	File Path
TextField Builder	punjab-mgramseva/TextFieldBuilder.dart at develop · egovernments/punjab-mgramseva
RadioButtonField Builder	punjab-mgramseva/RadioButtonFieldBuilder.dart at develop · egovernments/punjab-mgramseva
SearchSelectField Builder	punjab-mgramseva/SearchSelectFieldBuilder.dart at develop · egovernments/punjab-mgramseva
DatePicker Builder	punjab-mgramseva/DatePickerFieldBuilder.dart at develop · egovernments/punjab-mgramseva

Files Path

Model → punjab-mgramseva/property.dart at develop · egovernments/punjab-mgramseva , punjab-mgramseva/water_connection.dart at develop · egovernments/punjab-mgramseva

View → punjab-mgramseva/ConsumerDetails.dart at develop · egovernments/punjab-mgramseva

Controller → punjab-mgramseva/consumer_details_repo.dart at develop · egovernments/punjab-mgramseva , punjab-mgramseva/consumer_details_provider.dart at develop · egovernments/punjab-mgramseva