docs: 补记学习会话页相关导图条目
This commit is contained in:
+14
-4
@@ -535,7 +535,7 @@
|
|||||||
5. **数据与检索 + 导出**:数据-01 / 数据-02 / 数据-03 / 导出-01 均已完成;数据-04 / 数据-05 是本次实现过程中新发现并已修的既有缺陷(主键生成方式不一致、逻辑删除标签占唯一键)。本模块已收口。
|
5. **数据与检索 + 导出**:数据-01 / 数据-02 / 数据-03 / 导出-01 均已完成;数据-04 / 数据-05 是本次实现过程中新发现并已修的既有缺陷(主键生成方式不一致、逻辑删除标签占唯一键)。本模块已收口。
|
||||||
6. **安全与运维清理**:安全-02 / 安全-03 / 安全-04 已完成;安全-01 与运维-01 由维护者决定暂缓(见条目内记录);清理-01 已完成。
|
6. **安全与运维清理**:安全-02 / 安全-03 / 安全-04 已完成;安全-01 与运维-01 由维护者决定暂缓(见条目内记录);清理-01 已完成。
|
||||||
7. **学习录音(已暂停)**:模块整体挂起,重启前先定 §12「路线分叉」(依赖 OBS / 自研原生)。
|
7. **学习录音(已暂停)**:模块整体挂起,重启前先定 §12「路线分叉」(依赖 OBS / 自研原生)。
|
||||||
8. **学习闭环重构**:闭环-01 / 闭环-02 / 闭环-03 / 闭环-04 / 闭环-05 均已完成(首页只读化 → 任务名自动标签 → 标签字典与搜索选择 → 按标签复习与标签导图 → 执行页就地编辑导图);闭环-06 本次只出设计(概念落 `lpt-docs/docs/concepts/error-record.md`),实现前仍需定归属关系、入口关系与删除口径。
|
8. **学习闭环重构**:闭环-01 / 闭环-02 / 闭环-03 / 闭环-04 / 闭环-05 / 闭环-07 均已完成(首页只读化 → 任务名自动标签 → 标签字典与搜索选择 → 按标签复习与标签导图 → 执行页基础导图 → 执行页改列按碎片标签匹配的相关导图);闭环-06 本次只出设计(概念落 `lpt-docs/docs/concepts/error-record.md`),实现前仍需定归属关系、入口关系与删除口径。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -773,10 +773,10 @@
|
|||||||
>
|
>
|
||||||
> **现状坐标(接手时先看这里)**
|
> **现状坐标(接手时先看这里)**
|
||||||
> - **首页** = `/welcome` → `lpt-fe/src/components/Welcome.vue`:落地页(`Login.vue:44` 登录后跳这里),实际承担的是**复习 Feed 滚动条**(`getReviewFeed(100, "smart")`),并在残片卡片上直接挂了写操作。
|
> - **首页** = `/welcome` → `lpt-fe/src/components/Welcome.vue`:落地页(`Login.vue:44` 登录后跳这里),实际承担的是**复习 Feed 滚动条**(`getReviewFeed(100, "smart")`),并在残片卡片上直接挂了写操作。
|
||||||
> - **复习模块** = `/review` → `lpt-fe/src/components/Review.vue`:任务维度总览(任务卡片 + 统计、待归类内容、标签管理弹窗、导出/排序偏好),任务卡片主操作是「回忆复习」。
|
> - **复习模块** = `/review` → `lpt-fe/src/components/Review.vue`:复习总览(继续草稿、标签范围入口、待归类内容、最近回忆、标签管理与导出),不再有任务/报告/碎片三连统计和标签导图列表。
|
||||||
> - **任务执行页** = `/start-task/:taskNum` → `lpt-fe/src/components/StartTask.vue`。
|
> - **任务执行页** = `/start-task/:taskNum` → `lpt-fe/src/components/StartTask.vue`。
|
||||||
> - **基础导图** = 表 `review_standard_mind_maps`,端点 `GET/PUT /review/standard-mind-map/{taskNum}`、`POST /review/standard-mind-map/{taskNum}/find-node`(均在 `ReviewController`);前端 `lpt-fe/src/api/standardMindMap.ts` + `components/MindMapViewer.vue`(已支持 `:editable`)。
|
> - **基础导图** = 表 `review_standard_mind_maps`,端点 `GET/PUT /review/standard-mind-map/{taskNum}`、`POST /review/standard-mind-map/{taskNum}/find-node`(均在 `ReviewController`)仍在,但产品已无入口;前端 `api/standardMindMap.ts` 已删,任务页改为按碎片标签匹配 `review_recalls` 的相关导图(闭环-07)。
|
||||||
> - **残片标签** = 表 `markers`,端点 `GET|POST /markers`、`POST /markers/batch`、`DELETE /markers/{id}`、`PUT /markers/rename`、`GET /markers/filter`、`GET /markers/tags`;系统词表 `SystemMarkerEnum` 目前只有 `FROM_GUIDANCE("来源", "学习引导")`。
|
> - **知识碎片标签** = 表 `markers`,端点 `GET|POST /markers`、`POST /markers/batch`、`DELETE /markers/{id}`、`PUT /markers/rename`、`GET /markers/filter`、`GET /markers/tags`;系统词表 `SystemMarkerEnum` 目前只有 `FROM_GUIDANCE("来源", "学习引导")`。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -869,6 +869,16 @@
|
|||||||
- **实现前仍需定**:错误记录与内容归属的关系;回看列表与复习总览的入口关系;删除口径。
|
- **实现前仍需定**:错误记录与内容归属的关系;回看列表与复习总览的入口关系;删除口径。
|
||||||
- **验收**:待上述待定项定稿后补。**在数据模型与入口定下来之前不要动手实现。**
|
- **验收**:待上述待定项定稿后补。**在数据模型与入口定下来之前不要动手实现。**
|
||||||
|
|
||||||
|
### 闭环-07 学习会话页按碎片标签列出相关导图
|
||||||
|
|
||||||
|
- [x] 已完成
|
||||||
|
- **完成于** `lpt-fe` `f409b91`(前置 `469e8eb` 删掉复习总览里的标签导图旧块);文档 `lpt-docs` `d6cedad`
|
||||||
|
- **涉及仓库**:`lpt-fe`(`components/StartTask.vue`、`__tests__/components/StartTask.spec.ts`,删除 `api/standardMindMap.ts` 与其测试)+ `lpt-docs`(`concepts/mind-map.md`、`review-scope.md`、`review-overview.md`、术语表代码现状、`design/review-loop.md`)
|
||||||
|
- **依据**:任务页的「基础导图」只读写 `review_standard_mind_maps`,而维护者要的是「这个任务涉及标签的、用户自己画过的复习导图」。碎片创建或获得归属时会自动带任务名标签(`AutoTaskNameTag`),自由回忆的范围是标签集合;任务碎片的 USER 标签与回忆范围标签有交集,就是相关。
|
||||||
|
- **已定口径(2026‑11‑20,维护者确认)**:数据源取 `review_recalls` 里 `scopeType=TAG` 的回忆;与任务碎片的 USER 标签求交集;任务页只读,编辑回原回忆;`review_standard_mind_maps` 从任务页直接移除,后端接口与数据保留。
|
||||||
|
- **已实施**:`StartTask.vue` 的「基础导图」卡片替换为折叠的「相关导图」:展开时 `GET /review/task/{taskNum}` 取碎片 id → `POST /markers/batch` 取 USER 标签 → 分页拉 `GET /review/recalls?scopeType=TAG` 并按交集过滤;每行显示范围名、草稿/已结束、更新时间与命中标签;点行只读渲染 `expression.root`;空态给「去按标签复习」,失败可重试;每页 100、上限 1000 条并提示截断。`api/standardMindMap.ts` 与其测试删除。
|
||||||
|
- **验收**:展开前不发请求;只列有交集的 TAG 回忆并显示命中标签;点开只读、无编辑入口;任务页不再请求 `/review/standard-mind-map/{taskNum}`。✅ `npm run type-check`、`npm run lint`(0 error)、`npm run lint:ui`、`npm test`(57 文件 / 433 用例)、`npm run build` 通过;`StartTask.spec.ts` 覆盖默认收起不请求、交集过滤、无标签空态、只读渲染、失败重试。未做独立截图评审(本机无可用后端与浏览器二进制),按快检 12 条自检。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 14. 命名收敛(术语表对齐)
|
## 14. 命名收敛(术语表对齐)
|
||||||
|
|||||||
Reference in New Issue
Block a user