EduChain Retro

AI + Blockchain powered academic trust platform for assignments, marks, attendance, skills, and transparent verification.

EduChain Retro helps institutions move from trust-by-assumption to trust-by-proof. It combines role-based portals, multi-model integrity analysis, IPFS-backed document trails, and blockchain anchoring for tamper-evident academic workflows.

Project Description

EduChain Retro is a full-stack academic operations platform designed to improve trust, transparency, and traceability across the student lifecycle.

• For teachers, it streamlines assignment integrity checks, attendance capture, marks publishing, and alerts.
• For students, it provides transparent access to marks, attendance, integrity outcomes, and skill growth paths.
• For institutions, it introduces verifiable records using IPFS artifacts and optional blockchain anchoring for audit-readiness.

Working Video

16-03-34.1.mp4

Highlights

• Assignment integrity scoring using OpenAI and Gemini models
• IPFS evidence publishing through Pinata
• Blockchain verification flow for academic records
• Teacher and student role-specific dashboards
• Attendance tracking with QR-based capture flow
• Skills testing and recommendation-ready profile updates
• Notification pipeline for actionable academic events
• MongoDB-backed storage with fallback persistence support

Architecture Overview

flowchart LR
	U[Teacher or Student] --> FE[React + Vite Frontend]
	FE --> API[Express API Server]
	API --> MDB[(MongoDB)]
	API --> AI1[OpenAI Integrity Model]
	API --> AI2[Gemini Integrity Model]
	API --> PIN[Pinata IPFS]
	API --> BC[Sepolia Smart Contract]
	BC --> CH[(Blockchain Ledger)]
	PIN --> IPFS[(IPFS Content)]

Loading

Integrity Pipeline

flowchart TD
	A[Teacher uploads assignment] --> B[Store metadata in MongoDB]
	B --> C[Send content to integrity service]
	C --> D[OpenAI score]
	C --> E[Gemini score]
	D --> F[Normalize and combine results]
	E --> F
	F --> G[Generate integrity report]
	G --> H[Pin report to IPFS]
	H --> I[Persist CID + score]
	I --> J[Optional blockchain anchor]
	J --> K[Immutable verification trail]

Loading

Product Flow

flowchart LR
	L[Login Gateway] --> T[Teacher Workspace]
	L --> S[Student Workspace]

	T --> T1[Publish marks]
	T --> T2[Record attendance]
	T --> T3[Upload assignment]
	T --> T4[Track notifications]

	S --> S1[View marks]
	S --> S2[Scan attendance QR]
	S --> S3[Submit and view integrity status]
	S --> S4[Take skill tests]

	T1 --> V[Verification + audit visibility]
	T2 --> V
	T3 --> V
	S1 --> V
	S2 --> V
	S3 --> V
	S4 --> V

Loading

Tech Tools Used

• Frontend: React, TypeScript, Vite, Tailwind CSS, Radix UI, shadcn-style components
• Backend: Node.js, Express, TypeScript
• Database: MongoDB, Mongoose
• AI Services: OpenAI API, Google Gemini API
• Storage and Content Addressing: Pinata, IPFS
• Blockchain and Web3: Solidity, Sepolia Ethereum testnet, Alchemy RPC
• Tooling: npm, Drizzle config tooling, PostCSS, ESLint/TypeScript checks

Quick Start

1. Clone and enter project root

git clone https://github.com/Aditya-alchemist/EduChain.git
cd EduChain-Retro/EduChain-Retro

2. Install dependencies

npm install

3. Configure environment

Create .env in project root. Core variables:

MONGODB_URI=your_mongodb_connection_string
OPENAI_API_KEY=your_openai_key
GEMINI_API_KEY=your_gemini_key
OPENAI_INTEGRITY_MODEL=gpt-4o-mini
GEMINI_INTEGRITY_MODEL=gemini-1.5-flash
PINATA_API_KEY=your_pinata_key
PINATA_API_SECRET=your_pinata_secret
RPC_URL=your_sepolia_rpc_url
PRIVATE_KEY=your_wallet_private_key
CONTRACT_ADDRESS=your_deployed_contract
CONTRACT_ABI_PATH=contracts/EduChain.abi.json

4. Run the app

npm run dev

5. Optional checks

npm run check

Repo Structure

client/      React frontend app
server/      Express APIs and services
contracts/   Solidity contract and ABI
shared/      Shared types/routes/schema
script/      Build and utility scripts

Security Note

• Never commit real .env secrets (API keys, JWTs, private keys) to public repositories.
• Rotate keys immediately if they were ever exposed in Git history.

Roadmap

• Verifiable transcript and certificate issuance
• Institutional multi-tenant onboarding
• Advanced analytics and intervention automation
• Broader LMS and SIS integrations

Why EduChain Retro

It provides a practical trust layer for education operations where outcomes need to be explainable, auditable, and verifiable without slowing down day-to-day academic workflows.