[M-AI-01-01] 冻结统一 AI 架构 ADR 与第一阶段约束 #245

New Issue

wangdl · 2026-06-19T20:05:35+08:00

wangdl commented

2026-06-19 20:05:35 +08:00

背景

当前存在 BullMQ (TypeScript) 和 Rust HTTP 轮询两套 AI 执行系统，部署拓扑不统一。需要冻结目标架构和第一阶段约束。

目标

提交正式 ADR 文档，包含：

当前部署拓扑
目标部署拓扑
API Process 职责
Worker Process 职责
Heavy Runtime 当前处置
第一阶段非目标
全部 8 个迁移批次
回滚原则
架构约束（AppModule 不注册 Processor、WorkerModule 不暴露 Controller 等）

非目标

不修改代码
不修改数据库
不创建新模块

风险等级：P0

依赖：无

建议执行顺序：1

验收标准

ADR 文件进入版本库
文档包含当前和目标拓扑图
文档列出全部 5 个 Processor
文档列出后续 8 个里程碑
后续 Issue 全部引用该 ADR

## 背景当前存在 BullMQ (TypeScript) 和 Rust HTTP 轮询两套 AI 执行系统，部署拓扑不统一。需要冻结目标架构和第一阶段约束。 ## 目标提交正式 ADR 文档，包含： - 当前部署拓扑 - 目标部署拓扑 - API Process 职责 - Worker Process 职责 - Heavy Runtime 当前处置 - 第一阶段非目标 - 全部 8 个迁移批次 - 回滚原则 - 架构约束（AppModule 不注册 Processor、WorkerModule 不暴露 Controller 等） ## 非目标 - 不修改代码 - 不修改数据库 - 不创建新模块 ## 风险等级：P0 ## 依赖：无 ## 建议执行顺序：1 ## 验收标准 - [ ] ADR 文件进入版本库 - [ ] 文档包含当前和目标拓扑图 - [ ] 文档列出全部 5 个 Processor - [ ] 文档列出后续 8 个里程碑 - [ ] 后续 Issue 全部引用该 ADR

wangdl added this to the M-AI-01 Worker 进程边界与部署收口 milestone 2026-06-19 20:05:35 +08:00

wangdl commented

2026-06-19 20:26:59 +08:00

开发完成评论

完成内容

提交正式 ADR-001 文档：统一 AI 架构迁移决策
提交附录 A：Worker 执行依赖闭包审计
ADR 已冻结并进入版本库（commit 54bc505）

修改文件

docs/architecture/adr-001-unified-ai-architecture.md
docs/architecture/adr-001-appendix-a-worker-dependency-closure.md

代码证据

docs/architecture/adr-001-unified-ai-architecture.md:30-51：当前与目标部署拓扑 ASCII 图
docs/architecture/adr-001-unified-ai-architecture.md:52-68：API Process / Worker Process / Heavy Runtime 职责定义
docs/architecture/adr-001-unified-ai-architecture.md:77-88：8 个迁移批次（M-AI-01 ~ M-AI-08）
docs/architecture/adr-001-unified-ai-architecture.md:90-98：第一阶段 8 条非目标
docs/architecture/adr-001-unified-ai-architecture.md:100-109：6 条跨批次架构约束
docs/architecture/adr-001-unified-ai-architecture.md:111-119：回滚原则
docs/architecture/adr-001-unified-ai-architecture.md:121-129：现有 5 个 Processor 清单
docs/architecture/adr-001-unified-ai-architecture.md:131-157：当前模块依赖图
docs/architecture/adr-001-appendix-a-worker-dependency-closure.md:1-174：5 个 Processor 的完整依赖矩阵、事件链路审计、Module 注册审计、WorkerModule 缺失依赖、修复建议矩阵

测试情况

已运行命令：无（纯文档 Issue，不修改代码）
结果：N/A

未完成 / 风险

无

是否建议进入 Review

是

## 开发完成评论 ### 完成内容 - 提交正式 ADR-001 文档：统一 AI 架构迁移决策 - 提交附录 A：Worker 执行依赖闭包审计 - ADR 已冻结并进入版本库（commit `54bc505`） ### 修改文件 - `docs/architecture/adr-001-unified-ai-architecture.md` - `docs/architecture/adr-001-appendix-a-worker-dependency-closure.md` ### 代码证据 - `docs/architecture/adr-001-unified-ai-architecture.md:30-51`：当前与目标部署拓扑 ASCII 图 - `docs/architecture/adr-001-unified-ai-architecture.md:52-68`：API Process / Worker Process / Heavy Runtime 职责定义 - `docs/architecture/adr-001-unified-ai-architecture.md:77-88`：8 个迁移批次（M-AI-01 ~ M-AI-08） - `docs/architecture/adr-001-unified-ai-architecture.md:90-98`：第一阶段 8 条非目标 - `docs/architecture/adr-001-unified-ai-architecture.md:100-109`：6 条跨批次架构约束 - `docs/architecture/adr-001-unified-ai-architecture.md:111-119`：回滚原则 - `docs/architecture/adr-001-unified-ai-architecture.md:121-129`：现有 5 个 Processor 清单 - `docs/architecture/adr-001-unified-ai-architecture.md:131-157`：当前模块依赖图 - `docs/architecture/adr-001-appendix-a-worker-dependency-closure.md:1-174`：5 个 Processor 的完整依赖矩阵、事件链路审计、Module 注册审计、WorkerModule 缺失依赖、修复建议矩阵 ### 测试情况 - 已运行命令：无（纯文档 Issue，不修改代码） - 结果：N/A ### 未完成 / 风险 - 无 ### 是否建议进入 Review - 是

wangdl closed this issue

2026-06-19 23:03:55 +08:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: wangdl/api-server#245