docs: record the human approval of the design decisions

This commit is contained in:
2026-07-31 06:54:55 -04:00
parent 42d16919fc
commit 7ccb25e8f1
@@ -2,7 +2,7 @@
- **日期**: 2026-07-31 - **日期**: 2026-07-31
- **来源**: Gitea Issue #3(下游 dissect 审计需求) - **来源**: Gitea Issue #3(下游 dissect 审计需求)
- **状态**: 待人类审批 - **状态**: 已批准(2026-07-31,人类逐条确认 A2 / B1 / C1 / D1)
- **触发档位**: 强制(变更 `types.py` 公共类型 + `ports.py` 端口签名 + 遥测持久化 schema) - **触发档位**: 强制(变更 `types.py` 公共类型 + `ports.py` 端口签名 + 遥测持久化 schema)
## 1. 目标与非目标 ## 1. 目标与非目标
@@ -149,8 +149,8 @@ Issue 称「两者的数据都已经存在于 `TransportResult.raw` 里」。核
| Wiki 站 + `CHANGELOG.md` | 按 `docs-convention.md` §2 清单同步(公共行为变更,版本 bump 不得裸发) | | Wiki 站 + `CHANGELOG.md` | 按 `docs-convention.md` §2 清单同步(公共行为变更,版本 bump 不得裸发) |
| `.env.example:56` | 该行内联注释是仓内**唯一**的价格表格式说明(无独立模板文件,`config/prices.json` 是未入库的本地文件),补 `cached_input_per_1m` 可选档 | | `.env.example:56` | 该行内联注释是仓内**唯一**的价格表格式说明(无独立模板文件,`config/prices.json` 是未入库的本地文件),补 `cached_input_per_1m` 可选档 |
## 10. 待人类确认 ## 10. 审批记录
1. 本设计整体是否批准进入 `writing-plans` 2026-07-31 人类逐条确认: **A2**(TransportResult 强类型字段)、**B1**(缓存命中原样回放 + 度量口径带 `cache_hit = false`)、**C1**(ModelPrice 可选缓存单价档)、**D1**(DDL 加列 + 初始化期幂等补列)。设计获批,进入 `writing-plans`
2. 决策 B(缓存命中原样回放 + 度量口径带 `cache_hit = false`)是否认可——这是唯一一处「语义可争论」的选择。
3. 版本号定为 `1.1.0`(纯增字段但触及端口签名与表结构)是否合适 版本号 `1.1.0` 推进(纯增字段不破坏下游,但触及端口签名与表结构,minor 位比 patch 位更能提示下游);发版前若人类另有指示以指示为准