Skip to content

README.md

Latest commit

 

History

History
221 lines (165 loc) · 6.59 KB

README.md

File metadata and controls

221 lines (165 loc) · 6.59 KB

💊 PharmaSentinel

Blockchain-Based Pharmaceutical Supply Chain Management System

Python Django React PostgreSQL JWT Bootstrap

📌 About The Project

PharmaSentinel is a secure, blockchain-based web application designed to detect and prevent counterfeit medicines in the pharmaceutical supply chain.

Fake and substandard medicines pose a serious global health risk. Traditional supply chain systems rely on centralized databases that can be easily manipulated. PharmaSentinel solves this by assigning each medicine batch its own private blockchain, where every transaction is permanently recorded using SHA-256 hashing and HMAC digital signatures — making all data tamper-proof and fully traceable.

✨ Key Features

  • 🔐 JWT-Based Role Authentication — Secure login for 6 roles: Manufacturer, Distributor, Wholesaler, Shopkeeper, Consumer, and Regulatory Authority
  • ⛓️ Custom Private Blockchain — Each medicine batch has its own blockchain with hash chaining and digital signatures
  • 📦 End-to-End Medicine Tracking — Full lifecycle traceability from manufacturer to consumer
  • 🔍 Counterfeit Detection — Automatic blockchain validation to detect tampering and duplicate transactions
  • 📱 QR Code / Batch ID Verification — Consumers can verify medicine authenticity without login
  • 🏛️ Regulatory Admin Dashboard — Central control panel for monitoring supply chain compliance
  • 📊 Logging & Monitoring — System activity tracking using Python's logging module

🛠️ Tech Stack

Layer Technology
Backend Python, Django, Django REST Framework
Frontend React JS, Bootstrap
Database PostgreSQL
Authentication JWT (JSON Web Tokens)
Blockchain Custom Private Blockchain Implementation
Cryptography SHA-256 Hashing, HMAC Digital Signatures
Monitoring Python Logging Module

🏗️ System Architecture

Consumer / Stakeholder
        ↓
   React JS Frontend
        ↓
Django REST Framework (APIs)
        ↓
   JWT Authentication
        ↓
  Business Logic Layer
     ↙          ↘
PostgreSQL    Custom Blockchain
(User/Batch    (Transaction
   Data)         Records)

👥 User Roles

Role Permissions
Regulatory Authority Full system access, user management, compliance monitoring
Manufacturer Create medicine batches, initiate blockchain
Distributor Receive and transfer medicine batches
Wholesaler Receive and forward medicine batches
Shopkeeper Receive medicines, mark as sold
Consumer Verify medicine authenticity via Batch ID or QR Code

⛓️ How The Blockchain Works

Each medicine batch gets its own blockchain where every transaction is stored as a block:

Block Structure:
{
  "block_index"     : 1,
  "timestamp"       : "2025-01-01 10:00:00",
  "transaction_data": { batch_id, action, actor, location },
  "previous_hash"   : "abc123...",
  "hash"            : "def456...",
  "digital_signature": "hmac_signature"
}
  • SHA-256 generates a unique hash for every block
  • HMAC digital signatures verify data integrity
  • Any tampering breaks the hash chain and is immediately detected

🚀 Getting Started

Prerequisites

  • Python 3.8+
  • Node.js & npm
  • PostgreSQL

Installation

1. Clone the repository

git clone https://github.com/Fizza-Mukhtar/PharmaSentinel.git
cd PharmaSentinel

2. Backend Setup

cd backend
pip install -r requirements.txt

3. Configure Database

Create a .env file in the backend folder:

DATABASE_NAME=pharmasentinel
DATABASE_USER=your_db_user
DATABASE_PASSWORD=your_db_password
DATABASE_HOST=localhost
DATABASE_PORT=5432
SECRET_KEY=your_django_secret_key

4. Run Migrations

python manage.py makemigrations
python manage.py migrate

5. Start Backend Server

python manage.py runserver

6. Frontend Setup

cd frontend
npm install
npm start

The app will be running at http://localhost:3000

📁 Project Structure

PharmaSentinel/
├── backend/
│   ├── authentication/       # JWT auth & user roles
│   ├── blockchain/           # Custom blockchain logic
│   ├── medicines/            # Medicine batch management
│   ├── supply_chain/         # Transfer & tracking APIs
│   ├── dashboard/            # Regulatory admin panel
│   └── manage.py
├── frontend/
│   ├── src/
│   │   ├── components/       # React components
│   │   ├── pages/            # Role-based pages
│   │   └── App.js
│   └── package.json
└── README.md

🔒 Security Features

  • All passwords are hashed using Django's built-in security
  • JWT tokens expire automatically for session safety
  • Blockchain hash chaining detects any data tampering
  • HMAC signatures verify block integrity
  • Role-based access ensures users can only perform authorized actions

📸 Screenshots

1 5 drap

🎯 Future Enhancements

  • Integration with public blockchain (Ethereum)
  • AI-based anomaly detection in supply chain
  • SMS/Email alerts for suspicious activity
  • Multi-language support

👩‍💻 Author

Fizza Mukhtar
LinkedIn GitHub

📄 License

This project is for academic purposes.

"Ensuring every medicine that reaches a patient is genuine — because health cannot be compromised."