架構 / Architecture

總覽

平台分為 後端 (FastAPI) 與 前端 (Next.js)。後端的核心設計是一個 Broker 抽象介面, 作為「紙上交易 vs 真實交易」以及「不同市場(crypto / 台股 / 美股)」的單一接縫。 策略與 LLM 都輸出同一個 Signal 型別,因此工作流引擎可一視同仁地組合它們。

前端採兩室 IA(策略室 / 交易室)+ 左側樹狀導覽。MarketPanel 與 BacktestPanel 共用同一個即時線圖元件 PriceChart(輪詢即時、買賣點、均線疊圖);策略室 → 回測 → 工作流以 URL query 串接。詳見 frontend.md。

核心設計決策

1. Broker 抽象是唯一接縫

backend/app/brokers/base.py 定義 Broker ABC:get_ticker / get_ohlcv / create_order / get_balance / get_positions。新增市場或切換 paper/live 都只需新增子類別 + 在 registry.py 註冊,其餘程式不動。

規劃中(尚未實作,需金鑰與外網):台股 元大證券、美股 元大複委託 / Firstrade。 三者都將實作為 Broker 子類別。Firstrade 無官方 API(僅社群非官方函式庫)。

2. 策略與 AI 同型輸出

Signal(action, confidence, reason, source)。指標策略(strategies/)與 LLM 代理 (ai/signal_agent.py)都回傳 Signal,所以工作流的 strategy 與 ai_signal 節點可互換。

3. 下單路徑單一化

trading/execution.py:execute_order 是手動下單(API)與工作流下單共用的唯一路徑: 解析成交價 → 風控 RiskGuard.check → broker.create_order → 寫入 OrderRecord。

4. Fail Loud

缺資料、外部錯誤、風控違規一律明確拋錯/回報(非靜默略過),符合 CLAUDE.md。 例如行情抓取失敗回 502 NetworkError;風控違規回 422;未實作市場回 501。

工作流執行流程

資料模型(SQLite)

技術選型理由