fidc-backtest-engine/docs/successor-contract-20260914.md

换股证据与公司行为批次原子性

2026-09-14。开发候选，未发布生产；完整目标保持未完成。

已复现的错误

1. 正常公司行为入口未核对后继证券是否存在于冻结数据：源持仓100股即使缺后继资料，仍可先派息、送转并生成300股后继持仓。手工校正入口此前虽有单独检查，但正常入口没有，两个路径口径不同。
2. successor_ratio_value 将缺失、零、负数和非有限比例静默替换为1；非法现金字段也可能替换为0，错误输入因此成为看似成功的换股。
3. 批次先更新派息/送转、后处理换股现金。当后续现金超出金额合同而失败时，旧证券已经消失，新证券和应收款仍留在账本；目标股数调整及日志也可能部分提交。

负向测试在修复前实际失败。测试代码初次访问私有日期字段的编译错误先改为正式访问方法；这不是业务反例。用于金额超界的首个有限大数仍在金额合同范围内，已改用确实超界的有限值后复现部分更新，不将未超界样例称为错误。

处理合同

• 正常和手工权益校正使用同一换股条款/冻结证券资料校验。必须提供明确、有限、正的换股比例；代码不能缺失、含首尾空格或指向自身。孤立的比例/现金字段也拒绝。没有声明现金组成时仍代表没有现金腿，但明确提供的非法数字不得补0。
• 缺少源证券或后继证券资料时明确报告代码及公司行为日期，不生成隐式证券，不把价格行当成证券资料，更不把后继代码加入策略候选。
• 有经济影响的公司行为在独立账本副本中完成整个批次，成功后一次更新资金、持仓、应收、任务目标单位及说明。失败原状态不变；没有涉及实际持仓的正常日不克隆整个账本。
• 送转/换股股数超过事件和持仓的表示范围时明确失败，不能靠浮点转整数的饱和转换或负数delta继续运行。
• 保留已声明条款、原取得日期及最近买入日期、成本和原策略配置；不伪造委托/市场成交，不把换股当作重新选股。没有重写已提交订单或猜测新目标权重。

验证及剩余工作

本机Core907、Trading625、Runner463/API129通过；原9/63/16项ignore分别保留，不计通过。本次未改UI，也没有重复上一轮UI测试。

新增缺后继资料、13类坏条款、金额失败全批回滚（含原目标单位/权重）、送转/换股数量溢出、有效换股保留两类取得日期等专项。整段引擎覆盖Paper/GT/QMT三种已审计来源、及时/迟到及买/卖12组合：完整资料均保留200股后继持仓且没有新增市场订单/成交；缺资料均明确失败。这是隔离回放，不是券商连接/真实委托验收。

Source当前公司行为Arrow字段及Runner CorporateActionRowRecord仍未提供换股条款，日快照仍显式为无换股字段。这是独立的正式数据能力缺口，不能以本轮核心校验冒充已完成后继证券自动取数。完整范围闭包、目标状态跨公司行为语义、清空后参考、ETF跨模式及实际Source/Runner仍需继续验证。Source运行版本冻结保持，不改旧合同SHA、不注册替代合同或启用交易；后端发布还未准入。

Linux使用本轮新快照单独验收，收据完成后追加，不复用旧reinvestment/AEGDYL/UUx5ru/FewUWP结果。