- 后端业务 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
35 lines
982 B
Python
35 lines
982 B
Python
"""股票查询 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
|