docs(acm2-52): 修正跨文档事实冲突 F1–F9 与错引编号

- F1/F6 HTTP 契约:C-28 目标 ResponseDto + 请求体上限暂定 10MB,Q3 指向 C-28
- F2 legacy 与 SIS 的优先级限定;F3 超期判据对齐 ENQUEUED_AT;F4 改引 D1
- F5 参数默认值改引 reference/PARAM;F7 补 4 条契约状态词;F8 定义 MAID/MAFL 并明确排除共享航班;F9 补 INV-20
- N1/N2 错配编号改引;N3 迁移链指针;N4/M5 白名单补 D-x/OPS-x;N6 补 INV-16/17 映射;N7 加粗规则
- M1 回填退避事实与论证;M2 Q6/Q7;M4 Q4 假定标注;M7 去复述
纯文档,不改代码/迁移/配置/legacy。
This commit is contained in:
windyboy
2026-09-12 09:57:26 +08:00
parent 817236ca26
commit 69c2cf219f
8 changed files with 34 additions and 30 deletions
+4 -4
View File
@@ -22,7 +22,7 @@
| [reference.md](reference.md) | 参数注册表、指标与健康、模块入口、错误分类。 |
| [flight-state.md](flight-state.md) | 航班域模型与合并语义。 |
| [user-stories.md](user-stories.md) | US / OPS 验收目标。 |
| [legacy/](legacy/) | 现役行为基线与外部协议事实([SIS 规范](legacy/SIS_AODB_RMS-V0.1.md)、[XSD](legacy/unisysaodbsis.xsd);与现行文档冲突时以 SIS 为准。 |
| [legacy/](legacy/) | 现役行为基线与外部协议事实([SIS 规范](legacy/SIS_AODB_RMS-V0.1.md)、[XSD](legacy/unisysaodbsis.xsd)。外部协议事实(报文结构、字段语义、上游行为)以 SIS/XSD 为准;legacy 现役行为只是基线,已知缺陷不作依据;与本系统目标设计的已知差异见 `C-25`/`C-26`,确认状态见 `Q13`/`Q14`。 |
`message-lifecycle.md` 已并入 design.md,文件仅保留跳转说明。
@@ -32,7 +32,7 @@
|---|---|---|
| 水位 `W`、空洞判定与推进条件 | design「收报与水位」 | contracts 写对库方的承诺 `C-1``C-3`reference 写参数 |
| 保留期下界 `R_keep`、清除前置条件 | contracts「保留与清除」 | design 只引 `C-x`;执行步骤在上线前另立 |
| 处理标记值集与写权限 | contracts `C-5` | design 只写行为约束「只写空标记、不回撤、不覆盖」(`INV-6` |
| 处理标记值集与写权限 | contracts `C-5` | design 只写行为约束「只写空标记、不回撤、不覆盖」(`INV-7` |
| 回填四结果、放弃语义、`R` 的作用 | design「回填」 | invariants 记结论与可声明性 |
| 退避 / `claim-batch` / 回填期限等取值 | reference「参数」 | design 只引 `PARAM:x` |
| 消费权排他、ID 不复位、报文不可变、时钟、单实例 | invariants「前提」 | 其他文档只引 `PRE-x` |
@@ -41,11 +41,11 @@
## 4. 引用与写作纪律
1. **引用只用稳定 ID**`PRE-x``INV-x``CLM-x``C-x``PARAM:x``[G-x]``[Q-x]``US-xx``ACM2-nn`。**不再用章节号做跨文档引用。**
1. **引用只用稳定 ID**`PRE-x``INV-x``CLM-x``C-x``D-x``OPS-x``PARAM:x``[G-x]``[Q-x]``US-xx``ACM2-nn`。**不再用章节号做跨文档引用。**
本条取代旧版 README 的「其他文档引用章节号」规则:章节号随增删章节腐烂,指针失效后必然被改写为复述——重构前实测有 30 处「唯一定义处」与 33 处跨文档章节引用。
2. 指针之后**不再复述**被指内容。若两处需要同一段话,说明它放错了位置。
3. 文档不记进度,只记「主张是否可对外声明」。进度在 Plane。
4. 机制段只写「是什么 / 为什么」。验收 → invariants 验证映射;前置条件、红线与库方方案 → contracts / invariants;参数默认值 → reference;操作步骤在上线/切流前另立规程,设计阶段不写。一句话一个主张;加粗每节 ≤ 3 处
4. 机制段只写「是什么 / 为什么」。验收 → invariants 验证映射;前置条件、红线与库方方案 → contracts / invariants;参数默认值 → reference;操作步骤在上线/切流前另立规程,设计阶段不写。一句话一个主张;只强调关键结论,避免整段加粗。
5. 数值只有两个家:参数默认值与指标名在 reference.md;契约数值(保留期、值集、下界)在 contracts.md。
## 5. 维护清单