feat(backend): 字段库(condition_field)+ 因子参数化(模板/受控参数)+ 单位换算底座
字段库(本次新增的表与接口): - `condition_field` 表 + `/api/condition-fields`:中文名/说明可编辑、可停用; `kind`/单位阶梯/`base_unit` 由代码注册表收敛(改类型 422,伪字段 422, 越界单位 422),停用的字段不再进条件下拉,但既有策略仍按名字解析。 - 说明书里的数值条件按字段注册表补**基准单位**后缀(字段间比较不加,不猜单位)。 因子参数化(键即身份,冻结口径): - 模板 + 参数注册表(`quant/factors.py`):`ParamSpec`(类型/范围/枚举/默认值/说明)+ `FactorTemplate`(公式/依赖列/参数);规范键把**全部**参数写进名字,如 `momentum(window=90,direction=lower_is_better)`,所以改参数 = 新建一个身份, 旧因子/既有策略/已归档实验都不变义;`momentum(window=90)`(缺参数)明确拒绝 —— 缺项要靠模板默认值补齐,而默认值是可改的代码细节,一旦改动会追溯性改义。 - 参数只在受控范围内取值(窗口 2~500、方向二选一),越界/未知模板/多给参数一律 422 并列出允许范围,不静默截断、不悄悄取默认值;内置实例的启用开关由代码决定(422)。 - `/api/factors` 暴露 `template`/`params`/`param_specs`/`label`/`source`/`enabled`/ `resolvable`;新增 `/api/factors/templates`、`POST /api/factors`、`PATCH /api/factors`; `get_factor = resolve_factor` 兼容全部旧调用点,参数化键也是一等条件字段。 - 迁移链:c5d6(存量策略陈旧说明重算)→ d6e7(condition_field)→ a7c1 (factor_definition.enabled + name varchar(128))。 测试:新增 test_condition_fields.py / test_factor_params.py;全量 pytest 500 passed。
This commit is contained in:
@@ -207,6 +207,7 @@ def condition_needed_columns(query) -> set[str]:
|
||||
except FactorError:
|
||||
raise ValueError(
|
||||
f"条件字段未知:{f}(可用: 行情列/ma20/ma60/已注册因子/"
|
||||
"参数化因子键(如 momentum(window=90,direction=higher_is_better))/"
|
||||
"每日指标列(dv_ratio 等)/static.*/fundamental.*)"
|
||||
) from None
|
||||
needed.update(defn.requires)
|
||||
@@ -390,7 +391,13 @@ def _field_value(field, sym, statics, tech, financial):
|
||||
|
||||
|
||||
def _compare(left, right, op: str) -> bool:
|
||||
"""混合比较:None 视为不可用 → 除 ne 外不通过;数值/字符串分别处理。"""
|
||||
"""混合比较:None 视为不可用 → 除 ne 外不通过;数值/字符串分别处理。
|
||||
|
||||
任何类型不匹配(拿日期字段去比大小、in 的右侧不是列表…)一律返回 False,
|
||||
**绝不抛异常**:条件是用户可以随手改的输入,一个手滑的字段名不该把选股/回测
|
||||
打成 500。字段库(quant.condition_fields)会在源头上拒绝不可比较的字段,
|
||||
这里只是最后一道防线。
|
||||
"""
|
||||
if op == "ne":
|
||||
return left != right
|
||||
if left is None or right is None:
|
||||
@@ -403,12 +410,16 @@ def _compare(left, right, op: str) -> bool:
|
||||
# 字符串/其它:支持 eq/ne/in/not_in
|
||||
if op == "eq":
|
||||
return left == right
|
||||
if op == "in":
|
||||
return left in right
|
||||
if op == "not_in":
|
||||
return left not in right
|
||||
if op in ("in", "not_in"):
|
||||
try:
|
||||
return left in right if op == "in" else left not in right
|
||||
except TypeError: # 右侧不是容器 → 该条件无法求值
|
||||
return False
|
||||
if op in ("gt", "gte", "lt", "lte"):
|
||||
return _num_cmp(left, right, op) # 尝试数值,字符串会 ValueError → False
|
||||
try:
|
||||
return _num_cmp(left, right, op) # 尝试数值,字符串会 ValueError → False
|
||||
except (TypeError, ValueError):
|
||||
return False
|
||||
return False
|
||||
|
||||
|
||||
|
||||
Reference in New Issue
Block a user