Tamper-proof academic credential platform for Ethiopian universities. Issue & verify blockchain-anchored certificates instantly. Built with React, TypeScript, Supabase, and Solidity (Hardhat).
# EduChain Ethiopia
A digital credential verification platform that combats fake academic credentials by providing a trusted, tamper-proof system for universities, employers, and students across Ethiopia.
---
## Table of Contents
- Overview
- Architecture
- Features
- Tech Stack
- Getting Started
- Project Structure
- Configuration
- Authentication & Authorization
- API & Database
- Deployment
- Contributing
- License
---
## Overview
Academic credential fraud is a growing challenge in Ethiopia. EduChain Ethiopia provides a secure, verifiable, and student-friendly platform where:
- **Universities** issue digitally signed certificates with unique IDs and QR codes.
- **Employers & Institutions** verify credentials in real time — no paperwork, no delays.
- **Students** access a personal dashboard to view, share, and manage their academic records.
The platform supports bulk issuance via CSV/Excel, certificate revocation and expiry management, email notifications, detailed analytics, and customizable university branding.
---
## Architecture
```
┌──────────────────────────────────────────────────┐
│ Client (React) │
│ ┌──────────┐ ┌──────────┐ ┌────────────────┐ │
│ │ Auth UI │ │ Admin │ │ Public │ │
│ │ │ │ Dashboard│ │ Verification │ │
│ └──────────┘ └──────────┘ └────────────────┘ │
│ ┌──────────┐ ┌──────────┐ ┌────────────────┐ │
│ │ Issue │ │ Bulk │ │ Student Portal │ │
│ │ Certificate│ │ Issue │ │ │ │
│ └──────────┘ └──────────┘ └────────────────┘ │
└──────────────────┬───────────────────────────────┘
│
▼
┌──────────────────────────────────────────────────┐
│ Supabase (Backend) │
│ ┌──────────────┐ ┌────────────────────────────┐│
│ │ PostgreSQL │ │ Row Level Security ││
│ │ + RPCs │ │ (RLS) ││
│ └──────────────┘ └────────────────────────────┘│
│ ┌──────────────┐ ┌── …