feat(GOV-008): 采用 RocketMQ 消息队列架构

2026-08-13 14:22:50 +08:00
parent 3cc00de8f6
commit f5994ad77e
34 changed files with 463 additions and 43 deletions
@@ -0,0 +1,33 @@
+# RocketMQ 消息队列架构调整 PRD
+
+- 功能编号：GOV-008
+- PRD 版本：0.1
+- 状态：approved
+- 日期：2026-08-13
+
+## 问题
+
+项目早期约定 RabbitMQ，但尚未实现消息客户端或业务消息链路。现决定统一采用 RocketMQ，并需要在服务脚手架落地前同步架构、环境契约和部署边界，避免后续同时维护两套消息模型。
+
+## 目标
+
+- 项目唯一消息队列调整为 RocketMQ 5.x。
+- Scheduler 和 Worker 通过 `MessageBusAdapter` 使用版本化消息契约。
+- 配置明确区分 NameServer、Broker/Proxy Endpoint、Topic 和 Group。
+- 保留本地默认关闭策略，同时允许连接独立运行的本机 RocketMQ。
+- 检查当前本机 Docker RocketMQ 的实际连通状态，不夸大验证范围。
+
+## 非目标
+
+- 本版本不实现 Server、Scheduler、Worker 或 RocketMQ Node 客户端。
+- 不替用户创建、删除或重启 Docker 或本机 RocketMQ 进程。
+- 不连接生产 RocketMQ，不创建生产 Topic 或 Group。
+- NameServer 可达时不宣称消息生产和消费已经可用。
+
+## 验收标准
+
+- 当前架构、开发规范、部署说明和环境模板只采用 RocketMQ。
+- Scheduler 与 Worker 开发/生产模板键集合分别一致，且无 RabbitMQ 变量。
+- 文档定义重复投递、幂等、重试、死信和顺序消息边界。
+- 本机 NameServer 的版本、端口和启动状态有可复核证据。
+- 诊断必须区分 Docker 容器与本机原生进程，并报告 NameServer、Broker、Proxy 的真实状态。