Ion Hackathon

Problem Statement

People below the poverty line are provided with an official document, i.e. ration card by the Government to buy ration at subsidized rates under the National Food Security Act (NFSA) despite that, a lot of these people face many obstacles before they can get their ration. They have to go through a lot of mismanagement and corruption in the system.

  • Often, ration shop supervisors use malpractices to gain profits for themselves.
  • People have to wait in long queues for their turn to arrive and take their package.
  • Because of an unregulated system, people get frustrated and indulge in fights among themselves.
  • A lot of ration gets wasted because of these reasons.
  • Also, many people create fake ration cards for themselves to avail themselves of this facility by the government.
  • The innocent people who actually have a right to these food grains suffer and end up feeling helpless when they go through such kind of treatment.

Our Solution - Sugam

Sugam

To eliminate the queue formed in front of the ration shops and to put an end to all the malpractices, we are proposing a slot booking application that will allow the consumers to reserve a specific time for the collection of ration. People can book a slot according to their convenience, they would just have to enter their ration card details and select a date and time to confirm their booking.

Features

  • Authentication using phone number.
  • Register and get the details of ration card automatically fetched.
  • Distributors can create slots as per the stock availability.
  • Card holders can book the slots according to their convenience.
  • Upon confirmation a receipt will be sent to the phone number.
  • Distributor will do the manual verification through the receipt and mark done the holder.

Tech Stack

Frontend:

  • React
  • JSX
  • Material-UI
  • Bootstrap
  • CSS

Backend:

  • Node.js
  • Express.js

Database:

  • MongoDb

Authentication:

  • Firebase

Getting Started

  1. Fork the repository.

  2. Clone the forked repository.

git clone https://github.com/<your_user_name>/Sugam.git
  1. Navigate to the cloned repository.
cd Sugam

Prerequisite

Download Node.js from here.
Verify installation by checking the version.

node -v
npm -v

Installation

Server

Navigate to the server folder

cd backend

Install the dependencies by running the command in the terminal

npm install
Environment Variables

To run this project, you will need to add the following environment variables. Create a config.env file in the root.

MONGODB_URL
MONGO
API_SECRET
VONAGE_API_KEY

Client

Navigate to the server folder

cd frontend

Install the dependencies by running the command in the terminal

npm install
Environment Variables

To run this project, you will need to add the following environment variables. Create a config.env file in the root.

REACT_APP_STATE_API_TOKEN
REACT_APP_EMAIL_ID
REACT_APP_API_KEY
REACT_APP_AUTH_DOMAIN
REACT_APP_PROJECT_ID
REACT_APP_STORAGE_BUCKET
REACT_APP_MESSAGING_SENDER_ID
REACT_APP_APP_ID
REACT_APP_MEASUREMENT_ID

Run Locally

Server

Navigate to the server folder

cd backend

Start the server

npm start

After this server will start running at localhost:5000

Client

Navigate to the client folder

cd frontend

Start the project

npm start

After this the client start running at localhost:3000 and one can interact with the website.

Usage

Test data that need to be entered while using the site.

User Details

Ration Number:12buhy89039994
Name:Test User
State:Uttar Pradesh
City:Saharanpur

Distributor Details

Number:268t811tev1781
Name:Test Distributor
State:Uttar Pradesh
City:Saharanpur

Future Scope

In the coming future, we can expect that the concept of a handy ration card will be completely digitalized and there will be no need to carry the cards each time while going to get the ration, just a receipt will be enough to get the ration from the store.

We will provide the facility to create the digital ration cards via the Government officials who will do the verification process.

Team Members

Support

Do support and give a star ⭐