Skip to content

indresh404/CampusChain

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 

Repository files navigation

🚀 CampusChain

Fintech-Style Campus Digital Economy (Web Prototype + Full System Vision)

🌐 Live Demo: https://campus-chain-eta.vercel.app


🧠 Overview

CampusChain is a blockchain-powered campus financial ecosystem (concept + prototype) designed to replace cash and fragmented payment systems within a university.

It introduces a closed-loop digital economy where a university-issued token becomes the only medium of exchange for:

  • 🍔 Canteen payments
  • 📚 Library borrowing
  • 🎟️ Event registrations
  • 🎓 Fees & services
  • 💸 Peer-to-peer transfers

All transactions are designed to be secure, transparent, and tamper-proof using blockchain principles.

⚠️ Current Status: This repository contains a frontend web prototype (UI simulation with mock data). Backend, blockchain, and mobile systems are part of the planned architecture.


🎯 Key Idea

  • Students receive fixed tokens each semester
  • Tokens cannot be bought or converted to money
  • Spending must be managed strategically
  • Rewards are earned via merit & participation
  • System ensures fairness, transparency, and accountability

✨ What This Project Demonstrates

  • 🎨 Advanced fintech-level UI/UX design
  • 📊 Interactive data dashboards & analytics
  • 📷 QR-based payment flow simulation
  • 💸 Peer-to-peer transfer experience
  • 🏆 Reward & incentive system visualization
  • ⚡ Smooth animations & micro-interactions

⚙️ Core Features (Concept + UI Prototype)

💰 Token Economy

  • Fixed semester allocation
  • Closed-loop system (no real money)
  • Spending analytics

📱 QR-Based Payments

  • Dynamic QR payment simulation
  • One-tap confirmation flow
  • Error-free transaction UX

🏫 Multi-Role System

  • Super Admin (system control)
  • Category-based Admins
  • Students (end users)

📚 Smart Library System

  • Borrow tracking
  • Automatic fine calculation (simulated)

🎟️ Event Management

  • QR-based ticketing
  • Seat tracking system

🔁 Peer Transfers

  • Student-to-student token transfer
  • Daily limits & fraud prevention (concept)

🏆 Reward System

  • Tokens for academics, sports, events
  • Merit-based incentives

📊 Analytics Dashboard

  • Spending trends
  • Category breakdown
  • Transaction insights

🧱 Tech Stack & Implementation Status

✅ Currently Implemented (Prototype)

Frontend (Student Web App)

  • Next.js / React
  • TailwindCSS
  • Framer Motion
  • Recharts
  • Lottie React
  • React CountUp
  • Lucide React

Data Layer

  • Mock Data (static JSON)

🚧 Planned Full System (Architecture)

📱 Mobile Apps

  • React Native (Expo)
  • QR Scanner (Expo Camera)
  • Wallet Integration

🖥️ Admin Web Panel

  • React.js + Vite
  • Recharts (analytics dashboard)

⚙️ Backend

  • Node.js + Express.js
  • MongoDB Atlas
  • JWT Authentication
  • Socket.io (real-time updates)

🔗 Blockchain Layer

  • Ethereum (Sepolia / Mainnet)
  • Solidity Smart Contracts
  • Hardhat
  • Ethers.js

Smart Contracts (Planned):

  • CampusToken.sol
  • PaymentGateway.sol
  • LibraryContract.sol
  • RewardEngine.sol

🧭 Implementation Status

Module Status
Student Web App ✅ Completed (Prototype)
UI/UX System ✅ Completed
QR Flow Simulation ✅ Completed
Analytics Dashboard ✅ Completed
Backend 🚧 Planned
Blockchain 🚧 Planned
Mobile App 🚧 Planned

🏗️ System Architecture (Concept)

Student App ↔ Backend ↔ Blockchain
        ↘ MongoDB (off-chain data)

Admin App ↔ Backend ↔ Smart Contracts

Super Admin Web ↔ Backend ↔ Analytics

📁 Project Structure

campuschain/
│
├── frontend-web/          ← Student Prototype (current)
│
├── backend/               ← Planned
├── blockchain/            ← Planned
├── mobile/                ← Planned
│
└── README.md

🚀 Getting Started (Prototype)

git clone https://github.com/your-username/campuschain.git
cd campuschain
npm install
npm run dev

📸 Screenshots (Add These)

  • Dashboard (analytics)
  • QR payment flow
  • Transfer screen
  • Profile page

🔥 Why CampusChain?

  • ✅ Real-world campus problem solving
  • ✅ Strong product + system design thinking
  • ✅ Fintech-level UI/UX execution
  • ✅ Scalable architecture vision
  • ✅ Hackathon-ready concept

📌 Future Scope

  • Blockchain integration (Ethereum)
  • Smart contract deployment
  • Backend APIs
  • Wallet authentication
  • Admin dashboard
  • Mobile application
  • NFC payments

⭐ Support

If you like this project:

  • ⭐ Star the repo
  • 🍴 Fork it
  • 💡 Share feedback

About

Fintech-style web prototype of CampusChain — a blockchain-inspired campus token ecosystem where students use digital coins for payments, rewards, and peer transfers through a seamless QR-based experience.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • TypeScript 92.5%
  • CSS 6.2%
  • JavaScript 1.3%