docs: remove retired schedule generation design

This commit is contained in:
windyboy
2026-09-09 20:22:10 +08:00
parent f6f9d6c6cb
commit d53a0a1c2f
8 changed files with 106 additions and 481 deletions
@@ -91,7 +91,7 @@ msgexchange-api 为成都机场 OMMS 消息交换服务(`com.gzzn.omms:msgexch
3. `updatefltrBridge`:将各航班 `ABTM` 中的 `ABDG` **按序直接追加**到派生字段 `abdg`(代码不插入分隔符——分隔符依赖 `ABDG` 数据本身是否带逗号),拼接结果若以逗号结尾则**仅删除末尾一个逗号**
4. 调用 `redisService.hmset("flightInfo", FLID→FLTR)` 写入航班集合。
说明:`RedisService.hmset` 实现为 `opsForHash().putAll`,仅新增/覆盖 field新快照中未出现的旧 field 不会被删除,即 `flightInfo` 为合并写入语义,**并非整体替换**。快照差集清理须由新系统显式实现(见 6 节迁移验收边界)
说明:`RedisService.hmset` 实现为 `opsForHash().putAll`,仅新增/覆盖 field这是 legacy 行为记录,不构成新系统的设计依据
刷新成功:调用 `sendDschd` 向 Kafka 主题 `msg` 发送日计划到达通知(`MSG` 仅保留 `META`,业务体为空),随后将该记录标记为已处理,返回成功。
@@ -233,7 +233,7 @@ msgexchange-api 为成都机场 OMMS 消息交换服务(`com.gzzn.omms:msgexch
3. `hmset("flightInfo", FLID→FLTR)` 合并写入(新增/覆盖 field,不删除快照中未出现的旧 field);
4. 成功后发送日计划到达通知至 Kafka `msg`,并标记已处理。
- 验收标准:
- Redis `flightInfo` 合并写入:报文内航班被新增/覆盖;快照中不存在而 Redis 已存在的旧航班不被清除(合并语义,非整体替换)
- Redis `flightInfo` 合并写入:报文内航班被新增/覆盖;该行为仅供 legacy 对拍使用
- 主航班 `MAFL` 包含各共享航班的 `FLID` / `FLNO`
- 各航班 `abdg``ABDG` 值按序直接追加的结果:分隔符依赖数据本身,代码不插入分隔符;仅当拼接结果以逗号结尾时删除末尾一个逗号。回放测试需按该真实机制设定期望(见 3.3);
- Kafka `msg` 收到仅含 `META` 的通知消息;
@@ -484,7 +484,7 @@ msgexchange-api 为成都机场 OMMS 消息交换服务(`com.gzzn.omms:msgexch
9. 明文口令直接存放于各环境 `application-*.yml`;默认激活环境为 dev`spring.profiles.active=dev`)。
10. 忽略清单在 test 环境配置为 `error-*`,与其他环境(`eror-*`)不一致。
11. `hstCondition` 各阈值按毫秒计算(配置注释亦为毫秒),而相关代码注释存在单位表述不一致。
12. `updateByDaySchd``RedisService.hmset``putAll`)合并写入:新日计划快照中未出现的旧航班不会被清除(见 3.3)。如采用整体替换语义,新系统须显式清理差集并以回放测试固定预期
12. `updateByDaySchd``RedisService.hmset``putAll`)合并写入;该实现细节仅描述 legacy 行为
13. `FDELHandler` 对共享航班的删除同样调用 `sendMsg` 发送 `msg` 删除消息(与"共享航班不直接发送"的通用规则不一致)。
14. `FDELHandler` 删除共享航班、`ADFTHandler` 添加共享航班时,对主航班 `MAFL` 的修改均仅作用于内存对象并进入发送缓冲,未调用 `saveFltr` 写回 Redis;FDEL 元素比对使用 `==``MAFLDATA.getFlid()``FLTR.getFLID()` 均为 `BigInteger`,故为引用比较而非值比较)。属遗留缺陷,新系统应采用值相等比较并在同一原子状态变更中持久化主/共享航班关系。
15. `/schd/sync` 时间解析使用 12 小时制 `hh`(无 AM/PM 标记),且对空值、区间、解析失败及服务返回值均无校验。
@@ -504,7 +504,7 @@ msgexchange-api 为成都机场 OMMS 消息交换服务(`com.gzzn.omms:msgexch
### 6.2 迁移验收边界
1. **快照替换语义**若日航班计划采用整体替换,须显式清理差集,并以回放测试固定「输入样本 → Redis 终态」预期(现役为合并语义,见 3.3)
1. **日计划语义**新系统的日计划处理规则以 [运营航班状态设计](../flight-state.md) 为准,不从 legacy Redis 行为推导
2. **共享航班增删链路**:决定保留或消除 FDEL 对共享航班的通知(US-B1 例外);主/共享航班关系(ADFT 添加、FDEL 删除)须在同一原子状态变更中持久化(修复 ADFT/FDEL 未写回与 FDEL `==` 引用比较缺陷,见 5.7-14)。
3. **可执行验收矩阵**:覆盖 3 个 SCHD 与 29 个 FLOP 子类型,维度为「输入样本 × Redis 状态变更 × Kafka 通知结果」;对当前无测试的关键路径(如 ACTT、CNCL、FDEL、RESP、DNLD、ADFT)补自动化用例。
4. **入站可靠性**:每类消息的幂等键、重复投递与多实例并发行为。