edit | blame | history | raw

股票估值流水线说明

创建人员：dev.developer.ana.cai
文件职责：说明股票估值标准快照、统一计算、异常质检、缓存复用和 Markdown 底稿生成入口。
关联事项：DEV-ANA-STOCK-VALUATION-PIPELINE-V1-20260801-001。
业务规范：../../ana-doc/股票估值/股票价格合理性评估操作手册.md。
代码入口：../../dev/ana-dev/stock_valuation_pipeline/。
测试入口：../../dev/ana-dev/test/stock_valuation_pipeline/。
审计入口：../../ana-doc/案例审计报告.md。
记录方式：工具公开合同或状态变化时更新；执行事实写入根级开发账本。

1. 目标与边界

V1 将已经验证稳定的估值规则机器化，避免每只股票重复输入、重复推导、重复改表和平均分配复核资源。

已实现：信源注册表、标准 JSON 快照、TTM/估值/情景/反向计算、机构预测时效判断、异常清单、Markdown 底稿、结果清单、包含引擎源码与契约的联合指纹缓存和长城军工回归。

未实现：网页自动抓取、数据库、GUI、交易指令、自动投资结论、未知资产注入估值和对人工利润持续性判断的替代。

2. 交付入口

入口 作用
stock_valuation_pipeline/README.md 运行、输入、状态和复评用法
stock_valuation_pipeline/snapshot.schema.json 标准快照公开契约
stock_valuation_pipeline/source_registry.json 可信信源等级、用途、复用与重取规则
stock_valuation_pipeline/core.py 校验、计算、质检、报告和缓存核心
test/stock_valuation_pipeline/fixtures/great_wall_military_20260731.json 已完成报告的回归样例
test/stock_valuation_pipeline/test_pipeline.py 正常、失败、滞后、篡改和复用测试

3. 使用门禁

  1. 所有金额以元输入，股本以股输入，资本开支按现金流出正数输入。
  2. 机构预测为空也必须显式登记，不能用公司预告或自有情景替代。
  3. BLOCKED_INPUT_ERRORS 不得升级为正式结论；只按异常清单修复受影响字段。
  4. 相同指纹只在引擎源码、Schema、输入和注册表均未变化，且报告和结果文件哈希均匹配时复用；任一项改变则重算。
  5. 自动 PASS 仅表示机器规则通过，不代表经营假设或投资结论已独立审核。

4. 当前验证

  • py_compile=PASS；
  • 单元与回归测试 10/10 PASS；
  • 长城军工关键复算与既有人工报告一致；
  • 最终代码本机强制重算 20 次平均约 19.566 ms、最大约 40.708 ms；
  • 有效缓存读取 100 次平均约 8.633 ms、最大约 25.453 ms；
  • 状态：SELFTEST_PASS_PENDING_INDEPENDENT_REVIEW。

性能只覆盖标准快照完成后的本地机械链路；外部资料取得、口径确认和人工经营判断需要单独计时。