Skip to content

Latest commit

 

History

History
54 lines (35 loc) · 5.67 KB

File metadata and controls

54 lines (35 loc) · 5.67 KB

v0.18.0:学习目标层 M1——目标对象 + 访谈式设定 + 聚合视图(无 AI)

状态:M1 已实施(设计已批准 2026-09-02,含优化评审 10 项;M1 代码已交付 2026-09-02,真机验收待执行) 依据:用户指令「探讨学习目标是否偏离产品 / 目标设定需询问明确真正需求 / 讨论实现方式 / 优化评审全部采纳」+ 设计规格 2026-09-02-v0.18-learning-goals-design.md([ ] 已归档) 需求:激活 REQ-030(学习计划系统 · P17)(P3 远期 → v0.18 系列);实施批内拆分/编号 REQ-248~250 + ADR-027 目标层建模 补登

一句话

新增「🎯 目标」页:学习目标对象化(目标=组的容器,N:M 绑定)+ 访谈式目标设定(四步逼问真需求 + 宣言确认 + 里程碑草案预填)+ 跨组聚合看板(里程碑/组结算/周契约/复习活跃度/弱项信号)——全部本地,无 AI;AI 教练(目标摘要注入/复盘/追问)按 M3 后置默认关。

版本定位(v0.18 系列)

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

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

用户裁决记录(2026-09-02,详见规格 §三)

目标=组的容器(N:M)· 独立「🎯 目标」Tab · 目标≠体系 · 访谈式设定(混合制:结构化四步 + M3 AI 追问)· 判据=可观测信号加权(自测占位)· 生命周期含调整/暂停/放弃 · 库即记忆(无记忆模块/无缓存层)· 预算档位化(4K/10K/30K 默认标准)· 优化评审 10 项全部采纳(删缓存列/draft 态、单组件双展开、单行卡、FSRS 弱项信号、里程碑草案、table-driven 测试、切分微调)。

范围(M1 做 / 不做)

做:goals/goal_milestones/goal_groups 三表(迁移幂等)+ metrics_events kind 扩展(goal_* + self_test_* 占位契约);goal_interview(四步问题集 + 配方推导 + suggest_milestones + 宣言组装);goal_progress(跨表聚合 → 档位);goal_rules(四态状态机 + 毕业判据/守卫);CRUD/绑定/progress 命令;GoalPage(单行卡列表)+ InterviewDialog(双展开)+ GoalDetail + 弱项块(FSRS 低稳定性卡占比);组删除 CASCADE 影响面测试;埋点。

不做:毕业仪式/回顾流(M2)· AI 教练/预算分配器/影子缓存(M3)· 生成式复习(REQ-021 单独立项)· 概念低激活弱项(M3)· 采集端任何改动 · agent 框架/记忆模块 · 云同步。

设计要点摘要(完整见设计规格)

  • 数据模型:goals(name/domain_tag/status 四态/horizon_end 可空/success_criteria_json/intent_json/created_at 即开始时间)+ goal_milestones(criteria_type=manual|group_settled|self_test,ref_group_id 可空)+ goal_groups(N:M,UNIQUE(goal_id,group_id))
  • 访谈:第 1/3 问必答、2/4 问折叠可选;答案落 intent_json(scenario/level/driver/criteria_statement/non_scope/weekly_commitment/obstacles);第 5 步宣言 + 里程碑草案(基础→应用→项目,可删改);快速模式=同组件双展开(名称+期限)
  • 判据配方:能上手→里程碑+主组结算;能独立实例→+项目组结算+应用记录≥1;能教别人/证书→+自测≥80%(占位);说不清→默认档
  • 进度信号:里程碑完成率 + settlements 历史计数(归档组仍计入)+ 周契约完成率(复用 week_contract_status)+ review_logs 近 90 天活跃度 + FSRS 低稳定性卡占比(弱项)
  • 一致性契约:信号现算 / 快照归档;目标层零双写;上卷路径为唯一交叉入口

测试与验收

  • 纯函数 TDD:配方推导 table-driven golden(6 条端到端 + 参数矩阵)、suggest_milestones、goal_progress 聚合边界、四态状态机守卫、宣言组装;数据层 :memory: 三表 CRUD + M1 即测组删除 CASCADE;前端 Vitest(InterviewDialog 双展开/跳过/草案删改、GoalCard 徽标)
  • 验收:见规格 §十三(1-7 条 M1 可验;8 条属 M3;9 条回归全绿)

关联

  • 规格:2026-09-02-v0.18-learning-goals-design.md([ ] 已归档)
  • 复用:v0.11 组/结算/周契约/指标 · v0.13 概念/决策(应用判据)· FTS5(远期 L3 检索)· v0.16 AI 对话(M3 注入)
  • 后续:REQ-024(问我的笔记)· REQ-021(生成式复习)· REQ-231(上下文注入 L1-L4.5)· ADR-027(实施批补登)

待办(实施时执行)

  • 需求池登记:REQ-030 激活 + 拆分编号(REQ-248~250,与代码同批)
  • ADR-027 目标层建模(N:M、判据配方、四态状态机、预算硬约束)——M1 实施批补登
  • 真机验收(REQ-146 批):建目标→访谈→绑定组→里程碑随结算自动通过 全链路走查