diff --git a/OPTIMIZATION_BACKLOG.md b/OPTIMIZATION_BACKLOG.md index 93f18f3..63007b9 100644 --- a/OPTIMIZATION_BACKLOG.md +++ b/OPTIMIZATION_BACKLOG.md @@ -54,6 +54,7 @@ | | 数据-02 统计聚合在内存 | P3 | 已完成 | — | | | 数据-03 编号撞号风险 | P3 | 已完成 | — | | | 数据-04 主键生成方式不一致 | P3 | 已完成 | — | +| | 数据-05 逻辑删除标签占唯一键 | P3 | 已完成 | — | | 导出 | 导出-01 无数据导出 | P1 | 已完成 | — | | 安全 | 安全-01 数据库凭证明文 | P4 | 已暂缓(维护者决定) | 重新评估前提见条目内「当前决策」 | | | 安全-02 Actuator 鉴权边界 | P4 | 已完成 | — | @@ -70,7 +71,7 @@ | 学习闭环重构 | 闭环-01 操作入口归位 | P1 | 已完成 | — | | | 闭环-02 任务名自动成为标签 | P1 | 已完成 | — | | | 闭环-03 标签管理与搜索选择 | P1 | 已完成 | — | -| | 闭环-04 按标签复习生成导图 | P1 | 口径已定,待实施(依赖 闭环-02/03) | — | +| | 闭环-04 按标签复习生成导图 | P1 | 已完成 | — | | | 闭环-05 任务执行页展示并编辑导图 | P1 | 已完成 | — | | | 闭环-06 记录应用过程中犯的错误 | P2 | 只出设计 | 实现前仍需定:归属关系、入口关系、删除口径 | @@ -382,6 +383,16 @@ - **修复**:`@TableId(value = "id", type = IdType.AUTO)`,与表结构和其余实体一致;`UserEntity` 已核查,其 `user.id` 是 `varchar(255)` 非自增,不动。 - **验收**:全量 `./mvnw -q test`(418 用例)绿;任务 id 由数据库自增分配。 +### 数据-05(2026‑10‑10 新发现)逻辑删除的标签占着唯一键,移除后重打同名标签会插入失败 + +- [x] 已完成 +- **完成于** `lpt-be` `02d5c24` +- **涉及仓库**:`lpt-be` +- **依据**:`markers` 的唯一键是 `uk_markers_object_marker (object_type, object_num, kind, marker_name, marker_value)`,**不含 `deleted`**;而 `MarkerServiceImpl.addUserTag` 只按 `deleted = 0` 查重(`@TableLogic` 自动追加)后直接 `insert`。因此「移除某标签后再给同一对象打同名标签」会与被逻辑删除的那一行撞唯一键。 +- **影响**:必现的写入失败。闭环-02 的自动任务名标签会踩到:用户删掉自动标签后重新归类同一碎片,`addOwnerTaskNameTag` 抛唯一键冲突并让归类操作失败。这是闭环-02/04 实现过程中发现的既有缺陷(与 `user_tags` 的「删除后同名复用旧行」是同一类问题,那里已按复用处理)。 +- **修复**:新增 `MarkerMapper.selectAnyByObjectAndName`(自定义 SQL,含逻辑删除行)与 `revive(id)`,`addUserTag` 查到已删除的旧行时复用(把 `deleted` 归零)而不是插入新行。 +- **验收**:`MarkerServiceIntegrationTest` 新增两例(移除后重打同名标签复用同一行;删掉自动任务名标签后重新归类仍只有一条标签);全量 `./mvnw -o test` 452 用例 0 失败。 + --- ## 8. P4 安全与运维 @@ -784,7 +795,8 @@ ### 闭环-04 按标签做回忆复习并生成导图 -- [ ] 未完成 +- [x] 已完成 +- **完成于** `lpt-be` `6a30022`(新增标签导图存储与生成)、`4b30c88`(标签范围回忆对比与记录口径),均在 `dev` 分支;`lpt-fe` `72a1792`(新增按标签复习与标签导图页面,路由 `/review/by-tag`,复习总览工具栏有「按标签复习」入口) - **涉及仓库**:`lpt-be`(导图存储与取材口径、回忆对比入口)+ `lpt-fe`(`Review.vue` / `ReviewRecall.vue`)+ `lpt-ai`(提示词入参) - **依据**:回忆复习目前是任务维度——`Review.vue` 任务卡片主操作进 `/review/recall/:taskNum`(`ReviewRecall.vue`),基础导图也按 `taskNum` 存取。想要「按概念复习」,现在没有任何入口。 - **建议**:复习模块增加「按标签复习」:选一个或多个标签 → 聚合带这些标签的残片 → 生成/更新一张导图 → 走既有回忆对比链路。 @@ -794,7 +806,9 @@ - 多标签由用户在界面上选**并集/交集**(默认并集);缓存键把标签集合(排序后)与模式一起纳入。 - 重算**手动触发**:素材变化只置「待更新」,与报告-01 的导图重建口径一致。 - 按标签复习**写回忆记录**:`review_recall_records.task_num` 改为可空,并加范围列(任务/标签 + 标签集合),复习耗时与覆盖率统计一并可用。 -- **验收**:选定标签后可生成导图并完成一次回忆对比,记录落库可追溯;不影响既有按任务复习。 +- **已实施**:`review_tag_mind_maps` 独立表(范围键 = 归一化标签集合排序拼接 + 取数模式的 SHA-256,合一即同一张导图);`review_recall_records.task_num` 改为可空并新增 `scope_type`/`scope_key`/`scope_tags`/`scope_mode` 范围列,任务范围行显式写 `scope_type=TASK`,既有任务维度统计与查询口径不变;多标签由界面选并集(UNION)/交集(INTERSECT),默认并集;生成走 `POST /ai/tasks` 的 `TAG_MIND_MAP`(targetNum=范围键,params 带 tags/combineMode/mode),回忆对比走 `TAG_RECALL_COMPARE`;素材变化(标签增删改、碎片删除、碎片获得自动任务名标签)只置「待更新」,重建手动触发;lpt-ai 未改动(沿用既有提示词入参)。 +- **接口**:`POST /review/tag-mind-map/query`(读范围状态,不触发生成)、`PUT /review/tag-mind-map`(整体大纲保存,不存在即新建)、`POST /review/tag-mind-map/recall-records`(范围历史)。 +- **验收**:选定标签后可生成导图并完成一次回忆对比,记录落库可追溯;不影响既有按任务复习。✅ `lpt-be` 全量 `./mvnw -o test` = 452 用例 0 失败(含标签导图取材并集/交集、范围键稳定、素材变化只置待更新、软删除碎片不取材、租户隔离、任务维度统计不受标签行影响);`lpt-fe` `vue-tsc` 干净 + 全量 `npx vitest run` = 42 文件 / 259 用例全绿(新增 `tagMindMap.spec.ts` 3 例与 `TagReview.spec.ts` 4 例)。 ### 闭环-05 任务执行页展示并编辑该任务的基础导图