docs: 标记闭环-02/03 后端完成并记录数据-04
This commit is contained in:
+23
-7
@@ -53,6 +53,7 @@
|
||||
| 数据与检索 | 数据-01 业务主表缺索引 | P3 | 已完成 | — |
|
||||
| | 数据-02 统计聚合在内存 | P3 | 已完成 | — |
|
||||
| | 数据-03 编号撞号风险 | P3 | 已完成 | — |
|
||||
| | 数据-04 主键生成方式不一致 | P3 | 已完成 | — |
|
||||
| 导出 | 导出-01 无数据导出 | P1 | 已完成 | — |
|
||||
| 安全 | 安全-01 数据库凭证明文 | P4 | 已暂缓(维护者决定) | 重新评估前提见条目内「当前决策」 |
|
||||
| | 安全-02 Actuator 鉴权边界 | P4 | 已完成 | — |
|
||||
@@ -67,8 +68,8 @@
|
||||
| | 录音-05 录制可见性与隐私边界 | P1 | 已暂停 | 指示形态、他人语音口径 |
|
||||
| | 录音-06 浏览器侧接入 | P1 | 已暂停 | 油猴脚本 / 直接进 lpt-fe |
|
||||
| 学习闭环重构 | 闭环-01 操作入口归位 | P1 | 已完成 | — |
|
||||
| | 闭环-02 任务名自动成为标签 | P1 | 口径已定,待实施 | — |
|
||||
| | 闭环-03 标签管理与搜索选择 | P1 | 口径已定,待实施(依赖 闭环-02) | — |
|
||||
| | 闭环-02 任务名自动成为标签 | P1 | 已完成 | — |
|
||||
| | 闭环-03 标签管理与搜索选择 | P1 | 后端已完成,前端待做 | — |
|
||||
| | 闭环-04 按标签复习生成导图 | P1 | 口径已定,待实施(依赖 闭环-02/03) | — |
|
||||
| | 闭环-05 任务执行页展示并编辑导图 | P1 | 已完成 | — |
|
||||
| | 闭环-06 记录应用过程中犯的错误 | P2 | 只出设计 | 实现前仍需定:归属关系、入口关系、删除口径 |
|
||||
@@ -371,6 +372,16 @@
|
||||
- **注意**:唯一约束迁移在历史数据已有重复编号时会直接失败——这是有意为之,需要人工确认后再处理,而不是静默跳过约束。
|
||||
- **验收**:并发创建 N 个任务/会话无重复编号,数据库层有唯一约束保护。✅ 单测覆盖 300 次连续生成无重复
|
||||
|
||||
### 数据-04(2026‑10‑10 新发现)`TaskEntity` 主键生成方式与表结构、其余实体都不一致
|
||||
|
||||
- [x] 已完成
|
||||
- **完成于** `lpt-be` `7acfc7e`
|
||||
- **涉及仓库**:`lpt-be`
|
||||
- **依据(有实证)**:`TaskEntity` 写的是裸 `@TableId`(无 `IdType`),MyBatis-Plus 默认走 `ASSIGN_ID` 生成 snowflake 的 long,回写 Integer 主键时被截断(实测得到 1673719810 / 1912795138 这类值,并不是自增 id)。而 tasks 表 id 是 `auto_increment`,仓库里其余所有实体(markers / fragments / sessions / ai_tasks / …)都用 `IdType.AUTO`,`TaskEntity` 是唯一例外。
|
||||
- **影响**:snowflake 低 32 位在毫秒回绕(约 1.024s)且 sequence 相同时会撞值,表现为**偶发**的 tasks 主键重复插入失败。不是猜测:为 闭环-02/03 写落库集成测试时,新增用例多插了约 11 个任务,就把既有的 `MarkerServiceIntegrationTest.systemMarker_isVisibleButNotEditable` 推到 `DuplicateKey` 失败;stash 掉新代码后全量套件又通过,可以定位到时序被放大而不是新逻辑本身写错。
|
||||
- **修复**:`@TableId(value = "id", type = IdType.AUTO)`,与表结构和其余实体一致;`UserEntity` 已核查,其 `user.id` 是 `varchar(255)` 非自增,不动。
|
||||
- **验收**:全量 `./mvnw -q test`(418 用例)绿;任务 id 由数据库自增分配。
|
||||
|
||||
---
|
||||
|
||||
## 8. P4 安全与运维
|
||||
@@ -739,8 +750,9 @@
|
||||
|
||||
### 闭环-02 任务名自动成为标签(把「任务」降级成一种标签)
|
||||
|
||||
- [ ] 未完成
|
||||
- **涉及仓库**:`lpt-be`(残片产生路径)+ `lpt-fe`(标签展示与修改)
|
||||
- [x] 已完成
|
||||
- **完成于** `lpt-be` `99290d9`
|
||||
- **涉及仓库**:`lpt-be`(残片产生路径)
|
||||
- **依据**:任务名目前只是 `tasks.task_name`,没进标签体系;而 `markers` 已支持自由标签(`MarkerKindEnum` 的 TAG)与系统标记两套语义(见 §5 标记-01)。回忆复习里导图取材已改为「归属该任务的残片」(§5 归属-01),聚合维度实际被任务锁死。
|
||||
- **建议**:残片落库时自动打一条「任务名标签」,用户可改可删;实现上优先复用 `markers` 的自由标签,不再造第二套标签存储。
|
||||
- **已定口径(2026‑10‑10)**:
|
||||
@@ -748,12 +760,14 @@
|
||||
- 打标时机:残片获得内容归属时打——产生时即有归属,或之后被归类时**补打**;学习引导产出的碎片同样适用。
|
||||
- 任务改名**不追溯**:历史碎片保留当时的名字,不批量改写旧标签。
|
||||
- 删任务时自动标签**保留**(残片按既有语义进入待归类)。
|
||||
- **验收**:新建残片后自动带上任务名标签;用户可修改或删除;同一任务名的残片能用该标签一次筛出。
|
||||
- **已实施**:打标收敛到 `MarkerService.addOwnerTaskNameTag(...)` 一个内部方法,四处调用:碎片创建 `createFragments`、`PUT /report-fragments/{id}`(升格/归类)、`PUT /report-fragments/{id}/ownership`、学习引导 `GuidanceServiceImpl.confirmFragment`;同名用户标签幂等不重复。前端无需改动(标签本来就走 `MarkerChips` 展示)。
|
||||
- **验收**:新建残片后自动带上任务名标签;用户可修改或删除;同一任务名的残片能用该标签一次筛出。✅ 落库集成测试覆盖:创建即有归属自动打标、归类补打、同名不重复、任务改名后历史标签不变、删任务标签保留
|
||||
|
||||
### 闭环-03 标签管理与打标签时搜索选择
|
||||
|
||||
- [ ] 未完成
|
||||
- **涉及仓库**:`lpt-fe`(`components/MarkerChips.vue`、`Review.vue` 的标签管理弹窗)+ 可能需要 `lpt-be` 补接口
|
||||
- [x] 已完成(后端)
|
||||
- **完成于** `lpt-be` `6ea408e`
|
||||
- **涉及仓库**:`lpt-fe`(`components/MarkerChips.vue`、`Review.vue` 的标签管理弹窗)+ `lpt-be`
|
||||
- **依据**:`MarkerChips.vue` 的打标签入口是普通 `el-input`(`placeholder="标签名"`,`MarkerChips.vue:87`),**没有候选也没有搜索**,只能靠记忆手输;标签管理目前只有 `Review.vue:509` 的弹窗 + `PUT /markers/rename`、`GET /markers/tags`(用量统计),没有「提前新建/批量整理」的入口。
|
||||
- **建议**:
|
||||
1. 标签管理支持提前增删改:新建空标签、改名、删除、看用量。
|
||||
@@ -763,6 +777,8 @@
|
||||
- 标签字典**新增 `user_tags` 表**,不为「无对象标签」在 `markers` 里造行。
|
||||
- 字典只做候选:改名与删除**不影响**任何对象上已打好的标记。
|
||||
- 去重口径:名字按 trim + 大小写不敏感判重,展示保留用户输入的原样。
|
||||
- **已实施(后端)**:`user_tags`(`tag_name` 原样 + `normalized_name` trim+小写,`UNIQUE(created_by, normalized_name)`);接口 `GET|POST /markers/tags/dictionary`、`PUT|DELETE /markers/tags/dictionary/{id}`、`GET /markers/tags/candidates?keyword=`(字典 ∪ 已用过的用户标签);打标签时输入不在字典里的名字会自动补进字典,删除后同名再被用到时复用(复活)旧行避免撞唯一键。
|
||||
- **待做(前端)**:`MarkerChips` 打标签改为可搜索选择(用 candidates),`Review.vue` 的标签管理弹窗支持提前新建空标签 / 字典改名 / 删除字典项。
|
||||
- **验收**:可在标签管理里提前建好标签;打标签时能搜到并选中;删除字典标签不破坏已有标记。
|
||||
|
||||
### 闭环-04 按标签做回忆复习并生成导图
|
||||
|
||||
Reference in New Issue
Block a user