# suwjee/tradingbot-knowledge architecture

> Architecture diagram of the GitHub repository suwjee/tradingbot-knowledge, 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-knowledge
- Repository: https://github.com/suwjee/tradingbot-knowledge

## Overview

This repository is a current-only TradingBot knowledge vault: it organizes authoritative rules and synchronized source evidence so an engineer can trace a concept through its algorithm, implementation, mirror rules, and current version. The main workflow is that evidence-tracing and validation process, not execution of the trading engine. It also contains production engine and chart-server source, which are represented as evidence-bearing subsystems. Runtime connections are limited to relationships shown in excerpts or the SOURCE INDEX; unsampled wiring is not inferred.

Main entry points: [`06_SOURCE/Code/engine/pipeline/direction_policy.py`](https://github.com/suwjee/tradingbot-knowledge/blob/main/06_SOURCE/Code/engine/pipeline/direction_policy.py) (Direction Policy), [`06_SOURCE/Code/engine/pipeline/core_utils.py`](https://github.com/suwjee/tradingbot-knowledge/blob/main/06_SOURCE/Code/engine/pipeline/core_utils.py) (Shared Primitives), [`06_SOURCE/Code/engine/pipeline/order_audit_engine.py`](https://github.com/suwjee/tradingbot-knowledge/blob/main/06_SOURCE/Code/engine/pipeline/order_audit_engine.py) (Order Audit), [`06_SOURCE/Code/engine/pipeline/e_zone_detector.py`](https://github.com/suwjee/tradingbot-knowledge/blob/main/06_SOURCE/Code/engine/pipeline/e_zone_detector.py) (E Detection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_governance["Authority &amp; Core"]
  node_authority["Authority &amp; Retrieval<br/>[AUTHORITY_MODEL.md]"]
  node_core["Core Invariants<br/>[Core-Invariants.md]"]
  node_workflow["Operating Workflow"]
  node_current["Current Version<br/>[Current.md]"]
end

subgraph group_domain["Trading Domain"]
  node_behaviors["Behavior Rules"]
  node_algorithms["Algorithm Rules"]
  node_market["Market Chronology"]
  node_mirror["Mirror Rules"]
end

subgraph group_evidence["Source Evidence"]
  node_manifest["Source Manifest<br/>[Source-Manifest.md]"]
end

subgraph group_runtime["Engine &amp; Chart Runtime"]
  node_bridge["Pipeline Bridge"]
  node_reaction["Reaction &amp; Reset<br/>[reaction_engine.py]"]
  node_order["Order Audit"]
  node_lifecycle["Lifecycle &amp; Visibility"]
  node_a_detector["A Detection<br/>[a_zone_detector.py]"]
  node_blue_detector["Blue Detection"]
  node_s_detector["S Detection<br/>[s_zone_detector.py]"]
  node_e_detector["E Detection<br/>[e_zone_detector.py]"]
  node_direction["Direction Policy"]
  node_core_utils["Shared Primitives<br/>[core_utils.py]"]
  node_chart_api["Chart Server Routes<br/>[vite.config.js]"]
  node_raw_store["RAW Resource Store"]
  node_indicator["Indicator Range Runner"]
end

subgraph group_validation["Validation &amp; Data"]
  node_validation["Validation Policies<br/>[README.md]"]
  node_raw_data[("RAW Data Store<br/>[README.md]")]
end

node_engineer(("Engineer"))

node_engineer -->|"follows"| node_workflow
node_workflow -->|"consults"| node_authority
node_behaviors -->|"resolve to"| node_algorithms
node_algorithms -->|"trace to source"| node_manifest
node_manifest -->|"trace to"| node_mirror
node_mirror -->|"resolve to"| node_current
node_core -->|"explains invariants"| node_market
node_bridge -->|"creates detector"| node_e_detector
node_bridge -->|"uses"| node_core_utils
node_bridge -->|"uses"| node_order
node_a_detector -->|"uses"| node_core_utils
node_a_detector -->|"uses"| node_direction
node_blue_detector -->|"uses"| node_direction
node_e_detector -->|"uses"| node_core_utils
node_e_detector -->|"uses"| node_direction
node_e_detector -->|"uses"| node_order
node_lifecycle -->|"uses"| node_core_utils
node_lifecycle -->|"uses"| node_order
node_lifecycle -->|"uses"| node_direction
node_order -->|"uses"| node_core_utils
node_reaction -->|"uses"| node_direction
node_s_detector -->|"uses"| node_core_utils
node_s_detector -->|"uses"| node_order
node_s_detector -->|"uses"| node_direction
node_chart_api -->|"imports"| node_raw_store
node_chart_api -->|"runs calculations"| node_indicator
node_engineer -->|"checks evidence"| node_validation
node_engineer -.->|"may supply data"| node_raw_data

click node_authority "https://github.com/suwjee/tradingbot-knowledge/blob/main/00_SYSTEM/AUTHORITY_MODEL.md"
click node_core "https://github.com/suwjee/tradingbot-knowledge/blob/main/01_CORE/Core-Invariants.md"
click node_behaviors "https://github.com/suwjee/tradingbot-knowledge/tree/main/03_BEHAVIORS"
click node_algorithms "https://github.com/suwjee/tradingbot-knowledge/tree/main/04_ALGORITHMS"
click node_market "https://github.com/suwjee/tradingbot-knowledge/tree/main/02_MARKET_MODEL"
click node_mirror "https://github.com/suwjee/tradingbot-knowledge/tree/main/05_MIRROR"
click node_workflow "https://github.com/suwjee/tradingbot-knowledge/blob/main/12_WORKFLOWS/Operating-Workflow.md"
click node_current "https://github.com/suwjee/tradingbot-knowledge/blob/main/11_VERSIONS/Current.md"
click node_manifest "https://github.com/suwjee/tradingbot-knowledge/blob/main/06_SOURCE/Source-Manifest.md"
click node_bridge "https://github.com/suwjee/tradingbot-knowledge/blob/main/06_SOURCE/Code/engine/bridge/trading_pipeline.py"
click node_reaction "https://github.com/suwjee/tradingbot-knowledge/blob/main/06_SOURCE/Code/engine/pipeline/reaction_engine.py"
click node_order "https://github.com/suwjee/tradingbot-knowledge/blob/main/06_SOURCE/Code/engine/pipeline/order_audit_engine.py"
click node_lifecycle "https://github.com/suwjee/tradingbot-knowledge/blob/main/06_SOURCE/Code/engine/pipeline/lifecycle_engine.py"
click node_a_detector "https://github.com/suwjee/tradingbot-knowledge/blob/main/06_SOURCE/Code/engine/pipeline/a_zone_detector.py"
click node_blue_detector "https://github.com/suwjee/tradingbot-knowledge/blob/main/06_SOURCE/Code/engine/pipeline/blue_line_detector.py"
click node_s_detector "https://github.com/suwjee/tradingbot-knowledge/blob/main/06_SOURCE/Code/engine/pipeline/s_zone_detector.py"
click node_e_detector "https://github.com/suwjee/tradingbot-knowledge/blob/main/06_SOURCE/Code/engine/pipeline/e_zone_detector.py"
click node_direction "https://github.com/suwjee/tradingbot-knowledge/blob/main/06_SOURCE/Code/engine/pipeline/direction_policy.py"
click node_core_utils "https://github.com/suwjee/tradingbot-knowledge/blob/main/06_SOURCE/Code/engine/pipeline/core_utils.py"
click node_chart_api "https://github.com/suwjee/tradingbot-knowledge/blob/main/06_SOURCE/Code/apps/chart/vite.config.js"
click node_raw_store "https://github.com/suwjee/tradingbot-knowledge/blob/main/06_SOURCE/Code/apps/chart/server/raw-resource-store.js"
click node_indicator "https://github.com/suwjee/tradingbot-knowledge/blob/main/06_SOURCE/Code/apps/chart/server/indicator-range-input.js"
click node_validation "https://github.com/suwjee/tradingbot-knowledge/blob/main/07_VALIDATION/README.md"
click node_raw_data "https://github.com/suwjee/tradingbot-knowledge/blob/main/08_DATA/README.md"

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_authority,node_core,node_workflow,node_current toneBlue
class node_behaviors,node_algorithms,node_market,node_mirror toneAmber
class node_manifest toneMint
class node_bridge,node_reaction,node_order,node_lifecycle,node_a_detector,node_blue_detector,node_s_detector,node_e_detector,node_direction,node_core_utils,node_chart_api,node_raw_store,node_indicator toneRose
class node_validation,node_raw_data,node_engineer toneIndigo
```

## Components

### Authority & Core

- [Authority & Retrieval](https://github.com/suwjee/tradingbot-knowledge/blob/main/00_SYSTEM/AUTHORITY_MODEL.md): `00_SYSTEM/AUTHORITY_MODEL.md`
- [Core Invariants](https://github.com/suwjee/tradingbot-knowledge/blob/main/01_CORE/Core-Invariants.md): `01_CORE/Core-Invariants.md`
- [Operating Workflow](https://github.com/suwjee/tradingbot-knowledge/blob/main/12_WORKFLOWS/Operating-Workflow.md): `12_WORKFLOWS/Operating-Workflow.md`
- [Current Version](https://github.com/suwjee/tradingbot-knowledge/blob/main/11_VERSIONS/Current.md): `11_VERSIONS/Current.md`

### Trading Domain

- [Behavior Rules](https://github.com/suwjee/tradingbot-knowledge/tree/main/03_BEHAVIORS): `03_BEHAVIORS`
- [Algorithm Rules](https://github.com/suwjee/tradingbot-knowledge/tree/main/04_ALGORITHMS): `04_ALGORITHMS`
- [Market Chronology](https://github.com/suwjee/tradingbot-knowledge/tree/main/02_MARKET_MODEL): `02_MARKET_MODEL`
- [Mirror Rules](https://github.com/suwjee/tradingbot-knowledge/tree/main/05_MIRROR): `05_MIRROR`

### Source Evidence

- [Source Manifest](https://github.com/suwjee/tradingbot-knowledge/blob/main/06_SOURCE/Source-Manifest.md): `06_SOURCE/Source-Manifest.md`

### Engine & Chart Runtime

- [Pipeline Bridge](https://github.com/suwjee/tradingbot-knowledge/blob/main/06_SOURCE/Code/engine/bridge/trading_pipeline.py): `06_SOURCE/Code/engine/bridge/trading_pipeline.py`
- [Reaction & Reset](https://github.com/suwjee/tradingbot-knowledge/blob/main/06_SOURCE/Code/engine/pipeline/reaction_engine.py): `06_SOURCE/Code/engine/pipeline/reaction_engine.py`
- [Order Audit](https://github.com/suwjee/tradingbot-knowledge/blob/main/06_SOURCE/Code/engine/pipeline/order_audit_engine.py): `06_SOURCE/Code/engine/pipeline/order_audit_engine.py`
- [Lifecycle & Visibility](https://github.com/suwjee/tradingbot-knowledge/blob/main/06_SOURCE/Code/engine/pipeline/lifecycle_engine.py): `06_SOURCE/Code/engine/pipeline/lifecycle_engine.py`
- [A Detection](https://github.com/suwjee/tradingbot-knowledge/blob/main/06_SOURCE/Code/engine/pipeline/a_zone_detector.py): `06_SOURCE/Code/engine/pipeline/a_zone_detector.py`
- [Blue Detection](https://github.com/suwjee/tradingbot-knowledge/blob/main/06_SOURCE/Code/engine/pipeline/blue_line_detector.py): `06_SOURCE/Code/engine/pipeline/blue_line_detector.py`
- [S Detection](https://github.com/suwjee/tradingbot-knowledge/blob/main/06_SOURCE/Code/engine/pipeline/s_zone_detector.py): `06_SOURCE/Code/engine/pipeline/s_zone_detector.py`
- [E Detection](https://github.com/suwjee/tradingbot-knowledge/blob/main/06_SOURCE/Code/engine/pipeline/e_zone_detector.py): `06_SOURCE/Code/engine/pipeline/e_zone_detector.py`
- [Direction Policy](https://github.com/suwjee/tradingbot-knowledge/blob/main/06_SOURCE/Code/engine/pipeline/direction_policy.py): `06_SOURCE/Code/engine/pipeline/direction_policy.py`
- [Shared Primitives](https://github.com/suwjee/tradingbot-knowledge/blob/main/06_SOURCE/Code/engine/pipeline/core_utils.py): `06_SOURCE/Code/engine/pipeline/core_utils.py`
- [Chart Server Routes](https://github.com/suwjee/tradingbot-knowledge/blob/main/06_SOURCE/Code/apps/chart/vite.config.js): `06_SOURCE/Code/apps/chart/vite.config.js`
- [RAW Resource Store](https://github.com/suwjee/tradingbot-knowledge/blob/main/06_SOURCE/Code/apps/chart/server/raw-resource-store.js): `06_SOURCE/Code/apps/chart/server/raw-resource-store.js`
- [Indicator Range Runner](https://github.com/suwjee/tradingbot-knowledge/blob/main/06_SOURCE/Code/apps/chart/server/indicator-range-input.js): `06_SOURCE/Code/apps/chart/server/indicator-range-input.js`

### Validation & Data

- [Validation Policies](https://github.com/suwjee/tradingbot-knowledge/blob/main/07_VALIDATION/README.md): `07_VALIDATION/README.md`
- [RAW Data Store](https://github.com/suwjee/tradingbot-knowledge/blob/main/08_DATA/README.md): `08_DATA/README.md`

### Other components

- **Engineer**

## Connections

- Engineer → Operating Workflow: follows (evidence: `README.md`)
- Operating Workflow → Authority & Retrieval: consults (evidence: `README.md`)
- Behavior Rules → Algorithm Rules: resolve to (evidence: `README.md`)
- Algorithm Rules → Source Manifest: trace to source (evidence: `README.md`)
- Source Manifest → Mirror Rules: trace to (evidence: `README.md`)
- Mirror Rules → Current Version: resolve to (evidence: `README.md`)
- Core Invariants → Market Chronology: explains invariants (evidence: `README.md`)
- Pipeline Bridge → E Detection: creates detector (evidence: `06_SOURCE/Code/engine/bridge/trading_pipeline.py`)
- Pipeline Bridge → Shared Primitives: uses (evidence: `06_SOURCE/Code/engine/bridge/trading_pipeline.py`)
- Pipeline Bridge → Order Audit: uses (evidence: `06_SOURCE/Code/engine/bridge/trading_pipeline.py`)
- A Detection → Shared Primitives: uses (evidence: `06_SOURCE/Code/engine/pipeline/a_zone_detector.py`)
- A Detection → Direction Policy: uses (evidence: `06_SOURCE/Code/engine/pipeline/a_zone_detector.py`)
- Blue Detection → Direction Policy: uses (evidence: `06_SOURCE/Code/engine/pipeline/blue_line_detector.py`)
- E Detection → Shared Primitives: uses (evidence: `06_SOURCE/Code/engine/pipeline/e_zone_detector.py`)
- E Detection → Direction Policy: uses (evidence: `06_SOURCE/Code/engine/pipeline/e_zone_detector.py`)
- E Detection → Order Audit: uses (evidence: `06_SOURCE/Code/engine/pipeline/e_zone_detector.py`)
- Lifecycle & Visibility → Shared Primitives: uses (evidence: `06_SOURCE/Code/engine/pipeline/lifecycle_engine.py`)
- Lifecycle & Visibility → Order Audit: uses (evidence: `06_SOURCE/Code/engine/pipeline/lifecycle_engine.py`)
- Lifecycle & Visibility → Direction Policy: uses (evidence: `06_SOURCE/Code/engine/pipeline/lifecycle_engine.py`)
- Order Audit → Shared Primitives: uses (evidence: `06_SOURCE/Code/engine/pipeline/order_audit_engine.py`)
- Reaction & Reset → Direction Policy: uses (evidence: `06_SOURCE/Code/engine/pipeline/reaction_engine.py`)
- S Detection → Shared Primitives: uses (evidence: `06_SOURCE/Code/engine/pipeline/s_zone_detector.py`)
- S Detection → Order Audit: uses (evidence: `06_SOURCE/Code/engine/pipeline/s_zone_detector.py`)
- S Detection → Direction Policy: uses (evidence: `06_SOURCE/Code/engine/pipeline/s_zone_detector.py`)
- Chart Server Routes → RAW Resource Store: imports (evidence: `06_SOURCE/Code/apps/chart/vite.config.js`)
- Chart Server Routes → Indicator Range Runner: runs calculations (evidence: `06_SOURCE/Code/apps/chart/vite.config.js`)
- Engineer → Validation Policies: checks evidence (evidence: `README.md`)
- Engineer → RAW Data Store: may supply data (evidence: `README.md`)
