docs: 登记归属-01/报告-01/标记-01/复习-02/复习-06 完成

This commit is contained in:
cat-shark
2026-10-09 19:49:41 +08:00
parent fb9a26f456
commit b4914c41a9
+24 -9
View File
@@ -36,15 +36,15 @@
| | 会话-03 结束会话不幂等 | P0 | 已完成 | — |
| | 会话-04 悬挂会话无收敛 | P0 | 已完成 | — |
| | 会话-05 活跃会话拦截无出路 | P1 | 已完成 | — |
| 内容归属与报告 | 归属-01 内容归属与待归类 | 待实施 | 已实施(后端) | 前端进行中 |
| | 报告-01 报告与碎片不可修订 | P1 | 已实施(后端) | 前端进行中 |
| 标记与元信息 | 标记-01 统一标记存储 | P1 | 已实施(后端) | 前端待接入 |
| 复习 | 复习-01 复习回路补全 | 待确认 | 已完成决策 | — |
| | 复习-02 Feed 只读无反馈动作 | P1 | 已实施(后端) | 前端待接入 |
| 内容归属与报告 | 归属-01 内容归属与待归类 | 待实施 | 已完成 | — |
| | 报告-01 报告与碎片不可修订 | P1 | 已完成 | — |
| 标记与元信息 | 标记-01 统一标记存储 | P1 | 已完成 | — |
| 复习 | 复习-01 复习回路补全 | 待确认 | 已完成 | — |
| | 复习-02 Feed 只读无反馈动作 | P1 | 已完成 | — |
| | 复习-03 Feed 随机取样 | P3 | 已完成 | — |
| | 复习-04 覆盖率查询拉全量 | P3 | 已完成 | — |
| | 复习-05 Feed 返回全文 | P3 | 已完成 | — |
| | 复习-06 学习引导 | P1 | 已实施(后端) | 前端待接入 |
| | 复习-06 学习引导 | P1 | 已完成 | — |
| | 复习-07 复习耗时统计 | P2 | 已完成 | — |
| AI 链路 | AI-01 事务内同步等 AI | P2 | 已完成 | — |
| | AI-02 全链路同步阻塞 | P2 | 已完成 | — |
@@ -173,6 +173,10 @@
### 报告-01(原 LPT-08)学习报告与知识碎片不可修订
- [x] 已完成
- **完成于** `lpt-be` `c74f73a`(+ `lpt-fe` `18a2580`)
- **已实施**:碎片与报告都支持编辑与删除(软删除);新增 `PUT /report-fragments/{id}/ownership`、`DELETE /report-fragments/{id}`、`PUT|DELETE /review/report/{id}`、`GET /review/report/{id}/structured`;报告改为结构化三段(`session_summary` / `expectation_verdict` / `free_summary`,原 `content` 直接改名,不做老数据兼容),「按归属分组的碎片」查看时实时聚合;删除报告不连带删碎片,弹窗明示碎片保留。
> **已确认的决策(2026-10-09,维护者)**
>
> 1. **修订范围**:知识碎片与学习报告**都可编辑、都可删除**。删除一律走软删除(`deleted`),Feed / 统计 / 导图取材按未删除过滤。
@@ -197,6 +201,11 @@
### 复习-02(原 LPT-09)复习 Feed 只读,没有反馈动作
- [x] 已完成
- **完成于** `lpt-be` `63824b2`(+ `lpt-fe` `232fdb8`)
- **已实施**:碎片新增 `mastered` / `revisit` / `last_reviewed_time`;`PUT /review/feed/{fragmentId}/feedback` 标记或取消两个动作,`POST /review/feed/{fragmentId}/touched` 记录「接触」;智能排序的第三个信号取「最近接触时间」,「稍后再看」×1.6,「已掌握」×0.3(**不归零**,保留文档要求的随机性)。
- **刻意的取舍**:Feed 响应里 `mastered` / `revisit` 用 `@JsonIgnore` **隐藏**,前端只跟踪本次浏览内的点击状态。这样前端无法把反馈做成徽标或计数——一旦展示成状态,复习就会滑回清单模式。
- [ ] 未完成
- **涉及仓库**:`lpt-be`(+ `lpt-fe`)
- **依据**:Feed 仅提供列表/详情/回忆对比;`ReviewServiceImpl.reviewNeedWeight()` 的智能权重只有两个信号——时间衰减(`createdTime`)与任务最近一次回忆覆盖率。
@@ -218,7 +227,9 @@
### 复习-06 学习引导
- [ ] 未完成
- [x] 已完成
- **完成于** `lpt-ai` `fb3c6f9`、`lpt-be` `b51a621`(+ `lpt-fe` `232fdb8`)
- **已实施**:新增复习行为实体 `review_guidance_conversations`(记录上下文与复习耗时都挂在它身上);`GUIDANCE` AI 任务类型按轮提交,AI 回复写回会话轮次作为下一轮上下文;入口为 Feed 卡片与导图节点;用户确认后产出的碎片记录上下文为这次复习行为、默认内容归属为被引导概念所属任务、并带 `FROM_GUIDANCE` 系统标记;放弃不产生任何数据。
- **涉及仓库**:`lpt-be` + `lpt-fe` + `lpt-ai`(概念文档已写入 `lpt-docs`)
- **依据**:复习只有接触(Feed)与结构提取(回忆对比),概念边界上的误解(例如把“参数量”当成能决定磁盘占用)不会被覆盖率捕捉。
- **已定**:开放式问题引导(例:“1B 参数量的 LLM 模型,会占用多少磁盘空间?”),无标准答案、不判分;AI 在对话中纠正回答里隐含的边界问题;对话不设轮数上限;产出是知识碎片,由用户确认后记录;复用碎片全链路(归属、待归类、导图取材、Feed 回收);碎片默认归属“被引导概念所属的学习任务”,并带「来自学习引导」标记(仅标记,不做特殊处理);记录上下文为复习行为;耗时计入复习-07;不进入学习报告;入口为 Feed 卡片与导图节点;不提供降级形态,AI 不可用时该功能整体不可用。
@@ -454,8 +465,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 链路之后。
2. **内容归属与报告**:归属-01 + 报告-01 + 标记-01 均已一次改完(碎片表拆分归属、报告结构化、导图待更新标记、检索口径),学习引导的来源标记随之落地。本模块已收口。
3. **复习**:复习-01 六项结论已落;复习-02 / 复习-03 / 复习-04 / 复习-05 / 复习-06 / 复习-07 均已完成。本模块已收口。
4. **AI 链路**:AI-01 / AI-02 / AI-03 / AI-04 均已完成。本模块已收口。
5. **数据与检索 + 导出**:数据-01 / 数据-02 / 数据-03 / 导出-01 均已完成。本模块已收口。
6. **安全与运维清理**:安全-02 / 安全-03 / 安全-04 已完成;安全-01 与运维-01 由维护者决定暂缓(见条目内记录);清理-01 已完成。
@@ -484,6 +495,8 @@
> - 理由:`lpt-docs` 要求「待归类内容必须被看见,否则归类无从发生」;而复习的日常入口常常是 Feed 而不是总览,两处缺一都会漏。
> - 已排除:只放总览(归类时机与注意到的时机错开);只在 Feed 打标(永远不知道积压多少);独立「待归类」页面(会变成待办清单,且与总览职责重叠)。
>
> **归属-01 已完成(2026-10-09)。** 完成于 `lpt-be` `c74f73a`(+ `lpt-fe` `18a2580`、`lpt-docs` `8c55b86`)。
>
> **归属-01 决策完毕(2026-10-09),可以开工。** 实现要点汇总:碎片表拆 `context_type` + `context_num`(不可空、不可变)与内容归属字段(可空、可变、单一);报告表 `content` → `free_summary` 并新增 `session_summary` / `expectation_verdict`,分组段实时聚合不落库;删任务时碎片归属置空进待归类、其余软删;待归类在总览独立区块与 Feed 卡片两个入口呈现并支持就地归类/升格为任务。
- **文档**:`lpt-docs/docs/concepts/knowledge-ownership.md`(设计已确认,见文末结论)、`lpt-docs/docs/concepts/learning-report.md`(结构化报告形态)、`lpt-docs/docs/design/system-structure.md`(设计总纲)
@@ -564,6 +577,8 @@
> - 改名安全性依据:文档明确「标记不参与聚合口径,也不改变内容归属」,因此批量改名不存在数据口径风险——这正是它与「改内容归属」的关键区别。
> - 已排除:系统标记对用户隐藏(用户无法解释学习引导碎片为何归在那里、调试时看不到系统写了什么);只能删不能改名(改名退化为「删旧建新 + 逐条重打」,而批量改名本身无数据风险);可废弃(多一套状态转换与检索判断,而标签不参与聚合、保留历史标记的收益很小)。
>
> **标记-01 已完成(2026-10-09)。** 完成于 `lpt-be` `c6258fa`(+ `lpt-fe` `232fdb8`)。
>
> **标记-01 决策完毕(2026-10-09),可以开工。** 实现要点:一张通用标记表(`object_type` ∈ {FRAGMENT,TASK} + `object_num` + `kind` ∈ {SYSTEM,USER} + `marker_name` + 可空 `marker_value` + 建立者/时间);系统标记走代码枚举词表且用户只读;索引两条(按标记找对象、按对象列标记);前端提供点标签即筛选的单一筛选入口。
- **文档**:`lpt-docs/docs/concepts/marker.md`(新增,含 5 个待决问题)