docs: 登记 AI-01/02/04 与数据-02 完成

This commit is contained in:
cat-shark
2026-10-09 15:09:06 +08:00
parent 94c807ef30
commit 84f2e06f09
+21 -16
View File
@@ -46,12 +46,12 @@
| | 复习-05 Feed 返回全文 | P3 | 依赖复习-01 | 条目单位与摘要口径(复习-01 第 1 项) |
| | 复习-06 学习引导 | P1 | 已确认待实施 | 依赖 AI-02 / AI-03,以及标记-01 的存储设计 |
| | 复习-07 复习耗时统计 | P2 | 已完成 | — |
| AI 链路 | AI-01 事务内同步等 AI | P2 | 待决策 | 事务外纯读对比(小改)/ 任务表 + 异步回写 |
| | AI-02 全链路同步阻塞 | P2 | 可实施(方案已定) | 若 AI-01 选任务表方案,则与 AI-01 同批 |
| AI 链路 | AI-01 事务内同步等 AI | P2 | 已完成 | — |
| | AI-02 全链路同步阻塞 | P2 | 已完成 | — |
| | AI-03 单 worker 串行无重试 | P2 | 已完成 | — |
| | AI-04 防并发锁是 JVM 内存锁 | P2 | 可直接实施 | 需确认「生成中」的对外语义(返回任务状态而非实体) |
| | AI-04 防并发锁是 JVM 内存锁 | P2 | 已完成 | — |
| 数据与检索 | 数据-01 业务主表缺索引 | P3 | 已完成 | — |
| | 数据-02 统计聚合在内存 | P3 | 待决策 | SQL 聚合下推 / 物化统计表 |
| | 数据-02 统计聚合在内存 | P3 | 已完成 | — |
| | 数据-03 编号撞号风险 | P3 | 已完成 | — |
| 导出 | 导出-01 无数据导出 | P1 | 已完成 | — |
| 安全 | 安全-01 数据库凭证明文 | P4 | 待决策 + 需你执行 | 是否轮换凭证;历史值清理还是视为已泄露 |
@@ -238,12 +238,17 @@
### AI-02(原 LPT-12)AI 全链路同步阻塞,用户需干等最长 10 分钟
- [ ] 未完成
- [x] 已完成(后端 `lpt-be` `cf380c5`;前端随本条同批改造)
- **涉及仓库**:`lpt-be` + `lpt-fe` + `lpt-ai`
- **依据**:`lpt-fe/src/utils/request.ts` 的 `timeout: 600000`;`lpt-be` 的 `AiServiceClient.submitAndWait()` 内部轮询最长 600s;`GET /study-sessions/{sessionNum}/report-draft` 这类 GET 也会触发 10 分钟阻塞并计费;`ReviewRecall.vue` 存在「AI 对比分析中,已等待 N 秒…」的分档文案。
- **影响**:页面只能干等;刷新或断开后请求丢失,AI 已消耗的 token 无法回收,结果也不落库。
- **建议**:`lpt-be` 建 AI 任务表(提交后立即返回 taskId),前端轮询 `lpt-be`;结果回写后前端再取。生成期间允许离开页面再回来。
- **验收**:提交 AI 任务后接口在秒级返回任务标识;任务结果可重复获取,无需重试即可拿到。
- **已实施**:新增 `ai_tasks` 表与统一 AI 任务接口(`POST /ai/tasks`、`GET /ai/tasks/{taskNum}`、`GET /ai/tasks/latest`):
- 提交秒级返回任务标识,结果写在 `result_payload`,按标识可重复获取;
- 三类能力(回忆对比、标准导图生成、报告草稿)全部改为任务;
- 读取接口不再产生副作用:`GET /review/standard-mind-map/{taskNum}` 不再自动生成(缺失时返回 null),`GET /study-sessions/{sessionNum}/report-draft` 已删除;
- 执行器在 `ai-task-*` 线程池里执行,提交后立即投递,`@Scheduled` 兜底扫描接手投递失败与进程重启;卡在 RUNNING 超过阈值的任务会被回收重试。
- **顺带修掉的一个真实缺陷**:后台执行线程没有 Web 上下文,而租户拦截器与公共字段自动填充都取 `StpUtil`,会直接抛 `NotWebContextException`。已引入 `TenantContext` 让后台线程显式声明执行身份(以任务所属用户执行),请求线程行为不变。
- **遗留**:`lpt-ai` 侧无需改动(AI-03 已提供任务队列);`lpt-be` 的 `AiServiceClient` 仍是「提交到 lpt-ai 后轮询」的同步封装,但已被调用在执行线程内,不再阻塞请求。
- **依据**:`lpt-fe/src/utils/request.ts` 的 `timeout: 600000`;`lpt-be` 的 `AiServiceClient.submitAndWait()` 内部轮询最长 600s;`GET /study-sessions/{sessionNum}/report-draft` 这类 GET 也会触发 10 分钟阻塞并计费。
- **验收**:提交 AI 任务后接口在秒级返回任务标识;任务结果可重复获取,无需重试即可拿到。✅ 落库集成测试覆盖:提交不在请求线程里调 AI、按标识重复查询结果一致、失败任务可查到原因、任务受租户隔离
### AI-03(原 LPT-13)`lpt-ai` 单 worker 串行且无重试
@@ -263,12 +268,12 @@
### AI-04(原 LPT-14)防并发锁是 JVM 内存锁
- [ ] 未完成
- [x] 已完成
- **完成于** `lpt-be` `cf380c5`
- **涉及仓库**:`lpt-be`
- **依据**:`StandardMindMapServiceImpl` 的 `ConcurrentHashMap<String, AtomicBoolean> generatingTasks`。
- **影响**:多副本部署时锁失效;「生成中」的重复请求会返回 `queryByTaskNum()` 的结果(可能为 `null`)而被前端当成成功。
- **建议**:改为数据库/分布式锁,并明确「生成中」的对外语义(返回任务状态而不是实体)。
- **验收**:多副本场景下同一任务不会并发生成;生成中重复请求返回明确的进行中状态。
- **已实施**:删除 `StandardMindMapServiceImpl` 里的 `ConcurrentHashMap<String, AtomicBoolean> generatingTasks`,改为基于 `ai_tasks` 的进行中判定:同一用户 + 同一类型 + 同一目标已有 `PENDING`/`RUNNING` 任务时复用该任务,因此不存在「多副本锁失效」。执行侧再用「状态仍为 PENDING」的条件更新抢占,多副本并发也不会重复执行。
- **对外语义已明确**:提交接口返回的是**任务状态**(`AiTaskResponse`),不再是可能为 null 的实体;前端据此展示「正在生成」。
- **验收**:多副本场景下同一任务不会并发生成;生成中重复请求返回明确的进行中状态。✅ 单测覆盖「同一目标重复提交返回同一任务标识」,集成测试覆盖重复提交复用
---
@@ -395,8 +400,8 @@
1. **学习会话生命周期**:会话-01/02/03 已完成;会话-04 + 会话-05 已完成(收敛方式取「惰性 + 定时并用」,出口取「结束并开始新任务 + 放弃」)。本模块已收口。
2. **内容归属与报告**:归属-01 与报告-01 合并一次改完碎片表与报告结构(碎片归属、报告四段结构、导图待更新标记、检索口径);标记-01(统一标记存储)随同定下,学习引导的来源标记依赖它。
3. **复习**:先落复习-01 的六项结论(口径与内容边界),复习-07(复习耗时)已独立完成;再做复习-02 / 复习-03 / 复习-04 / 复习-05;复习-06(学习引导)依赖 AI-02 / AI-03 与标记-01,排在 AI 链路之后。
4. **AI 链路**:AI-01(先把 AI 移出事务)→ AI-02 + AI-03(异步任务与队列可靠性)→ AI-04(并发锁与生成中语义)。
5. **数据与检索 + 导出**:数据-01、数据-03、导出-01 已完成;剩数据-02(需定 SQL 聚合下推 / 物化统计表)。
4. **AI 链路**:AI-01 / AI-02 / AI-03 / AI-04 均已完成。本模块已收口。
5. **数据与检索 + 导出**:数据-01 / 数据-02 / 数据-03 / 导出-01 均已完成。本模块已收口。
6. **安全与运维清理**:安全-01 ~ 安全-04、运维-01、清理-01,彼此独立,可并行推进。
7. **学习录音(已暂停)**:模块整体挂起,重启前先定 §12「路线分叉」(依赖 OBS / 自研原生)。