# visualdigitalagency/options-strategy-dashboard architecture

> Architecture diagram of the GitHub repository visualdigitalagency/options-strategy-dashboard, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/visualdigitalagency/options-strategy-dashboard
- Repository: https://github.com/visualdigitalagency/options-strategy-dashboard

## Overview

Theta Desk is an options-selling screener with learning features, paper trading, and an admin-gated Zerodha integration. Users sign in, review screened Nifty 50 setups, inspect a stock’s strategy details, then place paper orders and track positions. The API also serves account, learning, calendar, and portfolio features; a separate worker refreshes market data and manages scheduled trading tasks. Edges reflect the excerpts, SOURCE INDEX references, and README statements; unsampled subsystem details are represented at their documented module paths.

Main entry points: [`server.py`](https://github.com/visualdigitalagency/options-strategy-dashboard/blob/main/server.py) (JSON-RPC API), [`frontend/src/rpc.js`](https://github.com/visualdigitalagency/options-strategy-dashboard/blob/main/frontend/src/rpc.js) (RPC client), [`engine/worker.py`](https://github.com/visualdigitalagency/options-strategy-dashboard/blob/main/engine/worker.py) (Scheduled worker), [`engine/virtual.py`](https://github.com/visualdigitalagency/options-strategy-dashboard/blob/main/engine/virtual.py) (Virtual trading)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_app["Dashboard<br/>[App.jsx]"]
  node_authui["Sign-in UI<br/>[auth.jsx]"]
  node_rpcclient["RPC client<br/>[rpc.js]"]
  node_screenui["Screener<br/>[Overview.jsx]"]
  node_stockui["Stock detail<br/>[StockDetail.jsx]"]
  node_builderui["Strategy builder<br/>[Builder.jsx]"]
  node_portfolio_ui["Portfolio<br/>[Portfolio.jsx]"]
  node_charts["Charts<br/>[Charts.jsx]"]
  node_learning["Learning progress<br/>[progress.py]"]
end

subgraph group_market["Market analysis"]
  node_screening["Screening rules<br/>[risk_rules.py]"]
  node_marketdata["Market data fetch<br/>[data_fetch.py]"]
  node_calendar["Market calendar<br/>[market_calendar.py]"]
end

subgraph group_trading["Trading"]
  node_paper["Virtual trading<br/>[virtual.py]"]
  node_livebroker["Broker integration<br/>[broker.py]"]
  node_brokeradapter["Zerodha adapter<br/>[zerodha.py]"]
end

subgraph group_platform["API and identity"]
  node_api["JSON-RPC API<br/>[server.py]"]
  node_identity["Accounts and permissions<br/>[auth.py]"]
end

subgraph group_operations["Background services"]
  node_worker["Scheduled worker<br/>[worker.py]"]
  node_postgres[("PostgreSQL<br/>[db.py]")]
  node_redis[("Redis cache<br/>[cache.py]")]
end

node_user(("Trader"))
node_nse(("NSE market data"))
node_zerodha(("Zerodha API"))

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_screenui
node_app -->|"provides auth"| node_authui
node_authui -->|"calls"| node_rpcclient
node_screenui -.->|"requests data"| node_rpcclient
node_stockui -->|"requests data"| node_rpcclient
node_builderui -->|"requests data"| node_rpcclient
node_portfolio_ui -->|"requests data"| node_rpcclient
node_stockui -.->|"renders"| node_charts
node_builderui -->|"renders"| node_charts
node_portfolio_ui -->|"renders"| node_charts
node_rpcclient -->|"sends RPC"| node_api
node_api -->|"dispatches auth"| node_identity
node_api -->|"dispatches screening"| node_screening
node_api -->|"dispatches trading"| node_paper
node_api -->|"dispatches broker"| node_livebroker
node_api -->|"serves calendar"| node_calendar
node_api -->|"dispatches progress"| node_learning
node_screening -->|"uses prices"| node_marketdata
node_marketdata -.->|"fetches quotes"| node_nse
node_paper -->|"stores positions"| node_postgres
node_paper -->|"caches snapshots"| node_redis
node_worker -->|"runs EOD pass"| node_paper
node_worker -.->|"refreshes calendar"| node_calendar
node_worker -.->|"refreshes screen"| node_screening
node_worker -->|"locks work"| node_redis
node_livebroker -->|"uses adapter"| node_brokeradapter
node_brokeradapter -.->|"connects"| node_zerodha

click node_app "https://github.com/visualdigitalagency/options-strategy-dashboard/blob/main/frontend/src/App.jsx"
click node_authui "https://github.com/visualdigitalagency/options-strategy-dashboard/blob/main/frontend/src/auth.jsx"
click node_rpcclient "https://github.com/visualdigitalagency/options-strategy-dashboard/blob/main/frontend/src/rpc.js"
click node_screenui "https://github.com/visualdigitalagency/options-strategy-dashboard/blob/main/frontend/src/pages/Overview.jsx"
click node_stockui "https://github.com/visualdigitalagency/options-strategy-dashboard/blob/main/frontend/src/pages/StockDetail.jsx"
click node_builderui "https://github.com/visualdigitalagency/options-strategy-dashboard/blob/main/frontend/src/pages/Builder.jsx"
click node_portfolio_ui "https://github.com/visualdigitalagency/options-strategy-dashboard/blob/main/frontend/src/pages/Portfolio.jsx"
click node_charts "https://github.com/visualdigitalagency/options-strategy-dashboard/blob/main/frontend/src/components/Charts.jsx"
click node_api "https://github.com/visualdigitalagency/options-strategy-dashboard/blob/main/server.py"
click node_identity "https://github.com/visualdigitalagency/options-strategy-dashboard/blob/main/engine/auth.py"
click node_screening "https://github.com/visualdigitalagency/options-strategy-dashboard/blob/main/engine/risk_rules.py"
click node_marketdata "https://github.com/visualdigitalagency/options-strategy-dashboard/blob/main/engine/data_fetch.py"
click node_calendar "https://github.com/visualdigitalagency/options-strategy-dashboard/blob/main/engine/market_calendar.py"
click node_paper "https://github.com/visualdigitalagency/options-strategy-dashboard/blob/main/engine/virtual.py"
click node_livebroker "https://github.com/visualdigitalagency/options-strategy-dashboard/blob/main/engine/broker.py"
click node_brokeradapter "https://github.com/visualdigitalagency/options-strategy-dashboard/blob/main/engine/brokers/zerodha.py"
click node_learning "https://github.com/visualdigitalagency/options-strategy-dashboard/blob/main/engine/progress.py"
click node_worker "https://github.com/visualdigitalagency/options-strategy-dashboard/blob/main/engine/worker.py"
click node_postgres "https://github.com/visualdigitalagency/options-strategy-dashboard/blob/main/engine/db.py"
click node_redis "https://github.com/visualdigitalagency/options-strategy-dashboard/blob/main/engine/cache.py"

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_app,node_authui,node_rpcclient,node_screenui,node_stockui,node_builderui,node_portfolio_ui,node_charts,node_learning toneBlue
class node_screening,node_marketdata,node_calendar toneAmber
class node_paper,node_livebroker,node_brokeradapter,node_zerodha toneMint
class node_api,node_identity toneRose
class node_worker,node_postgres,node_redis,node_user,node_nse toneIndigo
```

## Components

### User experience

- [Dashboard](https://github.com/visualdigitalagency/options-strategy-dashboard/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Sign-in UI](https://github.com/visualdigitalagency/options-strategy-dashboard/blob/main/frontend/src/auth.jsx): `frontend/src/auth.jsx`
- [RPC client](https://github.com/visualdigitalagency/options-strategy-dashboard/blob/main/frontend/src/rpc.js): `frontend/src/rpc.js`
- [Screener](https://github.com/visualdigitalagency/options-strategy-dashboard/blob/main/frontend/src/pages/Overview.jsx): `frontend/src/pages/Overview.jsx`
- [Stock detail](https://github.com/visualdigitalagency/options-strategy-dashboard/blob/main/frontend/src/pages/StockDetail.jsx): `frontend/src/pages/StockDetail.jsx`
- [Strategy builder](https://github.com/visualdigitalagency/options-strategy-dashboard/blob/main/frontend/src/pages/Builder.jsx): `frontend/src/pages/Builder.jsx`
- [Portfolio](https://github.com/visualdigitalagency/options-strategy-dashboard/blob/main/frontend/src/pages/Portfolio.jsx): `frontend/src/pages/Portfolio.jsx`
- [Charts](https://github.com/visualdigitalagency/options-strategy-dashboard/blob/main/frontend/src/components/Charts.jsx): `frontend/src/components/Charts.jsx`
- [Learning progress](https://github.com/visualdigitalagency/options-strategy-dashboard/blob/main/engine/progress.py): `engine/progress.py`

### Market analysis

- [Screening rules](https://github.com/visualdigitalagency/options-strategy-dashboard/blob/main/engine/risk_rules.py): `engine/risk_rules.py`
- [Market data fetch](https://github.com/visualdigitalagency/options-strategy-dashboard/blob/main/engine/data_fetch.py): `engine/data_fetch.py`
- [Market calendar](https://github.com/visualdigitalagency/options-strategy-dashboard/blob/main/engine/market_calendar.py): `engine/market_calendar.py`

### Trading

- [Virtual trading](https://github.com/visualdigitalagency/options-strategy-dashboard/blob/main/engine/virtual.py): `engine/virtual.py`
- [Broker integration](https://github.com/visualdigitalagency/options-strategy-dashboard/blob/main/engine/broker.py): `engine/broker.py`
- [Zerodha adapter](https://github.com/visualdigitalagency/options-strategy-dashboard/blob/main/engine/brokers/zerodha.py): `engine/brokers/zerodha.py`

### API and identity

- [JSON-RPC API](https://github.com/visualdigitalagency/options-strategy-dashboard/blob/main/server.py): `server.py`
- [Accounts and permissions](https://github.com/visualdigitalagency/options-strategy-dashboard/blob/main/engine/auth.py): `engine/auth.py`

### Background services

- [Scheduled worker](https://github.com/visualdigitalagency/options-strategy-dashboard/blob/main/engine/worker.py): `engine/worker.py`
- [PostgreSQL](https://github.com/visualdigitalagency/options-strategy-dashboard/blob/main/engine/db.py): `engine/db.py`
- [Redis cache](https://github.com/visualdigitalagency/options-strategy-dashboard/blob/main/engine/cache.py): `engine/cache.py`

### Other components

- **Trader**
- **NSE market data**
- **Zerodha API**

## Connections

- Trader → Dashboard: uses (evidence: `README.md`)
- Dashboard → Screener: routes to (evidence: `frontend/src/App.jsx`)
- Dashboard → Sign-in UI: provides auth (evidence: `frontend/src/App.jsx`)
- Sign-in UI → RPC client: calls (evidence: `frontend/src/auth.jsx`)
- Screener → RPC client: requests data
- Stock detail → RPC client: requests data
- Strategy builder → RPC client: requests data (evidence: `frontend/src/pages/Builder.jsx`)
- Portfolio → RPC client: requests data (evidence: `frontend/src/pages/Portfolio.jsx`)
- Stock detail → Charts: renders
- Strategy builder → Charts: renders (evidence: `frontend/src/pages/Builder.jsx`)
- Portfolio → Charts: renders (evidence: `frontend/src/pages/Portfolio.jsx`)
- RPC client → JSON-RPC API: sends RPC (evidence: `frontend/src/rpc.js`)
- JSON-RPC API → Accounts and permissions: dispatches auth (evidence: `server.py`)
- JSON-RPC API → Screening rules: dispatches screening (evidence: `server.py`)
- JSON-RPC API → Virtual trading: dispatches trading (evidence: `server.py`)
- JSON-RPC API → Broker integration: dispatches broker (evidence: `server.py`)
- JSON-RPC API → Market calendar: serves calendar (evidence: `server.py`)
- JSON-RPC API → Learning progress: dispatches progress (evidence: `server.py`)
- Screening rules → Market data fetch: uses prices (evidence: `engine/risk_rules.py`)
- Market data fetch → NSE market data: fetches quotes
- Virtual trading → PostgreSQL: stores positions (evidence: `engine/virtual.py`)
- Virtual trading → Redis cache: caches snapshots (evidence: `engine/virtual.py`)
- Scheduled worker → Virtual trading: runs EOD pass (evidence: `engine/worker.py`)
- Scheduled worker → Market calendar: refreshes calendar (evidence: `engine/worker.py`)
- Scheduled worker → Screening rules: refreshes screen
- Scheduled worker → Redis cache: locks work (evidence: `engine/worker.py`)
- Broker integration → Zerodha adapter: uses adapter (evidence: `engine/broker.py`)
- Zerodha adapter → Zerodha API: connects
