Chapter-5 Crop Price Viewing

This page describes one of the primary use cases of the Bolbhav app which is the farmers viewing the crop prices across various registered Mandis.

This document details the functionality of the Crop Price View section within the Bolbhav app, outlining the changes implemented in the newer version 6.5.0.

Overview

On the Bolbhav app, prices are shown from multiple sources:

  1. Open-source Public Data

    1. Agmarknet

    2. MP State Agricultural Marketing Board Website

  2. Sales receipt contributed by Bolbhav User

Steps in the Journey

  1. Select a mandi

  2. Select a crop for a particular mandi

  3. Do validation of a receipt (one time a day only if an unvalidated receipt is available)

  4. Price View Page

  5. On Price View Page, a user can change the date

Mandi Selection Page

When a user clicks on "View Receipts" on the home screen, they come to this page,

Key attributes visible

  1. Mandi Name

  2. Latest Available Price Date

  3. Count of receipts on the Latest Available Price Date

Mandi List

  1. Mandi Name is taken from the field "mandi_name_hi" from the Mandi Table, where "is_bolbhav_plus" is True.

  2. If none of the crops of a mandi has prices in the last 30 days then that mandi will not be shown in the list.

Latest Available Price Date

It is last date for which prices are available either from public database or prices that have been contributed by our users.

Count of receipts on the Latest Available Price Date

It is summation of all counts of receipts available for all the crops for the latest available price date. Public Database prices for a crop is counted as one receipt. {Clarification: Suppose, for a given date we do not have any prices from users but we have prices from public database for 5 crops. In this scenario, the count on the mandi page will be equivalent to five.}

How are mandis sorted?

  1. First two mandi will be user's favourite mandis.

  2. After, two favorite mandis, all other mandis will be sorted in following order

    1. Date

    2. Count of receipts within a date

How are favourite mandis decided?

  1. In the mandi_crop_follower table, total_visit_count field is used to identify the top mandi for which a user has made visit. The top two mandis are then shown on the mandi page.

  2. Within these top two mandis, if there is one unlocked mandi then that is shown on the top. If the unlocked mandi is not from the top two mandis then the unlocked mandi is shown on the top and then the most visited mandi from mandi_crop_follower table is shown.

  3. For a new user, there will be no entry in the mandi_crop_follower table, hence, no favourite mandis will be shown.

Search Bar functionality

A user can search the name of the mandi in Hindi, English or Hinglish.

Mandi Page Screens

Users with No Mandi or All Mandis Unlocked:

Users who haven't unlocked any mandis or have unlocked all mandis will see a complete list of all available mandis.

  • Users with no unlocked mandis can select any mandi and choose any crop within that mandi. However, they can only view public database prices and one sales receipt for that crop. The remaining receipts will be locked.

  • Users with all mandis unlocked can access any mandi and any crop, and they can view all uploaded receipts for their chosen selection.

Users with 1 mandi unlocked

These users will see a list of all mandis on the selection screen: One specific mandi will be marked as "unlocked," indicating the one they previously chose when unlocking the 1-mandi subscription (either through payment or 5 approved receipts). Learn more about subscriptions here.

  • For the unlocked mandi, users can choose any crop and view all uploaded receipts.

  • For other mandis and their crops, they will have similar experience of locked mandis.

Users whose 5 receipts got approved (Unavailed Plan)

  1. As soon as a user hit the milestone of five approved receipts, a subscription plan is allocated to them in the trader_subscription_tracker table.

    1. Plan Name: reward_for_5_receipt_contribution

    2. mandi_id: remain null

  2. When users whose reward_for_5_receipt_contribution is active but the mandi_id is null, visits the price view journey then they are taken on a page to select the mandi that they want to unlock.

  • They will first encounter a screen explaining the opportunity to unlock one free mandi for one year.

  • A list of all available mandis will be presented for them to choose from.

  • After selecting a mandi, a confirmation screen will appear, followed by a congratulatory screen upon confirmation.

  • The congratulatory screen will offer two CTAs:

    • अभी पर्ची डालें: This encourages users to upload more receipts to reach the next milestone of 50 receipts, unlocking all mandis.

    • भाव देखें: This CTA redirects the user to the mandi selection screen with their chosen mandi now unlocked and accessible for viewing crop prices

Crop Selection Page

When a user selects a mandi, they are shown the list of crops for that mandi.

Key attributes visible

  1. Crop List

  2. Latest Available Price Date/time

  3. Count of receipts on the Latest Available Price Date

Crop List

  1. Crop Name is taken from the field "crop_name_hi" from the Crop Table.

  2. Only those crops are shown for which price data (either from public database or user contributed) is avialble in the last 30 days.

Latest Available Price Date/time

It is last date for which prices are available either from public database or prices that have been contributed by our users.

  1. For crops where price for today is available. Show the number of seconds/minutes/hours at which price for that crop is updated. For example: 4 सेकंड/मिनट/घंटे पहले

  2. For older date situration, date is visible in DD/MM/YYYY format.

Count of receipts on the Latest Available Price Date

It is summation of all counts of receipts available for that crop for the latest available price date. Public Database prices for a crop is counted as one receipt.

Crop Sorting

Crops are sorted in following order

  1. Date

  2. Count of receipts within a date

Price Page

This page shows the price data for the chosen crop and mandi.

Key attributes visible

  1. Button to Select Date

  2. Public Database price poster

  3. Price Distribution table

  4. Images of sales receipt contributed by user

  5. A floating button to nudge users to contribute.

  6. lock on images

Button to Select Date

  1. The button have date written in the top half in DD Month_Hindi format and in the bottom half is the count of receipts for that date-mandi-crop combination. The count is including of the price from public database.

  2. Currently, the ten dates are shown.

  3. Only those dates are shown where at least one price is available. Today date is visible even if there are no prices.

  4. The dates will be in the acsending order with the lastest date will be on the right hand side. A user can scroll the dates and select any date.

  5. Upon selection, data for that date will be fetched. In between, all date button will turn unclickable and loading background will be visible in the receipt image section.

Public Database price poster

  1. This poster is a format coded in the frontend with dynamic fields.

  2. The share button leads to a WhatsApp message with price data. It does not share the poster.

  3. If prices from public database are available then show the prices. The field of quantity (arrival) will be visible only when there is data available. If this field is null and it will not be visible in the frontend.

  4. If prices from public database are not available then show a poster to them that the mandi officials have not uploaded the prices on government websites.

Price Distribution table

  1. It will be shown if number of approved receipts are over ten.

  2. To know more about how this table is formed. Read here

Image of sales receipt contributed by users

  1. On this page a lower size image that is of reduced quality is shown. If clicked then the image opens on a new page where high quality image is shown.

  2. The attributes visible on the image are

    1. Status of validation

      1. Pass

      2. Fail

      3. Pending

    2. Share button which when clicked will have a text message with a URL that also has a static image in the preview.

    3. Contributor profile image and name

    4. Validators profile images only

    5. Option to flag a receipt is approved

    6. Option to know the reasons if rejected

  3. How are receipts sorted?

    1. Public Database Price poster: It will always be shown on the top. After that sales receipts contributed by users will be shown in following order.

    2. Validated Receipts (Passed): Receipts that have been successfully validated and passed will be displayed first. Each validated receipt will be marked with a stamp indicating "Pass".

    3. Pending Receipts: Receipts that are pending validation will be displayed next. Each pending receipt will be marked with a stamp indicating "Janch Baki Hai" (Validation Pending).

    4. Failed Receipts: Receipts that have failed validation will be displayed last. Each failed receipt will be marked with a stamp indicating "Fail".

Floating Button

  1. This takes users to the contribution jouney.

  2. It has dynamic count of how many receipt a user has to submit to unlock the next level of reward.

    1. For user less than 5 approved receipts, it nudges to reach the milestone of 5 receipts to unlock one mandi.

    2. For users more than 5 but less than 50 approved receipts, it nudges to reach the milestone of 50 receipts to unlock all mandi.

Lock on images

PreviousValidation LogicNextCache Memory

Last updated