---
description: >-
  This page describes the frontend architecture of the Bolbhav Android
  Application without going into too much technical details, which are explained
  in later chapters.
---

# Copy of Bolbhav Android Application

## Introduction

The Bolbhav app has five main use cases:

<table data-view="cards"><thead><tr><th></th><th></th><th></th></tr></thead><tbody><tr><td><p><strong>Viewing crop prices</strong> </p><p></p><p><br>A user can see the latest prices of a mandi-crop combination including the image of individual sales receipt and aggregated statistics.</p></td><td></td><td></td></tr><tr><td><strong>Contributing crop sales receipts</strong><br><br>Any user can contribute the crop sale data for themselves for after taking consent of any other farmer. In this they share the image of the sale receipt and the associated data. </td><td></td><td></td></tr><tr><td><strong>Validation of crop sale receipts</strong><br><br>Any user can validate the receipts submitted by other users. Only validated receipts are shown to the users in the frontend.</td><td></td><td></td></tr><tr><td><p><strong>Purchasing silver tokens through subscription</strong></p><p><br><br>A user can buy silver tokens by paying to Bolbhav.</p></td><td></td><td></td></tr><tr><td><strong>Redeeming gold tokens into money</strong></td><td></td><td>Contributors can convert their earned tokens into real currency.</td></tr><tr><td><strong>Other use cases</strong></td><td></td><td><br>There are other necessary features like referral, FAQ, statement of tokens, receipt submitted, terms and conditions.</td></tr></tbody></table>

## Set-up

Bolbhav application was launched on 1st November 2023 on the Google Android Play Store.

#### How to download and access the application

On any Android smartphone, visit the Playstore and search for Bolbhav. Alternatively the application can be accessed via this link: [https://play.google.com/store/apps/details?id=com.listag](https://play.google.com/store/apps/details?id=com.listag)

{% hint style="success" %}
Why the App Id is listag.com and the released date is 20/03/2021?\
\
Bolbhav was pushed an update to an earlier app - List - that was created to unable farmers share their crop data with traders. List app was launched on March 20, 2021 but it did not get the traction from the farmers. Hence, this listed app was pulled down and Bolbhav app was uploaded as a new app on the same app id: com.listag. It had around 5000 app installs and over hundred reviews, we thought we can benefit from it.
{% endhint %}

#### Play console Admin

If you want access to playstore, please reach out to Vikas.

#### Language of the app

Currently, the application is only available in the Hindi language.

### Splash screen

Currently, it is a image that is not responsive and dimensions are messed up. We are working on a GIF.

<details>

<summary>Splash screen</summary>

<img src="https://3898150257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrjNYs8KmxBlZvBKyEb2T%2Fuploads%2FoGUY7ZgxXndCsUMKtwFt%2FScreenshot%202024-02-26%20at%2011.18.00%20PM.png?alt=media&#x26;token=d5f9870a-087b-4e3a-8958-eb44e1b7eb38" alt="" data-size="original">

</details>

#### Sign up

After one has installed the application, a user can login using an Indian phone number. They will receive a code in the message that the user has to submit to prove that they own the mobile number. Currently, this is the only way to sign-up. Sending message to international numbers is not integrated. Any phone number entered is automatically assumed to be an Indian phone number with default country code of +91.

<details>

<summary>Sign-up wireframe</summary>

<img src="https://3898150257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrjNYs8KmxBlZvBKyEb2T%2Fuploads%2FCMkzBnJGtrlD1oSujmir%2FScreenshot%202024-02-26%20at%2011.20.54%20PM.png?alt=media&#x26;token=d9df94e3-214f-4224-9721-801d21746604" alt="" data-size="original">

</details>

#### OTP service

The phone number verification code is sent via [Msg 91](docId:EYz_UoS0HYgTVEHjdFhq-) platform.

## Use case -1: Crop Price viewing

A user follow following steps to see crop prices:

1. Select mandi: On the home page, a user will see a list of mandi where we are live.
2. When a user selects a mandi, they are taken to next page where they are shown list of crops of the latest available date. This page also have mandi holiday information on past, current or future dates. Below the name of the crop, there are count of receipts for that crop-mandi combination.
3. When a user selects a crop, they are taken to the next page where they are shown the prices of that mandi-crop-date combination.
   1. Minimum - Median - Maximum prices per quintal
   2. Images of all receipts of that mandi-crop-date in decending order of price. A user can click on the image to open a HD version of image, where a user can zoom-in the image.
   3. Each image has a share button that share a deep link.

<figure><img src="https://3898150257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrjNYs8KmxBlZvBKyEb2T%2Fuploads%2Ff5UJyhO4RGLPdh9DfvM5%2FScreenshot%202024-02-26%20at%2011.51.30%20PM.png?alt=media&#x26;token=04297113-2a1e-4461-b0fa-2b8d07caea29" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
In the current journey, there are multiple scope of improvement.

1. A user cannot select date and look back past date prices to make sense of trends.
2. Reason of mandi holiday is not provided.
3. Only price range is shown, whereas we have the data to shown the price distribution.
4. On the price page, lot of space is wasted with static content.
{% endhint %}

## Use case -2: Crop sale receipt contribution

1. After selecting mandi, a user can click on the button "contribute sale receipt". This will take the user to select crop page. Here the user can see how many receipts of that crop has already been uploaded on the platform.
2. When a user selects the crop, they are taken to a page where they can enter the booklet number and receipt number written on the crop sale sale receipt.&#x20;
3. The combination of "mandi-date-booklet number-receipt number"  must be unique. If it is not then a recept is highlighted as duplicate entry and user is requested to uplaod some other receipt.
4. If the receipt is not duplicate, then the user is asked to provide more details:
   1. quantity
   2. price
   3. photo of the receipt
   4. phone number of the owner
5. After this the user is promised a certain number of promised token, whcih which be credited to their account upon succesful validation of the receipt. If validation fails then the user does not earn any tokens.&#x20;

<figure><img src="https://3898150257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrjNYs8KmxBlZvBKyEb2T%2Fuploads%2FgmxvUslJ3PN0BKbS7GEy%2FScreenshot%202024-02-27%20at%201.31.33%20AM.png?alt=media&#x26;token=d664aab4-aaff-496a-93d4-4f4c5d1b8d35" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
In the current journey, there are multiple scope of improvement.

1. There are two types of receipts in the mandis - hand written and printed. The receipt submission form is not personalized to type of receipt.
2. It is not very clear to why there is a need to submit the receipt owner phone number.
3. We can add the number of token on the crops itself so that the contributors can know which crop can lead them to maximum tokens.
4. We are not collecting trader's name, which is one of the main information for building future products.
{% endhint %}

## Use case -3: Validation of crop sale receipt contribution

1. A user is shown a receipt and a series of nine questions.
2. Once they submits the validation, they are promised tokens, credits to their wallet upon successul validation by another use or team member.
3. One receipt is shown to two users. If there answer contradicts then that receipt is shown to the team member for undertake final validation.

<figure><img src="https://3898150257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrjNYs8KmxBlZvBKyEb2T%2Fuploads%2FulSVDknYGp9gGqMx4CG2%2FScreenshot%202024-02-27%20at%202.12.23%20AM.png?alt=media&#x26;token=f8969ca9-3b11-4d30-b2b0-9e0f07e34616" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="443">Questions</th><th>Options</th></tr></thead><tbody><tr><td>क्या फोटो में मंडी नीलामी पर्ची साफ़ नज़र आ रही है?</td><td>हाँ, नहीं<br></td></tr><tr><td>क्या ये {{receipt_date}} तारीख़ की नीलामी पर्ची है?</td><td>हाँ, नहीं, दिख नहीं रहा है<br></td></tr><tr><td>क्या ये {{mandi_name_hi}} मंडी की नीलामी पर्ची है?</td><td>हाँ, नहीं, दिख नहीं रहा है</td></tr><tr><td>क्या इस पर्ची पर {{crop_nme_hi}} फ़सल का नाम लिखा हुआ है?</td><td>हाँ, नहीं, दिख नहीं रहा है<br></td></tr><tr><td>इस पर्ची का पुस्तिका क्रमांक {{booklet_number}} है?</td><td>हाँ, नहीं, दिख नहीं रहा है<br></td></tr><tr><td>इस पर्ची का अनुबंध क्रमांक {{receipt_id}} है?</td><td>हाँ, नहीं, दिख नहीं रहा है<br></td></tr><tr><td>क्या इस पर्ची {{price}} प्रति क्विंटल भाव लिखा है?</td><td>हाँ, नहीं, दिख नहीं रहा है<br></td></tr><tr><td>क्या इस पर्ची में अनुमानित वजन {{quantity}} क्विंटल लिखा है?</td><td>हाँ, नहीं, दिख नहीं रहा है</td></tr><tr><td>क्या पर्ची के पीछे {{crop_name_hi}} फसल साफ़ से दिख रही है?</td><td>हाँ, नहीं, दिख नहीं रहा है<br></td></tr></tbody></table>

## Use case -4: Purchase silver tokens using money

1. Silver tokens are needed to view prices. To see prices for one day, four silver tokens are reduced from user's wallet. Once four silver tokens are reduced, a user can see prices for next 24 hours.&#x20;
2. Services of Phone Pe Payment Gateway is used to enable users purchase subscription.
3. A user can choose between any of the three plans.





## Use case - 5: Convert gold token into money



## Other use cases

![](https://archbee-image-uploads.s3.amazonaws.com/WPhORIY5wbVXcAz9WLeSH/4zmIliq35zHO9G3wirvJ0_screenshot-2024-02-16-at-10230-am.png)

In the hamburger menu, there are other features that supports the user the undertaking above four use cases

### Tracking

Services of [Posthog](docId:C-yFMmbOinrHnuO6u9dcs) is used to track users interaction with the application.

### Referral

1. Referral link that a user can share with others and if anyone installs the app using it then the user gets silver tokens in rewards.
2. Services of Branch.io is used to track if a new user came using someone's referral code.

### FAQ

1. FAQ that contains a list of repeatedly asked questions.

### My Receipts

My Receipt page that provide information on all the receipts contributed by the user.

### My Tokens

My token page to know about the token balance and statements.

### My payments

1. My payments contain the list of all payments made by the user to buy subscription.
