# ganesh1583/blockchain-based-nft-ticketing-system architecture

> Architecture diagram of the GitHub repository ganesh1583/blockchain-based-nft-ticketing-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ganesh1583/blockchain-based-nft-ticketing-system
- Repository: https://github.com/ganesh1583/blockchain-based-nft-ticketing-system

## Overview

##### Project type and purpose
- This is a full-stack, blockchain-based ticket-selling dApp.
- Frontend: React single-page application that connects to Web3 wallets and a REST API.
- Backend: Node.js/Express server that manages user accounts, events, tickets, transactions, and coordinates with Ethereum smart contracts via Hardhat and Web3 libraries.
- Smart contracts: ERC-721-style NFT contract (“EventTicketNFT”) deployed to an Ethereum network (local or testnet).

##### File structure
- Top-level folders:
- backend – Node.js API server + smart contract development & deployment
- frontend – React application
- backend substructure:
- contracts – Hardhat modules (Lock.js) and EventTicketNFT Solidity artifacts
- scripts – deployment and minting scripts (deploy.js, mint-nft.js)
- db – database initialization (db.js)
- routes – Express routers for users, concerts, tickets, transactions
- middlewares – auth/user middleware
- comman_functions/upload.js – file-upload utility
- server.js – Express server entry point
- hardhat.config.js – Smart contract build/test/deploy configuration
- frontend substructure:
- public – static HTML and manifest
- src/components – reusable UI pieces (Navbar, Footer, QRCodeScanner, WalletConnect) plus route guards (PrivateRoute, OrganizerRoute)
- src/contexts – React Contexts for Auth, Event data, Web3 provider
- src/contracts – compiled JSON of EventTicketNFT for front-end Web3 calls
- src/pages – route-level pages for Home, Events, Dashboard, Ticket details, Scanner, Login/Register, etc.

##### README
- Minimal README title: “blockchain-based-ticket-selling” confirms focus on NFT tickets

##### Capturing essential details
- Don’t oversimplify: show both the REST API and the blockchain interface
- Persistence types: off-chain (DB) vs. on-chain (smart contract state)
- Deployment flow: from source code → Hardhat compile → deploy → contract address injected into both backend config and front-end JSON

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% User Interface Layer
    subgraph "User Interface"
        Wallet["Web3 Wallet"]:::frontend
        subgraph "React Application"
            Index["index.js"]:::frontend
            App["App.js"]:::frontend
            WalletConnect["WalletConnect Component"]:::frontend
            subgraph "Context Providers"
                AuthContext["AuthContext"]:::frontend
                EventContext["EventContext"]:::frontend
                Web3Context["Web3Context"]:::frontend
            end
        end
    end

    %% Backend Layer
    subgraph "Backend API"
        Server["server.js\n(Express Entry)"]:::backend
        subgraph "Route Handlers"
            Users["usersRouter"]:::backend
            Concerts["concertsRouter"]:::backend
            Tickets["ticketsRouter"]:::backend
            Transactions["transactionsRouter"]:::backend
        end
        Middleware["userMiddleware"]:::backend
        Upload["upload.js"]:::backend
        DB["db.js\n(Database Init)"]:::backend
    end

    %% Smart Contracts & Deployment
    subgraph "Smart Contracts & Deployment"
        LockModule["Lock.js\n(Hardhat Module)"]:::blockchain
        subgraph "Compiled Artifacts"
            EventNFT["EventTicketNFT.json"]:::blockchain
        end
        HardhatConfig["hardhat.config.js"]:::blockchain
        subgraph "Deployment Scripts"
            DeployScript["deploy.js"]:::blockchain
            MintScript["mint-nft.js"]:::blockchain
        end
        TestLock["Lock.js\n(Test)"]:::blockchain
    end

    %% Ethereum Network
    Ethereum["Ethereum Network"]:::blockchain

    %% Data Flow
    Wallet -->|"connect"| WalletConnect
    WalletConnect -->|"initializes"| Web3Context
    Index -->|renders| App
    App -->|"uses"| AuthContext
    App -->|"uses"| EventContext
    App -->|"uses"| Web3Context
    App -->|"calls REST API"| Server
    App -.->|"Web3 RPC"| Ethereum

    Server -->|"CRUD Operations"| DB
    Server -->|"uses middleware"| Middleware
    Server -->|"uses upload util"| Upload
    Server -->|"route handlers"| Users
    Server -->|"route handlers"| Concerts
    Server -->|"route handlers"| Tickets
    Server -->|"route handlers"| Transactions
    Server -.->|"Web3 RPC via Hardhat/Web3"| Ethereum

    DeployScript -->|deploys contracts| Ethereum
    MintScript -->|mints NFTs| Ethereum
    LockModule -->|compiled by Hardhat| Ethereum
    HardhatConfig -->|configures| LockModule
    TestLock -->|tests| LockModule

    Ethereum -->|stores on-chain data| EventNFT

    %% Click Events
    click WalletConnect "https://github.com/ganesh1583/blockchain-based-nft-ticketing-system/blob/main/frontend/src/components/WalletConnect.js"
    click Index "https://github.com/ganesh1583/blockchain-based-nft-ticketing-system/blob/main/frontend/src/index.js"
    click App "https://github.com/ganesh1583/blockchain-based-nft-ticketing-system/blob/main/frontend/src/App.js"
    click AuthContext "https://github.com/ganesh1583/blockchain-based-nft-ticketing-system/blob/main/frontend/src/contexts/AuthContext.js"
    click EventContext "https://github.com/ganesh1583/blockchain-based-nft-ticketing-system/blob/main/frontend/src/contexts/EventContext.js"
    click Web3Context "https://github.com/ganesh1583/blockchain-based-nft-ticketing-system/blob/main/frontend/src/contexts/Web3Context.js"
    click EventNFT "https://github.com/ganesh1583/blockchain-based-nft-ticketing-system/blob/main/frontend/src/contracts/EventTicketNFT.json"
    click Server "https://github.com/ganesh1583/blockchain-based-nft-ticketing-system/blob/main/backend/server.js"
    click Users "https://github.com/ganesh1583/blockchain-based-nft-ticketing-system/blob/main/backend/routes/usersRouter.js"
    click Concerts "https://github.com/ganesh1583/blockchain-based-nft-ticketing-system/blob/main/backend/routes/concertsRouter.js"
    click Tickets "https://github.com/ganesh1583/blockchain-based-nft-ticketing-system/blob/main/backend/routes/ticketsRouter.js"
    click Transactions "https://github.com/ganesh1583/blockchain-based-nft-ticketing-system/blob/main/backend/routes/transactionsRouter.js"
    click DB "https://github.com/ganesh1583/blockchain-based-nft-ticketing-system/blob/main/backend/db/db.js"
    click Middleware "https://github.com/ganesh1583/blockchain-based-nft-ticketing-system/blob/main/backend/middlewares/userMiddleware.js"
    click Upload "https://github.com/ganesh1583/blockchain-based-nft-ticketing-system/blob/main/backend/comman_functions/upload.js"
    click LockModule "https://github.com/ganesh1583/blockchain-based-nft-ticketing-system/blob/main/backend/ignition/modules/Lock.js"
    click HardhatConfig "https://github.com/ganesh1583/blockchain-based-nft-ticketing-system/blob/main/backend/hardhat.config.js"
    click DeployScript "https://github.com/ganesh1583/blockchain-based-nft-ticketing-system/blob/main/backend/scripts/deploy.js"
    click MintScript "https://github.com/ganesh1583/blockchain-based-nft-ticketing-system/blob/main/backend/scripts/mint-nft.js"
    click TestLock "https://github.com/ganesh1583/blockchain-based-nft-ticketing-system/blob/main/backend/test/Lock.js"

    %% Styles
    classDef frontend fill:#ADD8E6,stroke:#000
    classDef backend fill:#90EE90,stroke:#000
    classDef blockchain fill:#D8BFD8,stroke:#000
```
