@tushar-br/desktop 1.0.280 → 1.0.282

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@tushar-br/desktop",
-    "version": "1.0.280",
+    "version": "1.0.282",
     "description": "Private Image Cloud Storage & Backup System by Tushar",
     "main": "index.js",
     "bin": {

package/staging_area/micro projects/FOB-Electronic Voting System using Blockchain/README.md

@@ -0,0 +1,131 @@
+# Electronic Voting System using Blockchain (Academic Project)
+
+This project is a conceptual demonstration of an Electronic Voting System secured by Blockchain technology. It is designed for academic purposes (Diploma/Final Year Project) to showcase how blockchain principles (immutability, transparency, hashing) can be applied to voting systems.
+
+**Note:** This is an academic simulation. The blockchain runs locally on a single machine, and the cryptographic functions are implemented in Python for educational clarity.
+
+---
+
+## 🚀 How to Run
+
+### Prerequisites
+1. **Python 3.x** installed on your system.
+2. **Flask** (Python web framework).
+
+### Installation Steps
+1. Open your terminal/command prompt.
+2. Install Flask if you haven't already:
+   ```bash
+   pip install flask
+   ```
+3. Navigate to the project folder:
+   ```bash
+   cd "path/to/project_folder"
+   ```
+4. Run the application:
+   ```bash
+   python app.py
+   ```
+5. Open your web browser and go to:
+   ```
+   http://127.0.0.1:5000
+   ```
+
+### ⚡ Quick Start (Windows)
+Double-click the **`run_project.bat`** file.
+- It will automatically open your browser.
+- It will start the voting server in the terminal.
+
+---
+
+## 🌐 GitHub & Vercel Deployment
+
+This project is ready for GitHub and Vercel.
+
+### GitHub Upload
+1. Initialize git: `git init`
+2. Add files: `git add .`
+3. Commit: `git commit -m "Initial commit"`
+4. Push to your repository.
+
+### Vercel Deployment (Live Hosting)
+1. Install Vercel CLI or connect your GitHub repo to Vercel.
+2. The project includes `vercel.json` for automatic configuration.
+3. **Important Note for Vercel:** 
+   Attributes like `self.chain = []` are stored in memory. On serverless platforms like Vercel, the memory resets frequently. 
+   *   **For the best Academic Demo:** Run it **Locally** (using `run_project.bat`) so you can show the Terminal output with the Blockchain hashes accumulating.
+   *   **For Vercel:** It will work, but the blockchain might reset if the server sleeps. This is expected behavior for serverless demos.
+
+---
+
+## 📂 Project Structure
+
+- **`app.py`**: The main Python application (Flask server) connecting the UI and Blockchain.
+- **`blockchain.py`**: The core blockchain logic (Block creation, SHA-256 detailed hashing, Chain validation).
+- **`templates/`**: Contains HTML files for the user interface.
+- **`static/`**: Contains CSS files for styling.
+
+---
+
+## 🔗 Blockchain Concepts Explained
+
+### 1. What is Blockchain?
+Start with the simple idea: "A Blockchain is a digital ledger (notebook) that is duplicated and distributed across a network." 
+In our project, we simulate this ledger. It is a chain of blocks, where each block contains data (a vote).
+
+### 2. Why for Voting?
+- **Immutability:** Once a block is added, it cannot be changed. This prevents vote tampering.
+- **Transparency:** Anyone can inspect the blockchain to verify votes (in a public system).
+- **Security:** Hashing ensures that if one block is altered, the entire chain after it becomes invalid.
+
+### 3. How it Works in this Project
+1. **Voter Login:** The system accepts a Voter ID.
+2. **Vote Cast:** The user selects a candidate.
+3. **Hashing:** The system creates a "Block" containing:
+   - **Voter ID Hash:** We hash the ID (SHA-256) so the original identity is hidden but unique.
+   - **Timestamp:** Exact time of the vote.
+   - **Candidate Name:** Who received the vote.
+   - **Previous Hash:** The digital fingerprint of the *previous* block.
+4. **Chaining:** This block is added to the list. Because it contains the "Previous Hash," it is cryptographically linked to the history.
+
+---
+
+## 📐 System Architecture
+
+### Data Flow Components
+1. **Voter (User):** Interacts via the Web Browser.
+2. **HTML UI:** Simple forms for input and display.
+3. **Python Backend:** Receives data, handles logic.
+4. **Blockchain Ledger:** The immutable list of vote blocks.
+
+### Diagram (Text-Based)
+
+```
+[ Voter ]
+    |
+    | (Inputs ID & Vote)
+    v
+[ HTML UI (Browser) ]
+    |
+    | (HTTP Request - POST)
+    v
+[ Python Backend (Flask) ] ----> [ Voter Validation ]
+    |                                   |
+    | (Creates Block)                   | (Verify ID)
+    v                                   |
+[ Blockchain Simulation ] <-------------+
+    | 
+    +---> [ Calculate Hash (SHA-256) ]
+    |
+    +---> [ Link to Previous Block ]
+    |
+    +---> [ Append to Chain ]
+    |
+    v
+[ Terminal/Console Output ] (Displays Updated Ledger)
+```
+
+---
+
+## ⚠️ Academic Disclaimer
+This system is a **prototype** for educational demonstration only. It lacks advanced security features required for a real-world national election (e.g., distributed consensus, elliptical curve cryptography, biometric authentication, secure network transmission). It is meant to demonstrate the **logic** of blockchain in voting.

package/staging_area/micro projects/FOB-Electronic Voting System using Blockchain/app.py

@@ -0,0 +1,100 @@
+from flask import Flask, render_template, request, redirect, url_for, flash, send_file
+from blockchain import Blockchain
+import hashlib
+import os
+
+app = Flask(__name__)
+app.secret_key = 'academic_demo_key'  # Needed for flash messages
+
+# Initialize Blockchain
+blockchain = Blockchain()
+
+# Hardcoded candidates for the demo with metadata for UI
+CANDIDATES = [
+    {"id": "c1", "name": "Alice Johnson", "party": "Tech Innovation Party", "color": "#3498db"},
+    {"id": "c2", "name": "Bob Smith", "party": "Green Earth Alliance", "color": "#27ae60"},
+    {"id": "c3", "name": "Charlie Davis", "party": "Future Vision Party", "color": "#9b59b6"}
+]
+
+@app.route('/')
+def index():
+    return render_template('index.html')
+
+@app.route('/login', methods=['POST'])
+def login():
+    voter_id = request.form.get('voter_id')
+    if not voter_id:
+        flash("Please enter a valid Voter ID")
+        return redirect(url_for('index'))
+    
+    # 1. Check if voter has already voted (Academic Single Vote Enforcement)
+    # Note: We check the blockchain directly for the hashed ID
+    voter_hash = hashlib.sha256(voter_id.encode()).hexdigest()
+    for block in blockchain.chain:
+        if block.voter_id == voter_hash:
+            # Voter found in ledger -> Redirect to Error Page
+            return redirect(url_for('already_voted'))
+
+    # If new voter, allow access
+    return redirect(url_for('vote', voter_id=voter_id))
+
+@app.route('/vote')
+def vote():
+    voter_id = request.args.get('voter_id')
+    
+    # Security check: If no ID in URL, go home
+    if not voter_id:
+        return redirect(url_for('index'))
+    
+    # Security check: Re-verify if this ID has voted (prevent URL jumping)
+    voter_hash = hashlib.sha256(voter_id.encode()).hexdigest()
+    for block in blockchain.chain:
+        if block.voter_id == voter_hash:
+            return redirect(url_for('already_voted'))
+            
+    return render_template('vote.html', voter_id=voter_id, candidates=CANDIDATES)
+
+@app.route('/submit_vote', methods=['POST'])
+def submit_vote():
+    voter_id = request.form.get('voter_id')
+    candidate = request.form.get('candidate')
+
+    if not voter_id or not candidate:
+        flash("Invalid vote submission")
+        return redirect(url_for('index'))
+
+    # Add vote to blockchain
+    success, message = blockchain.add_vote(voter_id, candidate)
+
+    if success:
+        return render_template('confirmation.html', message=message, block_index=blockchain.get_latest_block().index)
+    else:
+        # If vote failed (likely duplicate catch), redirect to error page
+        return redirect(url_for('already_voted'))
+
+@app.route('/already_voted')
+def already_voted():
+    return render_template('already_voted.html')
+
+@app.route('/pdf/view')
+def view_pdf():
+    """Serve the PDF file for inline viewing in browser"""
+    pdf_path = os.path.join(app.root_path, 'templates', 'PDF', 'FOB-236340316058.pdf')
+    return send_file(pdf_path, mimetype='application/pdf')
+
+@app.route('/pdf/download')
+def download_pdf():
+    """Serve the PDF file for download"""
+    pdf_path = os.path.join(app.root_path, 'templates', 'PDF', 'FOB-236340316058.pdf')
+    return send_file(pdf_path, as_attachment=True, download_name='FOB-236340316058.pdf')
+
+@app.route('/chain')
+def view_chain():
+    # Helper route to view chain in browser JSON format (used by Terminal UI)
+    chain_data = [block.to_dict() for block in blockchain.chain]
+    return {"length": len(chain_data), "chain": chain_data}
+
+if __name__ == '__main__':
+    print("Electronic Voting System using Blockchain - Demo Started")
+    print("Access the UI at: http://127.0.0.1:5000")
+    app.run(debug=True)

package/staging_area/micro projects/FOB-Electronic Voting System using Blockchain/blockchain.py

@@ -0,0 +1,98 @@
+import hashlib
+import time
+import json
+
+class Block:
+    def __init__(self, index, timestamp, voter_id, candidate, previous_hash):
+        self.index = index
+        self.timestamp = timestamp
+        self.voter_id = voter_id  # This will be hashed for privacy in the chain
+        self.candidate = candidate
+        self.previous_hash = previous_hash
+        self.hash = self.calculate_hash()
+
+    def calculate_hash(self):
+        # Create a string representation of the block (excluding the hash itself)
+        # Using json.dumps ensures a consistent string format for hashing
+        block_string = json.dumps({
+            "index": self.index,
+            "timestamp": self.timestamp,
+            "voter_id": self.voter_id,
+            "candidate": self.candidate,
+            "previous_hash": self.previous_hash
+        }, sort_keys=True)
+        
+        # Calculate SHA-256 hash
+        return hashlib.sha256(block_string.encode()).hexdigest()
+
+    def to_dict(self):
+        return {
+            "index": self.index,
+            "timestamp": self.timestamp,
+            "voter_id": self.voter_id,
+            "candidate": self.candidate,
+            "previous_hash": self.previous_hash,
+            "hash": self.hash
+        }
+
+class Blockchain:
+    def __init__(self):
+        self.chain = []
+        self.create_genesis_block()
+
+    def create_genesis_block(self):
+        # The first block in a blockchain is the Genesis Block
+        # It has no previous hash (or arbitrary string like "0")
+        genesis_block = Block(0, time.time(), "GENESIS", "System Initialization", "0")
+        self.chain.append(genesis_block)
+        print("Blockchain Initialized with Genesis Block")
+
+    def get_latest_block(self):
+        return self.chain[-1]
+
+    def add_vote(self, voter_id, candidate):
+        # 1. Check if voter has already voted (simple check based on hashed ID in chain)
+        # In a real system, this would be more complex (e.g., separate voter registry)
+        voter_hash = hashlib.sha256(voter_id.encode()).hexdigest()
+        
+        for block in self.chain:
+            if block.voter_id == voter_hash:
+                return False, "Error: Voter has already cast a vote."
+
+        # 2. Create new block
+        previous_block = self.get_latest_block()
+        new_block = Block(
+            index=previous_block.index + 1,
+            timestamp=time.time(),
+            voter_id=voter_hash,  # Store hash of ID for simple anonymity
+            candidate=candidate,
+            previous_hash=previous_block.hash
+        )
+
+        # 3. Add to chain (immutability starts here)
+        self.chain.append(new_block)
+        
+        # 4. Display blockchain contents in terminal (as requested)
+        self.print_chain()
+        
+        return True, "Vote recorded successfully on blockchain"
+
+    def is_chain_valid(self):
+        for i in range(1, len(self.chain)):
+            current_block = self.chain[i]
+            previous_block = self.chain[i-1]
+
+            # Check if current block's hash is valid
+            if current_block.hash != current_block.calculate_hash():
+                return False
+            
+            # Check if current block points to the correct previous block
+            if current_block.previous_hash != previous_block.hash:
+                return False
+        return True
+
+    def print_chain(self):
+        print("\n--- Current Blockchain State ---")
+        for block in self.chain:
+            print(json.dumps(block.to_dict(), indent=4))
+        print("--------------------------------\n")

package/staging_area/micro projects/FOB-Electronic Voting System using Blockchain/requirements.txt

@@ -0,0 +1,2 @@
+Flask==3.0.3
+Werkzeug==3.0.3

package/staging_area/micro projects/FOB-Electronic Voting System using Blockchain/run_project.bat

@@ -0,0 +1,29 @@
+@echo off
+TITLE Electronic Voting System - Blockchain Demo
+COLOR 0A
+CLS
+
+ECHO ======================================================
+ECHO    ELECTRONIC VOTING SYSTEM USING BLOCKCHAIN
+ECHO    Academic Project - Local Environment
+ECHO ======================================================
+ECHO.
+ECHO [INFO] Starting the Python Backend Server...
+ECHO [INFO] Opening User Interface in default browser...
+ECHO.
+
+:: Open the browser immediately (it might take a second to connect while Flask starts)
+START "" "http://127.0.0.1:5000"
+
+:: Check if Python is installed (simple check)
+python --version >nul 2>&1
+IF %ERRORLEVEL% NEQ 0 (
+    ECHO [ERROR] Python is not installed or not in PATH.
+    PAUSE
+    EXIT /B
+)
+
+:: Run the Flask application
+python app.py
+
+PAUSE

package/staging_area/micro projects/FOB-Electronic Voting System using Blockchain/static/images/avatar_alice.svg

@@ -0,0 +1,12 @@
+<!-- Placeholder SVG Avatar Generator -->
+<svg width="120" height="120" viewBox="0 0 120 120" xmlns="http://www.w3.org/2000/svg">
+    <defs>
+        <linearGradient id="grad1" x1="0%" y1="0%" x2="100%" y2="100%">
+            <stop offset="0%" style="stop-color:#3498db;stop-opacity:1" />
+            <stop offset="100%" style="stop-color:#2980b9;stop-opacity:1" />
+        </linearGradient>
+    </defs>
+    <circle cx="60" cy="60" r="60" fill="url(#grad1)"/>
+    <circle cx="60" cy="45" r="20" fill="#fff" opacity="0.9"/>
+    <ellipse cx="60" cy="95" rx="30" ry="25" fill="#fff" opacity="0.9"/>
+</svg>

package/staging_area/micro projects/FOB-Electronic Voting System using Blockchain/static/images/avatar_bob.svg

@@ -0,0 +1,12 @@
+<!-- Placeholder SVG Avatar Generator -->
+<svg width="120" height="120" viewBox="0 0 120 120" xmlns="http://www.w3.org/2000/svg">
+    <defs>
+        <linearGradient id="grad2" x1="0%" y1="0%" x2="100%" y2="100%">
+            <stop offset="0%" style="stop-color:#27ae60;stop-opacity:1" />
+            <stop offset="100%" style="stop-color:#229954;stop-opacity:1" />
+        </linearGradient>
+    </defs>
+    <circle cx="60" cy="60" r="60" fill="url(#grad2)"/>
+    <circle cx="60" cy="45" r="20" fill="#fff" opacity="0.9"/>
+    <ellipse cx="60" cy="95" rx="30" ry="25" fill="#fff" opacity="0.9"/>
+</svg>

package/staging_area/micro projects/FOB-Electronic Voting System using Blockchain/static/images/avatar_charlie.svg

@@ -0,0 +1,12 @@
+<!-- Placeholder SVG Avatar Generator -->
+<svg width="120" height="120" viewBox="0 0 120 120" xmlns="http://www.w3.org/2000/svg">
+    <defs>
+        <linearGradient id="grad3" x1="0%" y1="0%" x2="100%" y2="100%">
+            <stop offset="0%" style="stop-color:#9b59b6;stop-opacity:1" />
+            <stop offset="100%" style="stop-color:#8e44ad;stop-opacity:1" />
+        </linearGradient>
+    </defs>
+    <circle cx="60" cy="60" r="60" fill="url(#grad3)"/>
+    <circle cx="60" cy="45" r="20" fill="#fff" opacity="0.9"/>
+    <ellipse cx="60" cy="95" rx="30" ry="25" fill="#fff" opacity="0.9"/>
+</svg>