mirror of
https://github.com/shy3130/tick-stock-panel.git
synced 2026-11-02 10:26:13 +00:00
shy3130
e71ca39b25
- 导出: 策略设置「导出策略包」(.zip), 按依赖闭包打包策略源码 + 引用的自定义信号/因子定义 + 用户调参; 叠加策略递归展开子策略与 overrides
- StrategyDef 增 scoring_columns, meta.scoring / module SCORING 引用列进入闭包
- 导入: 策略池「导入策略」同时接受 .py 与 .zip; 条目路径与配置备份白名单形态一致, 复用 apply_archive 安全校验/导入即冒烟/热重载; 包外路径 400 拒绝; 缺失依赖预览黄色预警
- API: GET /api/strategies/{id}/bundle, POST /api/strategies/bundle/inspect|apply
- engine.py 同时携带 #517 的 expected_generation 读 attempts 1→2 (服务级重试见后续 fix 提交)
118 lines
4.3 KiB
Python
118 lines
4.3 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}/series",
|
|
"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",
|
|
# 策略包导出 (bundle): 与 /source 同敏感级, 同为开放层
|
|
"GET /api/strategies/{strategy_id}/bundle",
|
|
}
|
|
|
|
|
|
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 中说明。",
|
|
)
|