group_xinghuo_jinrong

126 Commits 9 Branches 1 Tag

3 Commits

Include renames

Author	SHA1	Message	Date
GaoYiYuan_0626	57f16a50a1	基金转换 T+1 模型：T-8 引擎时机收口（调用点唯一性守护 + 受理不触引擎 + 真库链路切 T+1）【范围澄清】引擎调用点在 T-7 即已迁到确认事务 commit 之后（engine_call.run_convert_engine 唯一出口），受理段 accept_convert 自实现起就不含引擎调用 → R-7 已满足。本轮补齐守护与端到端验证。注意 F-10 已明确：T-8 不动去重口径（amount_view 三处消费方原样不动，那是 T-11 的范围）。【新增测试】 - test_convert_engine.py：test_process_convert_event_has_single_call_site —— AST 统计 app/ 下 process_convert_event( 的 Call 节点恰 1 处且宿主为 run_convert_engine。用 AST 而非字符串匹配：engine_call.py 的说明段含该字样，会被误判。已做突变验证（临时加第二处调用 → 断言变红，随后还原）。 - test_convert_accept.py：受理无副作用用例补「不触引擎」断言 —— 受理后 risk_alert 0 行、无 pass / engine_error 审计（验收 29 前半）。 - test_convert_confirm.py：test_real_engine_on_confirm_dedupes_daily_total —— 确认链路接真引擎（不注入 hook）：正证（阈值夹逼 → RISK-002 不命中，去重生效）+ 反证（阈值下调 → 命中，证明确认段确实跑过引擎），并断言一张单 / payload.events 两条 / 去重不删行（验收 5/6/7）。已做突变验证（禁用引擎调用 → 变红，随后还原）。【真库脚本】 verify_convert_engine.py 整体切换 T+1 链路（此前走 v1.0 convert_fund）：受理 accept_convert → 确认 confirm_one；新增 A0 组「受理不触引擎」；A~F 组保留原断言（引擎出单 / RISK-002 夹逼 / 去重不删行 / 幂等重放 / 无命中 / 清理自检）。真库 39/39 一致。 - 折算期望改用 T 日净值（未知价法），不再沿用批次买入净值 alloc.nav； - 基准日取真库日历中位开市日，T+1 = 下一交易日； - 阈值必须显式传给 confirm_one —— 缺省退回 settings 默认会把 RISK-002 误判为命中，症状像「去重失效」，实为口径没传（首轮实跑被 B 组断言捕获，已钉进注释）。【回归】全量 829 passed / 10 skipped（827 → +2）；复跑 T-6 verify_convert_accept 37/37、 T-7 verify_convert_confirm 83/83、v1.0 链路 verify_convert_service 35/35，均零失败。	2026-09-11 19:48:53 +08:00
GaoYiYuan_0626	a6ac39edd6	基金转换 T-11：工具与 SQL 汇总去重（FR-C15 / R-d） convert 在 core_trade 落两条流水（转出 redeem + 转入 subscribe，共享 convert_group_id），所有金额聚合读取方必须只计一次，否则同笔转换金额翻倍。落地（改码 3 处 + 新增 1 脚本 + 测试 3 文件） - rules.py：_amount_view → 公开 amount_view（提升而非复制别名，全仓唯一金额聚合口径）； docstring 补「跨模块共用」说明 - core_tools.py：query_recent_trades 的 sum_amount 改走 amount_view（FR-C15）； items / total_count 保持全量不变——两条流水是真实的两笔权益变动，读到两条是对的 - core_ro.py：list_holdings 加 h.qty > 0（convert 转出全部份额留下的 qty=0 归零行不是持仓）； sum_trades_on_date 加 convert 去重条件（R-d），组内只计转出端 - 新增 tests/test_core_tools.py（3 条：汇总不翻倍 / 跨口径一致性 / 持仓不返回 qty=0 行） - tests/test_core_ro_sum.py 追加 1 条 convert 去重用例（既有断言零改动） - 新增 scripts/dev/verify_convert_tools.py：真库验证脚本（MySQL 8.0.46）执行期裁定 2 条（已留痕） - _amount_view 提升为公开而非复制：一个函数两个名字会漂移（自检第 13 问） - SQL 条件从 IS NULL 扩为 IS NULL OR = ''：Python 的 if not gid 把空串当无组，而 SQL 里 '' IS NULL 恒假。真库实证：只写 IS NULL → 合计数 400000（正确 450000，漏算 50000）。不加则 RISK-002 漏算，且 sqlite 单测若只造 NULL 数据永远发现不了 - 等价性边界：组内无 redeem 时 SQL 丢整组、amount_view 保留首条；由 R-b 保证不可达验证 - pytest -q → 718 passed / 3 skipped（基线 714 加 4，零回归） - 突变验证 3 组均精准命中：去掉去重条件（2 红）/ 去掉 qty>0（1 红）/ 汇总不走 amount_view（2 红） - 真库 verify_convert_tools.py 14/14，隔离数据零残留 - 复跑受影响真库脚本零回归：T-8 31/31、T-7 35/35、T-10 20/20	2026-09-10 18:40:27 +08:00
GaoYiYuan_0626	7ad1c8204d	基金转换 T-8：规则引擎改造（_amount_view 去重视图 + process_convert_event）一次转换落两条流水（转出 redeem + 转入 subscribe，同 convert_group_id），金额聚合类规则若两条都算会翻倍报假预警，故按「逐笔 / 聚合」拆成两个视图。 - rules.py：新增 _amount_view —— 同组内只保留 redeem 那条（无 convert_group_id 的交易恒等通过、组内无 redeem 保首条、绝不删行）；run_rules 双视图分流： RISK-001/003/004 用全量 eligible（逐笔判定），RISK-002/005 走金额视图去重。 - alert_service.py：抽出公开 build_trade_event（事件体结构唯一定义）， record_trade_alerts 新增可选 events 参数；缺省 None 退化为单条，既有调用零改动。新建单落 payload.events 全部，聚合追加只追首条（只认转出端）。 - engine.py：抽 _run 共用实现；process_trade_event 变薄封装（签名与行为不变）；新增 process_convert_event(out_trade, in_trade, ...) 与 _notify_error_hook （hook 自身异常吞掉，原始异常照常上抛）。实质影响：阶段 1.5 从「ImportError 静默跳过」变为「真跑」——T-7 部署时 process_convert_event 不存在，T-8 落地后同一笔转换会真实出单 + 写 L3 + 落审计； T-7 真库脚本复跑仍 35/35，无连带破坏。验证：新增 tests/test_convert_engine.py（15 用例）+ test_convert_service.py 接线回归 1 条；pytest 672 passed / 3 skipped（基线 656 +16，零回归）；新增 scripts/dev/verify_convert_engine.py 真 MySQL 验证 31/31；突变验证（关掉去重视图 → 4 条变红）确认用例非假绿。	2026-09-10 17:34:35 +08:00

Author

SHA1

Message

Date

GaoYiYuan_0626

57f16a50a1

基金转换 T+1 模型：T-8 引擎时机收口（调用点唯一性守护 + 受理不触引擎 + 真库链路切 T+1）

【范围澄清】
引擎调用点在 T-7 即已迁到确认事务 commit 之后（engine_call.run_convert_engine 唯一出口），
受理段 accept_convert 自实现起就不含引擎调用 → R-7 已满足。本轮补齐**守护与端到端验证**。
注意 F-10 已明确：T-8 **不动**去重口径（amount_view 三处消费方原样不动，那是 T-11 的范围）。

【新增测试】
- test_convert_engine.py：test_process_convert_event_has_single_call_site —— AST 统计
  app/ 下 process_convert_event( 的 Call 节点**恰 1 处**且宿主为 run_convert_engine。
  用 AST 而非字符串匹配：engine_call.py 的说明段含该字样，会被误判。
  **已做突变验证**（临时加第二处调用 → 断言变红，随后还原）。
- test_convert_accept.py：受理无副作用用例补「不触引擎」断言 —— 受理后 risk_alert 0 行、
  无 pass / engine_error 审计（验收 29 前半）。
- test_convert_confirm.py：test_real_engine_on_confirm_dedupes_daily_total —— 确认链路接
  **真引擎**（不注入 hook）：正证（阈值夹逼 → RISK-002 不命中，去重生效）+ 反证（阈值下调
  → 命中，证明确认段确实跑过引擎），并断言一张单 / payload.events 两条 / 去重不删行（验收 5/6/7）。
  **已做突变验证**（禁用引擎调用 → 变红，随后还原）。

【真库脚本】
verify_convert_engine.py 整体切换 T+1 链路（此前走 v1.0 convert_fund）：
受理 accept_convert → 确认 confirm_one；新增 A0 组「受理不触引擎」；A~F 组保留原断言
（引擎出单 / RISK-002 夹逼 / 去重不删行 / 幂等重放 / 无命中 / 清理自检）。真库 39/39 一致。
- 折算期望改用 T 日净值（未知价法），不再沿用批次买入净值 alloc.nav；
- 基准日取真库日历中位开市日，T+1 = 下一交易日；
- 阈值必须显式传给 confirm_one —— 缺省退回 settings 默认会把 RISK-002 误判为命中，
  症状像「去重失效」，实为口径没传（首轮实跑被 B 组断言捕获，已钉进注释）。

【回归】
全量 829 passed / 10 skipped（827 → +2）；复跑 T-6 verify_convert_accept 37/37、
T-7 verify_convert_confirm 83/83、v1.0 链路 verify_convert_service 35/35，均零失败。

2026-09-11 19:48:53 +08:00

GaoYiYuan_0626

a6ac39edd6

基金转换 T-11：工具与 SQL 汇总去重（FR-C15 / R-d）

convert 在 core_trade 落两条流水（转出 redeem + 转入 subscribe，共享 convert_group_id），
所有金额聚合读取方必须只计一次，否则同笔转换金额翻倍。

落地（改码 3 处 + 新增 1 脚本 + 测试 3 文件）
- rules.py：_amount_view → 公开 amount_view（提升而非复制别名，全仓唯一金额聚合口径）；
  docstring 补「跨模块共用」说明
- core_tools.py：query_recent_trades 的 sum_amount 改走 amount_view（FR-C15）；
  items / total_count 保持全量不变——两条流水是真实的两笔权益变动，读到两条是对的
- core_ro.py：list_holdings 加 h.qty > 0（convert 转出全部份额留下的 qty=0 归零行不是持仓）；
  sum_trades_on_date 加 convert 去重条件（R-d），组内只计转出端
- 新增 tests/test_core_tools.py（3 条：汇总不翻倍 / 跨口径一致性 / 持仓不返回 qty=0 行）
- tests/test_core_ro_sum.py 追加 1 条 convert 去重用例（既有断言零改动）
- 新增 scripts/dev/verify_convert_tools.py：真库验证脚本（MySQL 8.0.46）

执行期裁定 2 条（已留痕）
- _amount_view 提升为公开而非复制：一个函数两个名字会漂移（自检第 13 问）
- SQL 条件从 IS NULL 扩为 IS NULL OR = ''：Python 的 if not gid 把空串当无组，
  而 SQL 里 '' IS NULL 恒假。真库实证：只写 IS NULL → 合计数 400000（正确 450000，漏算 50000）。
  不加则 RISK-002 漏算，且 sqlite 单测若只造 NULL 数据永远发现不了
- 等价性边界：组内无 redeem 时 SQL 丢整组、amount_view 保留首条；由 R-b 保证不可达

验证
- pytest -q → 718 passed / 3 skipped（基线 714 加 4，零回归）
- 突变验证 3 组均精准命中：去掉去重条件（2 红）/ 去掉 qty>0（1 红）/ 汇总不走 amount_view（2 红）
- 真库 verify_convert_tools.py 14/14，隔离数据零残留
- 复跑受影响真库脚本零回归：T-8 31/31、T-7 35/35、T-10 20/20

2026-09-10 18:40:27 +08:00

GaoYiYuan_0626

7ad1c8204d

基金转换 T-8：规则引擎改造（_amount_view 去重视图 + process_convert_event）

一次转换落两条流水（转出 redeem + 转入 subscribe，同 convert_group_id），
金额聚合类规则若两条都算会翻倍报假预警，故按「逐笔 / 聚合」拆成两个视图。

- rules.py：新增 _amount_view —— 同组内只保留 redeem 那条（无 convert_group_id
  的交易恒等通过、组内无 redeem 保首条、绝不删行）；run_rules 双视图分流：
  RISK-001/003/004 用全量 eligible（逐笔判定），RISK-002/005 走金额视图去重。
- alert_service.py：抽出公开 build_trade_event（事件体结构唯一定义），
  record_trade_alerts 新增可选 events 参数；缺省 None 退化为单条，
  既有调用零改动。新建单落 payload.events 全部，聚合追加只追首条（只认转出端）。
- engine.py：抽 _run 共用实现；process_trade_event 变薄封装（签名与行为不变）；
  新增 process_convert_event(out_trade, in_trade, ...) 与 _notify_error_hook
  （hook 自身异常吞掉，原始异常照常上抛）。

实质影响：阶段 1.5 从「ImportError 静默跳过」变为「真跑」——T-7 部署时
process_convert_event 不存在，T-8 落地后同一笔转换会真实出单 + 写 L3 + 落审计；
T-7 真库脚本复跑仍 35/35，无连带破坏。

验证：新增 tests/test_convert_engine.py（15 用例）+ test_convert_service.py
接线回归 1 条；pytest 672 passed / 3 skipped（基线 656 +16，零回归）；
新增 scripts/dev/verify_convert_engine.py 真 MySQL 验证 31/31；
突变验证（关掉去重视图 → 4 条变红）确认用例非假绿。

2026-09-10 17:34:35 +08:00