# pp112/tradingview-analyzer architecture

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

- Interactive diagram: https://gitdiagram.com/pp112/tradingview-analyzer
- Repository: https://github.com/pp112/tradingview-analyzer

## Overview

Cryptoscope is a cryptocurrency market-monitoring and trading dashboard. Its principal workflow periodically refreshes market data and computes indicator signals, exposes signals and account information through a backend API, then presents live updates and controls in a web UI. Users can inspect movers and positions/orders and associate signals with positions or orders. The graph includes the documented-by-tree capability areas, but several backend processors and frontend features were not excerpted; their internal connections are therefore omitted or marked unverified rather than inferred.

Main entry points: [`frontend/src/App.tsx`](https://github.com/pp112/tradingview-analyzer/blob/main/frontend/src/App.tsx) (Dashboard composition), [`frontend/src/hooks/useSSE.ts`](https://github.com/pp112/tradingview-analyzer/blob/main/frontend/src/hooks/useSSE.ts) (Live event hook), [`backend/app/application.py`](https://github.com/pp112/tradingview-analyzer/blob/main/backend/app/application.py) (Application lifecycle), [`backend/app/updater.py`](https://github.com/pp112/tradingview-analyzer/blob/main/backend/app/updater.py) (Data updater)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Backend runtime"]
  node_app["Application lifecycle<br/>[application.py]"]
  node_scheduler["Update scheduler<br/>[scheduler.py]"]
  node_startup["Startup updater<br/>[startup.py]"]
  node_updater["Data updater<br/>[updater.py]"]
  node_state[("Refresh state<br/>[state_manager.py]")]
  node_marketapi["Signals and market API<br/>[api.py]"]
  node_accountapi["Positions API<br/>[api.py]"]
end

subgraph group_market["Market analysis"]
  node_marketdata["Market data clients"]
  node_indicators["Indicator analysis"]
  node_signalmodel["Signal model<br/>[signal.py]"]
end

subgraph group_account["Trading account"]
  node_exchange["Bybit exchange client<br/>[client.py]"]
end

subgraph group_web["Web application"]
  node_webapi["Web API client<br/>[client.ts]"]
  node_signalapi["Signal requests<br/>[signals.ts]"]
  node_sse["Live event hook<br/>[useSSE.ts]"]
  node_signalsstore["Signals state<br/>[useSignalsStore.ts]"]
  node_controls["Signal controls<br/>[SignalControls.tsx]"]
  node_signaltable["Signal table<br/>[SignalTable.tsx]"]
  node_movers["Market movers<br/>[MoversCard.tsx]"]
  node_positionsui["Positions and orders"]
  node_linkapi["Signal-link requests<br/>[signalLinks.ts]"]
  node_linkhook["Signal-link hook<br/>[useSignalLinks.ts]"]
  node_linkstore["Signal-link state"]
  node_appui["Dashboard composition<br/>[App.tsx]"]
end

subgraph group_links["Signal links"]
  node_linkroutes["Signal-link routes<br/>[signal_links.py]"]
  node_linkrepo["Signal-link repository<br/>[repository.py]"]
  node_database[("SQLite database<br/>[database.py]")]
end

node_operator(("Dashboard user"))
node_exchangeprovider(("Bybit API"))

node_app -->|"starts"| node_scheduler
node_app -->|"runs startup"| node_startup
node_app -->|"serves"| node_marketapi
node_app -->|"initializes"| node_database
node_scheduler -->|"schedules"| node_updater
node_startup -->|"runs"| node_updater
node_startup -->|"checks freshness"| node_state
node_updater -.->|"refreshes"| node_marketdata
node_updater -.->|"computes"| node_indicators
node_indicators -.->|"produces"| node_signalmodel
node_operator -->|"uses"| node_appui
node_appui -->|"starts live updates"| node_sse
node_appui -->|"loads initial data"| node_signalapi
node_appui -->|"renders"| node_controls
node_appui -->|"renders"| node_signaltable
node_appui -->|"renders"| node_movers
node_appui -->|"renders"| node_positionsui
node_sse -->|"fetches signals"| node_signalapi
node_sse -->|"updates"| node_signalsstore
node_signalapi -->|"uses"| node_webapi
node_webapi -.->|"requests data"| node_marketapi
node_marketapi -.->|"serves signals"| node_signalmodel
node_positionsui -.->|"loads account data"| node_accountapi
node_accountapi -.->|"delegates"| node_exchange
node_exchange -->|"calls"| node_exchangeprovider
node_appui -->|"starts"| node_linkhook
node_linkhook -->|"loads links"| node_linkapi
node_linkhook -->|"updates"| node_linkstore
node_sse -->|"fetches linked values"| node_linkapi
node_sse -->|"updates values"| node_linkstore
node_linkapi -->|"uses"| node_webapi
node_linkapi -.->|"requests links"| node_linkroutes
node_linkroutes -->|"uses repository"| node_linkrepo
node_linkrepo -->|"persists links"| node_database

click node_app "https://github.com/pp112/tradingview-analyzer/blob/main/backend/app/application.py"
click node_scheduler "https://github.com/pp112/tradingview-analyzer/blob/main/backend/app/scheduler.py"
click node_startup "https://github.com/pp112/tradingview-analyzer/blob/main/backend/app/startup.py"
click node_updater "https://github.com/pp112/tradingview-analyzer/blob/main/backend/app/updater.py"
click node_state "https://github.com/pp112/tradingview-analyzer/blob/main/backend/storage/state_manager.py"
click node_marketdata "https://github.com/pp112/tradingview-analyzer/tree/main/backend/market"
click node_indicators "https://github.com/pp112/tradingview-analyzer/tree/main/backend/processing"
click node_signalmodel "https://github.com/pp112/tradingview-analyzer/blob/main/backend/models/signal.py"
click node_marketapi "https://github.com/pp112/tradingview-analyzer/blob/main/backend/api/api.py"
click node_webapi "https://github.com/pp112/tradingview-analyzer/blob/main/frontend/src/api/client.ts"
click node_signalapi "https://github.com/pp112/tradingview-analyzer/blob/main/frontend/src/api/signals.ts"
click node_sse "https://github.com/pp112/tradingview-analyzer/blob/main/frontend/src/hooks/useSSE.ts"
click node_signalsstore "https://github.com/pp112/tradingview-analyzer/blob/main/frontend/src/store/useSignalsStore.ts"
click node_controls "https://github.com/pp112/tradingview-analyzer/blob/main/frontend/src/features/signal-controls/SignalControls.tsx"
click node_signaltable "https://github.com/pp112/tradingview-analyzer/blob/main/frontend/src/features/signal-table/SignalTable.tsx"
click node_movers "https://github.com/pp112/tradingview-analyzer/blob/main/frontend/src/features/movers/MoversCard.tsx"
click node_accountapi "https://github.com/pp112/tradingview-analyzer/blob/main/backend/api/api.py"
click node_exchange "https://github.com/pp112/tradingview-analyzer/blob/main/backend/exchanges/bybit/client.py"
click node_positionsui "https://github.com/pp112/tradingview-analyzer/blob/main/frontend/src/features/positions-orders/PositionsOrdersCard.tsx"
click node_linkroutes "https://github.com/pp112/tradingview-analyzer/blob/main/backend/api/signal_links.py"
click node_linkrepo "https://github.com/pp112/tradingview-analyzer/blob/main/backend/signal_links/repository.py"
click node_database "https://github.com/pp112/tradingview-analyzer/blob/main/backend/storage/database.py"
click node_linkapi "https://github.com/pp112/tradingview-analyzer/blob/main/frontend/src/api/signalLinks.ts"
click node_linkhook "https://github.com/pp112/tradingview-analyzer/blob/main/frontend/src/hooks/useSignalLinks.ts"
click node_linkstore "https://github.com/pp112/tradingview-analyzer/blob/main/frontend/src/store/useSignalLinksStore.ts"
click node_appui "https://github.com/pp112/tradingview-analyzer/blob/main/frontend/src/App.tsx"

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_scheduler,node_startup,node_updater,node_state,node_marketapi,node_accountapi,node_operator toneBlue
class node_marketdata,node_indicators,node_signalmodel toneAmber
class node_exchange,node_exchangeprovider toneMint
class node_webapi,node_signalapi,node_sse,node_signalsstore,node_controls,node_signaltable,node_movers,node_positionsui,node_linkapi,node_linkhook,node_linkstore,node_appui toneRose
class node_linkroutes,node_linkrepo,node_database toneIndigo
```

## Components

### Backend runtime

- [Application lifecycle](https://github.com/pp112/tradingview-analyzer/blob/main/backend/app/application.py): `backend/app/application.py`
- [Update scheduler](https://github.com/pp112/tradingview-analyzer/blob/main/backend/app/scheduler.py): `backend/app/scheduler.py`
- [Startup updater](https://github.com/pp112/tradingview-analyzer/blob/main/backend/app/startup.py): `backend/app/startup.py`
- [Data updater](https://github.com/pp112/tradingview-analyzer/blob/main/backend/app/updater.py): `backend/app/updater.py`
- [Refresh state](https://github.com/pp112/tradingview-analyzer/blob/main/backend/storage/state_manager.py): `backend/storage/state_manager.py`
- [Signals and market API](https://github.com/pp112/tradingview-analyzer/blob/main/backend/api/api.py): `backend/api/api.py`
- [Positions API](https://github.com/pp112/tradingview-analyzer/blob/main/backend/api/api.py): `backend/api/api.py`

### Market analysis

- [Market data clients](https://github.com/pp112/tradingview-analyzer/tree/main/backend/market): `backend/market`
- [Indicator analysis](https://github.com/pp112/tradingview-analyzer/tree/main/backend/processing): `backend/processing`
- [Signal model](https://github.com/pp112/tradingview-analyzer/blob/main/backend/models/signal.py): `backend/models/signal.py`

### Trading account

- [Bybit exchange client](https://github.com/pp112/tradingview-analyzer/blob/main/backend/exchanges/bybit/client.py): `backend/exchanges/bybit/client.py`

### Web application

- [Web API client](https://github.com/pp112/tradingview-analyzer/blob/main/frontend/src/api/client.ts): `frontend/src/api/client.ts`
- [Signal requests](https://github.com/pp112/tradingview-analyzer/blob/main/frontend/src/api/signals.ts): `frontend/src/api/signals.ts`
- [Live event hook](https://github.com/pp112/tradingview-analyzer/blob/main/frontend/src/hooks/useSSE.ts): `frontend/src/hooks/useSSE.ts`
- [Signals state](https://github.com/pp112/tradingview-analyzer/blob/main/frontend/src/store/useSignalsStore.ts): `frontend/src/store/useSignalsStore.ts`
- [Signal controls](https://github.com/pp112/tradingview-analyzer/blob/main/frontend/src/features/signal-controls/SignalControls.tsx): `frontend/src/features/signal-controls/SignalControls.tsx`
- [Signal table](https://github.com/pp112/tradingview-analyzer/blob/main/frontend/src/features/signal-table/SignalTable.tsx): `frontend/src/features/signal-table/SignalTable.tsx`
- [Market movers](https://github.com/pp112/tradingview-analyzer/blob/main/frontend/src/features/movers/MoversCard.tsx): `frontend/src/features/movers/MoversCard.tsx`
- [Positions and orders](https://github.com/pp112/tradingview-analyzer/blob/main/frontend/src/features/positions-orders/PositionsOrdersCard.tsx): `frontend/src/features/positions-orders/PositionsOrdersCard.tsx`
- [Signal-link requests](https://github.com/pp112/tradingview-analyzer/blob/main/frontend/src/api/signalLinks.ts): `frontend/src/api/signalLinks.ts`
- [Signal-link hook](https://github.com/pp112/tradingview-analyzer/blob/main/frontend/src/hooks/useSignalLinks.ts): `frontend/src/hooks/useSignalLinks.ts`
- [Signal-link state](https://github.com/pp112/tradingview-analyzer/blob/main/frontend/src/store/useSignalLinksStore.ts): `frontend/src/store/useSignalLinksStore.ts`
- [Dashboard composition](https://github.com/pp112/tradingview-analyzer/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`

### Signal links

- [Signal-link routes](https://github.com/pp112/tradingview-analyzer/blob/main/backend/api/signal_links.py): `backend/api/signal_links.py`
- [Signal-link repository](https://github.com/pp112/tradingview-analyzer/blob/main/backend/signal_links/repository.py): `backend/signal_links/repository.py`
- [SQLite database](https://github.com/pp112/tradingview-analyzer/blob/main/backend/storage/database.py): `backend/storage/database.py`

### Other components

- **Dashboard user**
- **Bybit API**

## Connections

- Application lifecycle → Update scheduler: starts (evidence: `backend/app/application.py`)
- Application lifecycle → Startup updater: runs startup (evidence: `backend/app/application.py`)
- Application lifecycle → Signals and market API: serves (evidence: `backend/app/application.py`)
- Application lifecycle → SQLite database: initializes (evidence: `backend/app/application.py`)
- Update scheduler → Data updater: schedules (evidence: `backend/app/scheduler.py`)
- Startup updater → Data updater: runs (evidence: `backend/app/startup.py`)
- Startup updater → Refresh state: checks freshness (evidence: `backend/app/startup.py`)
- Data updater → Market data clients: refreshes
- Data updater → Indicator analysis: computes
- Indicator analysis → Signal model: produces
- Dashboard user → Dashboard composition: uses (evidence: `frontend/src/App.tsx`)
- Dashboard composition → Live event hook: starts live updates (evidence: `frontend/src/App.tsx`)
- Dashboard composition → Signal requests: loads initial data (evidence: `frontend/src/App.tsx`)
- Dashboard composition → Signal controls: renders (evidence: `frontend/src/App.tsx`)
- Dashboard composition → Signal table: renders (evidence: `frontend/src/App.tsx`)
- Dashboard composition → Market movers: renders (evidence: `frontend/src/App.tsx`)
- Dashboard composition → Positions and orders: renders (evidence: `frontend/src/App.tsx`)
- Live event hook → Signal requests: fetches signals (evidence: `frontend/src/hooks/useSSE.ts`)
- Live event hook → Signals state: updates (evidence: `frontend/src/hooks/useSSE.ts`)
- Signal requests → Web API client: uses (evidence: `frontend/src/api/signals.ts`)
- Web API client → Signals and market API: requests data
- Signals and market API → Signal model: serves signals
- Positions and orders → Positions API: loads account data
- Positions API → Bybit exchange client: delegates
- Bybit exchange client → Bybit API: calls (evidence: `backend/exchanges/bybit/client.py`)
- Dashboard composition → Signal-link hook: starts (evidence: `frontend/src/App.tsx`)
- Signal-link hook → Signal-link requests: loads links (evidence: `frontend/src/hooks/useSignalLinks.ts`)
- Signal-link hook → Signal-link state: updates (evidence: `frontend/src/hooks/useSignalLinks.ts`)
- Live event hook → Signal-link requests: fetches linked values (evidence: `frontend/src/hooks/useSSE.ts`)
- Live event hook → Signal-link state: updates values (evidence: `frontend/src/hooks/useSSE.ts`)
- Signal-link requests → Web API client: uses (evidence: `frontend/src/api/signalLinks.ts`)
- Signal-link requests → Signal-link routes: requests links
- Signal-link routes → Signal-link repository: uses repository (evidence: `backend/api/signal_links.py`)
- Signal-link repository → SQLite database: persists links (evidence: `backend/signal_links/repository.py`)
