feat: Phase 3 Web — 业务 API(stocks/factors/backtests)+ Next.js 前端

- 后端业务 API:GET /api/stocks(搜索/分页)、GET /api/factors(因子目录)、POST /api/factor-tests 与 /api/backtests(Research Spec 驱动同步执行)、GET /api/backtests/last;Annotated 依赖注入 + CORS(dev)
- Repository 批量查询 get_range_many(研究装配一次查询,避免逐只拉取)
- 前端 frontend/web:Next.js 15(TS) + ECharts —— 总览 / 股票池 / 因子研究(IC·RankIC·分层展示) / 回测(净值·回撤·月度·持仓·未建模标注)
- 前端只消费业务 API 与标准化 BacktestResult,无 Qlib/SQL 概念泄漏
- 真实数据:同步 20 只权重股 2023-2024 日线(9680 根)支撑截面研究
- 验证:API 集成测试 8 项(DTO 校验/装配/引擎/标准结果,内存 repo 全链路)+ 全量 pytest 68 passed;前端 tsc + next build 通过;无头浏览器端到端(factors/backtest 页面渲染后端数据)
- ruff clean
This commit is contained in:
Simon
2026-09-06 17:14:33 +08:00
parent e9f59d3cf8
commit 92627f5b6b
27 changed files with 1863 additions and 7 deletions
+34
View File
@@ -0,0 +1,34 @@
"""股票查询 API:/api/stocks。"""
from __future__ import annotations
from fastapi import APIRouter, HTTPException
from app.api.deps import StockRepoDep
from app.domain.entities.market import Stock
router = APIRouter(prefix="/stocks", tags=["stocks"])
@router.get("", response_model=list[Stock], summary="股票列表")
def list_stocks(
repo: StockRepoDep,
q: str | None = None,
limit: int = 50,
offset: int = 0,
) -> list[Stock]:
if limit > 500:
limit = 500
stocks = repo.list()
if q:
needle = q.upper()
stocks = [s for s in stocks if needle in s.symbol or needle in s.name.upper()]
return stocks[offset : offset + limit]
@router.get("/{symbol}", response_model=Stock, summary="按代码查询")
def get_stock(symbol: str, repo: StockRepoDep) -> Stock:
stock = repo.get_by_symbol(symbol)
if stock is None:
raise HTTPException(status_code=404, detail=f"未找到股票 {symbol}")
return stock