🌾 Smart e-Ration Distribution System

A full-stack PHP & MySQL web application that digitizes the Public Distribution System (PDS) by enabling citizens to request ration online, verify identity, generate QR-based pickup tokens, and allowing administrators and shopkeepers to efficiently manage ration distribution.

---

🌐 Live Demo

Website: https://smart-eration.42web.io

---

✨ Features

👤 Citizen Module

• Secure Citizen Verification
• OTP Verification
• Family Details
• Rice Allocation
• Request Ration
• QR Code Token
• Pickup Time Slot
• Nearby Ration Shops
• Interactive Maps

---

🛒 Shopkeeper Module

• Secure Login
• Pending Requests
• Verify Token
• Distribute Ration
• Scan Citizen Details
• Today's Distribution
• Logout

---

👨‍💼 Admin Module

• Admin Authentication
• Dashboard
• Add Citizen
• Add Shop
• Manage Stock
• Stock Records
• Change Password
• Session Management

---

🛠 Tech Stack

Frontend

• HTML5
• CSS3
• JavaScript

Backend

• PHP 8

Database

• MySQL
• MySQLi

APIs & Libraries

• Fast2SMS API
• Leaflet.js
• OpenStreetMap
• QR Code API

Hosting

• InfinityFree
• phpMyAdmin

---

📸 Screenshots

🏠 Home & Shopkeeper Portal

Home	Shopkeeper Portal

---

🔐 Admin Authentication & Stock Management

Admin Login	Stock Management

---

📦 Stock Records & Citizen Portal

Stock Records	Citizen Portal

---

📲 OTP Verification & Digital Token

OTP Verification	Digital Token

---

🗂 Project Structure

e-ration-system/

admin/
shopkeeper/
config/
css/
qrcodes/

index.php
citizen-login.php
family-details.php
send-request.php
verify-otp.php
timeslot.php
nearby-shops.php

README.md

---

🗄 Database Design

The application uses 6 relational tables.

Table	Purpose
admins	Admin Authentication
shopkeepers	Shopkeeper Accounts
citizens	Citizen Information
family_members	Family Details
ration_shops	Shop Locations
ration_requests	Distribution Requests

---

🔄 Workflow

Citizen Login
      │
      ▼
OTP Verification
      │
      ▼
Family Details
      │
      ▼
Request Ration
      │
      ▼
QR Token Generation
      │
      ▼
Shopkeeper Verification
      │
      ▼
Ration Distribution

---

🚀 Installation

Clone Repository

git clone https://github.com/Pulipati-Rahul/e-ration-distribution.git

Move Project

htdocs/e-ration-system

Import Database

e_ration_system.sql

Configure

config/db.php

Start Apache & MySQL using XAMPP.

---

🔑 Demo Credentials

Admin

Username : admin
Password : admin123

Shopkeeper

Username : shop
Password : shop123

Citizen

Name : Ramesh Kumar
Card : RC100001
Aadhaar : 123456789012
Mobile : 9876543210

---

🎯 Key Functionalities

• Role-based Authentication
• Password Hashing (bcrypt)
• Session Management
• OTP Verification
• QR Code Generation
• Location-based Shop Finder
• Stock Management
• Request Tracking
• Token Verification
• Responsive UI

---

🔒 Security Features

• Password Hashing
• PHP Sessions
• SQL Injection Prevention
• Authentication Checks
• Role-based Access
• OTP Validation

---

🔮 Future Enhancements

• SMS Gateway Integration
• Email Notifications
• Aadhaar API Integration
• Online Payments
• Real-time Stock Monitoring
• Government Portal Integration
• Analytics Dashboard

---

📚 Learning Outcomes

This project helped in understanding:

• PHP Backend Development
• MySQL Database Design
• Session Management
• Authentication Systems
• CRUD Operations
• REST-style Workflows
• QR Code Generation
• Maps Integration
• Deployment on InfinityFree

---

👨‍💻 Author

Pulipati Rahul

Full Stack Developer

GitHub: https://github.com/Pulipati-Rahul

LinkedIn: https://www.linkedin.com/in/pulipatirahul

Portfolio: https://pulipatirahul.vercel.app

---

⭐ Support

If you found this project helpful, consider giving it a ⭐ on GitHub.

It motivates me to continue building high-quality projects.