# gobi1990/trading-signal-terminal-claude architecture

> Architecture diagram of the GitHub repository gobi1990/trading-signal-terminal-claude, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/gobi1990/trading-signal-terminal-claude
- Repository: https://github.com/gobi1990/trading-signal-terminal-claude

## Overview

Trading Signal Terminal is a Streamlit market-data and planning dashboard, not a brokerage or order-execution system. A user selects a symbol, or pastes holdings / selects a market mover; the app fetches price data, computes indicators and FVGs, then presents strategy consensus, a strict gated entry checklist, charts and a risk plan. Portfolio analysis reuses the symbol-analysis flow, while the curated screener supplies symbols for that same flow. Source excerpts are partial; links reflect the README and sampled code, and uncertain internal wiring is omitted.

Main entry points: [`app.py`](https://github.com/gobi1990/trading-signal-terminal-claude/blob/main/app.py) (Symbol Analysis), [`data_feed.py`](https://github.com/gobi1990/trading-signal-terminal-claude/blob/main/data_feed.py) (Market Data), [`risk_management.py`](https://github.com/gobi1990/trading-signal-terminal-claude/blob/main/risk_management.py) (Risk Plan), [`market_movers.py`](https://github.com/gobi1990/trading-signal-terminal-claude/blob/main/market_movers.py) (Mover Screener)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Dashboard"]
  node_live["Live Signals<br/>[app.py]"]
  node_portfolio_view["Portfolio Tab<br/>[app.py]"]
  node_movers_view["Movers Tab<br/>[app.py]"]
end

subgraph group_analysis["Signal Analysis"]
  node_symbol_analysis["Symbol Analysis<br/>[app.py]"]
  node_market_data["Market Data<br/>[data_feed.py]"]
  node_technical_indicators["Technical Indicators<br/>[indicators.py]"]
  node_fvg["FVG Detection<br/>[fvg.py]"]
  node_strategies["Strategy Consensus<br/>[strategies.py]"]
  node_gated_pipeline["Gated Entry Pipeline<br/>[strategies.py]"]
  node_fundamentals["Stock Fundamentals<br/>[data_feed.py]"]
end

subgraph group_risk["Risk Planning"]
  node_risk_plan["Risk Plan<br/>[risk_management.py]"]
  node_trade_plan["Trade Guidance<br/>[strategies.py]"]
end

subgraph group_discovery["Portfolio &amp; Discovery"]
  node_holdings_parser["Holdings Parser<br/>[portfolio.py]"]
  node_mover_screener["Mover Screener<br/>[market_movers.py]"]
end

node_user(("Trader"))
node_yahoo(("Yahoo Finance"))
node_binance(("Binance"))

node_user -->|"select symbol"| node_live
node_user -->|"paste holdings"| node_portfolio_view
node_user -->|"browse movers"| node_movers_view
node_live -->|"request analysis"| node_symbol_analysis
node_portfolio_view -->|"parse holdings"| node_holdings_parser
node_portfolio_view -->|"analyze positions"| node_symbol_analysis
node_movers_view -->|"rank universe"| node_mover_screener
node_mover_screener -->|"fetch quotes"| node_yahoo
node_movers_view -->|"analyze selection"| node_symbol_analysis
node_symbol_analysis -->|"fetch OHLCV"| node_market_data
node_market_data -->|"fetch stocks"| node_yahoo
node_market_data -->|"fetch crypto"| node_binance
node_symbol_analysis -->|"compute indicators"| node_technical_indicators
node_symbol_analysis -->|"detect gaps"| node_fvg
node_symbol_analysis -->|"score signals"| node_strategies
node_symbol_analysis -->|"check entry gates"| node_gated_pipeline
node_symbol_analysis -->|"build risk plan"| node_risk_plan
node_symbol_analysis -->|"build guidance"| node_trade_plan
node_risk_plan -->|"calculate ATR"| node_technical_indicators
node_symbol_analysis -->|"load fundamentals"| node_fundamentals
node_fundamentals -->|"fetch company data"| node_yahoo

click node_live "https://github.com/gobi1990/trading-signal-terminal-claude/blob/main/app.py"
click node_portfolio_view "https://github.com/gobi1990/trading-signal-terminal-claude/blob/main/app.py"
click node_movers_view "https://github.com/gobi1990/trading-signal-terminal-claude/blob/main/app.py"
click node_symbol_analysis "https://github.com/gobi1990/trading-signal-terminal-claude/blob/main/app.py"
click node_market_data "https://github.com/gobi1990/trading-signal-terminal-claude/blob/main/data_feed.py"
click node_technical_indicators "https://github.com/gobi1990/trading-signal-terminal-claude/blob/main/indicators.py"
click node_fvg "https://github.com/gobi1990/trading-signal-terminal-claude/blob/main/fvg.py"
click node_strategies "https://github.com/gobi1990/trading-signal-terminal-claude/blob/main/strategies.py"
click node_gated_pipeline "https://github.com/gobi1990/trading-signal-terminal-claude/blob/main/strategies.py"
click node_risk_plan "https://github.com/gobi1990/trading-signal-terminal-claude/blob/main/risk_management.py"
click node_trade_plan "https://github.com/gobi1990/trading-signal-terminal-claude/blob/main/strategies.py"
click node_holdings_parser "https://github.com/gobi1990/trading-signal-terminal-claude/blob/main/portfolio.py"
click node_mover_screener "https://github.com/gobi1990/trading-signal-terminal-claude/blob/main/market_movers.py"
click node_fundamentals "https://github.com/gobi1990/trading-signal-terminal-claude/blob/main/data_feed.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_live,node_portfolio_view,node_movers_view toneBlue
class node_symbol_analysis,node_market_data,node_technical_indicators,node_fvg,node_strategies,node_gated_pipeline,node_fundamentals toneAmber
class node_risk_plan,node_trade_plan toneMint
class node_holdings_parser,node_mover_screener toneRose
class node_user,node_yahoo,node_binance toneIndigo
```

## Components

### Dashboard

- [Live Signals](https://github.com/gobi1990/trading-signal-terminal-claude/blob/main/app.py): `app.py`
- [Portfolio Tab](https://github.com/gobi1990/trading-signal-terminal-claude/blob/main/app.py): `app.py`
- [Movers Tab](https://github.com/gobi1990/trading-signal-terminal-claude/blob/main/app.py): `app.py`

### Signal Analysis

- [Symbol Analysis](https://github.com/gobi1990/trading-signal-terminal-claude/blob/main/app.py): `app.py`
- [Market Data](https://github.com/gobi1990/trading-signal-terminal-claude/blob/main/data_feed.py): `data_feed.py`
- [Technical Indicators](https://github.com/gobi1990/trading-signal-terminal-claude/blob/main/indicators.py): `indicators.py`
- [FVG Detection](https://github.com/gobi1990/trading-signal-terminal-claude/blob/main/fvg.py): `fvg.py`
- [Strategy Consensus](https://github.com/gobi1990/trading-signal-terminal-claude/blob/main/strategies.py): `strategies.py`
- [Gated Entry Pipeline](https://github.com/gobi1990/trading-signal-terminal-claude/blob/main/strategies.py): `strategies.py`
- [Stock Fundamentals](https://github.com/gobi1990/trading-signal-terminal-claude/blob/main/data_feed.py): `data_feed.py`

### Risk Planning

- [Risk Plan](https://github.com/gobi1990/trading-signal-terminal-claude/blob/main/risk_management.py): `risk_management.py`
- [Trade Guidance](https://github.com/gobi1990/trading-signal-terminal-claude/blob/main/strategies.py): `strategies.py`

### Portfolio & Discovery

- [Holdings Parser](https://github.com/gobi1990/trading-signal-terminal-claude/blob/main/portfolio.py): `portfolio.py`
- [Mover Screener](https://github.com/gobi1990/trading-signal-terminal-claude/blob/main/market_movers.py): `market_movers.py`

### Other components

- **Trader**
- **Yahoo Finance**
- **Binance**

## Connections

- Trader → Live Signals: select symbol
- Trader → Portfolio Tab: paste holdings
- Trader → Movers Tab: browse movers
- Live Signals → Symbol Analysis: request analysis
- Portfolio Tab → Holdings Parser: parse holdings
- Portfolio Tab → Symbol Analysis: analyze positions
- Movers Tab → Mover Screener: rank universe
- Mover Screener → Yahoo Finance: fetch quotes
- Movers Tab → Symbol Analysis: analyze selection
- Symbol Analysis → Market Data: fetch OHLCV
- Market Data → Yahoo Finance: fetch stocks
- Market Data → Binance: fetch crypto
- Symbol Analysis → Technical Indicators: compute indicators
- Symbol Analysis → FVG Detection: detect gaps
- Symbol Analysis → Strategy Consensus: score signals
- Symbol Analysis → Gated Entry Pipeline: check entry gates
- Symbol Analysis → Risk Plan: build risk plan
- Symbol Analysis → Trade Guidance: build guidance
- Risk Plan → Technical Indicators: calculate ATR
- Symbol Analysis → Stock Fundamentals: load fundamentals
- Stock Fundamentals → Yahoo Finance: fetch company data
