跳轉到

Trade System 文件站

這份文件站的目標不是只告訴你「怎麼跑起來」,而是盡可能讓一個新接手的人在閱讀後,能理解這個專案的:

  • 系統邊界
  • 模組責任
  • 資料流
  • 策略與參數管理方式
  • API 使用方式
  • 資料庫結構
  • 部署限制與風險

如果你要做到「看完之後能重構出相近系統」,建議依下列順序閱讀。

建議閱讀順序

  1. 快速開始
  2. 系統架構
  3. 核心資料流
  4. 策略與參數系統
  5. Quote Adapter 與資料格式
  6. API 總覽
  7. 資料庫與持久化
  8. 部署指南

專案定位

這個專案是一套以 FastAPI 為入口的量化回測與研究平台,主功能包括:

  • 以多種資料來源抓取 OHLCV 歷史資料
  • 把資料轉為內部 DataFeed
  • 套用不同策略版本進行回測
  • 透過 broker 模擬交易與損益
  • 對回測結果做統計分析
  • 提供 API 給前端儀表板、訓練頁與最佳化頁使用

功能地圖

一般回測

  • 切換商品
  • 切換策略
  • 切換週期
  • 切換時間範圍
  • 編輯當前策略參數
  • 讀取最新回測狀態

研究與優化

  • 參數訓練區間管理
  • 多區段回測
  • 最佳化任務建立 / 執行 / 查詢進度 / 分頁看結果
  • 收藏最佳化結果

輔助資料

  • 回測歷史記錄
  • 備註系統
  • 參數匯出

目前系統的重要特性

  • 後端入口集中在 app.py
  • 策略註冊集中在 src/strategy/strategy_registry.py
  • 參數已改為依 ticker + timeframe + strategy_name 隔離
  • 文件內提到的某些舊文件與現況可能有落差,這份文件站以目前實作為準

文件站建議用途

這套文件可作為:

  • 新成員 onboarding 手冊
  • 前端串接參考
  • 後端重構前的現況盤點
  • 部署與維運手冊
  • 後續改版時的基準規格