股票估值端到端协调层 V2 编码方案 V005

创建人员：dev.developer.project.secondary / infodev-2

开发事项：DEV-ANA-STOCK-VALUATION-PIPELINE-V2-20260801-001

性质：V003+V004 实现阶段真实 smoke 发现后的最小 provider 合同修订。

当前状态：PENDING_PROVIDER_DELTA_REVIEW；本文件 PASS 前不实施新增端点，不把缺失金融资产填 0。

1. 触发证据

方案 PASS 后首次真实 smoke 使用 001270.SZ / 2026-08-01，在 1.47 秒内以 BLOCKED 如实结束，失败包为 dev/tmp/valuation-v2-real-smoke-001/cold.failed-b036e888ea644a1db66df5d967ffa26f/。原因是已审简版 RPT_DMSK_FN_BALANCE 的真实响应只暴露 MONETARYFUNDS,TOTAL_EQUITY,TOTAL_ASSETS,TOTAL_LIABILITIES,SHORT_LOAN,AVAILABLE_SALE_FINASSET 等摘要列，没有已知非经营性金融资产明细；原始 blob hash=819144da9256200c0feeb1b03bb2e3715b08827817ec58871c7761ca5dd60f81。实现按合同阻断，没有以 0 降级。

同一已登记公开 host datacenter-web.eastmoney.com 的 reportName=RPT_F10_FINANCE_GBALANCE 返回完整资产负债字段；受控只读核对 001270.SZ / 2026-03-31 得到：MONETARYFUNDS=179539263.25、TOTAL_EQUITY=1560369145.27、TRADE_FINASSET_NOTFVTPL=95338761.64、NONCURRENT_LIAB_1YEAR=458204.55、LEASE_LIAB=367261.65，后二者合计 825466.20，与冻结快照完全一致。

另一个真实差异是 as-of 2026-08-01 为非交易日；若 kline beg=end=as-of 会得到空数组，而业务合同要求取不晚于 as-of 的最近交易日。

2. 唯一请求修订

V003 第 6 节 Eastmoney finance 表中的 balance 请求由：

reportName=RPT_DMSK_FN_BALANCE

替换为：

reportName=RPT_F10_FINANCE_GBALANCE

host、HTTPS、GET、filter、分页、排序、响应上限、adapter version、B1+A1 回链、as-of 和停止规则均不变；不增加新域名或自由回退。字段映射固定：

• 权益=TOTAL_EQUITY；现金=MONETARYFUNDS；少数股东权益=MINORITY_EQUITY|null→0；
• 非经营性金融资产仅对响应中实际存在的下列字段求和：TRADE_FINASSET,TRADE_FINASSET_NOTFVTPL,DERIVE_FINASSET,BUY_RESALE_FINASSET,CREDITOR_INVEST,OTHER_CREDITOR_INVEST,OTHER_EQUITY_INVEST,OTHER_NONCURRENT_FINASSET,FVTPL_FINASSET,FVTOCI_FINASSET,FVTOCI_NCFINASSET；一个字段都不存在时 BLOCKED，不得填 0；
• 有息债务仅对响应中实际存在的 SHORT_LOAN,NONCURRENT_LIAB_1YEAR,LONG_LOAN,BOND_PAYABLE,LEASE_LIAB,SHORT_BOND_PAYABLE 求和；一个字段都不存在时 BLOCKED；存在但为 null 可按法定表中无该项目计 0；
• 仍须 NOTICE_DATE<=as-of、REPORT_DATE<=as-of，并回链同报告期 A1 公告。

3. 非交易日行情修订

kline 请求 end=requested_as_of，beg=requested_as_of-14 calendar days；适配器在返回记录中只保留 f51<=as-of 并取最大 f51。14 日窗口无记录即 BLOCKED，不扩大窗口、不换站。该变化只实现既有“取不晚于 as-of 的最近交易日”合同，不改变行情来源或字段。

4. fixture 与测试增量

• fixture 的 balance 文件改为完整端点响应前像，并补 TRADE_FINASSET_NOTFVTPL=95338761.64、NONCURRENT_LIAB_1YEAR=458204.55、LEASE_LIAB=367261.65；expected 不变；
• 新增简版 balance 缺明细必须 BLOCKED、完整 balance 精确求和、全部明细字段存在但为 null 得 0、所有字段都不存在 BLOCKED；
• 新增周末 as-of 在 14 日窗口取 2026-07-31、窗口空记录 BLOCKED、未来 kline 被排除；
• 实施后重跑 V2 全套、V1 10/10、fixture 冷/热和真实 cold/warm smoke。

5. 继承与门禁

V003=28030 bytes / 358C37EE1FE7F5F832FAF33EBDEB1B1714DE46F315A55A1C1D53AF43D687C61F、V004=12117 bytes / 50DE1F7E765E8B828DEF1C25D6D5BEA32C3C0B07FD034929542AAE0CB4E84799 的其余合同全部继承。V005 不修改 ana-dev，不增加 provider、域名、网络预算或交易结论。只有 dev.reviewer.project 对本 delta PASS 后才实施本节变更。