Skip to content

TraceSafe is a lightweight, end-to-end supply chain transparency platform built for the GLYTCH Hackathon. It brings trust and traceability to agriculture using Hyperledger Fabric, enabling farmers, retailers, regulators, and consumers to verify every step of a batch’s journey.

Notifications You must be signed in to change notification settings

SreeAditya-Dev/TraceSafe

Repository files navigation

TraceSafe 🛡️

Blockchain-Enabled Supply Chain Transparency Platform

TraceSafe is a next-generation supply chain management system designed to bring transparency, trust, and efficiency to the agricultural journey from farm to fork. Built for the GLYTCH hackathon.

🌟 Key Features

🔗 Blockchain Integration (Hyperledger Fabric)

  • Immutable Ledger: All critical events (harvest, pickup, transit, delivery) are recorded on a private, permissioned blockchain.
  • Smart Contracts: Business logic for batch lifecycle and certification is enforced by chaincode.
  • Multi-Org Architecture: Simulates a real-world consortium with Farmer, Driver, Retailer, and Regulator organizations.

🏅 Smart Certification

  • Blockchain-Backed Certificates: Admins can issue immutable certificates for batches that meet quality standards.
  • Tamper-Proof: Certificates are stored on the ledger and cannot be forged.
  • Customer Verification: End consumers can scan a QR code to see the "TraceSafe Certified" badge and verify authenticity.

🛡️ Integrity Verification

  • Automated Auditing: The "Integrity Verification" feature instantly cross-checks the local database against the blockchain ledger.
  • Tamper Detection: Detects any discrepancies in status or certification data.
  • Self-Healing: Automatically syncs the local state if the blockchain is ahead (e.g., if a batch was certified but the DB update failed).

🚜 Farmer-Centric Design

  • AgriStack Integration: Seamless login for farmers using their government AgriStack IDs.
  • FSSAI Compliance: Tracks and displays FSSAI license numbers for regulatory compliance.
  • Profile Management: Farmers can manage their profiles, crops, and land details.

📦 Complete Journey Tracking

  • Visual Timeline: Full history of the batch from harvest to sale.
  • IoT Data: Tracks temperature and humidity during transit (simulated).
  • Media Evidence: Stores images of the produce at every stage.

🛠️ Tech Stack

  • Frontend: React, TypeScript, Tailwind CSS, Lucide Icons
  • Backend: Node.js, Express, PostgreSQL
  • Blockchain: Hyperledger Fabric v2.5
  • Storage: MinIO (S3-compatible object storage for images)
  • Containerization: Docker & Docker Compose

🚀 Getting Started

Prerequisites

  • Docker & Docker Compose
  • Node.js (v18+)

Installation

  1. Start the Infrastructure:
    docker-compose up -d
  2. Install Dependencies:
    npm install
    cd backend && npm install
  3. Run the Application:
    # Terminal 1: Backend
    cd backend && npm run dev
    
    # Terminal 2: Frontend
    npm run dev

👥 User Roles

  • Admin: admin@tracesafe.com (Regulator/System Admin)
  • Farmer: Login via AgriStack ID
  • Retailer: retailer@tracesafe.com
  • Driver: driver@tracesafe.com

Screen

Landing & Authentication

TraceSafe Login

🔗 Blockchain Integration (Hyperledger Fabric)

Admin Dashboard – Batches

🏅 Smart Certification

Batch Certification

🛡️ Integrity Verification

Integrity Verification

🚜 Farmer-Centric Design

Farmer Dashboard

📦 Batch Creation & Evidence Capture

Create Batch

🧭 Complete Journey Tracking

Journey Timeline

🏆 Hackathon Recognition

GLYTCH Certificate

About

TraceSafe is a lightweight, end-to-end supply chain transparency platform built for the GLYTCH Hackathon. It brings trust and traceability to agriculture using Hyperledger Fabric, enabling farmers, retailers, regulators, and consumers to verify every step of a batch’s journey.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published