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:
@@ -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(
|
||||
|
||||
Reference in New Issue
Block a user