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:
@@ -3,15 +3,17 @@ package com.gzzn.omms.msgexchange.config
|
||||
import io.micronaut.context.annotation.ConfigurationProperties
|
||||
|
||||
/**
|
||||
* 运营日计算(docs/flight-state.md §2.1):由 SODT(ddMMMyyHHmm)与机场时区按切日边界推导;
|
||||
* OPERATION_DAY 不是接收日/落库日,一经确定不可变。切日边界业务配置,
|
||||
* 不得假设等于自然日零点(默认 0 点为占位,业务口径待确认)。
|
||||
* 算航班运营保障日(OPERATION_DAY)要用的两个参数,对应配置里的 `msgx.operation-day.*`:
|
||||
* 机场时区和切日边界。运营日由计划运行时间 SODT 加时区推出来,不是接收日也不是落库日,
|
||||
* 算出来就固定不变。
|
||||
*
|
||||
* 不能假设运营日等于自然日,民航的一天从几点开始由业务定。默认 0 点只是占位,待确认。
|
||||
*/
|
||||
@ConfigurationProperties("msgx.operation-day")
|
||||
class OperationDayProps {
|
||||
/** 机场时区(IANA)。 */
|
||||
/** 机场所在时区,用 IANA 名称,比如 Asia/Shanghai。 */
|
||||
var zone: String = "Asia/Shanghai"
|
||||
|
||||
/** 切日边界:SODT 本地时刻早于该小时的归属前一运营日(0–23)。 */
|
||||
/** 切日边界小时:SODT 的本地时刻早于这个点就归属前一个运营日。取值 0–23。 */
|
||||
var cutoffHour: Int = 0
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user