Skip to content

Commit d8313ec

Browse files
committed
docs(goal): v0.18.1 版本文档(M2 已实施)+ 系列表/索引/行数豁免更新
- v0.18.1.md:毕业仪式/回顾流/暂停放弃/组删除降级——范围/守卫链/快照哲学/ 测试验收/真机待办;versions README 索引新增行 - v0.18.0.md 系列表:v0.18.1 已实施(REQ-255~257);v0.18.2 设计已批准(ADR-028) - line-limit-exemptions:commands_goals 525 / db_goals 431 行数刷新与拆分计划 (M2 生命周期命令组已按登记拆出 commands_goals_lifecycle.rs)
1 parent 186fde9 commit d8313ec

4 files changed

Lines changed: 44 additions & 3 deletions

File tree

‎docs/standards/line-limit-exemptions.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -62,8 +62,8 @@
6262
| app/src-tauri/src/commands_video.rs | 370 | v0.5.0 M1(REQ-043)起:视频档案命令域(检测装配/领域检测/预热/记忆);v0.13.6(REQ-219~222)形态/领域/细目/记忆命令 + 分区映射形态接线再增;审查轮(H1 领域记忆兜底顺序修复/L2 独立 try)微增 | 若再增长:领域命令组拆至 commands_video_domain.rs |
6363
| app/src-tauri/src/commands_live.rs | 362 | 实时采集命令域(启动/停止/档案热切换/剪辑监听);v0.13.6(REQ-220)update_live_profile 细目参数与校验 + 审查轮(clear sentinel 空串语义/fine 计入至少一项)再增 | 若再增长:档案覆写命令拆至 commands_live_profile.rs |
6464
| app/src-tauri/src/live_session.rs | 368 | 会话装配/状态(LiveSessionParams 聚合 + run_session_after_engine 骨架 + ProfileOverride 细目字段);v0.13.6 +2 | 若再增长:ProfileOverride 与参数分拆至 live_session_params.rs |
65-
| app/src-tauri/src/commands_goals.rs | 498 | v0.18.0(REQ-248~250):学习目标命令域(14 命令 + inner 纯编排 + 访谈校验/埋点/宣言组装/进度收集)——命令薄壳与 inner 同域(commands_knowledge_core 先例);列表/详情/进度三视图共用 collect_signals/goal_card_metrics | 若再增长:里程碑命令组拆至 commands_goals_milestones.rs |
66-
| app/src-tauri/src/db_goals.rs | 313 | v0.18.0(REQ-248):goals 三表 DDL + 实体 CRUD/绑定/结算钩子内聚;行映射与事务建目标共享 add_milestone 族 | 若再增长:里程碑操作拆至 db_goals_milestones.rs |
65+
| app/src-tauri/src/commands_goals.rs | 525 | v0.18.0(REQ-248~250):学习目标命令域(15 命令 + inner 纯编排 + 访谈校验/埋点/宣言组装/进度收集)——命令薄壳与 inner 同域(commands_knowledge_core 先例);列表/详情/进度三视图共用 collect_signals/goal_card_metrics;v0.18.1 生命周期命令已拆至 commands_goals_lifecycle.rs | 若再增长:里程碑命令组拆至 commands_goals_milestones.rs |
66+
| app/src-tauri/src/db_goals.rs | 431 | v0.18.0(REQ-248~250):goals 三表 DDL + 实体 CRUD/绑定/结算钩子内聚;行映射与事务建目标共享 add_milestone 族;v0.18.1(REQ-255/256)毕业报告快照表与报告取数(结算快照/复习统计/成果物清单)再增 | 若再增长:毕业报告取数拆至 db_goals_graduation.rs |
6767

6868
## 前端(app/src/,数字来自前端审查快照;Task #9/10 拆分进行中)
6969

‎docs/versions/README.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -47,6 +47,7 @@
4747
| v0.17.0 | [v0.17.0.md](./v0.17.0.md) — AI 精修可到达度:策略化提示词(JSON v3 声明/四档阶梯/六旋钮/书面目标 chips/预览所见即所发)+ 笔记级 AI 能力(编辑态 🤖 AI 统一入口/手写档案/内容传参/工作台笔记级)+ 精修流式会话化(片级解析流事件/对话卡流式正文/完成双入口)(REQ-245~247,ADR-026) | 版本文档(代码已交付 2026-09-01) |
4848
| v0.17.1 | [v0.17.1.md](./v0.17.1.md) — bug 修复:知识补充轨迹 NULL 列崩溃(get_ai_task_trajectory Option 化)+ 笔记级精修卡住(NoteAiDialog hook taskIdRef 接线 + 结果取回防御) | 版本文档(代码已交付 2026-09-01) |
4949
| v0.18.0 | [v0.18.0.md](./v0.18.0.md) — 学习目标层 M1:目标对象 + 访谈式设定(四步+宣言+里程碑草案)+ 跨组聚合看板(REQ-030 激活/REQ-248~250,ADR-027;M1 代码已交付 2026-09-02,真机验收待执行) | 版本文档(M1 已实施) |
50+
| v0.18.1 | [v0.18.1.md](./v0.18.1.md) — 学习目标层 M2:毕业仪式 + 回顾流时间线 + 暂停/放弃 + 组删除降级提示(REQ-255~257;报告快照目标删除后仍可读) | 版本文档(M2 已实施 2026-09-02,真机验收待执行) |
5051

5152
## 沉淀规则
5253

‎docs/versions/v0.18.0.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@
1313
| 小版本 | 内容 | 状态 |
1414
|---|---|---|
1515
| **v0.18.0(本版)** | M1:三表 DDL + 纯函数(访谈/进度/状态机/里程碑建议)+ CRUD/绑定 + GoalPage/InterviewDialog + 埋点 | **已实施**(2026-09-02,真机验收待执行) |
16-
| v0.18.1 | M2:毕业仪式(goal_settle + 报告快照)+ 回顾流时间线 + pause/abandon + 组删除降级提示 | 已立项(REQ-255~257,即将实施) |
16+
| v0.18.1 | M2:毕业仪式(goal_settle + 报告快照)+ 回顾流时间线 + pause/abandon + 组删除降级提示 | **已实施**(2026-09-02,REQ-255~257;真机验收待执行) |
1717
| v0.18.2 | **AI 目标规划师**(用户 2026-09-02 重裁决:AI 规划+体系深度联动——建议制确认落库/双入口/初步体系/概念弱项/`/goal`/周契约预填/预算档位化,默认关) | 设计已批准([ADR-028](../adr/ADR-028-ai-goal-planner.md),REQ-251~254) |
1818

1919
> 生成式复习(REQ-021)单独立项;采集增强(REQ-229)维持搁置;不接 agent 框架/记忆模块/自主规划。

‎docs/versions/v0.18.1.md‎

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
# v0.18.1:学习目标层 M2——毕业仪式 + 回顾流 + 暂停/放弃 + 组删除降级提示
2+
3+
> 状态:**已实施**(2026-09-02;真机验收待执行)
4+
> 依据:v0.18 设计规格 §七/§十([ ] 已归档)· 用户排期裁决(2026-09-02:M2 先行 → v0.18.2 AI 规划师)
5+
> 需求:REQ-255(毕业仪式与报告快照)/ REQ-256(回顾流时间线)/ REQ-257(暂停/放弃与组删除提示)——已登记需求池
6+
7+
## 一句话
8+
9+
毕业=**用户可见确认仪式**(延续 v0.11.3 结算仪式纪律):判据全达标 → 报告预览 → 确认后 `goal_settle` 生成**毕业报告快照**(里程碑/子组结算/复习统计/成果物清单——目标删除后仍可读)+ 状态归档 + 埋点;目标详情新增**回顾流时间线**(创建→里程碑→组结算→毕业,全现算零双写);暂停/恢复外新增**放弃**(可选原因、无惩罚文案);绑定组被删的「随组结算」里程碑显示**降级提示**(按手动确认)。全程无 AI(M1/M2 零 AI 铁律)。
10+
11+
## 范围(做 / 不做)
12+
13+
**做**:goal_graduation_reports 快照表(FK SET NULL——报告独立于目标行)· goal_retro 纯函数(报告组装/回顾流/纯文本摘要,无 AI)· goal_settle(守卫:状态机+判据未达标拒绝/重复毕业拒绝/放弃后拒绝)· goal_retro / goal_abandon(原因可选、200 字上限)· list_goal_graduations(毕业档案)· GraduateDialog/RetroTimeline/详情面板(毕业按钮 ready 门控/放弃内联确认/降级提示条)/GoalPage 毕业档案区 · 埋点 goal_graduated/goal_abandoned。
14+
15+
**不做**:AI 教练/规划(v0.18.2)· 生成式复习 · 目标间依赖 · 毕业报告的 markdown 导出。
16+
17+
## 设计要点
18+
19+
- **守卫链**:goal_settle ① 状态机(毕业仅从 active 发起——已毕业/放弃/暂停拒绝)② 判据(graduation_readiness 未全达标拒绝,明细回显——仪式不豁免信号);快照先写、状态后归档(原子同命令)。
20+
- **快照哲学**:report_json 独立表(goal_id ON DELETE SET NULL,goal_name 冗余)——「毕业报告与回顾流快照永久保留」(同 notes_versions 哲学,验收 5)。
21+
- **回顾流现算**:created/milestone(仅完成态入线——skipped 无发生时刻不造假事件)/settlement(按组折叠+历史计数)/graduated;排序按发生时刻升序。
22+
- **降级提示**:group_settled 型里程碑 ref_group_id NULL ⇒「绑定组已删除,判据信号丢失——按手动确认」(数据层 CASCADE 语义随 M1 已就绪)。
23+
- **放弃**:active/paused→abandoned(终态拒绝);可选原因入 metrics payload(200 字上限);无惩罚文案(弹性承诺上延)。
24+
25+
## 测试与验收
26+
27+
- 纯函数 TDD:goal_retro golden(报告全字段透传/回顾流四类时间线/跳过不造假事件/空边界/文本摘要边界)
28+
- 数据层:毕业报告快照 CRUD + **目标删除后报告保留**(验收 5);组结算快照
29+
- 命令层:毕业守卫矩阵(未达标/重复毕业/放弃后毕业拒绝)/放弃守卫(终态拒绝/原因截断)/埋点断言
30+
- 前端 Vitest:GraduateDialog 确认流(mock goal_settle:预览→确认→报告渲染→失败不回退)
31+
- 验收:① 目标详情「🎓 毕业仪式」判据未满禁用+明细可见 ② 确认后状态=已毕业+回顾流时间线生成+报告快照落库 ③ 目标删除后「毕业档案」仍可读报告 ④ 放弃显式可用+可选原因+无惩罚文案 ⑤ 组删除后降级提示条出现 ⑥ 回归:cargo test / clippy / vitest / tsc 全绿
32+
33+
## 关联
34+
35+
- 规格:[v0.18 设计规格([ ] 已归档)](../archive/2026-09-02/2026-09-02-v0.18-learning-goals-design.md)
36+
- 后续:v0.18.2 AI 目标规划师([设计已批准](../superpowers/specs/2026-09-02-v0.18.2-ai-goal-planning-design.md),REQ-251~254)· 生成式复习(REQ-021 单独立项)
37+
38+
## 待办(剩余)
39+
40+
- [ ] 真机验收:建目标→达成判据→毕业仪式→报告快照→删除目标→档案可读 全链路走查(REQ-146 批)

0 commit comments

Comments
 (0)