# swarnadeep-dey/algoedge architecture

> Architecture diagram of the GitHub repository swarnadeep-dey/algoedge, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/swarnadeep-dey/algoedge
- Repository: https://github.com/swarnadeep-dey/algoedge

## Overview

AlgoEdge is an Indian-equities research pipeline whose main workflow screens NIFTY 50 stocks into SQLite, then uses that ticker universe for event-driven backtesting and training-period optimization; a Streamlit dashboard presents the screener, backtest, and optimizer results. Backtesting separates market data, strategy signals, portfolio accounting, simulated execution, and analytics. The README documents the full capabilities, while sampled source confirms key database and report interactions. Some internal wiring and the dashboard’s optimizer loading are not fully shown, so uncertain links are omitted.

Main entry points: [`python_codes/Screeners.py`](https://github.com/swarnadeep-dey/algoedge/blob/main/python_codes/Screeners.py) (NIFTY Screener), [`results/market_data.db`](https://github.com/swarnadeep-dey/algoedge/blob/main/results/market_data.db) (Market Database), [`python_codes/Optimeser.py`](https://github.com/swarnadeep-dey/algoedge/blob/main/python_codes/Optimeser.py) (Grid Search), [`python_codes/Backtester.py`](https://github.com/swarnadeep-dey/algoedge/blob/main/python_codes/Backtester.py) (Portfolio Accounting)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_screen["Screening and Data"]
  node_screener["NIFTY Screener<br/>[Screeners.py]"]
  node_marketdb[("Market Database<br/>[market_data.db]")]
  node_config["Strategy Config<br/>[strategy_config.py]"]
end

subgraph group_backtest["Backtesting Engine"]
  node_datahandler["Market Data Handler<br/>[Backtester.py]"]
  node_eventstrategy["Event Strategy<br/>[Backtester.py]"]
  node_portfolio["Portfolio Accounting<br/>[Backtester.py]"]
  node_execution["Simulated Execution<br/>[Backtester.py]"]
  node_analytics["Performance Analytics<br/>[Backtester.py]"]
end

subgraph group_optimize["Parameter Optimization"]
  node_optimizer["Grid Search<br/>[Optimeser.py]"]
end

subgraph group_presentation["Reports and Dashboard"]
  node_excel["Excel Report Writer<br/>[Excel_reports.py]"]
  node_dashboard["Streamlit Dashboard<br/>[Dashboard.py]"]
  node_reports["Generated Reports"]
end

node_user(("Researcher"))
node_yahoo{{"Yahoo Finance"}}

node_user -->|"views results"| node_dashboard
node_user -->|"refreshes"| node_screener
node_screener -->|"downloads prices"| node_yahoo
node_screener -->|"uses thresholds"| node_config
node_screener -->|"writes snapshot"| node_marketdb
node_screener -->|"exports screener"| node_excel
node_marketdb -->|"provides tickers"| node_datahandler
node_datahandler -->|"downloads history"| node_yahoo
node_eventstrategy -->|"reads prices"| node_datahandler
node_eventstrategy -->|"emits signals"| node_portfolio
node_portfolio -->|"dispatches orders"| node_execution
node_execution -->|"returns fills"| node_portfolio
node_portfolio -->|"records equity"| node_analytics
node_analytics -->|"exports backtest"| node_excel
node_marketdb -->|"provides tickers"| node_optimizer
node_optimizer -->|"downloads training data"| node_yahoo
node_optimizer -->|"uses strategy rules"| node_config
node_optimizer -->|"exports grid results"| node_excel
node_excel -->|"saves workbooks"| node_reports
node_marketdb -->|"loads screener"| node_dashboard
node_reports -->|"loads analytics"| node_dashboard

click node_screener "https://github.com/swarnadeep-dey/algoedge/blob/main/python_codes/Screeners.py"
click node_marketdb "https://github.com/swarnadeep-dey/algoedge/blob/main/results/market_data.db"
click node_config "https://github.com/swarnadeep-dey/algoedge/blob/main/python_codes/strategy_config.py"
click node_datahandler "https://github.com/swarnadeep-dey/algoedge/blob/main/python_codes/Backtester.py"
click node_eventstrategy "https://github.com/swarnadeep-dey/algoedge/blob/main/python_codes/Backtester.py"
click node_portfolio "https://github.com/swarnadeep-dey/algoedge/blob/main/python_codes/Backtester.py"
click node_execution "https://github.com/swarnadeep-dey/algoedge/blob/main/python_codes/Backtester.py"
click node_analytics "https://github.com/swarnadeep-dey/algoedge/blob/main/python_codes/Backtester.py"
click node_optimizer "https://github.com/swarnadeep-dey/algoedge/blob/main/python_codes/Optimeser.py"
click node_excel "https://github.com/swarnadeep-dey/algoedge/blob/main/python_codes/Excel_reports.py"
click node_dashboard "https://github.com/swarnadeep-dey/algoedge/blob/main/python_codes/Dashboard.py"
click node_reports "https://github.com/swarnadeep-dey/algoedge/tree/main/results"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_screener,node_marketdb,node_config toneBlue
class node_datahandler,node_eventstrategy,node_portfolio,node_execution,node_analytics toneAmber
class node_optimizer toneMint
class node_excel,node_dashboard,node_reports toneRose
class node_user,node_yahoo toneIndigo
```

## Components

### Screening and Data

- [NIFTY Screener](https://github.com/swarnadeep-dey/algoedge/blob/main/python_codes/Screeners.py): `python_codes/Screeners.py`
- [Market Database](https://github.com/swarnadeep-dey/algoedge/blob/main/results/market_data.db): `results/market_data.db`
- [Strategy Config](https://github.com/swarnadeep-dey/algoedge/blob/main/python_codes/strategy_config.py): `python_codes/strategy_config.py`

### Backtesting Engine

- [Market Data Handler](https://github.com/swarnadeep-dey/algoedge/blob/main/python_codes/Backtester.py): `python_codes/Backtester.py`
- [Event Strategy](https://github.com/swarnadeep-dey/algoedge/blob/main/python_codes/Backtester.py): `python_codes/Backtester.py`
- [Portfolio Accounting](https://github.com/swarnadeep-dey/algoedge/blob/main/python_codes/Backtester.py): `python_codes/Backtester.py`
- [Simulated Execution](https://github.com/swarnadeep-dey/algoedge/blob/main/python_codes/Backtester.py): `python_codes/Backtester.py`
- [Performance Analytics](https://github.com/swarnadeep-dey/algoedge/blob/main/python_codes/Backtester.py): `python_codes/Backtester.py`

### Parameter Optimization

- [Grid Search](https://github.com/swarnadeep-dey/algoedge/blob/main/python_codes/Optimeser.py): `python_codes/Optimeser.py`

### Reports and Dashboard

- [Excel Report Writer](https://github.com/swarnadeep-dey/algoedge/blob/main/python_codes/Excel_reports.py): `python_codes/Excel_reports.py`
- [Streamlit Dashboard](https://github.com/swarnadeep-dey/algoedge/blob/main/python_codes/Dashboard.py): `python_codes/Dashboard.py`
- [Generated Reports](https://github.com/swarnadeep-dey/algoedge/tree/main/results): `results`

### Other components

- **Researcher**
- **Yahoo Finance**

## Connections

- Researcher → Streamlit Dashboard: views results (evidence: `README.md`)
- Researcher → NIFTY Screener: refreshes
- NIFTY Screener → Yahoo Finance: downloads prices (evidence: `python_codes/Screeners.py`)
- NIFTY Screener → Strategy Config: uses thresholds (evidence: `python_codes/Screeners.py`)
- NIFTY Screener → Market Database: writes snapshot (evidence: `python_codes/Screeners.py`)
- NIFTY Screener → Excel Report Writer: exports screener (evidence: `python_codes/Screeners.py`)
- Market Database → Market Data Handler: provides tickers (evidence: `README.md`)
- Market Data Handler → Yahoo Finance: downloads history (evidence: `python_codes/Backtester.py`)
- Event Strategy → Market Data Handler: reads prices (evidence: `python_codes/Backtester.py`)
- Event Strategy → Portfolio Accounting: emits signals (evidence: `python_codes/Backtester.py`)
- Portfolio Accounting → Simulated Execution: dispatches orders (evidence: `python_codes/Backtester.py`)
- Simulated Execution → Portfolio Accounting: returns fills (evidence: `python_codes/Backtester.py`)
- Portfolio Accounting → Performance Analytics: records equity (evidence: `python_codes/Backtester.py`)
- Performance Analytics → Excel Report Writer: exports backtest (evidence: `README.md`)
- Market Database → Grid Search: provides tickers (evidence: `python_codes/Optimeser.py`)
- Grid Search → Yahoo Finance: downloads training data (evidence: `python_codes/Optimeser.py`)
- Grid Search → Strategy Config: uses strategy rules (evidence: `python_codes/Optimeser.py`)
- Grid Search → Excel Report Writer: exports grid results (evidence: `python_codes/Optimeser.py`)
- Excel Report Writer → Generated Reports: saves workbooks
- Market Database → Streamlit Dashboard: loads screener (evidence: `python_codes/Dashboard.py`)
- Generated Reports → Streamlit Dashboard: loads analytics (evidence: `python_codes/Dashboard.py`)
