Introduction

Jira Ticket:

https://project-sunbird.atlassian.net/browse/SC-1321

JTBD

Jobs To Be Done:
Context/ Ask : States require Diksha usage to be reported at a District level (as of now) so as to be able to drive action on the ground to improve usage.
User Personas: All usage (state as well as other consumption)

Requirement Specifications

This section consists of requirement specifications for specific use cases in the User JTBD. The requirements for each use case are elaborated in detail through sub-sections for:

Use case overview

The solution proposal is based on the following broad premises:

>> Any device that installs/ uses Diksha will be mapped to a location (Device Profile) - the user will be prompted to edit/ confirm a location based on a suggestion that uses IP based location

>> Users who sign up will be required to declare a location for their user profile - the location from the device profile can be used as a suggestion for the user to edit/ confirm.

Usage attribution (for telemetry):

If there is no user logged in:

>> All such usage will be attributed to the device location

If there is a user logged in:

>> If the User Profile has a location available, usage will be attributed to this location

>> If the user profile does not have a location, the user will be prompted to confirm their location - the system will suggest a location for the user to confirm, based on the device location. Once the user confirms, this is stored against the user profile.

Overall process workflow

App/ Portal Actions:

When a device starts to use Diksha, check to see if the device is registered (has an entry in the device profile)
If device not entered in Device Profile, create an entry in Device Profile (post location capture as confirmed by user - this will use GPS/ IP mapping to provide suggestions)
If no user is logged in, set Derived Location = Device Location

When a user logs in, check to see if the User Profile has a location

If location is available, set Derived Location = User Profile Location
If location is not available, use Device location as a suggestion, and prompt the user to confirm their location. Once confirmed, save the location to the user’s profile

Set Derived Location = User Profile location

Stamp telemetry from device with Derived Location - stamping of telemetry with the location will happen in the pipeline

APP BEHAVIOUR

When a device installs the app :: Determining Location for Device Profile

The device register API is called as soon as installation happens (if the device is online), and the IP based location of the device is captured [ Santhosh Vasabhaktula Namrita Rao - in case the device is offline, is it cached locally and sent to the server when a connection is available? ]
~~TBD : As part of permissions, the user is asked to grant access to GPS - and if this is obtained, the GPS based location of the user is also obtained (but not saved)~~
As part of on boarding, the user has to mandatorily [MAKE CONFIGURABLE] confirm their location - in order to make this easier, the user is prompted to confirm the location derived by IP ~~(or GPS, if available)~~
The user can choose to confirm the suggested location (the suggested location will be provided if the IP based location suggestion is available. If not, there is no suggested location), or choose a State/ District from the values in the autocomplete dropdown [a user can start typing to see suggestions or can use the drop down to see the list of possible values to select]
The location thus confirmed by the user is stored as the User Confirmed location against the device in the Device Profile DB

When a user Signs up (self sign up) :: Determining Location for User Profile

Sign up by filling form

Sign Up with Google

Fill out the sign up form (Name, Phone/ Email, Password)
Get OTP, and submit it to complete account creation
Re-login

Login with Google

Go through On Boarding - Board, Medium, Class
Has to confirm location suggestion (as derived from Device profile), or choose a location from the autocomplete dropdown values

This causes the self signed up user Profile to be created with the location details as confirmed by the user.

Note: In case of user accounts set up by the state (SSO, Shadow DB) where the state provides the school (sub-org) association of the user, this location detail will be used to populate the user profile. The user is not required to declare their location in such cases. Likewise, when a migration/ merge to the state tenant happens, the location values in the state tenant will be retained.

PORTAL BEHAVIOUR

Pre-requisites: Portal Device duplication has to be resolved if this has to function in a predictable fashion (expected to be resolved as part of release 2.4)

The portal workflow can be initiated via

Portal browse
QR scan (using Dikhsa or a non-Diksha app)

Portal usage can happen on desktops as well as mobile devices (mobile web)

The rest of the flows (location determination, location storage against device, location storage against logged in user) remain the same as the app.

[TBD : Offline desktop app Namrita Rao Santhosh Vasabhaktula]

TELEMETRY STAMPING

Stamping of telemetry :: Telemetry attribution to a location - in the pipeline

If usage is by a non-logged in user, derived location = device location
If usage is by a logged in user and user profile has location, derived location = user location
If usage is by a logged in user and user profile does not have location, the user is prompted to confirm their location using the device location as a suggestion. Once the user manually confirms their location, this is stored in the user profile.

Stamping of usage telemetry is carried out using the derived location.

Other points to note:

The default list of locations (State/ District) will be packaged with the app , and will periodically refreshed from the server - like the current Framework list that the app loads. The Platform will have to be the single source of District data for Diksha
The list of Districts will have to be validated individually with states (What happens if I can’t find my District in the list?)
Defaults for State/ District list will be loaded onto Diksha (Udise defaults) - these will be used to populate the State/ District dropdowns that the user will choose from.

Link to workflows (Detailed visualisation of the following workflows - w.r.t. deriving location)

>> App install and usage

>> New user sign up

>> Telemetry stamping

>> Portal based usage

Localization requirements

Telemetry requirements

How many users are seeing a location suggestion based on IP resolution?

How many users are accepting the suggestion without making any changes?

How many users are making changes to the suggestion and then saving the location?

How many have edited their location (State/ District) after providing it?

UX Designs:

PORTAL :: https://projects.invisionapp.com/d/main#/projects/prototypes/18613846

APP :: Location Permission

Dependencies
Impact on other products
Impact on existing data

Key Metrics

Srl. No.	Metric	Purpose of Metric