# suwjee/tradingbot architecture

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

- Interactive diagram: https://gitdiagram.com/suwjee/tradingbot
- Repository: https://github.com/suwjee/tradingbot

## Overview

TradingBot is a Windows candlestick workstation: users acquire or load candle data, inspect it in chart and FARAZ workspaces, apply indicators and drawings, and review serialized trading-analysis results. The browser owns interaction and presentation; the Python engine owns trading calculations. The README documents candle display, drawings, indicators and review tables, while source excerpts show the chart entry point, FARAZ API, algorithm reference view and engine bridge. Some engine-stage connections and browser/server routing are not visible in the excerpts, so those links are omitted or marked unverified.

Main entry points: [`engine/bridge/trading_pipeline.py`](https://github.com/suwjee/tradingbot/blob/main/engine/bridge/trading_pipeline.py) (Pipeline Bridge), [`apps/chart/src/main.js`](https://github.com/suwjee/tradingbot/blob/main/apps/chart/src/main.js) (Chart Application), [`apps/chart/server/faraz-candle-api.js`](https://github.com/suwjee/tradingbot/blob/main/apps/chart/server/faraz-candle-api.js) (FARAZ Candle API), [`engine/pipeline/lifecycle_engine.py`](https://github.com/suwjee/tradingbot/blob/main/engine/pipeline/lifecycle_engine.py) (Behavior Lifecycle)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_chart["Chart Workstation"]
  node_main["Chart Application<br/>[main.js]"]
  node_workspace["Workspace State"]
  node_chartstate["Chart State<br/>[state.js]"]
  node_drawing["Drawing Tools<br/>[drawing-math.js]"]
  node_indicators["Indicator Lifecycle"]
end

subgraph group_data["Candle Data"]
  node_export["Candle Export<br/>[candle-export.js]"]
  node_updater["Candle Updates<br/>[candle-update.js]"]
  node_faraz["FARAZ Candle API"]
  node_localpaths["Local State Paths"]
  node_rawstore[("RAW Resource Store")]
  node_rawcontract["RAW File Contract"]
end

subgraph group_analysis["Analysis and Review"]
  node_algorithm["Algorithm Reference<br/>[page.js]"]
  node_algorithmcontent["Calculation Guides"]
  node_manualreview["Manual Review<br/>[render.js]"]
end

subgraph group_engine["Trading Engine"]
  node_bridge["Pipeline Bridge"]
  node_reaction["Reaction Detection<br/>[reaction_engine.py]"]
  node_orderaudit["Order Audit"]
  node_lifecycle["Behavior Lifecycle"]
  node_ezone["E-Zone Detection<br/>[e_zone_detector.py]"]
  node_szone["S-Zone Detection<br/>[s_zone_detector.py]"]
  node_azone["A-Zone Detection<br/>[a_zone_detector.py]"]
  node_blue["Blue-Line Detection"]
  node_coreutils["Shared Primitives<br/>[core_utils.py]"]
  node_direction["Direction Policy"]
end

node_user(("Workstation User"))

node_user -->|"uses"| node_main
node_main -->|"resolves state"| node_workspace
node_main -->|"restores state"| node_chartstate
node_main -->|"opens export"| node_export
node_main -->|"updates candles"| node_updater
node_main -->|"opens workspace"| node_algorithm
node_main -->|"restores lifecycle"| node_indicators
node_main -->|"resolves points"| node_drawing
node_algorithm -->|"renders guides"| node_algorithmcontent
node_export -->|"parses metadata"| node_rawcontract
node_faraz -->|"resolves storage"| node_localpaths
node_faraz -->|"creates store"| node_rawstore
node_faraz -->|"parses filenames"| node_rawcontract
node_rawstore -->|"uses contract"| node_rawcontract
node_main -.->|"requests candles"| node_faraz
node_bridge -->|"uses primitives"| node_coreutils
node_bridge -->|"uses audit"| node_orderaudit
node_ezone -->|"uses primitives"| node_coreutils
node_ezone -->|"uses policy"| node_direction
node_ezone -->|"uses audit"| node_orderaudit
node_szone -->|"uses primitives"| node_coreutils
node_szone -->|"uses policy"| node_direction
node_szone -->|"uses audit"| node_orderaudit
node_lifecycle -->|"uses primitives"| node_coreutils
node_lifecycle -->|"uses policy"| node_direction
node_lifecycle -->|"uses audit"| node_orderaudit
node_reaction -->|"uses policy"| node_direction
node_bridge -.->|"coordinates stage"| node_reaction
node_bridge -.->|"coordinates stage"| node_lifecycle
node_bridge -.->|"coordinates stage"| node_ezone
node_bridge -.->|"coordinates stage"| node_szone
node_bridge -.->|"coordinates stage"| node_azone
node_bridge -.->|"coordinates stage"| node_blue
node_bridge -.->|"supplies results"| node_manualreview

click node_main "https://github.com/suwjee/tradingbot/blob/main/apps/chart/src/main.js"
click node_workspace "https://github.com/suwjee/tradingbot/blob/main/apps/chart/src/features/workspace-session.js"
click node_chartstate "https://github.com/suwjee/tradingbot/blob/main/apps/chart/src/chart/state.js"
click node_drawing "https://github.com/suwjee/tradingbot/blob/main/apps/chart/src/drawings/drawing-math.js"
click node_indicators "https://github.com/suwjee/tradingbot/blob/main/apps/chart/src/features/indicator-lifecycle.js"
click node_export "https://github.com/suwjee/tradingbot/blob/main/apps/chart/src/features/candle-export.js"
click node_updater "https://github.com/suwjee/tradingbot/blob/main/apps/chart/src/features/candle-update.js"
click node_faraz "https://github.com/suwjee/tradingbot/blob/main/apps/chart/server/faraz-candle-api.js"
click node_localpaths "https://github.com/suwjee/tradingbot/blob/main/apps/chart/server/local-state-paths.js"
click node_rawstore "https://github.com/suwjee/tradingbot/blob/main/apps/chart/server/raw-resource-store.js"
click node_rawcontract "https://github.com/suwjee/tradingbot/blob/main/apps/chart/src/features/raw-file-contract.js"
click node_algorithm "https://github.com/suwjee/tradingbot/blob/main/apps/chart/src/algorithm/page.js"
click node_algorithmcontent "https://github.com/suwjee/tradingbot/blob/main/apps/chart/src/algorithm/content/calculation-guides.js"
click node_manualreview "https://github.com/suwjee/tradingbot/blob/main/apps/chart/src/features/manual-review/render.js"
click node_bridge "https://github.com/suwjee/tradingbot/blob/main/engine/bridge/trading_pipeline.py"
click node_reaction "https://github.com/suwjee/tradingbot/blob/main/engine/pipeline/reaction_engine.py"
click node_orderaudit "https://github.com/suwjee/tradingbot/blob/main/engine/pipeline/order_audit_engine.py"
click node_lifecycle "https://github.com/suwjee/tradingbot/blob/main/engine/pipeline/lifecycle_engine.py"
click node_ezone "https://github.com/suwjee/tradingbot/blob/main/engine/pipeline/e_zone_detector.py"
click node_szone "https://github.com/suwjee/tradingbot/blob/main/engine/pipeline/s_zone_detector.py"
click node_azone "https://github.com/suwjee/tradingbot/blob/main/engine/pipeline/a_zone_detector.py"
click node_blue "https://github.com/suwjee/tradingbot/blob/main/engine/pipeline/blue_line_detector.py"
click node_coreutils "https://github.com/suwjee/tradingbot/blob/main/engine/pipeline/core_utils.py"
click node_direction "https://github.com/suwjee/tradingbot/blob/main/engine/pipeline/direction_policy.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_main,node_workspace,node_chartstate,node_drawing,node_indicators,node_user toneBlue
class node_export,node_updater,node_faraz,node_localpaths,node_rawstore,node_rawcontract toneAmber
class node_algorithm,node_algorithmcontent,node_manualreview toneMint
class node_bridge,node_reaction,node_orderaudit,node_lifecycle,node_ezone,node_szone,node_azone,node_blue,node_coreutils,node_direction toneRose
```

## Components

### Chart Workstation

- [Chart Application](https://github.com/suwjee/tradingbot/blob/main/apps/chart/src/main.js): `apps/chart/src/main.js`
- [Workspace State](https://github.com/suwjee/tradingbot/blob/main/apps/chart/src/features/workspace-session.js): `apps/chart/src/features/workspace-session.js`
- [Chart State](https://github.com/suwjee/tradingbot/blob/main/apps/chart/src/chart/state.js): `apps/chart/src/chart/state.js`
- [Drawing Tools](https://github.com/suwjee/tradingbot/blob/main/apps/chart/src/drawings/drawing-math.js): `apps/chart/src/drawings/drawing-math.js`
- [Indicator Lifecycle](https://github.com/suwjee/tradingbot/blob/main/apps/chart/src/features/indicator-lifecycle.js): `apps/chart/src/features/indicator-lifecycle.js`

### Candle Data

- [Candle Export](https://github.com/suwjee/tradingbot/blob/main/apps/chart/src/features/candle-export.js): `apps/chart/src/features/candle-export.js`
- [Candle Updates](https://github.com/suwjee/tradingbot/blob/main/apps/chart/src/features/candle-update.js): `apps/chart/src/features/candle-update.js`
- [FARAZ Candle API](https://github.com/suwjee/tradingbot/blob/main/apps/chart/server/faraz-candle-api.js): `apps/chart/server/faraz-candle-api.js`
- [Local State Paths](https://github.com/suwjee/tradingbot/blob/main/apps/chart/server/local-state-paths.js): `apps/chart/server/local-state-paths.js`
- [RAW Resource Store](https://github.com/suwjee/tradingbot/blob/main/apps/chart/server/raw-resource-store.js): `apps/chart/server/raw-resource-store.js`
- [RAW File Contract](https://github.com/suwjee/tradingbot/blob/main/apps/chart/src/features/raw-file-contract.js): `apps/chart/src/features/raw-file-contract.js`

### Analysis and Review

- [Algorithm Reference](https://github.com/suwjee/tradingbot/blob/main/apps/chart/src/algorithm/page.js): `apps/chart/src/algorithm/page.js`
- [Calculation Guides](https://github.com/suwjee/tradingbot/blob/main/apps/chart/src/algorithm/content/calculation-guides.js): `apps/chart/src/algorithm/content/calculation-guides.js`
- [Manual Review](https://github.com/suwjee/tradingbot/blob/main/apps/chart/src/features/manual-review/render.js): `apps/chart/src/features/manual-review/render.js`

### Trading Engine

- [Pipeline Bridge](https://github.com/suwjee/tradingbot/blob/main/engine/bridge/trading_pipeline.py): `engine/bridge/trading_pipeline.py`
- [Reaction Detection](https://github.com/suwjee/tradingbot/blob/main/engine/pipeline/reaction_engine.py): `engine/pipeline/reaction_engine.py`
- [Order Audit](https://github.com/suwjee/tradingbot/blob/main/engine/pipeline/order_audit_engine.py): `engine/pipeline/order_audit_engine.py`
- [Behavior Lifecycle](https://github.com/suwjee/tradingbot/blob/main/engine/pipeline/lifecycle_engine.py): `engine/pipeline/lifecycle_engine.py`
- [E-Zone Detection](https://github.com/suwjee/tradingbot/blob/main/engine/pipeline/e_zone_detector.py): `engine/pipeline/e_zone_detector.py`
- [S-Zone Detection](https://github.com/suwjee/tradingbot/blob/main/engine/pipeline/s_zone_detector.py): `engine/pipeline/s_zone_detector.py`
- [A-Zone Detection](https://github.com/suwjee/tradingbot/blob/main/engine/pipeline/a_zone_detector.py): `engine/pipeline/a_zone_detector.py`
- [Blue-Line Detection](https://github.com/suwjee/tradingbot/blob/main/engine/pipeline/blue_line_detector.py): `engine/pipeline/blue_line_detector.py`
- [Shared Primitives](https://github.com/suwjee/tradingbot/blob/main/engine/pipeline/core_utils.py): `engine/pipeline/core_utils.py`
- [Direction Policy](https://github.com/suwjee/tradingbot/blob/main/engine/pipeline/direction_policy.py): `engine/pipeline/direction_policy.py`

### Other components

- **Workstation User**

## Connections

- Workstation User → Chart Application: uses (evidence: `README.md`)
- Chart Application → Workspace State: resolves state (evidence: `apps/chart/src/main.js`)
- Chart Application → Chart State: restores state (evidence: `apps/chart/src/main.js`)
- Chart Application → Candle Export: opens export (evidence: `apps/chart/src/main.js`)
- Chart Application → Candle Updates: updates candles (evidence: `apps/chart/src/main.js`)
- Chart Application → Algorithm Reference: opens workspace (evidence: `apps/chart/src/main.js`)
- Chart Application → Indicator Lifecycle: restores lifecycle (evidence: `apps/chart/src/main.js`)
- Chart Application → Drawing Tools: resolves points (evidence: `apps/chart/src/main.js`)
- Algorithm Reference → Calculation Guides: renders guides (evidence: `apps/chart/src/algorithm/page.js`)
- Candle Export → RAW File Contract: parses metadata (evidence: `apps/chart/src/features/candle-export.js`)
- FARAZ Candle API → Local State Paths: resolves storage (evidence: `apps/chart/server/faraz-candle-api.js`)
- FARAZ Candle API → RAW Resource Store: creates store (evidence: `apps/chart/server/faraz-candle-api.js`)
- FARAZ Candle API → RAW File Contract: parses filenames (evidence: `apps/chart/server/faraz-candle-api.js`)
- RAW Resource Store → RAW File Contract: uses contract (evidence: `apps/chart/server/raw-resource-store.js`)
- Chart Application → FARAZ Candle API: requests candles
- Pipeline Bridge → Shared Primitives: uses primitives (evidence: `engine/bridge/trading_pipeline.py`)
- Pipeline Bridge → Order Audit: uses audit (evidence: `engine/bridge/trading_pipeline.py`)
- E-Zone Detection → Shared Primitives: uses primitives (evidence: `engine/pipeline/e_zone_detector.py`)
- E-Zone Detection → Direction Policy: uses policy (evidence: `engine/pipeline/e_zone_detector.py`)
- E-Zone Detection → Order Audit: uses audit (evidence: `engine/pipeline/e_zone_detector.py`)
- S-Zone Detection → Shared Primitives: uses primitives (evidence: `engine/pipeline/s_zone_detector.py`)
- S-Zone Detection → Direction Policy: uses policy (evidence: `engine/pipeline/s_zone_detector.py`)
- S-Zone Detection → Order Audit: uses audit (evidence: `engine/pipeline/s_zone_detector.py`)
- Behavior Lifecycle → Shared Primitives: uses primitives (evidence: `engine/pipeline/lifecycle_engine.py`)
- Behavior Lifecycle → Direction Policy: uses policy (evidence: `engine/pipeline/lifecycle_engine.py`)
- Behavior Lifecycle → Order Audit: uses audit (evidence: `engine/pipeline/lifecycle_engine.py`)
- Reaction Detection → Direction Policy: uses policy (evidence: `engine/pipeline/reaction_engine.py`)
- Pipeline Bridge → Reaction Detection: coordinates stage
- Pipeline Bridge → Behavior Lifecycle: coordinates stage
- Pipeline Bridge → E-Zone Detection: coordinates stage
- Pipeline Bridge → S-Zone Detection: coordinates stage
- Pipeline Bridge → A-Zone Detection: coordinates stage
- Pipeline Bridge → Blue-Line Detection: coordinates stage
- Pipeline Bridge → Manual Review: supplies results
