edit | blame | history | raw

2026-08-05 股票估值每日台账 MVP 工作记录

  • 事项：DEV-STOCK-VALUATION-LEDGER-MVP-20260805-001
  • owner：dev.developer.project.secondary / infodev-2
  • requester：case_analysis.analyst.valuation
  • reviewer：dev.reviewer.project / inforev
  • 管理派单：HANDOFF-INFOADMIN-INFODEV2-STOCK-VALUATION-LEDGER-MVP-ASSIGN-20260805-001
  • 任务起点：2026-08-05T17:26:10+08:00
  • 当前状态：MySQL 单后端、HOLD/2 返修和前复权专表 delta 已完成，待合并实现复审。

1. 初版与审核

初版按当时需求实现 SQLite 四表 CLI，完成 15 项测试、125/136 正式导入，未运行正式 daily。共享审核员返回 HOLD/4：V2 fqt=1 不能证明未复权和完整日；后续复评错误地估值日当日生效；同快照哈希下 calculation 改值未识别；全失败会发布空 latest 且双文件非成对提交。

审核期间用户明确否决 SQLite，需求 owner 把正式口径改为本机 MySQL 独立库 stock_valuation，项目管理员冻结：行情只读 trading_xuntou、台账只写 stock_valuation、不得读写 tianxia、不得回退 V2 网络、不保留双后端。

2. MySQL 单后端实施

  • 新增 database.py，只从 STOCK_VALUATION_MYSQL_* 或不入库本机 JSON 读取连接参数；测试库名需要显式开关和固定前缀。
  • 将 schema.sql 改为 MySQL 8 / InnoDB / utf8mb4 四表，连接和全部 CRUD 改为 mysql.connector 参数化 SQL。
  • 导入仍只读正式快照和 valuation_results.json；同身份逐不可变字段核对，差异写 E_IMMUTABLE_VERSION_CONFLICT。
  • 第一版估值日可用；后续版本次日生效，前版有效至新估值日。
  • 生产行情桥只做 trading_xuntou SELECT。最新用户口径固定读取 cn_stock_kline_1d_front 前复权专表，检查专表 schema、证券身份、正式日历、请求日以前最大开市日、current 水位、15:05 最终装载时间、来源和币种；禁止通用表、dividend_type 推断和 V2/network 回退。
  • daily_price 和 daily_judgement 在同一 MySQL 事务中写入；数据库错误整批回滚。
  • latest 两文件用 staging/backup/replace/rollback 状态机；全失败不发布也不覆盖旧文件。
  • run_daily.ps1 只执行一次 MySQL daily，计划任务仍仅为文档示例。

3. 验证

  • MySQL 隔离测试最终：22/22 PASS / 86.679s；含整批故障回滚、两文件 staging 全点异常矩阵、非正区间零半状态、前复权专表 schema 正反合同、大小写敏感的 ticker/source 精确门禁、陈旧日历水位阻断和禁旧路径。
  • project 完整回归：119/119 PASS / 140.964s。
  • 正式结果包隔离库：冷导入 136，热导入 136 unchanged，计数 125/136/0/0。
  • 125 证券离线 daily：125 条价格和判定，四标签全覆盖，复跑无新增。
  • F2：2026-08-06 复评当日旧版本、2026-08-07 新版本，历史不回写。
  • F3：同哈希下 base_low 10 -> 11 明确冲突，原值保留。
  • F4：全失败首次双文件不存在，后续保留旧字节；两个替换点的 OSError/KeyboardInterrupt/SystemExit 均回滚。
  • 首次 MySQL 集中复审=HOLD/2：F1—F3 关闭；F4-R1 指出 staging 的 create/write/flush/fsync 未纳入回滚，P1 指出判定 E_RANGE 可在 price INSERT 后形成半状态。
  • F4-R1 修复：两份 stage 的四故障点 × OSError/KeyboardInterrupt/SystemExit 共 24 组均不改正式 pair 且 stage/backup 为 0。
  • P1 修复：在任何价格 INSERT 前校验并计算判定；base_low=0 得到 FAILED/E_RANGE/0 price/0 judgement。
  • 复审过程中用户再次明确行情口径：前复权专表 trading_xuntou.cn_stock_kline_1d_front。已通知审核员旧冻结快照被需求变更部分取代；代码、测试、工程说明和证据按专表 delta 更新，未运行生产 daily。
  • 旧快照限定复审返回 SUPERSEDED_REQUIREMENT_CHANGE，其中 F4-R1/P1 子结论均关闭、范围内阻断为 0；整体 PASS 留给当前专表新快照。
  • 200 行暖查询小于 1 秒。
  • compileall、CLI help、Windows PowerShell 5.1 语法、strict UTF-8/no BOM/尾随空白、scoped diff 和凭据扫描均 PASS；治理=OK/projects1/warnings0。
  • 需求 owner 随后按冻结合同完成一次生产 daily；本开发线程仅只读核对正式计数、source、规范行哈希和输出哈希，没有重复运行或改写历史行。

4. 正式 MySQL 与清理

从正式结果包重建并热复验：

  • security=125
  • valuation_version=136
  • daily_price=124
  • daily_judgement=124
  • 跨表孤儿=0
  • 热导入=inserted=0/unchanged=136/gap_count=1

MySQL 核验通过后，按事先登记的精确路径删除旧试制库 ana-data/result/股票估值/估值台账/stock_valuation.sqlite3（删除前 163840/48AF0F...99C），同时删除仅服务该文件的 .gitignore。旧库未被用作迁移源；正式台账可从结果包重建。

5. 边界

  • 需求 owner 生产结果：as_of=2026-08-05，124/124 只 A 股覆盖，标签 偏低3/基本合理39/偏贵39/明显偏贵43；09880.HK 为唯一不支持缺口。
  • 审核员复现 current 日历但 window_end < as-of 可误收旧交易日；已在 SQL expected/outer gate 和 _record_from_row 双重要求水位覆盖请求 as-of，补 2026-08-04 window_end / 2026-08-05 as-of 阻断反例。
  • 正式 source ID 全部为 trading_xuntou.cn_stock_kline_1d_front:xtquant:front；开发线程只读核验 source/close/版本/标签一致性，没有重复执行生产 daily。
  • 港股当前不在 A 股行情合同内；不新增 provider。
  • 外部网络、V2 provider、开发线程生产 daily、计划任务安装、tianxia 动作和 ana-dev 修改均为 0。
  • 下一步冻结新哈希并向同一审核员提交 F4-R1/P1 与前复权专表 delta 的合并实现复审。