docs(kdoc): 其余模块注释统一为直白说明

把上一提交没覆盖到的模块也改完,至此仓库内不再有"只写编号、不写说明"的注释。

涉及 33 个文件(生产 24 + 测试 9),包括航班状态模型与合并引擎、事件与留痕模型、
运营日计算、投递器、历史归档作业、编解码与身份、重试与重放、健康指示器、
生命周期装配、以及各自的测试类。

改法与前面一致:先说这段代码做什么,再说为什么这么做,术语第一次出现就地解释
(FLID、OPERATION_DAY、航班版本号、删除通知、待发事件表等)。工单编号
(U07/N02/ACM2-10 之类)已全部移除;段落编号只剩 10 处,全部带文件名位于句尾,
用作延伸阅读,例如"见 docs/flight-state.md §5"。

保留了本来就自解释的行内注释、PgTestSupport 顶部的环境变量默认值表格,
以及 InboxController 里描述待补接口的 TODO。

校验:逐文件做"去注释后比对"(块注释 + 行注释清除、空白归一),33 个文件代码
零差异;另做逐行非注释代码比对,同样零差异。clean test 为 78 passed / 1 skipped。
This commit is contained in:
windyboy
2026-09-10 11:14:11 +08:00
parent 6e7d819034
commit 1183c7522b
33 changed files with 283 additions and 210 deletions
@@ -176,7 +176,10 @@ class AdftProcessor(
ApplyResult.Succeeded
}
/** §3.3 保守语义:仅出现字段 Set;集合出现 Replace、缺失保留。 */
/**
* 上游对"字段缺失"的含义还没确认,这里取保守做法:
* 报文里出现的字段覆盖本地值,没出现的字段保持原值不动。
*/
private fun setOnly(record: ScheduleRecord) = MergeChange(
flid = record.flid,
scalars = record.scalars,
@@ -5,9 +5,12 @@ import com.gzzn.omms.msgexchange.domain.DecodedMessage
import java.time.LocalDate
/**
* ACMA-8 I3:幂等键 = SNDR|TYPE|STYP|SEQN。
* 计算集中此处唯一入口;“是否含日边界”可配置且默认关闭(CONFIRM 矩阵 #11
* SEQN 重置作用域确认前不改语义——上线后不改幂等键)。
* 幂等键的唯一算法:发送方、报文类型、子类型、流水号四段用竖线拼起来,用来判断同一条业务
* 报文是不是已经处理过。
*
* 也可以再拼上日期做"按天去重",由 msgx.identity.include-day-boundary 控制,默认关闭:
* 发送方的流水号到底按什么范围重置还没确认,语义定下来之前不动。幂等键上线后就不能再改,
* 改了会让已有的去重记录全部对不上。
*/
object Identity {
fun of(