feat: persist feature research and versioned alpha assessments

2026-09-08 21:52:46 +08:00
parent f89ae211d2
commit eb4850a003
32 changed files with 2003 additions and 20 deletions
@@ -0,0 +1,36 @@
+# 第二阶段验收：特征与成果管理
+
+日期：2026-09-08。范围：特征方案、保存视图、变体关系、版本化评估。未调用真实模型或 WorldQuant；平台调用使用隔离合成响应。
+
+## 交付行为
+
+- 特征方案保存固定输入快照、经济假设、处理步骤及输出模板，支持历史版本、AI 结构化生成和转换模板；转换保存完整方案版本，并在模板工坊恢复输入和假设。
+- Alpha 保存视图持久化筛选、排序和显示列，支持搜索恢复、新建及乐观版本更新。
+- 实验父来源有可查询关系索引，迁移补齐已有 JSON 父来源。关系图保留多父来源，沿实验、回测产出 Alpha、后续种子研究双向追溯。每次回测来源仍沿用原分页来源接口。
+- 规则评估保存规则版本和阈值、平台快照、实验输入、回测条目设置、缺失项及本地自相关证据。模型建议另存新报告，不覆盖规则判断和旧报告；不自动修改 Alpha 本地研究状态。
+- Alpha 详情及实验详情共用评估、来源关系能力；AI 共用特征保存、转换及规则评估业务接口。
+
+## 验收步骤与结果
+
+| 验收 | 结果与证据 |
+|---|---|
+| 特征保存 v1、转换模板、更新 v2、展开旧模板 | 通过；实验仍保留原方案 v1 的假设、输入和步骤 |
+| 保存筛选、排序、列设置；提交非法排序 | 通过；视图恢复原设置，非法参数返回 422 |
+| 缺失指标、缺失检查、已有 FAIL、完整 PASS | 通过；分别保留 review/block/pass，缺失不当零 |
+| 同步覆盖平台快照、模型建议“通过” | 通过；旧报告快照不变，规则 block 不变 |
+| 部分回测结果 | 通过；不完整结果即使指标达标也保留待核实，实验输入和设置快照存在 |
+| 多父实验、孙实验、产出 Alpha 再研究 | 通过；从种子或后续实验均可找到来源链路 |
+| 后端全量回归 | 187 passed；之后补充的不完整结果及跨 Alpha 追溯等专项 10 passed。日志 `/tmp/wq-stage-two-full-backend.log`、`/tmp/wq-stage-two-focused.log` |
+| 前端类型检查及生产构建 | 通过；已有 lottie-web eval 构建警告不影响构建。日志 `/tmp/wq-stage-two-build-final.log` |
+| 浏览器特征编辑→保存→转模板→保存视图→导入合成 Alpha→保存评估 | 通过；1 passed，页面无 JS 错误。已检查截图 `/tmp/wq-stage-two-evaluation.png` |
+| 现有浏览器回归 | 全量初跑 16 通过、2 失败；修正合成数据定位及异步任务等待后，失败场景与相邻工作空间复验 3 passed。原失败均已覆盖。日志 `/tmp/wq-stage-two-browser-regression.log`、`/tmp/wq-stage-two-browser-followup.log` |
+| PostgreSQL 17 增量迁移 0006→0007 | 通过；Alembic check 无额外操作，旧研究备注保留，版本、关系和评估 API 通过 |
+| PostgreSQL 备份恢复 | 通过；独立测试库 pg_dump/pg_restore 后研究版本、评估、关系数量和旧备注一致。脚本 `backend/tests/research_outcomes_postgres.py`，日志 `/tmp/wq-stage-two-postgres.log` |
+
+浏览器首轮发现的是验收定位与合成测试参数问题：固定输入使用既有的 all/excluded_ids 协议；保留草稿的隐藏页不能用全局标签定位；Semi 弹窗确认按钮的无障碍名称为 confirm。修正后新增闭环通过。全量回归另发现共享合成数据使 Alpha 不在第一页，以及旧数据数量提前满足断言造成任务浮层晚打开；改为筛选目标 Alpha、等待对应任务完成及浮层出现，相关场景复验通过。
+
+## 边界
+
+关系图响应限制 100 个实验、8 层；截断时明确提示并提供边界继续展开。每条原始回测来源仍可分页完整读取。评估模型解释一次最多使用 20 条规则记录，保存选取范围，不改变完整规则报告。特征步骤不执行原始时间序列离线计算。
+
+真实 WorldQuant 元数据与实际模拟仍因自动审批要求当前对话明确授权而未验证；此前已发出授权问题，不以合成平台测试代替真实联调。
@@ -5,7 +5,7 @@ Status: ready-for-agent
 ## 阶段

 - [x] 一：算子、模板、表达式模块、两类变体与回测来源闭环。
- [ ] 二：特征方案、保存视图、关系、比较和评估。
+- [x] 二：特征方案、保存视图、关系、比较和评估。
 - [ ] 三：固定自动研究、预算、持久步骤、恢复。
 - [ ] 四：原生 QuantFlow 画布与共用执行。
 - [ ] 验证：后端、前端、浏览器、PostgreSQL 迁移与恢复。
@@ -15,3 +15,5 @@ Status: ready-for-agent
 开始实现。工作区原有侧栏、配置抽屉、Alpha 页面及测试改动保留；主代理负责所有代码修改和最终验证。

 第一阶段已通过本地后端、浏览器和 PostgreSQL 验收；报告见 `../acceptance/stage-1.md`。真实 WorldQuant 联调因自动审批未认可已有授权而等待当前对话确认，不将合成测试记为真实联调。
+
+第二阶段已通过后端、前端、浏览器和 PostgreSQL 迁移/恢复验证；报告见 `../acceptance/stage-2.md`。独立 Alpha 列表布局改动继续留在工作区，本次仅提交保存视图接入。