windy/msgexchange-v2
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
81 Commits 1 Branch 0 Tags
a89755c2008db705e236d537d202dd7abf67c0cd
Commit Graph
25 Commits
Author SHA1 Message Date
windyboy dcdc5117bf docs(acm2-51): 收口 D10/D14/D15 
- D10 投递保序：architecture 改为 FLID 级（与 design/CLM-7 对齐，实现收敛归 ACM2-34）
- D14 REQ_TRACK 状态名：user-stories US-08 对齐实现的 PENDING/SENT/DONE/EXPIRED
- D15 容量假设：invariants 新增 CLM-10（未实测，含解除条件），design §10 加指针
纯文档，不改代码/迁移/配置/legacy。
 2026-09-12 11:33:58 +08:00
windyboy 69c2cf219f 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。
 2026-09-12 09:57:26 +08:00
windyboy 6eade95a97 docs: 拆分契约/前提/参数文档，合并消息生命周期并收敛设计裁决 
- design.md 合并 message-lifecycle.md（后者保留跳转 stub），去重并改用稳定 ID 引用
- 新增 invariants.md（前提/不变量/声明边界/验证映射）、contracts.md（对外条款与 Q 台账）、
  reference.md（参数/指标/模块/错误分类）
- architecture/flight-state/user-stories/README 同步重划引用；README 废止「引用章节号」
- 裁决收敛：R 按超期而非次数放弃、清除前提含放弃清单、航班表写者互斥、head-deadline 仅告警、
  超期判据用本地入队时间、投递批次读取时刻冻结、schd 只进不退与条件标记、FLID 复用为前提
- 删除 runbooks 与 CI 防漂移校验：设计阶段不产出面向执行期的产物

Refs: ACM2-42..51
 2026-09-11 15:48:14 +08:00
windyboy 50e0e7f389 docs: 修复跨文档冲突与外部规范口径 
不动代码、配置与迁移，只收敛文档口径。

- 登记两项外部冲突：Q13 日计划缺失可选字段（SIS §3.16 注释 4 要求删除本地值，
  与现行"未携带字段保留"相反）、Q14 主/共享删除顺序与 EROR 回报义务
  （SIS §1.6.1-1.d / §4.8）；航班级"缺席不删"补 SIS §3.16 注释 1 依据。
- flight-state §3.3 补主/共享关联按 FLID 值比较的规则。
- message-lifecycle：§11 水位不变量与 §5.1 空洞老化自洽；删除过期的 updatedAt
  判据，统一为 PROCESSING_STARTED_AT + 可注入 Clock；§5.1/§6 补 SIS 480 分钟
  Expiry 与 legacy 1 天保留窗，作为 Q2/Q6/Q7 的取值参照。
- architecture/design：明细表口径统一为 8 张资源明细表 + FLIGHT_ROUTE_POINT；
  Oracle 11g 断言收敛为待适配验证；配置键按 application.yml 实际名称加 msgx. 前缀。
- user-stories：Q2/Q6/Q11 补外部锚点并收窄 Q11 到重置周期 + SNDR 值域；
  新增 Q13/Q14 并挂入 US-05/06/08 前置；五个独立事实改为引用 message-lifecycle §1。
- README/legacy：文档基线改为代码基线 eea1120 + git log 指引；补"外部协议冲突以
  SIS 为准"的维护规则；修正 /all/flights 过滤措辞；术语统一为「回填意图」。

验证：文档间章节引用 0 缺失、markdown 0 断链、SIS 引用小节全部存在、
Q1–Q14 正文与 Q 表双向可解析、代码块配对正常。
 2026-09-10 20:54:01 +08:00
windyboy dd839e6abb docs: 统一生命周期与处理职责口径 2026-09-10 19:48:49 +08:00
windyboy 8c6bb83b62 docs: 同步信箱生命周期实现口径——§4 缺口收敛、水位空洞老化、回填事实并入 PROC_STATE 
message-lifecycle.md：§4 两个崩溃窗口随"终态与回填意图同体同行"消除（不再是缺口，改为
说明剩余未闭环项是回填跨库单写期间的持续失败）；§5.1 补空洞老化规则（自增回滚空位会使
水位永久停摆，超出最大提交时延即判永久并放行，只跳过空洞不越过已存在的行）；§5.2 补判据
机制（不依赖独立待办表，R 覆盖退避）；§3 表格改回填意图与"到期或已达 NOW − R"。
design.md：§2.1 表以 INBOX_CURSOR 取代 BACKFILL_TODO、PROC_STATE 责任补回填事实；
§3.1 收报改为按 ID 区间扫描且不以标记为谓词；§3.3 终态由处理器事务内落库、死信同样可
补写；§6.1 维护作业改为 BackfillService.sweep；§7 补 max-commit-delay/overdue-backfill/
backfill-batch 与 mailbox.processed-value；§8 验证表补"终态未回填不得阻断发现"与"意图随
事务回滚"；§9 入口表更新；§10 缺口两则改写为现状与待确认项。
architecture.md：§4 主流程第 1/3/4 步与 §3 存储表同步（水位、回填意图、单事务范围）。
flight-state.md：§2 对象表同步。user-stories.md：US-01/US-09 当前基础与落点改为实现现状、
Q2 口径改为"老化阈值待库方书面承诺"。
 2026-09-10 11:00:02 +08:00
windyboy ffd3abd655 docs: message-lifecycle 审查修正——消解跨文档冲突、口径归口并登记 Q12 
message-lifecycle.md：
- §5.3 日计划改为现行合并语义（缺席不删、缺失保留，引 flight-state §3.1），类型粒度统一 TYPE-STYP
- §5.1 明确两条扫描路径按 ID 区间取行、不以处理标记为谓词；水位定义与 Q2 绑定
- §4 两个缺口改与 design §10 同措辞；§5.2 的 R 构成挂 Q6/Q9，新增 Q12 积压跳过授权
- §6 方案 B 对账补“只补缺失行、标记单调不回退”；删除能力声明标注待 Q9 确认
- §7 改为“尚未实现”、统一 COUTMSGS_* 列名；§11 ID 不断链改为条件式不变量

user-stories.md：US-11 第 4 条限定为“本系统不写共享历史表/不清除外部信箱”；US-01 扫描谓词指向 lifecycle §5.1；US-01/09/11 前置补口径指针；新增 Q12；OPS-2 补积压与最老未处理信龄；Q10 列名统一。

architecture.md：共享 MySQL 红线限定主体；§6 中断恢复表改为指向 message-lifecycle §4；收报步骤补扫描谓词指针。

design.md：水位定义、回填死信处理、维护作业、归档、缺口恢复统一指向 message-lifecycle。

README.md：核对日期更新至 2026-09-10（代码基线 99a0f5f，文档基线 328bbf8）；维护规则补规范类文档一档。
 2026-09-10 09:00:53 +08:00
windyboy 328bbf88d2 docs: 新增 message-lifecycle.md——上游消息生命周期唯一规范（五事实/崩溃恢复/水位/超期补写/历史积压/信箱清除 A/B/出站契约），登记 Q9/Q10/Q11，README 索引与 architecture/design 指针补齐 2026-09-10 08:55:43 +08:00
windyboy 8068ed975b docs: 文档整理——统一 KAFKA 事件名与运营日术语，链接文字对齐标题，修复两处空行格式，README 补旧行为基线索引；主/共享级联语义上移至 flight-state §3.3 并增补 STATE_VERSION 不变量（architecture §9 引用同步改为 §3.1/§4/§7） 2026-09-10 08:16:31 +08:00
windyboy b75f566276 docs: 按代码现状收敛 architecture/design/user-stories 口径并对齐 flight-state 口吻 
- design.md：删除已退场 PUMP_JOB/Handler/Decision 等引用，改按 ScheduleProcessor 与
  DynamicProcessors 实际分派描述；补 PROTOCOL 错误类与 RESP 守卫缺口；实现入口与 §10
  差异清单按 HEAD 代码重写
- architecture.md：修正悬空章节引用；关键决策删减为仍具约束价值的 4 条并连续编号 D1–D4，
  补当前状态列
- user-stories.md：逐条更新 US 当前基础与落点，清理已不存在的文件与旧叙事，Handler 术语统一
- README.md：实现核对日期更新至 2026-09-09（基线 d53a0a1）

flight-state.md 与 docs/legacy/ 保持原样。
 2026-09-09 21:50:05 +08:00
windyboy d53a0a1c2f docs: remove retired schedule generation design 2026-09-09 20:22:10 +08:00
windyboy 879d658159 refactor(flight-state): 按 flight-state.md 审计定稿全量重构脚手架与 SQL (ACM2-31) 
- SQL 基线 V1__flight_state_baseline.sql 整体取代 V1.0.0–V1.4.0：
  PIPELINE_LOCK/PROC_STATE/MSG_EVENT/REQ_TRACK/BACKFILL_TODO/FLIGHT_SCHD
  + 8 张资源明细表 + FLIGHT_ROUTE_POINT + SCHD_SNAP_LOG 留痕层
- 废除 FDAY 日代/SCHD_GEN/名单差删：OPERATION_DAY 不可变（应用层校验 +
  条件更新强化 §7.4），STATE 仅 ACTIVE/DELETED，物理清除只在历史归档后
- 处理器化：applyScheduleRecords（§5.1 七步同一事务，重放判定/整包
  DEAD(PROTOCOL)/归属冲突不落地）+ FLOP/FDEL/ADFT（tombstone 仅
  ACTIVE→DELETED，重复 FDEL 幂等不推进版本）
- 投递：KAFKA_SCHD 同 FLID 按最新 STATE_VERSION 合并，被压掉事件关闭，
  TOMBSTONE 发 null 值消息（键缺失=删除旧值 §7.3）
- 回填待办改为业务事务内预登记，消除提交后写待办的崩溃窗口（§7.2/§10）
- XML 解码改为 jackson-dataformat-xml 数据类直接映射（SIS 信封强类型，
  FLTR 开放标签泛型承载）
- 历史归档/物理清除顺序不可颠倒：归档确认成功集才物理删除，未接通删 0 条
- 移除 PUMP_JOB 队列/ReferenceService/FlightStoreDiffTool 等旧机制与测试，
  新增运营日/引擎/快照/FDEL/归档顺序不变性回归测试
 2026-09-09 17:53:08 +08:00
windyboy 2b112f527c docs: consolidate flight state design 2026-09-09 11:43:34 +08:00
windyboy bb81deae0a docs: 航班状态设计重写为当前基线，按请求/下载与动态两条线讲清状态变更 (ACM2-30) 2026-09-08 18:50:34 +08:00
windyboy cd5de56937 refactor(flight-schd): 全宽表零子表收敛 16 个集合并定案 PIPELINE_LOCK 行锁 (ACM2-29) 
依据 ACM2-29 新定案【全宽表·零子表】，废除「*_TXT 过渡 + 按需升独立子表」
原规划（对 XSD maxOccurs=99 的过度设计），结合报文样例与成都现场地服实际
规律（登机门 1~2、值机柜台 1~3、转盘 1~2、延误单有效、靠撤桥/轮挡各 1 次）
将 16 个明细集合全部收敛为 FLIGHT_SCHD 宽表标量列或紧凑 VARCHAR 字串。

行为变更：
- V1.2.0 迁移：新增集合平铺槽位列（GTDT×2/CKDT×3/CLDT×2/PSDT×2/CHDT×2，
  跨集合同名属性按 B 前缀/CH 前缀消解）、里程碑标量列（DELY_*、ABTM_A/D、
  CHOT_ON/OFF）、异常前缀标量列（FDIV/FRET/FLAB）、紧凑航路字串
  （ROUT_PATH/ERUT_PATH）与无界集合 JSON 字串列（SRVT/VIPF/MAFL_TEXT）；
  删除全部 16 个 *_TXT 文本列；不建任何子表、零 CLOB；
- 仓储层：删除子表替换/回查机制，写侧集合键平铺为列（序号属性 0 = 显式
  删除标记，分舱复用条目抹平去重，超界按定案丢弃），读侧由平铺列重建
  16 个集合键，视图与 legacy flightInfo hash 保持同构（KAFKA_SCHD 线格式
  与 FS7 Diff 逐字段比对不受存储形态影响）；
- I5 单写者锁修正：PIPELINE_LOCK 单行 SELECT ... FOR UPDATE 取代
  PG advisory lock，PG/Oracle 11g 同构，无 DBMS_LOCK DBA 特权依赖；
- FlightFieldsJson 对契约结构字段解析 JSON tree 输出原生数组/对象，
  杜绝集合被再次编码成字符串的双重转义。

不变量：消息严格 FIFO、单写者互斥、增量=字段级合并（集合键出现=单资源
集合级全量快照替换）、快照=整体替换、按代域化差删均不变。

迁移影响：本地开发库为一次性测试数据，已重置并由 Flyway 全新应用
V1.0.0→V1.2.0（同文件名内容变更，沿用旧库会触发校验和不匹配）。

验证：./gradlew test 全绿（66 个用例，含本地 PG 真实方言集成：集合槽位
替换/清除、里程碑与航路平铺回读、PIPELINE_LOCK NOWAIT 互斥与提交释放）。
 2026-09-08 08:48:24 +08:00
windyboy 7b7b61f100 feat(processing): 实现自有 PostgreSQL 运营航班权威存储与单事务闭环 (ACM2-28) 
- FS1: 增加 Flyway 迁移 V1.1.0__flight_schd.sql，创建 FLIGHT_SCHD 与 SCHD_GEN
- FS2: 实现 FlightSchdRepository 接口及 JdbcFlightSchdRepository 与 StubFlightSchd，增强 JdbcOps 事务管理
- FS3: 扩展 MessageProcessor 事务 2 与按 FLID 点查视图，合并变更、事件与终态入单事务提交
- FS4: SnapshotFlow SQL 化（批处理 upsert、域内差删、SQL CAS 推进与熔断保护），JobExecutor 接入 PG 清场删除
- FS5: 彻底退役 Redis 权威与写路径，移除 FlightRedisClient、Lua 脚本、健康指示器与配置残留
- FS6: 补齐 U09/U29 不变量门禁（崩溃幂等、CAS 防并发、ADFT 存活保障、非 UTC JVM/会话时区无漂移）与 FlywayMigrationTest
- FS7: 交付影子对拍比较内核 FlightStoreDiffTool 与单元测试
- FS8: 全面回改 decision-flight-state、architecture、design、user-stories 权威文档与规范
 2026-09-07 16:12:00 +08:00
windyboy abacd6a3f4 docs: 收敛架构设计规范与用户故事实施清单 (ACM2-28) 2026-09-07 15:10:57 +08:00
windyboy bf233f7f69 docs(arch): 规范架构关键决策并清理冗余口水话与会话残留 
- 审查重构关键架构决策：规范 D1~D8 为规范定案与权衡结构
- 扩充系统级核心决策：固化跨库存储边界（D9）、主泵单写者模型（D10）、Kafka 幂等生产契约（D11）与报文归档契约（D12）
- 清理会话残留与口水化表述（家务活/见缝插针/变砖/沙箱环境记录等）
- 规范技术栈基线与当前就绪度客观描述
 2026-09-07 14:34:57 +08:00
windyboy 346929ea5d docs: 二轮审查文档收敛 ACM2-23～27（Kafka/依赖/ResponseDto/STATUS/格式） 2026-09-07 14:15:07 +08:00
windyboyandCursor 7ccdd00a31 docs: 统一中间件定位与 JDBC 轮询主路径口径 
Align README, architecture, design, config comments, and ingress docs
with the upstream message-processing middleware model: external CIIMS write
to CMINMSGS, JDBC poll as production ingress, HTTP /cminmsgs/send as compat.

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-07 10:27:44 +08:00
windyboy 8c8d2613c2 docs: 合并文档目录——doc/ 与根目录基线材料统一入 docs/legacy/ 
消除 doc/ vs docs/ 双目录混淆（git mv 保留历史）：
- doc/msgexchange-api-legacy-user-stories.md → docs/legacy/
- doc/unisysaodbsis.xsd → docs/legacy/
- SIS_AODB_RMS-V0.1.md（根目录 703KB）→ docs/legacy/
- 删除空 doc/ 目录；README「文档」导航补充 docs/legacy/（外部参考/基线材料，
  非本系统文档）；更新 README/architecture 与基线文档自引的路径引用。

docs/ 现为：architecture.md、design.md（自产）+ legacy/（legacy 拷贝参考）。
 2026-09-07 08:29:49 +08:00
windyboy e0ce863905 refactor(storage): ACM2-12 落地——自有 PostgreSQL 全内部状态，共享 MySQL 仅信箱 
按 ACM2-12 定案把仓库存储口径从"MySQL 六辅助表"推进到最终形态：
- 迁移：删除 MySQL V2.0.0 六表脚本，新增自有 PG V1.0.0
  （PROC_STATE/MSG_EVENT/PUMP_JOB/REQ_TRACK/REF_MASTER，PG 方言，REQ_TRACK.COUTMSGS_ID
  按 U18 修为 BIGINT；FLIGHT_STATE 阶段 B 缓做不建表）。
- 配置：datasources.default = 自有 PostgreSQL（enabled=false 待 U05）；
  移除 datasources.reference/flyway.reference；新增 mailbox.shared-mysql（共享信箱，
  仅 DML，不建表）；test profile 显式启用 H2 内存 datasource。
- 接口/注释：Repositories KDoc 按 ACM2-12 归属（自有 PG / 信箱封装 / gen→Redis 占位 /
  FLIGHT_STATE 缓做）；InboxService、Pump 事务模型注释对正
  （信箱外部副作用 + PG 本地事务 + 回填最终一致）。
- 文档：architecture §1/§2/§3/§4/§5(D1/D2)/§6/§7/§8、design §1/§2/§3.1/§3.4/§3.5/§6/§9、
  README 全部按 ACM2-12 收口（自有 PG + 共享信箱 + Redis 动态/gen + 阶段 B 缓做）。

验证：37 测试全绿；dev stub 冒烟仍可启动、/health UP、收报 200。
信箱适配层（CminmsgMailbox/OutboxMailbox）、gen→Redis Lua、作业窗口语义、影子重设计
属 ACM2-12 Checks ②③④⑤（U05/U09 批次）。
 2026-09-07 08:21:11 +08:00
windyboy a3f1da4bcc feat(ref): 21 类静态主数据独立 PostgreSQL 参考库边界就位（ACM2-11 落地） 
按 ACM2-11 定案调整（业务事务库 MySQL + 航班动态 Redis 不变）：
- 接口拆分：RefDataRepository 收为 gen-only（SCHD_GEN/流程 4 CAS，留守业务库）；
  新增 StaticRefRepository + RefUpsert 对齐 SOURCE 审计（N19）。
- 调用点：RequestCoordinator 应答落库、ReferenceService(21 类同步 TODO) 指向
  StaticRefRepository；Decision.refUpserts 与 Pump 事务 2 注释同步
  （静态写为弱事务，不入主泵事务 2）。
- Stub：StubRefData 仅 gen；新增 StubStaticRef（内存，保留 source）。
- 配置：datasources.reference / flyway.datasources.reference 占位
  （PostgreSQL，enabled=false 不建连；驱动 org.postgresql 随阶段 6 实装引入，
  版本由 platform BOM 约束 ~42.7）；catalog 补 postgresql。
- 文档：README / docs/architecture.md §2/§6 / docs/design.md §2/§6/§9 数据边界
  全部按"21 类 → PG 参考库、gen 留守 MySQL、Redis 动态不变"更新。

验证：37 测试全绿（./gradlew test，接口拆分后无破坏）。
表结构/迁移/ReferenceService 实装/应答接线属阶段 6（U05 批次后）。
 2026-09-07 07:56:54 +08:00
windyboy 7e3bf383a5 docs+fix: 文档回到代码事实；修复 dev 冒烟使其真正可跑（ACM2-10 复核意见落地） 
实测过程发现并修复四层问题，随后全部按实测结果校订文档：

- build.gradle.kts：补 application.mainClass（Kotlin 顶层 main → ApplicationKt）。
  此前 ./gradlew run 报 "No main class specified"，installDist 启动脚本主类为空（Dockerfile 不可运行）。
- application-dev.yml：stub 模式真正免基础设施——
  * datasources.default.enabled=false（micronaut-jdbc JdbcDataSourceEnabled 条件排除 DataSource，
    原注释"stub 不建连"意图未实现，DataSource eager 强制连 MySQL 导致启动失败）；
  * 关闭 micronaut 自带 Redis/Kafka 健康指示器（无 broker 时装配即把 /health 打成 500）；
  * 端点配置前缀修正：micronaut.endpoints.* 是死配置（/env 404、/beans 401 实测），
    正确为顶层 endpoints.*（env 默认禁用 / beans 默认 enabled+sensitive 一并注明）；
  * 关闭 eureka discovery，避免无注册中心时 /health 变 DOWN。
  验证：MICRONAUT_ENVIRONMENTS=dev ./gradlew run 无任何 env/外部依赖启动 → POST /cminmsgs/send
  200 返回 ID → /health UP；text/plain 415（U16 缺口实证）。37 测试全绿未受影响。
- README/docs/architecture.md/docs/design.md：按实测与复核意见校订——
  * README：dev 冒烟命令恢复为"无需 DB/Redis/Kafka"，记录修复缘由；
  * architecture：U17 服务名未落地（注册名仍取 micronaut.application.name=msgexchange-nextgen，
    msgx.service-name 无消费方）、三层隔离为目标态（仅 register-eureka=false 生效）、
    管理端点 5.1 实际口径（/env 默认禁用、/beans 默认 enabled+sensitive）、就绪度口径更新；
  * design：§9 补 U17 行；smoke 路径 UNSUPPORTED→CODEC_ERROR 修正；毒丸 head-deadline 判据不可达、
    快照 CAS 崩溃重放二次自增版本等"代码行为≠文档声明"处加实现注；I1 状态行同步。
- gradle/libs.versions.toml + gradle.properties：版本矩阵注释按依赖解析实测修正
  （platform 5.1.3 生效但 core 系解析 5.1.13，classpath 混用；原"5.1.10 无平台 BOM"说法与观测不符）。

未提交内容：无。代码级缺陷（毒丸判据、CAS 重放、DNLD 路由顺序、identity 键释放等）仍属
ACM2-10 排期，本次仅按文档职责如实标注，未改动实现。
 2026-09-07 07:39:57 +08:00
windyboy f0411da5fa docs: 补充架构文档与设计文档（docs/architecture.md + docs/design.md） 
- architecture.md：系统定位与双跑策略、技术栈、总体拓扑（两条单线程管道）、
  模块职责、关键决策 D1–D8、数据边界（六辅助表 vs legacy 旧表）、两阶段权威
  与就绪度（诚实口径：生产默认不可服务，前置 U05/U07/U09/U13/U15）、
  部署与安全姿态、可观测性。
- design.md：状态机与错误分类（含重放白名单）、六表数据模型（含 U18 已知缺口）、
  流程 1–4 与泵作业语义、失败/重试统一设计（U08）、不变量 I1–I5 落点、
  参数表、测试策略、可观测性、缺口清单对照 ACM2-10 U01–U30。
- README：新增文档导航；关联节按 ACM2-10 T16 修正改为 ACM2 现行入口
  （ACM2-3 架构权威 / ACM2-4 脚手架 / ACM2-10 评审），ACMA 仅归档。
 2026-09-06 22:30:03 +08:00