[M-AI-08-01] 盘点剩余 AI Workflow 并冻结学习综合分析迁移契约 #328

New Issue

wangdl · 2026-06-22T21:27:16+08:00

wangdl commented

2026-06-22 21:27:16 +08:00

类型 / 标签

audit / architecture / ai-platform / learning-analysis

风险等级

P0 — 遗漏生产级 AI Workflow 将导致迁移不完整；契约错误导致全量返工

依赖

M-AI-07 PASS

目标

审计当前学习综合分析与学习建议的真实链路
盘点仓库内全部剩余 AI 调用，确认 M-AI-08 是否为最后一个核心业务迁移里程碑

A. 全量 AI Workflow 盘点

搜索所有 AiGatewayService、Provider SDK、DeepSeek、generate/chat/completion、BullMQ AI queues、EventBus AI subscriber、旧 AiAnalysisWorker、Prompt Registry、modelName/modelTier。为每条调用建立清单：Workflow / 公开入口 / 模型调用方 / 当前执行方式 / 是否已迁移 / 对应里程碑 / 后续处理。分类：已迁移 / M-AI-08 范围 / 非生产代码 / 测试或工具 / 明确延期 / 遗漏的生产级 Workflow。

B. 学习分析现有链路

追踪 Controller/Scheduler → Analysis Service → 数据聚合 → Prompt → Model → Result Repository → Recommendation → 查询接口。所有结论附文件路径、类名、方法名、行号。

C-G. 审计范围

数据来源（可信服务端/客户端声明/禁止进入 Snapshot）、分析窗口（7天/30天/自然周/自然月）、当前输出字段、分析vs建议拓扑（单一Job vs Parent-Child）、副作用矩阵。

输出

docs/architecture/m-ai-08-learning-analysis-migration-contract.md
docs/architecture/m-ai-migration-inventory.md
Inventory 必须明确：M-AI-08 是否为最后一个核心业务迁移里程碑：是/否

非目标

不修改代码 / 不修改 Prisma / 不创建 Migration / 不注册 Job / 不改变生产流量

验收标准

全部 AI 调用已盘点（含搜索证据）
每条调用已分类（已迁移/M-AI-08/非生产/延期/遗漏）
Inventory 明确回答 M-AI-08 是否为最后一批
学习分析链路完整记录（文件+行号）
数据源矩阵完成
分析窗口冻结
拓扑（单一/父子 Job）冻结
契约文档写入 docs/architecture/

建议执行顺序

第 1 个执行

## 类型 / 标签 - audit / architecture / ai-platform / learning-analysis ## 风险等级 P0 — 遗漏生产级 AI Workflow 将导致迁移不完整；契约错误导致全量返工 ## 依赖 - M-AI-07 PASS ## 目标 1. 审计当前学习综合分析与学习建议的真实链路 2. 盘点仓库内全部剩余 AI 调用，确认 M-AI-08 是否为最后一个核心业务迁移里程碑 ## A. 全量 AI Workflow 盘点搜索所有 AiGatewayService、Provider SDK、DeepSeek、generate/chat/completion、BullMQ AI queues、EventBus AI subscriber、旧 AiAnalysisWorker、Prompt Registry、modelName/modelTier。为每条调用建立清单：Workflow / 公开入口 / 模型调用方 / 当前执行方式 / 是否已迁移 / 对应里程碑 / 后续处理。分类：已迁移 / M-AI-08 范围 / 非生产代码 / 测试或工具 / 明确延期 / 遗漏的生产级 Workflow。 ## B. 学习分析现有链路追踪 Controller/Scheduler → Analysis Service → 数据聚合 → Prompt → Model → Result Repository → Recommendation → 查询接口。所有结论附文件路径、类名、方法名、行号。 ## C-G. 审计范围数据来源（可信服务端/客户端声明/禁止进入 Snapshot）、分析窗口（7天/30天/自然周/自然月）、当前输出字段、分析vs建议拓扑（单一Job vs Parent-Child）、副作用矩阵。 ## 输出 - docs/architecture/m-ai-08-learning-analysis-migration-contract.md - docs/architecture/m-ai-migration-inventory.md Inventory 必须明确：M-AI-08 是否为最后一个核心业务迁移里程碑：是/否 ## 非目标不修改代码 / 不修改 Prisma / 不创建 Migration / 不注册 Job / 不改变生产流量 ## 验收标准 - [ ] 全部 AI 调用已盘点（含搜索证据） - [ ] 每条调用已分类（已迁移/M-AI-08/非生产/延期/遗漏） - [ ] Inventory 明确回答 M-AI-08 是否为最后一批 - [ ] 学习分析链路完整记录（文件+行号） - [ ] 数据源矩阵完成 - [ ] 分析窗口冻结 - [ ] 拓扑（单一/父子 Job）冻结 - [ ] 契约文档写入 docs/architecture/ ## 建议执行顺序第 1 个执行

wangdl added this to the M-AI-08 学习综合分析、学习建议与 AI 迁移闭环 milestone 2026-06-22 21:27:16 +08:00

wangdl commented

2026-06-22 21:32:08 +08:00

开发完成评论

完成内容

A. 全量 AI Workflow 盘点 (docs/architecture/m-ai-migration-inventory.md)

17 个 AI Workflow 全部盘点
6 已迁移 (Active Recall/Feynman/ReviewCard/Quiz/Synthetic/Engine infra)
4 在 M-AI-08 范围 (learning_state_analysis/weak_point_analysis/next_action_planning/flashcard_generation)
5 明确延期 (Learning Trend/Knowledge Import/RAG Chat/Vector Rerank/Admin Chat)
2 待退役 (Legacy AiAnalysisWorker/ReviewCardSubscriber)

B. 学习分析迁移契约 (docs/architecture/m-ai-08-learning-analysis-migration-contract.md)

当前链路：Runtime 轮询 → external AI call → persistResult()
目标链路：Unified Engine → AiGateway → LearningAnalysisProjector
数据源矩阵：11 个可信服务端数据源，逐项分类
聚合窗口：行为 7 天 / 成绩 30 天
Snapshot Schema：study/review/quiz/activeRecall/feynman metrics + dataQuality
Output Schema：summary/strengths/weaknesses/trends/risks/recommendations with evidenceRefs
拓扑：单一 learning_analysis Job（一次模型调用合并三者）
3 个阻塞项 (A1/A2/A3)：Prompt/Schema 缺失，由 Runtime 外部管理

关键判定:

M-AI-08 是否为最后一个核心业务迁移里程碑：是
是否有未登记的生产模型调用：否

修改文件

docs/architecture/m-ai-migration-inventory.md — 新增 (152 行)
docs/architecture/m-ai-08-learning-analysis-migration-contract.md — 新增 (418 行)

代码证据

发现	证据
4 个 Runtime job types	user-ai.service.ts:11-17 JOB_TYPE_CONFIG
外部 Runtime 轮询	runtime-internal.controller.ts:22 pollJobs
persistResult 三种分支	runtime-internal.service.ts:295-365
Snapshot 聚合	snapshot-builder.service.ts:75 buildSnapshot
无 Prompt/Schema	prompt-template.service.ts — 无 learning_ 相关注册
AiLearningAnalysis 模型	schema.prisma:2173-2194
WeakPointCandidate 模型	schema.prisma:2198-2216
NextActionRecommendation	schema.prisma:2220-2239

测试情况

781 passed (ai-job + user-ai + ai-runtime + quiz) = 0 failed

未完成 / 风险

A1/A2 阻塞：learning_state/weak_point/next_action Prompt 和 Schema 需 M-AI-08-03 新增
flashcard_generation 归属待确认：可纳入 M-AI-08 或延期

是否建议进入 Review

是 — 契约已冻结，建议进入 M-AI-08-02

## 开发完成评论 ### 完成内容 **A. 全量 AI Workflow 盘点** (docs/architecture/m-ai-migration-inventory.md) - 17 个 AI Workflow 全部盘点 - 6 已迁移 (Active Recall/Feynman/ReviewCard/Quiz/Synthetic/Engine infra) - 4 在 M-AI-08 范围 (learning_state_analysis/weak_point_analysis/next_action_planning/flashcard_generation) - 5 明确延期 (Learning Trend/Knowledge Import/RAG Chat/Vector Rerank/Admin Chat) - 2 待退役 (Legacy AiAnalysisWorker/ReviewCardSubscriber) **B. 学习分析迁移契约** (docs/architecture/m-ai-08-learning-analysis-migration-contract.md) - 当前链路：Runtime 轮询 → external AI call → persistResult() - 目标链路：Unified Engine → AiGateway → LearningAnalysisProjector - 数据源矩阵：11 个可信服务端数据源，逐项分类 - 聚合窗口：行为 7 天 / 成绩 30 天 - Snapshot Schema：study/review/quiz/activeRecall/feynman metrics + dataQuality - Output Schema：summary/strengths/weaknesses/trends/risks/recommendations with evidenceRefs - 拓扑：单一 learning_analysis Job（一次模型调用合并三者） - 3 个阻塞项 (A1/A2/A3)：Prompt/Schema 缺失，由 Runtime 外部管理 **关键判定**: - M-AI-08 是否为最后一个核心业务迁移里程碑：**是** - 是否有未登记的生产模型调用：**否** ### 修改文件 - docs/architecture/m-ai-migration-inventory.md — 新增 (152 行) - docs/architecture/m-ai-08-learning-analysis-migration-contract.md — 新增 (418 行) ### 代码证据 | 发现 | 证据 | |------|------| | 4 个 Runtime job types | user-ai.service.ts:11-17 JOB_TYPE_CONFIG | | 外部 Runtime 轮询 | runtime-internal.controller.ts:22 pollJobs | | persistResult 三种分支 | runtime-internal.service.ts:295-365 | | Snapshot 聚合 | snapshot-builder.service.ts:75 buildSnapshot | | 无 Prompt/Schema | prompt-template.service.ts — 无 learning_ 相关注册 | | AiLearningAnalysis 模型 | schema.prisma:2173-2194 | | WeakPointCandidate 模型 | schema.prisma:2198-2216 | | NextActionRecommendation | schema.prisma:2220-2239 | ### 测试情况 - 781 passed (ai-job + user-ai + ai-runtime + quiz) = 0 failed ### 未完成 / 风险 - A1/A2 阻塞：learning_state/weak_point/next_action Prompt 和 Schema 需 M-AI-08-03 新增 - flashcard_generation 归属待确认：可纳入 M-AI-08 或延期 ### 是否建议进入 Review - **是** — 契约已冻结，建议进入 M-AI-08-02

wangdl closed this issue

2026-06-22 22:19:38 +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#328