windy/msgexchange-v2
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
13 Commits 1 Branch 0 Tags
7e3bf383a558cbc6247718820a0f5969b06e5f4b
Commit Graph
8 Commits
Author SHA1 Message Date
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 6c887adf56 fix(delivery,health): U14 deleteOf 结构化 JSON + U12 健康检查真实 ping（ACM2-10 复审核验项②③） 
- U14（复审②）：deleteOf 字符串模板在 partitionKey=null/非空时均产出非法 JSON，
  改 Jackson 结构化序列化（null→null 字面量，非空→带引号转义）；
  DispatcherTickTest 新增 phase B 两样例（readTree 合法性 + refs 精确断言）。
  注：该分支仅 Phase B 且 ES 投递成功后可达，当前属潜伏缺陷。
- U12（复审③）：Redis/Kafka 健康指示器由仅查 bean 存在升级为真实 ping
  （false/异常→DOWN；缺 bean 仍 DOWN）。FlightRedisClient/DeliveryPort 增 ping()
  （stub 返回 true；DeliveryPort 默认实现，真实 Kafka 实装时覆写为 metadata 校验）。
  ping 判定拆为可单测纯函数，HealthIndicatorsTest 覆盖 UP/DOWN/异常/缺 bean 四态。

验证：./gradlew test 37 个测试全绿（本地，未推送）。
 2026-09-06 22:12:23 +08:00
windyboy 6de3fa6c9c feat(observability): U12 可观测底座（ACM2-10 U12/R05/N31b） 
- logback：logstash 通道先加 AsyncAppender（queueSize 4096、neverBlock、discardingThreshold 0）
  ——logstash 不可达不阻塞业务线程（N31b 顺序约束：先降级再补日志）；MDC 增加 traceId/target
- 结构化日志 + MDC traceId（TraceLog.withTrace=cminmsgsId/eventId）：
  InboxService 收报 INFO；MessageProcessor SUCCEEDED/SKIPPED INFO、FAILED/解码失败 WARN、
  DEAD(MALFORMED/毒丸/EXHAUSTED) ERROR；SnapshotFlow staging/CAS WARN、快照成功 INFO；
  Dispatcher 发送 DEBUG、逐条/整批重试 WARN、DEAD(DLQ) ERROR、flushSchd 批次 INFO；
  ReplayService 重放 INFO/非法类 WARN；PipelineLifecycle 起停 INFO
- 自定义健康指示器（infra/health）：redis-flight-store / kafka-delivery——BeanProvider 可选解析，
  缺 bean（未 stub 也未实装）报 DOWN 而非启动失败；/health 聚合
- 保留：micrometer 队列深度/投递延迟 gauge 依赖版本选型（micronaut-micrometer 与平台 BOM 5.1.3
  对齐待锁），随数据层/真实 client 批次补；U13 毒丸超时告警与 DLQ 巡检入口仍属 WP2
 2026-09-06 21:02:27 +08:00
windyboy f6da0cb782 feat(runtime): U07 生命周期装配 + stub 装配冒烟（ACM2-10 U07/U01 遗留） 
- PipelineLifecycle：ServerStartupEvent 后在专用单线程（msgx-pump/msgx-dispatcher，daemon）
  拉起 Pump/Dispatcher 循环；停机 requestStop+interrupt+join；@Requires(msgx.pipeline.autostart=true)
- PipelineProps.pipeline.autostart（默认 false，生产/测试默认不自动起循环，防泄漏线程）
- stub 装配（infra/stub，@Requires(msgx.stubs=true)）：7 仓储内存实装 + StubXmlCodec（未实装
  → CODEC_ERROR 走 FAILED 可重放路径）+ StubRedis + StubDeliveryPort + Holder Factory
- 配置：application-dev.yml（stubs+autostart，/env、/beans 放开，无需 DB 即可 dev 跑通）；
  application-test.yml（stubs=true、autostart=false）；README 补 dev stub 运行说明
- PipelineSmokeTest（4）：等价 /beans 装配核验 + 收报→主泵领取→FAILED(CODEC_ERROR) + U11 重放
  回 PENDING + Dispatcher flush 聚合（stub 用例前清内存状态防上下文复用串扰）
- 全量测试 34 个通过
 2026-09-06 20:53:14 +08:00
windyboy 73113779d2 fix(processing): U08 重试闭环 + FailureScheduler + U11 重放入口（ACM2-10） 
- U08 闭环：失败状态迁移移到持有 head/事件的边界内——processOne/SnapshotFlow 统一经
  ProcFailure（FAILED+attempts+退避，达上限 DEAD/EXHAUSTED 并落库 attempts）；Dispatcher
  逐条与 SCHD 批量共用 retryOrDead；flushSchd 失败整批 attempts+1/指数退避，队首未到期不
  claim，达上限整批 DEAD(DLQ)；loop 只作最后防线——仅 catch Exception，InterruptedException
  恢复中断位并上抛，致命 Error 不吞（异常必可见）
- 统一策略：新增 FailureScheduler（可注入 java.time.Clock + TimeFactory，backoff/exhausted
  单一来源）与 ProcFailure，MessageProcessor/SnapshotFlow/Dispatcher 共用
- U11：ReplayService 显式重放入口 + ProcStateRepository.requeueByErrorClasses——仅白名单内
  可恢复类（CODEC_ERROR/UNSUPPORTED/INFRA/EXHAUSTED）从 FAILED/DEAD 回 PENDING(attempts 清零)，
  MALFORMED 永不重放
- 测试（30 个全绿）：①Pump 内部异常→FAILED(INFRA)→重试达上限 DEAD；②SCHD 连续失败退避递增→
  整批 DEAD 且 KAFKA:msg 不受影响；③AssertionError/InterruptedException 不被普通恢复吞掉；
  另有 ReplayService(3)、Dispatcher 批退避、InfraBindingStartupTest（DataSource 启动级绑定）
- 收尾：.gitattributes（行尾/二进制）；Gradle 10 弃用告警核查——仅来自 micronaut-application
  插件（BOM 注入 + IDE 文件生成），升级 Gradle 10 前需先升插件版本（已记录）
 2026-09-06 19:08:02 +08:00
windyboy 2175c352f6 fix(processing): WP1 核心语义（ACM2-10 U06/U08/U10/U11） 
- U06/N03：Dispatcher 逐条循环显式排除 KAFKA_SCHD（唯一出口 flushSchd 批量聚合），
  修复 schd 事件被无条件 markSent 吞掉、flush 永远 claim 不到的整链死路；flush 失败整批
  保持 PENDING、lastFlush 仅成功后推进（N24）
- U08 部分：Pump/Dispatcher loop 异常隔离（单次异常不静默死亡，U12 补告警日志）；
  processOne FAILED 入口 attempts 毒丸升级 DEAD（防退避到期后无限重试）；
  N28：backoffFor(attempt≤0) 下界保护不再抛异常
- U10/N21：未注册 handler → FAILED(UNSUPPORTED)+退避（绝不写终态）；占位安全化——
  HistorySweep.pickHistory 占位改空集（T07 修订）、SnapshotFlow staging 未实装改
  FAILED(UNSUPPORTED)+退避而非 DEAD（N05），CAS 冲突 FAILED(INFRA)+退避（N06 紧循环修复）
- U11/T06：decode 失败差异化——MALFORMED→DEAD 不重试；CODEC_ERROR→FAILED 可重放
- 新增 ErrorClass.UNSUPPORTED；单测：DispatcherTickTest(3)/MessageProcessorTest(6)/
  PipelinePropsTest(2)，19 个测试全绿
 2026-09-06 18:19:04 +08:00
windyboy 821da1334c feat(build): 阶段0 冒烟底座（ACM2-10 U01–U04） 
- U01：接入 KSP(kotlin-ksp 2.3.0)+micronaut-inject-kotlin，Micronaut BeanDefinition 由 0→94 个生成；
  移除 processing.annotations 业务包过滤（N23）
- U02：补 Gradle wrapper(9.6.1)；版本矩阵单一来源——micronaut 固定 5.1.3(gradle.properties
  micronaut.version，平台 BOM 最高发布版)、JDK25 口径统一、snakeyaml 版本入 catalog；
  新增 .github/workflows/ci.yml 与 Dockerfile；.gitignore 补 .kotlin/.opencode/.zcode/.gradle-*
- U03：application.yml 键位修正(datasources.default/flyway.datasources.default/kafka.producers.default)，
  移除 logstash 死配置块、logback env 统一 MSGX_LOGSTASH_*；新增 application-dev.yml(/env、/beans
  仅开发放开)；PipelineProps 四嵌套类补 @ConfigurationProperties；新增 PipelinePropsBindingTest
  （改值—回读离线验收，Micronaut Test 5.x 用 TestPropertyProvider）
- U04：README「数据库初始化」与 V2.0.0 脚本头声明 CMINMSGS legacy 前置（全新库需先建旧表）
 2026-09-06 17:59:07 +08:00
windyboy b2f3b896cc feat: scaffold Micronaut+Kotlin service per ACMA-8 v4 architecture 
- 4 modules (ingress/processing/delivery/reference) + codec + infra + jobs
- Flyway V2.0.0: six aux tables (PROC_STATE/MSG_EVENT/REF_DATA/REQ_TRACK/PUMP_JOB/FLIGHT_STATE)
- Lua: snapshot_replace (atomic cover+gen-diff-delete), batch_delete (3:30 sweep)
- config: env-externalized secrets, phase A/B switch, ACMA-8 param-table defaults
- logback: logstash TCP JSON + traceId MDC
- pure-logic tests: identity (I3), schd aggregation max-by-EVENT_ID (FIX #7)
- build verified: gradle compile+test green on JDK 25 (Micronaut 5.1 requires JVM 25+)

Migrated from legacy repo subdirectory per repo-strategy decision (separate repo
per service, org convention). Refs: ACMA-9, ACMA-8 v4, ACMA-6
 2026-09-06 16:13:50 +08:00