docs: 补记范围相关导图与 prod 升级方案
- 待办:复习总览改为「上次编辑的导图」,任务页相关导图不再区分草稿/已结束 - 新增笔记:总览按所选标签列出保存过的导图 - 新增提案:prod 只保留学习记录后原地升级
This commit is contained in:
@@ -773,7 +773,7 @@
|
||||
>
|
||||
> **现状坐标(接手时先看这里)**
|
||||
> - **首页** = `/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`。
|
||||
> - **基础导图** = 表 `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("来源", "学习引导")`。
|
||||
@@ -876,8 +876,8 @@
|
||||
- **涉及仓库**:`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 条自检。
|
||||
- **已实施**:`StartTask.vue` 的「基础导图」卡片替换为折叠的「相关导图」:展开时 `GET /review/task/{taskNum}` 取碎片 id → `POST /markers/batch` 取 USER 标签 → 分页拉 `GET /review/recalls?scopeType=TAG` 并按交集过滤;每行显示范围名、更新时间与命中标签;点行只读渲染 `expression.root`;空态给「去按标签复习」,失败可重试;每页 100、上限 1000 条并提示截断。`api/standardMindMap.ts` 与其测试删除。(2026-11-22 起回忆记录不再有草稿/已结束状态,行内只留更新时间与命中标签;「在原回忆中编辑」进入的回忆页打开即编辑。)
|
||||
- **验收**:展开前不发请求;只列有交集的 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 条自检。
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user