shy3130
ae93849d55
b14f367 模拟盘重构新增 DELETE /api/paper/account 与 GET /api/paper/rounds,
按网关 paper:trade 前缀规则自动进入开放面, 补进快照。
115 lines
4.1 KiB
Python
115 lines
4.1 KiB
Python
"""Tier A 开放契约快照 — 开放面的任何变化必须是有意识的。
|
|
|
|
契约即承诺: /api/openapi.json?tier=a 列出的端点集合是二开方依赖的稳定面。
|
|
本测试把该集合冻结成常量 — 新增/移除/改方法都会失败, 失败者须同步更新
|
|
快照并在 PR 里说明契约变更 (对外破坏性变更需 major 版本)。
|
|
|
|
快照来源与 /api/openapi.json?tier=a 完全同源: app.openapi() 的 paths
|
|
逐 (method, path) 过 api_gateway.required_scope — 规则表是唯一源。
|
|
"""
|
|
from __future__ import annotations
|
|
|
|
import pytest
|
|
|
|
from app.services import api_gateway
|
|
|
|
# 冻结的开放面 (method + OpenAPI 路径模板), 按字母序。
|
|
# 变更此表 = 契约变更, 请在 commit message 与 changelog 中明示。
|
|
EXPECTED_OPEN_ENDPOINTS: set[str] = {
|
|
"GET /api/alerts",
|
|
"GET /api/backtest/candidates",
|
|
"POST /api/backtest/factor/batch",
|
|
"GET /api/backtest/factor/columns",
|
|
"POST /api/backtest/factor/run",
|
|
"POST /api/backtest/run",
|
|
"GET /api/backtest/status",
|
|
"POST /api/backtest/strategy/run",
|
|
"GET /api/events",
|
|
"POST /api/events/ticket",
|
|
"GET /api/ext-data",
|
|
"POST /api/ext-data/{config_id}/ingest",
|
|
"GET /api/ext-data/{config_id}/rows",
|
|
"GET /api/ext-data/{config_id}/values",
|
|
"GET /api/ext-data/schema-all",
|
|
"GET /api/ext-data/schema/{config_id}",
|
|
"GET /api/ext-data/{config_id}/dimension-intraday",
|
|
"GET /api/ext-data/{config_id}/dimension-members",
|
|
"GET /api/index/daily",
|
|
"GET /api/index/minute",
|
|
"GET /api/intraday/indices",
|
|
"GET /api/intraday/status",
|
|
"GET /api/kline/daily",
|
|
"GET /api/kline/daily/latest",
|
|
"GET /api/kline/instruments/search",
|
|
"GET /api/kline/minute",
|
|
"GET /api/kline/minute-range",
|
|
"GET /api/overview/market",
|
|
"DELETE /api/paper/account",
|
|
"GET /api/paper/account",
|
|
"POST /api/paper/account",
|
|
"GET /api/paper/accounts",
|
|
"POST /api/paper/arena/batch_create",
|
|
"POST /api/paper/auto_rules",
|
|
"DELETE /api/paper/auto_rules/{rule_id}",
|
|
"GET /api/paper/auto_rules",
|
|
"POST /api/paper/auto_rules/{rule_id}/enabled",
|
|
"GET /api/paper/compare",
|
|
"POST /api/paper/freeze",
|
|
"GET /api/paper/nav",
|
|
"POST /api/paper/orders",
|
|
"DELETE /api/paper/orders/{order_id}",
|
|
"GET /api/paper/orders",
|
|
"GET /api/paper/overview",
|
|
"GET /api/paper/positions",
|
|
"POST /api/paper/rebuild",
|
|
"GET /api/paper/rounds",
|
|
"POST /api/paper/settings",
|
|
"GET /api/paper/stats",
|
|
"GET /api/paper/trades",
|
|
"GET /api/regime/coverage",
|
|
"GET /api/regime/history",
|
|
"GET /api/regime/latest",
|
|
"GET /api/regime/mainline",
|
|
"GET /api/regime/phases",
|
|
"GET /api/regime/states",
|
|
"GET /api/screener/cached",
|
|
"GET /api/screener/limit-ladder",
|
|
"GET /api/screener/market-snapshot",
|
|
"POST /api/screener/run",
|
|
"POST /api/screener/run_all",
|
|
"POST /api/screener/run_preset",
|
|
"GET /api/screener/strategies",
|
|
"GET /api/strategies",
|
|
"GET /api/strategies/ai/status",
|
|
"GET /api/strategies/{strategy_id}",
|
|
"GET /api/strategies/{strategy_id}/source",
|
|
}
|
|
|
|
|
|
def _collect_open_endpoints() -> set[str]:
|
|
"""与 /api/openapi.json?tier=a 同源收集 (app.openapi paths 过 required_scope)。"""
|
|
from app.main import app
|
|
|
|
spec = app.openapi()
|
|
found: set[str] = set()
|
|
for path, ops in spec.get("paths", {}).items():
|
|
for method in ops:
|
|
if method in ("get", "post", "put", "delete", "patch") and api_gateway.required_scope(
|
|
method.upper(), path,
|
|
):
|
|
found.add(f"{method.upper()} {path}")
|
|
return found
|
|
|
|
|
|
def test_open_contract_snapshot():
|
|
found = _collect_open_endpoints()
|
|
added = found - EXPECTED_OPEN_ENDPOINTS
|
|
removed = EXPECTED_OPEN_ENDPOINTS - found
|
|
if added or removed:
|
|
pytest.fail(
|
|
"Tier A 开放契约发生变化 — 这是对外承诺面, 须有意识地更新快照:\n"
|
|
f" 新增: {sorted(added) or '无'}\n"
|
|
f" 移除: {sorted(removed) or '无'}\n"
|
|
"确认无误后, 同步更新本文件的 EXPECTED_OPEN_ENDPOINTS 并在 commit 中说明。",
|
|
)
|