# deadsmash07/advance-analytic-tool architecture

> Architecture diagram of the GitHub repository deadsmash07/advance-analytic-tool, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/deadsmash07/advance-analytic-tool
- Repository: https://github.com/deadsmash07/advance-analytic-tool

## Overview

##### Project type and purpose
- This is a full-stack web application for real-time stock market analysis (built with Flask, pandas, Plotly, yfinance) combined with a library of standalone trading-algorithm tools (implemented in C++/Python under `Trading_Algorithms/`).
- The README describes:
- A Flask-based backend that fetches data from Yahoo Finance via yfinance
- Data processing with pandas, interactive visualization with Plotly
- A responsive frontend (HTML templates, CSS, JavaScript) for exploring, comparing, and viewing market summaries
- A scheduler component for periodic tasks
- A set of command-line trading strategies (DMA, MACD, RSI, etc.) under `Trading_Algorithms/`

##### File structure
- Top-level:
- `test_flask.py`, `scheduler.py`, `data.py`, `requirements.txt`, `Makefile` – core backend scripts & setup
- `static/` (CSS) and `templates/` – frontend assets (views)
- `Trading_Algorithms/` – C++ and Python implementations of multiple trading strategies, with their own Makefile
- CSV/XLSX data files (`top_gainers.csv`, `stock_list.xlsx`, etc.) for persisting fetched data
- Patterns:
- MVC-style separation:
– “Models”: `data.py` + pandas DataFrames + CSV/XLSX files
– “Views”: HTML templates + Plotly charts + CSS/JS
– “Controllers”: Flask routes in `test_flask.py`
- Scheduler: `scheduler.py` runs periodic fetch & writes CSVs
- CLI Tools: `Trading_Algorithms/` invoked via `make strategy=…`

##### README for additional insights
- Architecture described verbally: Flask endpoints, dynamic template rendering, yfinance→pandas→Plotly pipeline
- No external database—data persisted in CSV/XLSX files
- Trading algorithms are standalone command-line utilities, not integrated into the web UI

##### Detail
- Scheduler’s cron-like trigger and output files
- Which modules depend on `data.py` vs. which use raw CSV

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Frontend Layer
    subgraph "Frontend Layer"
        direction TB
        User["User"]:::frontend
        Browser["Browser"]:::frontend
        Templates["Jinja2 Templates"]:::frontend
        StaticAssets["Static Assets (CSS/JS)"]:::frontend
    end

    %% Backend Services
    subgraph "Backend Services"
        direction TB
        FlaskApp["Flask Application"]:::service
        DataModel["Data Models & Processing"]:::service
        Scheduler["Scheduler Service"]:::service
    end

    %% External Service
    subgraph "External Service"
        direction TB
        YahooFinance["Yahoo Finance API (yfinance)"]:::external
    end

    %% Data Store
    subgraph "Data Store"
        direction TB
        CSVFiles["CSV/XLSX Files"]:::datastore
    end

    %% Trading Algorithm Engine
    subgraph "Trading Algorithm Engine"
        direction TB
        TradingEngine["CLI Tools (C++/Python)"]:::cli
    end

    %% Dependency & Documentation
    Requirements["requirements.txt & Makefile"]:::service
    Documentation["README.md & Assets"]:::service

    %% Connections
    User -->|uses| Browser
    Browser -->|requests| FlaskApp
    FlaskApp -->|imports| DataModel
    FlaskApp -->|renders| Templates
    FlaskApp -->|serves| StaticAssets
    FlaskApp -->|fetches data| YahooFinance
    Scheduler -->|fetches data| YahooFinance
    Scheduler -->|writes| CSVFiles
    FlaskApp -->|reads/writes| CSVFiles
    TradingEngine -->|reads/writes| CSVFiles
    TradingEngine -->|invoked via| Requirements
    FlaskApp -->|defined by| Requirements
    Documentation ---|describes| FlaskApp

    %% Click Events
    click FlaskApp "https://github.com/deadsmash07/advance-analytic-tool/blob/main/test_flask.py"
    click DataModel "https://github.com/deadsmash07/advance-analytic-tool/blob/main/data.py"
    click Scheduler "https://github.com/deadsmash07/advance-analytic-tool/blob/main/scheduler.py"
    click Templates "https://github.com/deadsmash07/advance-analytic-tool/tree/main/templates/"
    click StaticAssets "https://github.com/deadsmash07/advance-analytic-tool/tree/main/static/css/"
    click TradingEngine "https://github.com/deadsmash07/advance-analytic-tool/tree/main/Trading_Algorithms/"
    click Requirements "https://github.com/deadsmash07/advance-analytic-tool/blob/main/requirements.txt"
    click Requirements "https://github.com/deadsmash07/advance-analytic-tool/tree/main/Makefile"
    click Documentation "https://github.com/deadsmash07/advance-analytic-tool/blob/main/README.md"

    %% Styles
    classDef frontend fill:#D0E8FF,stroke:#004085,color:#004085;
    classDef service fill:#D4EDDA,stroke:#155724,color:#155724;
    classDef datastore fill:#FFF3CD,stroke:#856404,color:#856404;
    classDef external fill:#E2E3E5,stroke:#6C757D,color:#6C757D;
    classDef cli fill:#F8D7DA,stroke:#721C24,color:#721C24;
```
