# sumeetbeginner/tradex architecture

> Architecture diagram of the GitHub repository sumeetbeginner/tradex, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-07-13). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sumeetbeginner/tradex
- Repository: https://github.com/sumeetbeginner/tradex

## Overview

##### Project type and purpose
- This is a full-stack, real-time stock-market simulation platform (“TradingX”)
- Frontend: React/Vite single-page application
- Backend: Flask REST API (middleware)
- Database: Firebase (Auth, Firestore, Realtime Database)
- Purpose: Let users trade virtual stocks, view live charts, portfolio, news, gainers/losers

##### File structure
- Top-level:
- client/ → React code (Vite config, index.html, src/)
- server/ → Flask app (app.py, wsgi.py, Algorithms/ for data-gathering scripts, requirements.txt)
- README.md → tech stack, setup, Firebase config
- client/src/firebase.js shows direct Firebase integration for Auth, Firestore, Realtime DB
- server/Algorithms contains Python modules for stock algorithms (topgainers, toplosers, news scraping, nifty data)
- Vercel configs (client/vercel.json, server/vercel.json) show deployment targets

##### README for additional insights
- Confirms stack: React frontend, Flask backend, Firebase DB
- Outlines dev setup (npm install & run dev, pip install & run wsgi.py)
- Firebase used for user authentication and data persistence

##### Detailed element checklist
Auth, Home, Portfolio, Search, Wallet, Wishlist, Settings)
- External data: NSE JSON, web-scraped news, market API
- Deployment: Vercel (client & server)
- User → React SPA → Flask API
- React SPA ↔ Firebase services
- Flask API → Algorithms → External Data

## Diagram (Mermaid)

```mermaid
graph TB
    %% External Data Sources
    External["External Data Sources\n(Stock API, Scrapers)"]:::external

    %% Frontend Layer
    subgraph "Frontend Layer"
        direction TB
        ReactSPA["React SPA"]:::compute
        MainJS["main.jsx"]:::frontend
        AppJS["App.jsx"]:::frontend
        Main2JS["Main2.jsx"]:::frontend
        FirebaseSDK["firebase.js"]:::frontend
        subgraph "Components"
            direction TB
            AuthDir["Auth\n(Login.jsx, Signup.jsx)"]:::frontend
            HomeDir["Home & Live Charts\n(Home.jsx, Nifty.jsx, NiftyChart.jsx)"]:::frontend
            PortfolioDir["Portfolio\n(Portfolio.jsx)"]:::frontend
            SearchDir["Search\n(Search.jsx, SearchBar.jsx)"]:::frontend
            WalletDir["Wallet & Charts\n(Wallet.jsx, BarChart.jsx, PieChart.jsx)"]:::frontend
            WishlistDir["Wishlist\n(Wishlist.jsx)"]:::frontend
            SettingDir["Setting\n(Setting.jsx, PremiumBox.jsx, SalaryBox.jsx)"]:::frontend
            StocksDir["Stocks\n(StockDetails.jsx, StockChart.jsx, StockDataA.jsx, BuyBox.jsx, SellBox.jsx)"]:::frontend
        end
        AssetData["nse.json"]:::data
        ViteConfig["vite.config.js"]:::frontend
        VercelFE["vercel.json"]:::external
    end

    %% Backend Layer
    subgraph "Backend Layer"
        direction TB
        FlaskAPI["Flask REST API\n(app.py, index.py, wsgi.py)"]:::compute
        subgraph "Algorithms"
            direction TB
            Gainers["Gainers\n(topgainers.py, toplosers.py)"]:::compute
            NewsMod["News\n(scrapenews.py)"]:::compute
            NiftyMod["Nifty Data\n(nifty.py)"]:::compute
        end
        BackendJSON["nse.json"]:::data
        ReqTxt["requirements.txt"]:::compute
        VercelBE["vercel.json"]:::external
    end

    %% Firebase Services
    subgraph "Firebase Services"
        direction TB
        AuthDB["Authentication"]:::datastore
        Firestore["Firestore"]:::datastore
        RealtimeDB["Realtime Database"]:::datastore
    end

    %% Deployment
    Vercel["Vercel Deployment"]:::external

    %% User
    User["User"]:::external

    %% Connections
    User -->|uses| ReactSPA
    ReactSPA -->|calls API| FlaskAPI
    ReactSPA -->|Auth/Reads/Writes| AuthDB
    ReactSPA -->|Reads/Writes| Firestore
    ReactSPA -->|Subscribes| RealtimeDB
    FlaskAPI -->|invokes| Gainers
    FlaskAPI -->|invokes| NewsMod
    FlaskAPI -->|invokes| NiftyMod
    Gainers -->|fetches| External
    NewsMod -->|scrapes| External
    NiftyMod -->|reads| External
    FlaskAPI -->|serves static| BackendJSON
    ReactSPA -->|loads| AssetData

    Vercel --> ReactSPA
    Vercel --> FlaskAPI

    %% Click Events - Frontend
    click ReactSPA "https://github.com/sumeetbeginner/tradex/tree/master/client/"
    click MainJS "https://github.com/sumeetbeginner/tradex/blob/master/client/src/main.jsx"
    click AppJS "https://github.com/sumeetbeginner/tradex/blob/master/client/src/App.jsx"
    click Main2JS "https://github.com/sumeetbeginner/tradex/blob/master/client/src/Main2.jsx"
    click FirebaseSDK "https://github.com/sumeetbeginner/tradex/blob/master/client/src/firebase.js"
    click AuthDir "https://github.com/sumeetbeginner/tradex/tree/master/client/src/components/Auth/"
    click HomeDir "https://github.com/sumeetbeginner/tradex/tree/master/client/src/components/Home/"
    click PortfolioDir "https://github.com/sumeetbeginner/tradex/tree/master/client/src/components/Portfolio/"
    click SearchDir "https://github.com/sumeetbeginner/tradex/tree/master/client/src/components/Search/"
    click WalletDir "https://github.com/sumeetbeginner/tradex/tree/master/client/src/components/Wallet/"
    click WishlistDir "https://github.com/sumeetbeginner/tradex/tree/master/client/src/components/Wishlist/"
    click SettingDir "https://github.com/sumeetbeginner/tradex/tree/master/client/src/components/Setting/"
    click StocksDir "https://github.com/sumeetbeginner/tradex/tree/master/client/src/components/stocks/"
    click AssetData "https://github.com/sumeetbeginner/tradex/blob/master/client/src/assets/data/nse.json"
    click ViteConfig "https://github.com/sumeetbeginner/tradex/blob/master/client/vite.config.js"
    click VercelFE "https://github.com/sumeetbeginner/tradex/blob/master/client/vercel.json"

    %% Click Events - Backend
    click FlaskAPI "https://github.com/sumeetbeginner/tradex/blob/master/server/app.py"
    click FlaskAPI "https://github.com/sumeetbeginner/tradex/blob/master/server/index.py"
    click FlaskAPI "https://github.com/sumeetbeginner/tradex/blob/master/server/wsgi.py"
    click Gainers "https://github.com/sumeetbeginner/tradex/tree/master/server/Algorithms/Gainers/"
    click NewsMod "https://github.com/sumeetbeginner/tradex/tree/master/server/Algorithms/News/"
    click NiftyMod "https://github.com/sumeetbeginner/tradex/tree/master/server/Algorithms/niftydata/"
    click BackendJSON "https://github.com/sumeetbeginner/tradex/blob/master/server/nse.json"
    click ReqTxt "https://github.com/sumeetbeginner/tradex/blob/master/server/requirements.txt"
    click VercelBE "https://github.com/sumeetbeginner/tradex/blob/master/server/vercel.json"

    %% Styles
    classDef compute fill:#cce5ff,stroke:#3399ff,stroke-width:1px
    classDef frontend fill:#e6f7ff,stroke:#66c2ff,stroke-width:1px
    classDef datastore fill:#ffe5cc,stroke:#ff9933,stroke-width:1px
    classDef data fill:#fff0b3,stroke:#ffd24d,stroke-width:1px
    classDef external fill:#f2f2f2,stroke:#999999,stroke-width:1px,stroke-dasharray: 2 2
```
