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

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

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

性质：仅关闭 V005 审核的一个 schema 完整性阻断；V003+V004 与 V005 已通过的端点/K 线条款全部继承。

当前状态：`PENDING_BALANCE_SCHEMA_REREVIEW`；PASS 前不实施 provider delta。

## 1. 非经营性金融资产的冻结口径与完整键

本流水线的 `non_operating_financial_assets` 口径是可直接从公开表中识别的流动性非经营金融资产，不把长期战略性 `OTHER_EQUITY_INVEST`、债权投资或其他非流动金融资产自动视为可抵减企业价值的现金等价物。完整端点每条 balance record 必须包含下列全部键，即使值为 null：

1. 互斥 alias 组 `liquid_fv_assets`：`TRADE_FINASSET_NOTFVTPL,TRADE_FINASSET,FVTPL_FINASSET,APPOINT_FVTPL_FINASSET,AVAILABLE_SALE_FINASSET`；
2. 单列组成：`DERIVE_FINASSET,BUY_RESALE_FINASSET`。

缺任一键即 `E_BALANCE_SCHEMA_DRIFT/BLOCKED`。通过键集合校验后：显式 null 计 0；alias 组 0 个非 null 则该组为 0，1 个非 null 采用该值，2 个及以上非 null 时只有所有值数值完全相等才计一次，否则 `E_BALANCE_ALIAS_CONFLICT/BLOCKED`；两个单列组成分别取显式数值或 null→0。三组求和才是 `non_operating_financial_assets`。

`001270.SZ / 2026-03-31` 的冻结完整响应中，alias 组只有 `TRADE_FINASSET_NOTFVTPL=95338761.64` 非 null，另外两组 null，因此精确结果为 `95338761.64`；`OTHER_EQUITY_INVEST=97998119` 明确不纳入这一现金等价口径，不得重复或扩大口径。

## 2. 有息债务的冻结完整键

每条 balance record 必须同时存在以下六键：

`SHORT_LOAN,NONCURRENT_LIAB_1YEAR,LONG_LOAN,BOND_PAYABLE,LEASE_LIAB,SHORT_BOND_PAYABLE`

缺任一键即 `E_BALANCE_SCHEMA_DRIFT/BLOCKED`。键集合完整后，显式 null 计 0，非 null 必须为非负数，再求和。这里没有 alias：短期债券与应付债券是不同期限组成，均实际存在时分别计入。

冻结响应为 `NONCURRENT_LIAB_1YEAR=458204.55`、`LEASE_LIAB=367261.65`，其余四键显式 null，精确债务=`825466.20`。

## 3. 少数股东权益

`MINORITY_EQUITY` 是强制 schema 键：absent=`E_BALANCE_SCHEMA_DRIFT/BLOCKED`；present 且 explicit null=0；present 且数值则必须非负并采用。不得用 `dict.get(...,0)` 混淆 absent 与 null。

## 4. 离线反例

在完整成功 fixture 基础上逐一删除：

- 任一 `liquid_fv_assets` alias 键、`DERIVE_FINASSET` 或 `BUY_RESALE_FINASSET`；
- 任一六个债务键；
- `MINORITY_EQUITY`。

每个删除用例均断言 `BLOCKED/E_BALANCE_SCHEMA_DRIFT`。另测 alias 两键同时存在且值相等只计一次、值不同则 `BLOCKED/E_BALANCE_ALIAS_CONFLICT`；全键存在且相关值 null 得 0；冻结完整响应精确得到 financial_assets=`95338761.64`、debt=`825466.20`、minority=`0`。

## 5. 门禁

V005 中与本文件冲突的“任一候选键存在即可求和”条款被本文件替换；V005 已通过的 `RPT_F10_FINANCE_GBALANCE` 端点和 K 线 14 日窗口不重开。仅 `dev.reviewer.project` PASS 后实施代码/fixture 并重跑原定验收。