Secure admin-controlled evidence management system with role-based access control.
Completion Date: December 2025 | Status: 🟢 Production Ready
- ✅ 8-Role RBAC System
- Super Admin, Admin, Investigator, Forensic Analyst
- Lawyer, Judge, Court Official, Auditor
- Granular permissions per role
- ✅ Dual Authentication
- MetaMask wallet integration (Web3)
- Email/Password authentication
- 2FA support
- Session management
- ✅ Admin Dashboard
- User registration approval workflow
- Role assignment & modification
- Activity monitoring
- System health metrics
- ✅ User Management
- Profile management
- Department/jurisdiction assignment
- Status tracking (active/inactive)
- ✅ Upload System
- Multi-file upload support
- File type validation
- Size limit enforcement (100MB)
- Metadata capture
- ✅ Download System
- Access control enforcement
- Download history tracking
- Watermarking capability
- Audit trail logging
- ✅ Database Security
- Row Level Security (RLS) in Supabase
- Encrypted data at rest
- Secure API endpoints
- SQL injection protection
- ✅ Real-time Notifications
- WebSocket implementation
- Role-based notification routing
- Activity alerts
- System status updates
- ✅ Complete API documentation
- ✅ User guides for all 8 roles
- ✅ Deployment instructions
- ✅ Security best practices
Completion Date: January 2026 | Status: 🟢 Production Ready
- ✅ Polygon Network Integration
- Smart contract deployment
- Evidence hash anchoring
- Transaction verification
- Gas optimization
- ✅ Immutable Records
- SHA-256 hash generation
- On-chain proof storage
- Timestamp verification
- Tamper-proof audit trail
- ✅ Blockchain Explorer
- Transaction lookup
- Block verification
- Real-time sync status
- ✅ Distributed File Storage
- IPFS pinning service
- Content-addressable storage
- CID generation & tracking
- Redundancy management
- ✅ Retrieval System
- Fast gateway access
- Fallback mechanisms
- Cache optimization
- Availability monitoring
- ✅ Cryptographic Verification
- Digital signatures (ECDSA)
- Hash integrity checks
- Replay attack prevention
- Nonce-based authentication
- ✅ Zero-Trust Architecture
- End-to-end encryption
- API key rotation
- Rate limiting
- DDoS protection
- ✅ Health Dashboard
- Blockchain sync status
- IPFS node health
- API response times
- Error rate tracking
- ✅ Alerting System
- Failure notifications
- Performance degradation alerts
- Security incident detection
- Automated recovery
- ✅ Database Optimization
- Query indexing
- Connection pooling
- Caching layer (Redis)
- ✅ API Optimization
- Response compression
- Pagination implementation
- Async processing
- Load balancing
Start Date: February 2026 | Expected Completion: July 2026 | Status: 🟡 Active Development
Status: 🔄 In Development | Priority: 🔴 HIGH | ETA: April 2026
- Deepfake Detection
- ⏳ Face swap identification (TensorFlow model)
- ⏳ Audio morphing detection
- ⏳ Expression synthesis analysis
- ⏳ Voice cloning detection
- GAN Artifact Analysis
- ⏳ Synthetic image identification
- ⏳ AI-generated content detection
- ⏳ Neural network fingerprinting
- ⏳ Style transfer detection
- Audio Forensics
- ⏳ Spectrogram analysis
- ⏳ Voice authenticity verification
- ⏳ Background noise analysis
- ⏳ Audio splicing detection
- ML Framework: TensorFlow 2.15, PyTorch
- Models: FaceForensics++, Wav2Lip, MesoNet
- Processing: NVIDIA CUDA, GPU acceleration
Status: 🔄 In Development | Priority: 🔴 HIGH | ETA: April 2026
- EXIF Data Extraction
- ⏳ GPS coordinates & location history
- ⏳ Device ID & camera model
- ⏳ Firmware version tracking
- ⏳ Capture timestamp analysis
- ⏳ Software modification history
- Forensic Validation
- ⏳ Camera fingerprinting (PRNU - Photo Response Non-Uniformity)
- ⏳ Metadata consistency checks
- ⏳ Timestamp anomaly detection
- ⏳ Digital signature verification
- ⏳ Thumbnail-image mismatch detection
- Tools: ExifTool, Pillow, libexif
- Storage: PostgreSQL JSONB fields
- Processing: Python multiprocessing
Status: 🔄 In Development | Priority: 🟡 MEDIUM | ETA: May 2026
- Continuous Monitoring
- ⏳ Real-time hash verification (every 6 hours)
- ⏳ Blockchain sync checking
- ⏳ IPFS availability monitoring
- ⏳ Automated integrity audits
- ⏳ Chain of custody validation
- Alert System
- ⏳ Hash mismatch notifications
- ⏳ Tampering detection alerts
- ⏳ Chain of custody breaks
- ⏳ System health warnings
- ⏳ Email/SMS/Push notifications
- Queue: Celery + Redis
- Scheduler: Celery Beat
- Notifications: SendGrid, Twilio, Firebase
- WebSockets: Socket.io
Status: 📝 Planning | Priority: 🟡 MEDIUM | ETA: June 2026
- Forensic Soundness Scoring (0-100)
- ⏳ Evidence integrity score
- ⏳ Chain of custody completeness
- ⏳ Metadata richness rating
- ⏳ Technical quality metrics
- ⏳ Blockchain verification confidence
- Admissibility Prediction
- ⏳ Legal standard compliance (%)
- ⏳ Risk assessment (Low/Medium/High)
- ⏳ Strength indicators
- ⏳ Expert recommendations
- ⏳ Court acceptance probability
Component Weight Current Status Blockchain Verification 25% ⏳ In Design Metadata Completeness 20% ⏳ In Design Chain of Custody 20% ⏳ In Design Technical Quality 15% ⏳ In Design Timestamp Consistency 10% ⏳ In Design Audit Trail 10% ⏳ In Design
Status: 📝 Planning | Priority: 🟡 MEDIUM | ETA: June 2026
- Standards Compliance
- Daubert Standard Checker > - ⏳ Scientific validity assessment > - ⏳ Peer review verification > - ⏳ Error rate analysis > - ⏳ General acceptance testing
- Federal Rules of Evidence (FRE) > - ⏳ Rule 702 (Expert Testimony) compliance > - ⏳ Rule 901 (Authentication) verification > - ⏳ Rule 1001 (Best Evidence Rule) check
- ⏳ Rule 403 (Probative vs Prejudicial) analysis
- Legal Review Dashboard
- ⏳ Compliance checklist automation
- ⏳ Missing evidence alerts
- ⏳ Legal requirement tracking
- ⏳ Admissibility probability calculator
- ⏳ Case precedent search
- 🇺🇸 US: Federal Rules of Evidence, Daubert, Frye
- 🇮🇳 India: Evidence Act 1872 (Sections 65A, 65B)
- 🇪🇺 EU: GDPR compliance checks
Status: 📝 Planning | Priority: 🟢 LOW | ETA: July 2026
- Judicial Management
- ⏳ Court order recording & tracking
- ⏳ Evidence admission/exclusion decisions
- ⏳ Ruling documentation
- ⏳ Case timeline management
- ⏳ Seal/unseal evidence workflow
- Court Official Dashboard
- ⏳ Judge interface for evidence review
- ⏳ Hearing schedule integration
- ⏳ Digital courtroom display mode
- ⏳ Verdict recording system
- ⏳ Appeal tracking
Current Status: ✅ Core Complete | 🔄 Phase 3 Enhancements In Progress
Current Status: ✅ Core Complete | 🔄 Phase 3 Enhancements In Progress
- Evidence verification & blockchain proof retrieval
- Metadata analysis & extraction
- Audit trail access
- Comparison reports
- Expert opinion documentation
Feature Status Priority ETA AI-powered deepfake analysis tools 🔄 In Development 🔴 HIGH April 2026 EXIF forensic dashboard 🔄 In Development 🔴 HIGH April 2026 Automated soundness scoring ⏳ Planned 🟡 MEDIUM May 2026 Advanced comparison reports ⏳ Planned 🟡 MEDIUM May 2026 PRNU camera fingerprinting 🔄 In Development 🔴 HIGH April 2026 Batch analysis workflow ⏳ Planned 🟢 LOW June 2026 ML model training interface ⏳ Planned 🟢 LOW July 2026
Digital evidence management often faces challenges like data tampering, lack of a verifiable chain of custody, and inconsistent access control. Traditional systems can be opaque, making it difficult for judicial and investigative bodies to trust the integrity of digital artifacts.
EVID-DGC addresses these issues by leveraging blockchain-inspired principles and robust role-based access control. By utilizing a secure Supabase backend and providing immutable audit logs, the system ensures that every action—from evidence upload to court review—is tracked and verifiable, maintaining the highest standards of digital forensic integrity.
- ✅ 8-Role RBAC - Complete role-based access control
- ✅ Dual Authentication - MetaMask wallet + Email/Password
- ✅ Admin Dashboard - Full user management interface
- ✅ Evidence Upload - Multi-format file support (PDF, images, videos, audio)
- ✅ Database Security - Supabase PostgreSQL with Row Level Security
- ✅ Real-time Notifications - Socket.IO WebSocket integration
- ✅ Audit Logging - Complete activity tracking
- ✅ File Processing - Watermarking and compression
- ✅ Case Management - Full case lifecycle with status tracking
- ✅ Export System - Evidence download with watermarks
- ✅ TRUE BLOCKCHAIN INTEGRATION - Complete blockchain integration
- Smart Contract deployed to Polygon Amoy:
0x39453ED8CF79Fe56150fe1E8348e75894e3dD9e3 - Real on-chain transactions with TX hash recording
- Gas usage tracking and optimization
- Block number recording
- Explorer links (Polygonscan)
- Hash verification against blockchain
- Smart Contract deployed to Polygon Amoy:
- ✅ IPFS DECENTRALIZED STORAGE - Fully operational IPFS integration
- Pinata API integration
- Content Identifier (CID) generation
- Decentralized file storage and retrieval
- Gateway URLs for file access
- Pin management system
- ✅ ADVANCED SECURITY - Multi-layer security implementation
- Rate limiting (Blockchain: 10/min, Upload: 50/hr, Verification: 30/min)
- Transaction validation
- CID validation
- File validation
- Enhanced API protection
- ✅ SYSTEM MONITORING - Real-time monitoring and alerting
- Real-time health checks
- Blockchain metrics dashboard
- IPFS statistics tracking
- Automated alerts system
- Performance tracking
- ✅ PERFORMANCE OPTIMIZATION - Production-ready optimization
- Database indexing for blockchain data
- Efficient query patterns
- Rate-limited operations
- Connection pooling
| Category | Technologies | Status |
|---|---|---|
| Frontend | HTML5, CSS3, Vanilla JavaScript, Socket.IO Client | ✅ Working |
| Backend | Node.js v16+, Express.js, Socket.IO (Real-time) | ✅ Working |
| Database | Supabase (PostgreSQL with Row Level Security) | ✅ Working |
| Authentication | MetaMask/Web3, Email/Password | ✅ Working |
| File Processing | Multer, Sharp, PDF-Lib | ✅ Working |
| Icons & UI | Lucide Icons, Custom CSS | ✅ Working |
| Hosting | Render, Vercel, Netlify Compatible | ✅ Working |
| Smart Contracts | Solidity (Deployed on Polygon Amoy) | ✅ Phase 2 |
| Storage | IPFS via Pinata API | ✅ Phase 2 |
| Blockchain | Polygon Amoy Testnet (Production Ready) | ✅ Phase 2 |
The system implements 8 distinct roles to ensure strict access control:
- Public Viewer: Browse public case information.
- Investigator: Handle case creation and evidence uploads.
- Forensic Analyst: Perform technical analysis and generate reports.
- Legal Professional: Conduct legal reviews of cases and evidence.
- Court Official: Manage judicial proceedings and scheduling.
- Evidence Manager: Maintain the chain of custody and storage integrity.
- Auditor: Oversee system compliance and review audit logs.
- Administrator: Full system oversight, user management, and configuration.
blockchain-evidence/
├── contracts/ # Smart contract files
│ └── EvidenceStorage.sol # Main evidence storage contract
├── docs/ # Complete documentation
│ ├── USER_GUIDE.md # User manual for all roles
│ ├── DEVELOPER_GUIDE.md # Development setup and workflow
│ ├── SECURITY.md # Security practices and policies
│ ├── DEPLOYMENT.md # Production deployment guide
│ ├── MAINTENANCE.md # System maintenance procedures
│ └── swagger.js # API documentation (OpenAPI)
├── public/ # Frontend application (80+ files)
│ │
│ ├── 🏠 Core Landing & Pages
│ │ ├── index.html # Main landing page with login options
│ │ ├── app.js # Core frontend application logic
│ │ ├── config.js # Global configuration settings
│ │ ├── styles.css # Global stylesheet
│ │ ├── quickstart.html # Quick start guide page
│ │ ├── privacy.html # Privacy policy page
│ │ ├── favicon.ico # Site favicon
│ │ └── logo-32x32.png # Application logo
│ │
│ ├── 🔐 Authentication & Security (15 files)
│ │ ├── forgot-password.js # Password reset functionality
│ │ ├── reset-password.html # Password reset page
│ │ ├── password-security.css # Password security styling
│ │ ├── password-security.js # Password policy enforcement
│ │ ├── password-strength.js # Password strength validator
│ │ ├── password-policy-admin.js # Admin password policy config
│ │ ├── two-factor-auth.css # 2FA styling
│ │ ├── two-factor-auth.js # Two-factor authentication logic
│ │ ├── two-factor-integration.js # 2FA system integration
│ │ ├── session-manager.js # User session management
│ │ ├── session-timeout.css # Session timeout styling
│ │ ├── session-timeout.js # Auto-logout functionality
│ │ ├── session-timeout-admin.js # Admin session timeout config
│ │ ├── comprehensive-registration.js # Enhanced registration system
│ │ └── storage.js # Local storage utilities
│ │
│ ├── 👤 Account & User Management (5 files)
│ │ ├── account-settings.html # User account settings page
│ │ ├── account-settings.js # Account settings logic
│ │ ├── account-settings-styles.css # Account settings styling
│ │ ├── profile.html # User profile page
│ │ └── user-roles.html # User role information page
│ │
│ ├── 📊 Dashboards - Role Based (9 files)
│ │ ├── dashboard.html # Main dashboard (role redirect)
│ │ ├── dashboard-navigator.js # Dashboard navigation logic
│ │ ├── dashboard-public.html # Public viewer dashboard
│ │ ├── dashboard-investigator.html # Investigator dashboard
│ │ ├── dashboard-analyst.html # Forensic analyst dashboard
│ │ ├── dashboard-legal.html # Legal professional dashboard
│ │ ├── dashboard-court.html # Court official dashboard
│ │ ├── dashboard-manager.html # Evidence manager dashboard
│ │ ├── dashboard-auditor.html # Auditor dashboard
│ │ └── admin.html # Administrator dashboard
│ │
│ ├── 🗂️ Case Management (7 files)
│ │ ├── case-management.html # Case creation and management
│ │ ├── cases.html # Case listing and search
│ │ ├── case-status-manager.js # Case status workflow
│ │ ├── case-status-styles.css # Case status styling
│ │ ├── case-timeline.html # Case timeline visualization
│ │ ├── case-hash-manifest.js # Case hash tracking
│ │ └── case-summary-exporter.js # Case summary export
│ │
│ ├── 📁 Evidence Management (16 files)
│ │ ├── evidence-manager.html # Main evidence management
│ │ ├── enhanced-evidence-upload.js # Advanced upload features
│ │ ├── enhanced-upload-styles.css # Upload UI styling
│ │ ├── evidence-display.css # Evidence display styling
│ │ ├── evidence-display.js # Evidence display logic
│ │ ├── evidence-preview.css # Preview modal styling
│ │ ├── evidence-preview.js # Evidence preview system
│ │ ├── evidence-preview-styles.css # Additional preview styles
│ │ ├── evidence-preview-system.js # Preview system core
│ │ ├── evidence-viewers.js # Multi-format file viewers
│ │ ├── evidence-comparison.css # Comparison view styling
│ │ ├── evidence-comparison.html # Evidence comparison tool
│ │ ├── evidence-comparison.js # Comparison logic
│ │ ├── evidence-export.html # Evidence export page
│ │ ├── evidence-exporter.js # Export functionality
│ │ ├── evidence-tagging.html # Evidence tagging system
│ │ ├── evidence-tagging.js # Tag management logic
│ │ ├── evidence-verification.html # Evidence verification page
│ │ ├── evidence-verification.js # Blockchain verification
│ │ └── tag-manager.js # Tag CRUD operations
│ │
│ ├── 📜 Policy & Compliance (8 files)
│ │ ├── retention-policy.html # Retention policy management
│ │ ├── retention-policy.js # Retention policy logic
│ │ ├── retention-policy-manager.js # Policy enforcement
│ │ ├── retention-policy-styles.css # Retention policy styling
│ │ ├── legal-hold-management.html # Legal hold system
│ │ ├── data-protection.html # Data protection policies
│ │ ├── audit-trail.html # System audit trail viewer
│ │ └── activity-feed-widget.js # Activity feed component
│ │
│ ├── 👥 Role Management (7 files)
│ │ ├── role-manager.js # Role assignment logic
│ │ ├── role-wizard.js # Role selection wizard
│ │ ├── role-wizard-styles.css # Role wizard styling
│ │ ├── role-selection-wizard.js # Role onboarding wizard
│ │ ├── role-landing-system.js # Role-based landing pages
│ │ ├── role-change-approval.js # Role change workflow
│ │ └── settings.html # Role & system settings
│ │
│ ├── 🎨 UI/UX & Accessibility (6 files)
│ │ ├── responsive-improvements.css # Mobile responsive fixes
│ │ ├── accessibility-fixes.css # WCAG compliance fixes
│ │ ├── accessibility-manager.js # Accessibility features
│ │ ├── loading-screen.css # Loading screen styling
│ │ ├── loading-screen.js # Loading screen component
│ │ ├── fixed-navbar.js # Sticky navigation bar
│ │ ├── navbar.js # Navigation logic
│ │ ├── stability-fixes.css # UI stability patches
│ │ └── empty-states-system.js # Empty state components
│ │
│ ├── ℹ️ Help & Support (3 files)
│ │ ├── help-center.html # Help center main page
│ │ ├── help-center.js # Help center logic
│ │ ├── help-center-styles.css # Help center styling
│ │ ├── troubleshooting.html # Troubleshooting guide
│ │ └── api-reference.html # API documentation page
│ │
│ ├── 📈 System Monitoring (3 files)
│ │ ├── system-health.html # System health dashboard
│ │ ├── timeline-visualization.html # Activity timeline view
│ │ ├── timeline-visualization.js # Timeline rendering
│ │ └── notifications.js # Real-time notifications
│ │
│ └── 🛠️ System Utilities (4 files)
│ ├── enhanced-error-handling.js # Global error handling
│ ├── enhanced-stability.js # Stability improvements
│ ├── blockchain-feedback.js # Blockchain operation feedback
│ └── css/ # Additional stylesheets
│
├── server.js # Express.js backend server
├── complete-database-setup-fixed.sql # Complete database schema
├── package.json # Dependencies and scripts
├── render.yaml # Render.com deployment config
├── .env.example # Environment variables template
├── .gitignore # Git ignore rules
├── LICENSE # Apache 2.0 license
├── SECURITY.md # Security policy
├── CODE_OF_CONDUCT.md # Community guidelines
├── CONTRIBUTING.md # Contribution guidelines
└── README.md # Project documentation
- server.js - Express backend with Socket.IO, handles all API endpoints, authentication, file uploads, and database operations
- complete-database-setup-fixed.sql - Complete PostgreSQL schema with 17+ tables, Row Level Security policies, triggers, and stored functions
- package.json - Node.js dependencies (321 packages) and npm scripts for development and deployment
- .env.example - Template for environment variables (Supabase URL, API keys, JWT secrets)
- render.yaml - Render.com deployment configuration with build and start commands
- public/config.js - Frontend configuration for API endpoints, file size limits, supported formats
- USER_GUIDE.md - Complete user manual with role-specific instructions and workflows
- DEVELOPER_GUIDE.md - Development setup, architecture overview, API reference, and contribution guide
- SECURITY.md - Security implementation details, best practices, and vulnerability reporting
- DEPLOYMENT.md - Production deployment instructions for Render, Vercel, and Netlify
- MAINTENANCE.md - System maintenance procedures, backup strategies, and troubleshooting
- 🚀 Quick Start
- 📖 User Guide
- 💻 Developer Guide
- 📡 API Documentation
- 🔒 Security Guide
- 🚀 Deployment Guide
- 🔧 Maintenance Guide
| Topic | Description | Link |
|---|---|---|
| User Guide | Role-specific guides and common tasks | 👤 User Guide |
| Developer Guide | Setup, architecture, and development workflow | 💻 Developer Guide |
| API Documentation | Complete API reference with examples | 📡 API Docs |
| Security Guide | Security practices and vulnerability mitigations | 🔒 Security Guide |
| Deployment Guide | Deploy to Render, Vercel, or Netlify | 🚀 Deployment |
| Maintenance Guide | Regular maintenance and troubleshooting | 🔧 Maintenance |
Before you begin, ensure you have the following installed:
- Node.js (v16 or higher) - Download
- npm (comes with Node.js) or yarn
- Git - Download
- MetaMask browser extension - Install
- Supabase account - Sign up
- Code Editor (VS Code recommended)
# Clone the repository
git clone <repository-url>
# Navigate to project directory
cd blockchain-evidence# Install all required packages and run setup
npm install
# Or run setup manually
npm run setupThe setup script creates a .env file automatically. Update it with your Supabase credentials:
# Update these values in .env
SUPABASE_URL=your_supabase_project_url
SUPABASE_KEY=your_supabase_anon_key- Log in to your Supabase Dashboard
- Create a new project or select existing one
- Navigate to SQL Editor
- Execute the following SQL files in order:
-- Step 1: Core database structure
-- Copy and run: complete-database-setup.sql
-- Step 2: Evidence tagging system (optional)
-- Copy and run: evidence-tagging-schema.sql
-- Step 3: Evidence export system (optional)
-- Copy and run: evidence-export-schema.sql# Start the backend server with auto-reload
npm run dev
# Or for production mode
npm startThe server will start on http://localhost:3000
Open your browser and navigate to:
- Main Application: http://localhost:3000
- Health Check: http://localhost:3000/api/health
- Navigate to the login page
- Click "Connect Wallet" button
- MetaMask extension will popup automatically
- Connect with any wallet address
- The system will create test users automatically
- Select a role and complete registration
Use these pre-configured test accounts:
| Password | Role | |
|---|---|---|
investigator@evid-dgc.com |
hashed_password_123 |
Investigator |
analyst@evid-dgc.com |
hashed_password_456 |
Forensic Analyst |
legal@evid-dgc.com |
hashed_password_789 |
Legal Professional |
admin@evid-dgc.com |
admin_password |
Administrator |
Note: These are demo credentials for testing. In production, use secure passwords and proper authentication.
Issue: "Config not defined" error
- Solution: Ensure
config.jsis loaded beforeapp.jsin HTML
Issue: Navigation not working
- Solution: Check browser console for JavaScript errors
- Ensure Lucide icons are loading properly
Issue: Wallet connection fails
- Solution: Install MetaMask browser extension
- Check browser console for detailed error messages
Issue: Server won't start
- Solution: Check
.envfile exists and has correct format - Ensure port 3000 is not in use by another application
# Start development server
npm start
# Install new dependency
npm install package-name
# Check server health
curl http://localhost:3000/api/health
# View logs
# Check browser console and server terminalThe application can be deployed on various platforms:
- Platform: Render.com, Vercel, or Netlify
- Database: Supabase (PostgreSQL)
- File Storage: IPFS via Pinata
Ensure the following environment variables are set in your production environment:
# Supabase Configuration
SUPABASE_URL=your_production_supabase_url
SUPABASE_KEY=your_production_supabase_key
# Server Configuration
PORT=3000
NODE_ENV=production
# IPFS/Pinata Configuration (if using)
PINATA_API_KEY=your_pinata_api_key
PINATA_SECRET_KEY=your_pinata_secret_key
# Blockchain Network
BLOCKCHAIN_NETWORK=polygon
BLOCKCHAIN_RPC_URL=your_rpc_url
-
Connect Repository:
- Go to Render Dashboard
- Click "New +" → "Web Service"
- Connect your GitHub repository
-
Configure Service:
Name: evid-dgc Environment: Node Build Command: npm install Start Command: npm start
-
Set Environment Variables:
- Add all required environment variables in Render dashboard
- Navigate to "Environment" tab
- Add each variable from the list above
-
Deploy:
- Click "Create Web Service"
- Render will automatically deploy on every push to main branch
# Install Netlify CLI
npm install -g netlify-cli
# Login to Netlify
netlify login
# Deploy
netlify deploy --prodOr drag and drop the public folder on Netlify Drop.
The project is configured for automatic deployment:
- Trigger: Push to
mainbranch - Build: Automatic via
npm install - Deploy: Automatic via hosting provider
- Rollback: Available through hosting dashboard
- Application Logs: Available in Render/Vercel/Netlify dashboard
- Database Logs: Available in Supabase dashboard
- Uptime Monitoring: Consider using services like UptimeRobot
For detailed deployment troubleshooting, see Deployment Documentation.
┌─────────────────┐
│ Web Browser │
│ (MetaMask + │
│ Frontend) │
└────────┬────────┘
│
│ HTTPS
▼
┌─────────────────────────────────┐
│ Express.js Backend │
│ ┌──────────────────────────┐ │
│ │ Authentication Layer │ │
│ │ (MetaMask/Email) │ │
│ └──────────────────────────┘ │
│ ┌──────────────────────────┐ │
│ │ Role-Based Access │ │
│ │ Control (RBAC) │ │
│ └──────────────────────────┘ │
│ ┌──────────────────────────┐ │
│ │ Evidence Processing │ │
│ │ (Upload/Watermark) │ │
│ └──────────────────────────┘ │
│ ┌──────────────────────────┐ │
│ │ Real-time Events │ │
│ │ (Socket.IO) │ │
│ └──────────────────────────┘ │
└────┬──────────┬─────────┬───────┘
│ │ │
│ │ │
▼ ▼ ▼
┌─────────┐ ┌─────────┐ ┌──────────┐
│Supabase │ │ IPFS │ │Blockchain│
│PostgreSQL│ │(Pinata) │ │(Polygon) │
│ +RLS │ │ Storage │ │ Network │
└─────────┘ └─────────┘ └──────────┘
Evidence Upload Flow:
- User authenticates via MetaMask or Email
- Role verification through RBAC system
- Evidence file uploaded to Express backend
- File processed (watermark, compression)
- File stored in IPFS via Pinata
- Metadata and IPFS hash stored in Supabase
- Transaction recorded on Polygon blockchain
- Audit log created in database
- Real-time notification sent via Socket.IO
Access Control Flow:
- User login → JWT token generated
- Each request validated against user role
- Supabase RLS policies enforce database security
- Audit trail logged for compliance
| Component | Technology | Purpose |
|---|---|---|
| Frontend | HTML/CSS/JS | User interface and interactions |
| API Server | Express.js | REST API and business logic |
| WebSocket | Socket.IO | Real-time notifications |
| Database | Supabase (PostgreSQL) | Structured data storage |
| File Storage | IPFS/Pinata | Decentralized evidence storage |
| Blockchain | Polygon | Immutable audit trail |
| Authentication | MetaMask/Supabase Auth | User authentication |
| Authorization | Custom RBAC | Role-based permissions |
For detailed architecture documentation, see Implementation Summary.
If you find this project helpful, please consider giving it a Star! It helps others discover the project and keeps the maintainers motivated.
We value your feedback! If you have suggestions for new features or have found a bug, please open an issue or start a discussion in your repository.
We welcome contributions from developers, security researchers, legal professionals, and anyone passionate about improving digital evidence management!
- Fork the repository and clone it locally
- Read our Contributing Guide for detailed instructions
- Check out open issues for ways to help
- Join the discussion in GitHub Discussions
- 🐛 Bug Reports: Found an issue? Let us know!
- 💡 Feature Requests: Have ideas for improvements?
- 🔧 Code Contributions: Fix bugs or add new features
- 📚 Documentation: Help improve our guides and docs
- 🎨 Design & UX: Enhance the user interface
- 🧪 Testing: Help us test new features
- 🌐 Localization: Translate the app to other languages
- Choose an issue or propose a new feature
- Fork and create a branch for your changes
- Make your changes following our coding standards
- Test thoroughly and add documentation
- Submit a pull request with a clear description
For detailed guidelines, see our Contributing Guide.
Thanks to all the amazing people who have contributed to EVID-DGC! 🎉
 Gooichand 🚀 Project Lead & Core Developer |
Want to see your name here? Check out our Contributing Guide and start contributing today!
We recognize contributors in multiple ways:
- README Contributors Section (above)
- Release Notes for significant contributions
- GitHub Contributors Page automatic recognition
- Special Mentions in project updates and social media
- Star the repository ⭐ to show your support
- Watch the repository 👀 to stay updated
- Fork and contribute 🍴 to help improve the project
- Share with others 📢 who might be interested
- Join discussions 💬 in GitHub Issues and Discussions
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.
Copyright 2025 EVID-DGC Blockchain Evidence Management System
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
We are committed to providing a friendly, safe, and welcoming environment. Please review our CODE_OF_CONDUCT.md.