The documents in this section provide the complete details of the

Overview

The users receive a link via SMS. Clicking on this link redirects the users to the login page of the mGramSeva app. The users can log in from this screen or even reset their password in case they are logging in for the first time. The mGramSeva application link initiates from this screen.

Language Selection

The link in the SMS redirects users to this screen which is the first screen which is the language selection screen. The user selects the preferred language and clicks on Continue. English, Hindi, and Punjabi are the supported languages with Punjabi as the default language. Localization in the screens is displayed based on the language selected.

User ID and Password Entry

The user enters the User ID, which is the registered mobile number of the user, and the system-generated password. Clicking on the Continue button logs in the user.

Forgot Password

The Forgot Password link navigates the user to the password reset screen.

On Successful Login or on Validations of User ID and Password

First Time Login

The user is redirected to the password reset screen where they enter the OTP received on the registered mobile number. The next screen prompts the user to enter a new password and then confirm the same. This is similar to the first-time login screen. Clicking on Submit displays the acknowledgement screen. Clicking on the Continue to Login button on the acknowledgement screen takes the user to the login page.

Subsequent Login

The user is redirected to the home page of the application which displays the menu options based on the mapped user role.

Based on the user role the following functionalities are available and displayed on the home screen:

As soon as the revenue collector marks the bill as paid by the consumer, they receive one SMS with the link to receipt in PDF format and another SMS with a link to collect feedback.

​All content on this page by eGov Foundation is licensed under a Creative Commons Attribution 4.0 International License.

Overview

The household masters have to be created in the system to initiate the demand generation and collection process. These are consumers also referred to as the household that avails the water connection and supply on regular basis.

Select the Create Consumer option from the list of tile/cards on the home page. This redirects the user to the Create Consumer page.

Data element details for the consumer are listed in the table below -

Overview

The search screen is used to filter the list of consumers based on selected criteria. This is the common search screen for all the transactions such as -

1. Collect payments

Expense modification is allowed based on the status of the payment as given in below scenarios -

Scenario 1: When the status is “Unpaid”

Allows users to modify all the details except the Bill id. But the user has the option to mark the Bill as “Cancelled”.

Scenario 2: When the status is “Paid”

Does not allow users to modify any details. But the user has the option to mark the Bill as “Cancelled”.

All content on this page by

Overview

This is an option to download bills without clicking on collect payment.

Steps

The user of the GP system is onboarded by loading user records in bulk as a backend activity. The system enables the loading of user records in bulk and creates the profiles with a mobile number as login id and with a random password.

On loading user profiles - The GP users are sent a link and login credentials over SMS required to login to the mGramSeva application. The link navigates to this screen and takes the user through the flow of logging in and resetting the password in case of first-time login.

The web link, too, initiates from the same screen.

​All content on this page by eGov Foundation is licensed under a Creative Commons Attribution 4.0 International License.

Overview

Show Update App popup to end users in case there is a new release in the Google Play Store or IOS App Store.

MDMS Configuration

There are 2 methods to generate Bulk Demand -

1. Auto (scheduler based)

2. Manual

Auto: The demand is generated at end of the month or the first day of next month or as scheduled for the recently completed billing cycle. Use cases are as below -

Overview

Clicking on the Dashboard on the home screen navigates the user to the revenue dashboard view for the current month. This provides a tabular view of the list of consumer records.

Data Points

The demand is generated for metered connections for the billing period (defined based on the meter reading date) selected by the user at the time of recording the meter reading.

The 2 use cases to be handled are -

1. First demand generated in the system: The demand is generated for the selected billing period. The demand period would be from “Previous meter reading date” from the consumer master or the demand created as part of the master TO the date entered in the billing screen. The arrears are tagged to the previous billing period of the current demand, and the period is from the start of FY to the “Previous meter reading date” from the consumer master.

2. Consecutive demand: The demand is generated for the period defined based on

mGramSeva users can edit their basic information like name, add gender, email and change password using the hamburger menu on any screen.

1. Users can click on the hamburger menu from any screen. A slider from the left opens up.

2. Users are able to

On selection of “Modify Expense” option, the below search screen is shown for the users to search the Bill/s -

Search Criteria -

• Vendor Name

• Expense Type

Overview

Clicking on the Dashboard on the home screen navigates the user directly to the revenue dashboard of the current month. From here, the user can switch to the expenditure tab to get a view of expenses. This provides a tabular view of all expenses incurred in that month.

Data Points

Following are the data points/actions needed on the screen:

The table on the screen is a horizontal scrollable one with the leftmost column fixed.

All content on this page by is licensed under a .

Overview

Users can click on the Household Register on the home screen and navigate to this screen. This provides a single-view snapshot of all pending collections by consumers to date.

Unlike non-metered connections that have a billing cycle for demand & bills generated automatically, a metered connection needs more inputs, which helps in volumetric billing.

A revenue collector can see a CTA to “Generate a new Bill” on the HH details screen.

1. Clicking on “Generate a new Bill” takes users to the bill generation screen where new meter reading details are entered.

2. The field on the bill generation screen for metered connections is displayed in the table below.

All Gram Panchayats have a monthly billing cycle for water charges. The Scheduler automatically triggers on the “X” date of every month to generate demand and raise bills for non-metered connections.

• Metered connections do not fall under bulk demand generation

1. For the first month of go-live, it is only the arrears and no demand that is generated hence there is no bill to collect payments.

Overview

Consumer information can be edited under certain conditions -

1. Before the first demand is generated in the system

2. After the first demand is generated in the system

Edit Screen

• Users with permission to edit consumer records can click on the Edit Consumer info tile on the home screen. This navigates them to the consumer search screen.

• Users can navigate from the search screen or the search results screen (Case when multiple search results are displayed) to the Consumer Edit Screen.

• On the successful load of the consumer edit screen, all data parameters of the consumer are shown (with editable and non-editable fields).

The table below lists the editable field details -

Edit Options

1. In case there are arrears, demand is generated. If there are no arrears, demand is not generated.

2. Users can modify the arrear value. In such a case, demand is generated with the updated value.

3. Users can add arrear to the connection, for which arrear was zero at the time of creating the connection. In such a case, new demand is generated.

Clicking on the Submit button shows a nudge saying Details Submitted Successfully. Closing the nudge navigates the user back to the home screen.

The CTA is activated only when any field is changed or updated. Else, it is in an inactive state.

All content on this page by is licensed under a .

Overview

1. Users are redirected to the View Consumer screen from the home screen via

   • Collect payments → Search Screen → Consumer Details Screen

   • Download bills & receipts → Search screen → Consumer Details Screen

   • Dashboard → Collections → Click on Consumer ID

   • Household Register → Click on Consumer ID

2. This screen contains all information related to HH

Static HH card displays the following details

1. New Connection ID (also displayed as a heading)

2. Consumer name

3. Father's name

4. Phone number

For Non-Metered Connection

1. If the bill is not generated (Post rollout until the first month)

   • Only the data Card is shown - No action is required

2. Once the first demand is generated - A new consumer bill/card gets generated and displays the following data points and actions -

New Connection Before First Bill Generation

First bill is generated - Payment Collection is pending

2 payments made

For Metered Connection

1. If a bill is not generated (Post rollout until the first month)

   • A data card is displayed on the screen

   • Below the data card - the Card to generate a new bill is also displayed

All content on this page by is licensed under a .

Overview

Water Connection advance changes are added to allow the customer to pay the advance amount. This amount is adjusted when a new demand is generated. We can enable or disable advance based on the configuration.

Pre-requisites

Once the demand is generated for metered and non-metered connections, revenue collectors come to this screen to collect payments.

1. Users can see the consumer billing information on the screen

2. Clicking on View Details expands the card and shows more details. Clicking on the Hide Details collapses the card to show only connection ID, Consumer Name & Total Due Amount.

3. Payment amount - can either pay

The expense entry for the O&M on regular basis is captured on this screen.

On selecting the option “Add Expense Record” from the list of tile/cards on the home page, the user is navigated to the expense entry screen. The screen displays the following fields.

On Submitting, the Expense entry gets created with a Bill number assigned. The Bill number generated would be based on logic defined as - “EB-<FY>-<4 digit running seq No>”

On Successful creation of expense entry, an acknowledgement screen is shown “Expense Entry successful” along with the Bill Number.

All content on this page by is licensed under a .

For mGramSeva users, different notifications are displayed on the home screen based on various system triggers.

1. A new card is used for each notification displayed below.

2. Cards have a countdown timer - today, 1 day ago, 2 days ago, 3 days ago, and so on.

Various SMS notifications are sent to different users on different actions. Below is a consolidated list of all SMS notifications required.

Bill and Receipt PDFs can be sent to consumers at multiple touchpoints.

1. When bulk demand is generated through SMS

2. When meter reading is done for metered connections, via SMS

3. When revenue collector goes to HH screen and clicks on download PDF (into his mobile)

4. When revenue collector goes to HH screen and clicks on WhatsApp share PDF (Share PDF’s on WhatsApp)

Bill PDF

Receipt PDF

All content on this page by is licensed under a .

Backend Code Git Repo

Connect to your GitHub account and navigate to the config /persister repo: DevOps repo: Connect your Github account

There is the concept of hierarchy in mGramSeva : 1. State-level user → one who can create a Division user 2. Div level user → one who can create the employees like Sarpanch for mgramseva List of changes done in the user service and HRMS service to adapt HRMS in mGramSeva:

1. Modified the search API of user service to do role based search of users based on the tenants it is mapped to and show the list in all cities where it is mapped to. State-level users can search for division users. Division users are created and mapped to pb as the base tenants and roles HRMS_ADMIN, and DIV_ADMIN to the concerned cities. Division users can search users based on roles like - SYSTEM,+GP_ADMIN,+COLLECTION_OPERATOR,+PROFILE_UPDATE,+DASHBOAD_VIEWER within the GPWSC it is currently logged into.

Users can walk through the application for a better understanding of different user actions available on key screens.

Home Screen

Consumer creation screen

Expense Entry Screen

Dashboard

All content on this page by is licensed under a .